Flutter 工程化搭建(Android端)

手机APP/开发
543
0
0
2022-05-28

为了积极拥抱新技术并优化RN的性能问题,所以决定在新业务需求中引入Flutter技术栈

Flutter混合栈开发大致可以分为一下两种模式

native工程直接依赖开发

具体接入方式为,先在setting.gradle 中加入如下代码:

setBinding(new Binding([gradle: this]))
evaluate(new File(
        settingsDir,'../../Flutter Module工程根目录/.android/include_flutter.groovy'
))

其次在App的build.gradle 中加入如下代码:

 implementation project(':flutter')

最后在主工程的build.gradle 中加入如下代码即可:

repositories {
buildscript {
        maven {
            url 'http://download.flutter.io'}}
}

allprojects {
    repositories {
        maven {
            url 'http://download.flutter.io'}}
}

native工程接入aar

新建Flutter module工程

flutter create -t module xx_module

目录结构如下

xx_modlue 
          - .android // Android测试工程- .ios  // iOS测试工程- lib  // Flutter主工程- main.dart // Flutter入口文件- pubspec.yaml  // Flutter三方包配置文件

Flutter中提供了将module打包成aar的命令,生成的aar文件路径为 xx_modlue/build/host/outputs/repo

flutter build aar

将生成的aar文件引入Android开发工程即可完成aar的引用

到目前为止整个aar的引入基本是可以正常开发的,但是存在问题,那就是在每次开发都需要手动的将生成的aar包复制到主工程中进行依赖,不仅操作麻烦而且会出错,所以讲Flutter打包及引入流程变成日常开发常用的模式是最佳实践

flutter 打包上传流程分析:

为符合日常开发流程,需要将Flutter打成的aar文件上传至maven,因此首要任务就是解决将aar上传至maven问题

查看生成的aar目录下面的pom文件会发现主工程依赖的第三方aar包也会被下载至xx_modlue/build/host/outputs/repo路径下,pom文件如下:

<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><modelVersion>4.0.0</modelVersion><groupId>com.xxx.flutter</groupId><artifactId>xxx</artifactId> 
  <version>release-0.0.7</version><packaging>aar</packaging><dependencies><dependency><groupId>io.flutter</groupId><artifactId>flutter_embedding_release</artifactId><version>1.0.0-af51afceb8886cc11e25047523c4e0c7e1f5d408</version><scope>compile</scope></dependency><dependency><groupId>io.flutter</groupId><artifactId>armeabi_v7a_release</artifactId><version>1.0.0-af51afceb8886cc11e25047523c4e0c7e1f5d408</version><scope>compile</scope></dependency><dependency><groupId>io.flutter</groupId><artifactId>arm64_v8a_release</artifactId><version>1.0.0-af51afceb8886cc11e25047523c4e0c7e1f5d408</version><scope>compile</scope></dependency><dependency><groupId>io.flutter</groupId><artifactId>x86_64_release</artifactId><version>1.0.0-af51afceb8886cc11e25047523c4e0c7e1f5d408</version><scope>compile</scope></dependency></dependencies>
</project>

分析pom文件可知在上传主工程生成的aar的时候我们还需要将下载下来的第三方aar上传至maven库,因此我们得知具体工程化脚本流程如下:

1、获取生成的aar路径

2、上传第三方依赖的aar文件

3、更新主工程aar的artifactId

4、上传主工程aar文件

具体脚本如下:

deploy_aar(){
    mvn deploy:deploy-file \
    -DpomFile="$FILE_PATH/$NAME.pom" \
    -DgeneratePom=false \
    -Dfile="$FILE_PATH/$NAME.aar" \
    -Durl="http://xxx.xxx.xxx:xxx/repository/public/" \
    -DrepositoryId="nexus" \
    -Dpackaging=aar \
    -s="mvn-settings.xml" \
    -Dversion="$VERSION"
}

projectDir=`pwd`

# 清除Flutter生成文件
flutter clean

# 获取pub包
flutter pub get

# 删除文件夹
rm -rf `pwd`/build/host/outputs/repo/


# 修改版本号
group="com.xxx.flutter"
type="release"
#type="debug"
#type="profile"
version="${type}-0.0.7"
artifactId="xxx"


echo "替换Flutter/build.gradle 中的group 为${group}"
path=`pwd`/.android/Flutter/build.gradle
sed -i '' '29s/^.*$/group "'${group}'"/'  ${path}
echo "替换Flutter/build.gradle 中的version 为${version}"
path=`pwd`/.android/Flutter/build.gradle
sed -i '' '30s/^.*$/version "'${version}'"/'  ${path}


# 打包AAR
flutter build aar --no-debug --no-profile

# 找到AAR并上传
path=`pwd`
# shellcheck disable=SC2006
p=`find ${path}/build/host/outputs/repo -type f  -name "*${type}*.aar"`
echo "${p}"


