boost android版本,Android现有的原生项目集成FlutterBoost

本文会随着FlutterBoost的发布不断更新。

写本篇文章的目的：FlutterBoost的README和FlutterBoost所给的demo有出入，照着README是无法成功集成的。官方demo是已经集成完毕后的状态，所以我参考了demo，尝试如何一步一步集成，中间也遇到了一些问题，所以想记录一下，同时也希望对别人有所帮助。在此过程中请教了flutter boost 开源贡献小组中的许多大佬，他们也都热心给出了许多建议，在此表示感谢。

注意：本篇文章并不涉及FlutterBoost的原理。

本文基于你已经安装好了flutter并进行了相关的配置。如何安装配置请参考起步:安装Flutter。

先看看集成后的效果

运行效果.gif

接下来开始

flutter boost 目前已经支持flutter 1.9版本，对应的flutter 版本是：v1.9.1-hotfixes。

flutter boost分支是：feature/flutter_1.9_upgrade。

flutter boost androidx 分支是：feature/flutter_1.9_androidx_upgrade。如果你的项目需要支持 androidx的话，需要选择使用这个分支 。

切换flutter到stable分支。

这里说一下，flutter也是一个git仓库。我们可以用git命令或者Sourcetree等图形化工具查看。

首先在命令行运行flutter channel stable，切换到stable分支。然后运行flutter pub get。然后看一下stable分支最新的提交。

stable_channel.png

我是使用Sourcetree来查看flutter仓库的。可以看到当前处于stable分支的v1.9.1+hotfix.6节点。

创建Android原生工程

android_project.png

android_project_structure.png

我们创建好的Android原生工程结构如上图所示，注意我们是使用了androidx的。

使用Android Studio 创建一个flutter module工程

create_flutter_module_step1.png

选择 File->New->New Flutter Project

create_flutter_module_step2.png

create_flutter_module_step3.png

create_flutter_module_step4.png

注意我们创建的是一个 Flutter Module，并且我们使用了androidx。创建好的flutter module结构如下所示。

flutter_module_structure.png

Flutter Module 集成 Flutter Boost

现在我们要在创建好的Flutter Module中集成Flutter Boost。这里注意一点，因为我们的Android 原生项目和Flutter Module都使用了androidx,所以我们要使用Flutter Boost对应的flutter_1.9_androidx_upgrade分支。当时没注意这一点，也是一直报错，请教了flutter boost 开源贡献小组中的许多大佬才解决。

废话少说，打开Flutter Module的pubspec.yaml文件，添加Flutter Boost依赖。

dependencies:

flutter:

sdk: flutter

flutter_boost:

git:

url: 'https://github.com/alibaba/flutter_boost.git'

ref: 'feature/flutter_1.9_androidx_upgrade'

添加完毕以后在命令行里运行flutter pub get。到现在Flutter Module 集成 Flutter Boost已经完成，接下来的工作就是原生项目集成Flutter Module和Flutter Boost。

Android 原生项目集成Flutter Module和Flutter Boost

Android 原生项目集成Flutter Module和Flutter Boost就是以依赖module的方式把Flutter Module和Flutter Boost引进来。可以参考Android 原生项目集成Flutter。

首先在Android 原生项目的app的build.gradle文件中添加如下声明

android {

//...

compileOptions {

sourceCompatibility 1.8

targetCompatibility 1.8

}

}

如果不加这个东西，会导致许多编译错误。例如：

Transform artifact lifecycle-common-java8.jar (androidx.lifecycle:lifecycle-common-java8:2.0.0) with DexingTransform

然后在Android 原生项目根目录的settings.gradle文件中添加如下声明

include ':app' // 这一行应该存在

setBinding(new Binding([gradle: this]))

evaluate(new File(

settingsDir.parentFile,

'flutter_module/.android/include_flutter.groovy'

))

注意：如果你是从github上clone我的代码，需要改成如下所示，切记切记。

include ':app' // 这一行应该存在

setBinding(new Binding([gradle: this]))

evaluate(new File(

settingsDir.parentFile,

'FlutterBoostFlutterModule/.android/include_flutter.groovy'

))

添加完毕以后，同步一下工程。同步完毕以后工程目录如下所示。

project_structrue_after_change_settings.png

然后点击Android studio 工具栏上的Project Structure按钮为Android 原生项目app添加依赖。

tool_bar_project_structure.png

select_app_add_moduel.png

app_add_modules.png

点击OK，同步工程以后，我们发现在app的build.gradle文件中加入了这两行，说明我们集成Flutter Module和Flutter Boost成功。

success_integrate.png

使用Flutter Boost

现在我们已经把项目依赖搞定了，接下来就是使用了。首先我们把官方给的demoflutter_1.9_androidx_upgrade克隆下来，因为我们需要用到其中代码，就不自己写了，直接从官方demo中拷贝过来。

从官方demo中拷贝Android 原生部分的代码、资源文件等

官方demo.png

克隆下来以后使用AndroidStudio打开，目录结构如上所示。

首先我们拷贝Android 原生部分的代码、资源文件到我们的Android 项目中。

copy_android_code.png

拷贝完毕后有几点需要注意：

在AndroidManifest.xml文件中指定使用MyApplication。

将拷贝的Activity在AndroidManifest.xml文件中声明。

需要将NewBoostFlutterActivity也在AndroidManifest.xml文件中声明，这一点一定要注意。

Android 原生项目的AndroidManifest.xml文件

package="com.dmw.useflutterboost">

android:name=".MyApplication"

android:allowBackup="true"

android:icon="@mipmap/ic_launcher"

android:label="@string/app_name"

android:roundIcon="@mipmap/ic_launcher_round"

android:supportsRtl="true"

android:theme="@style/AppTheme">

android:name=".NativePageActivity"

android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density"

android:theme="@style/Theme.AppCompat"

android:windowSoftInputMode="adjustResize" />

android:name=".FlutterFragmentPageActivity"

android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density"

android:hardwareAccelerated="true"

android:theme="@style/Theme.AppCompat"

android:windowSoftInputMode="adjustResize">

android:name="io.flutter.embedding.android.SplashScreenDrawable"

android:resource="@drawable/page_loading" />

android:name="com.idlefish.flutterboost.containers.NewBoostFlutterActivity"

android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density"

android:hardwareAccelerated="true"

android:theme="@style/Theme.AppCompat"

android:windowSoftInputMode="adjustResize">

android:name="io.flutter.embedding.android.SplashScreenDrawable"

android:resource="@drawable/page_loading" />

从官方demo中拷贝flutter部分的代码、资源文件等

copy_flutter_code.png

到此集成结束，我们运行一下运行Android 原生项目看看是什么样子。

运行Android 原生项目

运行效果.gif

到此，我们的集成工作已经完毕，我们可以在此基础上修改文件，添加一些文件等等看看效果来研究Flutter Boost的原理等等。

参考链接