前言
Flutter 作为跨平台,支持通过module的形式集成在现有的项目中,也可以通过打包成aar 在现有项目中接入,达到不需要改动现有项目结构来引入Flutter 作为模块开发。
这里主要介绍怎么将一个Flutter项目改造成可以打成aar包去集成到现有项目中。
创建项目
通过Android Studio 直接新建一个flutter Application(这里AS可以新建是因为直接添加了Flutter 插件,至于如何添加这里不做赘述)
之后就下一步,填写对应包名和保存路径完成创建,完成的项目结构如下图:
试运行一下,可以正常运行安装,跟其他demo效果一样
项目改造
现在通过编译安装之后,我们发现在项目里面多了个build文件,在app/outputs/apk 里面有app.apk 这个就是我们安装在手机上的apk包,现在我希望将他打成aar然后放到其他项目中引用。
在我们改造项目之前我们需要先将build/app/intermediates/flutter/release 里面的assets文件拷贝到我们项目app/src/main/assets 里面
接下来把项目打成aar需要做以下两步改造:
1、把app/build.gradle中的apply plugin: 'com.android.application'修改为apply plugin: 'com.android.library'
2、注释掉 applicationId "com.shanbay.flutterapp"
执行命令 flutter build apk,就可以得到app-release.aar文件。
将build/app/outputs/aar 里面的app-release.aar 集成到现有项目中
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
ButterKnife.bind(this)
FlutterMain.startInitialization(this.applicationContext)
}
fun onViewClick(v: View?) {
when (v?.id) {
R.id.mBtnFlutter -> {
//跳转到flutter界面
val intent = Intent()
intent.setClass(this,MainActivity::class.java)
startActivity(intent)
}
}
}
}
运行之后发现手机上会装有两个app,这个跟我们的预期有一些偏差,查看我们flutter项目里面的android的AndroidManifest.xml,发现里面Activity有定义LAUNCHER,这个就是导致手机上会有两个应用入口的原因了。
改造成模块化的aar
一个项目有两个桌面入口,对于大部分应用来说是不合理的,接下来我们就开始来改造,让编译出来的aar就相当于一个模块
首先在android目录下的gradle.properties里面添加BUILD_MODE=aar,src目录下新建一个文件夹maven里面放置AndroidManifest.xml,将activity的category:LAUNCHER去掉
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.cyh.commonflutter">
<uses-permission android:name="android.permission.INTERNET"/>
<application>
<activity android:name=".FlutterTestActivity"
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density"
android:hardwareAccelerated="true"
android:launchMode="standard"
android:theme="@style/LaunchTheme"
android:windowSoftInputMode="stateHidden|adjustResize">
<meta-data
android:name="io.flutter.app.android.SplashScreenUntilFirstFrame"
android:value="true" />
</activity>
</application>
</manifest>
接下来对app/build.gradle 进行改造,先将gradle.properties里面定义的参数BUILD_MODE进行判断,通过这个标志来判断当前模式是aar模式还是flutter模式
def isRunAsFlutter = "flutter" == BUILD_MODE
println('=== build_mode ===' + BUILD_MODE + "=== isRunAsFlutter ===" + isRunAsFlutter)
if (isRunAsFlutter) {
apply plugin: 'com.android.application'
} else {
apply plugin: 'com.android.library'
}
再对app/build.gradle里面的android进行一些修改,修改defaultConfig,aar不需要applicationId
if (isRunAsFlutter) {
applicationId "com.cyh.commonflutter"
}
buildTypes 里面通过对debug和release做不同的引入so处理
buildTypes {
debug {
ndk {
if (isRunAsFlutter) {
abiFilters "armeabi-v7a", "arm64-v8a", "x86"
} else {
abiFilters "armeabi-v7a"
}
}
}
release {
signingConfig signingConfigs.debug
ndk {
abiFilters "armeabi-v7a"
}
}
}
我们新增了一个maven的文件存放AndroidManifest,在打aar包的时候需要引入这里面的manifest而不是引入项目默认的manifest
sourceSets {
main {
def srcFile = isRunAsFlutter ? 'src/main/AndroidManifest.xml' : 'src/maven/AndroidManifest.xml'
manifest.srcFile srcFile
java {
srcDir 'src/main/java'
}
res.srcDirs = ['src/main/res']
assets.srcDirs = ['src/main/assets']
jniLibs.srcDirs = ['src/main/jniLibs']
}
}
通过以上步骤,我们就可以保存flutter项目可以随时编译运行调试,也可以在其他项目需要引用的时候直接打aar包,让其他项目进行引用。如果有搭建nexus代码仓库的话,就可以将代码上传到maven库,然后其他地方再引用,这样就可以达到项目之间的协作了