array=(${p//'\n'/})
currentName=""
currentPath=""
currentPom=""
currentDir=""

# shellcheck disable=SC2068
for item in ${array[@]}
do
    resFile=`basename ${item}`
    echo "${item}"
    result=$(echo ${resFile} | grep "flutter_release")if [[ "$result" == "" ]]
    then
      lenght=${#item}
      sub=${item:0:${lenght}-3}
      pom="${sub}pom"
      resFileLenght=${#resFile}
      subDir=${item:0:${lenght}-${resFileLenght}}
      curName=`echo ${resFile} | cut -d "-" -f 2`
      curNameLenght=${#curName}
      subVersion=${curName:0:${curNameLenght}-4}
      nameLenght="${#resFile}"
      subName=${resFile:0:${nameLenght}-4}export FILE_PATH="${subDir}"export NAME="${subName}"export VERSION=${subVersion}
      deploy_aar
    else
      nameLenght="${#resFile}"
      subName=${resFile:0:${nameLenght}-4}
      currentName="${subName}"
      currentPath=${item}
      currentPath=${item}
      lenght=${#item}
      sub=${item:0:${lenght}-3}
      currentPom="${sub}pom"
      resFileLenght=${#resFile}
      subDir=${item:0:${lenght}-${resFileLenght}}
      currentDir=${subDir} 
    fi
done

cd "${currentDir}"
echo `pwd`
mv "${currentName}.aar" "${artifactId}-${version}.aar"
mv "${currentName}.pom" "${artifactId}-${version}.pom"
cd ${projectDir}
echo `pwd`

currentName="${artifactId}-${version}"
currentPath="${currentDir}${currentName}.aar"
currentPom="${currentDir}${currentName}.pom"
echo "current name is ${currentName}"
echo "current path is ${currentPath}"
echo "currentPom is ${currentPom}"
echo "替换pom artifactId为${artifactId}"
sed -i '' '6s/^.*$/  <artifactId>'${artifactId}'<\/artifactId> /'  ${currentPom}
echo "currentDir is ${currentDir}"
echo "currentVersion is ${version}"


export FILE_PATH="${currentDir}"
export NAME="${currentName}"
export VERSION=${version}
deploy_aar

上传maven成功后,主工程依赖Flutter代码就和添加第三方SDK流程一致了。

选型对比

名称 优点 缺点 native工程直接依赖开发 接入快 工程结构复杂,无法将Flutter开发从native开发流程中剥离 native工程接入aar Flutter开发与native开发流程解耦 初期接入流程复杂

最终选择为通过maven方式接入aar方便后续拓展

Flutter 混合栈选型

在完成Flutter混合开发接入流程后,会有混合栈管理问题,在混合方案中解决的主要问题是如何去处理交替出现的Flutter和Native页面。综合目前的开源框架,选型为FlutterBoost

flutterBoost Flutter端接入:

FlutterBoost.singleton.registerPageBuilders(<String, PageBuilder>{testhome: (String pageName, Map<dynamic, dynamic> params, String _) =>MyHomePage(title: ''),
      shoppingcar: (String pageName, Map<dynamic, dynamic> params, String _) {
        String platformItemNo = '';if (params.containsKey("platformItemNo")) {
          platformItemNo = params['platformItemNo'];
          NativeChat.print(platformItemNo);}return ShoppingCar(platformItemNo: platformItemNo);},login: (String pageName, Map<dynamic, dynamic> params, String _) =>LoginPage(),overlay: (String pageName, Map<dynamic, dynamic> params, String _) =>OverlayPage(),});

android端接入:

application 初始化代码:

val router =
            INativeRouter { context, url, urlParams, requestCode, exts ->
                PageRouter.openPageByUrl(context, url, urlParams)}

        val boostLifecycleListener = object : FlutterBoost.BoostLifecycleListener {
            override fun onEngineCreated() {}

            override fun onPluginsRegistered() {}

            override fun beforeCreateEngine() {}

            override fun onEngineDestroy() {}

        }

        val platform = FlutterBoost.ConfigBuilder(application, router).isDebug(BuildConfig.DEBUG).whenEngineStart(FlutterBoost.ConfigBuilder.ANY_ACTIVITY_CREATED).renderMode(FlutterView.RenderMode.texture).lifecycleListener(boostLifecycleListener).build()
        FlutterBoost.instance().init(platform)

路由配置代码

// PageRouter 路由跳转及配置页面
object PageRouter {/**
     * 路由映射
     */ 
    val pageName: HashMap<String?, String?> =
        object : HashMap<String?, String?>() {
            init {put("xxxx://shoppingCar", "shoppingCar")put("xxxx://login", "login")put("xxxx://home", "home")put("xxxx://overlay", "overlay")}}const val SHOPPING_CAR = "xxxx://shoppingCar"const val LOGIN_PAGE = "xxxx://login"const val OVERLAY = "xxxx://overlay"const val BUYER_PRODUCT_DETAIL = "xxxx://buyer/productdetail"const val TEST_SECOND = "xxxx://testSecond"

    @JvmOverloads 
    fun openPageByUrl(
        context: Context,
        url: String,
        params: Map<*, *>?,
        requestCode: Int = 0): Boolean {
        val path = url.split("\\?").toTypedArray()[0]
        Log.i("openPageByUrl", path)return try {
            when {
                pageName.containsKey(path) -> {
                    val intent =
                        BoostFlutterActivity.withNewEngine().url(pageName[path]!!).params(params!!).backgroundMode(BoostFlutterActivity.BackgroundMode.opaque).build(context)if (context is Activity) {
                        context.startActivityForResult(intent, requestCode)} else {
                        context.startActivity(intent)}

                    return true}
                url.startsWith(TEST_SECOND) -> {
                    context.startActivity(Intent(
                            context,
                            SecondActivity::class.java
                        ))return true}else -> false}} catch (t: Throwable) {false}}
}

native 跳转逻辑

// 初始化channel通知

 FlutterBoost.instance().channel().addMethodCallHandler { call, result ->when (call.method) {"baseUrl" -> {
                    result.success(ApiConstant.getApiUrl())}}}

// 跳转代码

 val params = hashMapOf<String, String>()
            params["param"] = param
            PageRouter.openPageByUrl(this, PageRouter.SHOPPING_CAR, params)

Flutter 测试环境搭建

在混合开发的工程中被吐槽最多的大概就是测试了吧,和native打包在一起调试费时费力,对前端开发要求高需要了解native的基本流程