目前主流的混合开发方案有两种集成方式:源码集成、产物集成
本篇文件会详细介绍这两种集成方案的具体实现过程。由于开始在项目中使用了源码集成的方案,使用源码集成的方法,使用jenkins打包比较麻烦,需要管理两个工程的git仓库,所以后来改成了产物集成的方式。并在最终将产物集成方式整个过程自动化,方便代码及产物管理,接入成本大大降低。
源码集成
也就是谷歌官方提供的方案[https://github.com/flutter/flutter/wiki/Add-Flutter-to-existing-apps]。需要讲flutter module的代码也拉下来,然后开始集成。
1、打开原生工程的settings.gradle,加入以下配置
setBinding(new Binding([gradle: this])) // new
evaluate(new File( // new
settingsDir.parentFile, // new
'/flutter-sdk/mall_flutter_module/.android/include_flutter.groovy' // new
))
这里依赖的flutter module工程是和原生工程目录同级的。
2、打开app module下的build.gradle文件,在dependencies下怎加
implementation project(':flutter')
配置完以上两步,sync一下之后,就可以在原生项目中访问flutter。
产物集成(手动)
Flutter项目单独开发,开发完成后发布成aar包或者iOS的framework形式,原生项目依赖flutter输出的制品即可。
产物集成具体过程:
1、flutter 项目下,执行flutter build aar --build-number version即可讲产物aar发布到本地的maven仓库,(如果只想发release版本,可以使用flutter build aar --no-debug --no-profile --build-number version)
2、将.\build\host\outputs\repo复制到原生工程(我是在app module下新建了flutter_aar,然后将repo拷贝到flutter_aar下)
3、打开app module下的build.gradle文件,添加如下配置
dependencies {
debugImplementation 'com.example.mall_flutter_module:flutter_debug:1.0'
releaseImplementation 'com.example.mall_flutter_module:flutter_release:1.0'
api("cn.rongcloud.sdk:im_kit:4.0.3.14")
}
repositories {
mavenCentral()
maven {
url "flutter_aar\\repo"
}
maven {
url "https://storage.googleapis.com/download.flutter.io"
}
}
配置完以上两步,sync一下之后,就可以在原生项目中访问flutter。但是这种方式,产物不好管理。整个过程需要手动发布aar到本地maven,然后本地的maven仓库要放在原生工程目录下,这样才能提交到git上,才能在jenkins上正常打包编译。
产物集成(流程自动化)
原始的flutter build aar 会生成多个aar到本地repo,但是我们希望整个流程自动化。修改maven deployer到remote。
1、在jenkins上新建一个job,该job每次构建时,自动拉去flutter module的代码,并执行以下命令
flutter build aar --no-debug --no-profile --build-number version
2、修改jenkins服务器上,flutter sdk中的aar_init_build_script.gradle文件(文件所在目录flutter sdk安装目录 \flutter\packages\flutter_tools\gradle)
project.uploadArchives {
repositories {
mavenDeployer {
//repository(url: "file://${outputDir}/outputs/repo")
repository(url: "http://XXX.XX.XX.XX:XXXX/repository/maven-releases/"){
authentication("userName":"admin","password":"admin")
}
}
}
}
这样修改之后,每次执行job,都会把产物发布到远程的maven仓库中。
3、android工程中,修改app module下的build.gradle文件配置
dependencies {
implementation 'com.example.mall_flutter_module:flutter_release:1.0.0.5'
}
repositories {
mavenCentral()
//商城release maven,测试阶段及上线的时候使用
maven {
url "http://172.16.10.65:9081/repository/maven-releases/"
}
maven {
url "https://storage.googleapis.com/download.flutter.io"
}
}
这样通过远程maven的方式依赖及可访问到flutter。