Flutter动态化-Android（一）

时间  2020-04-12
标签 flutter 动态 android 栏目 Android 繁體版
原文   原文链接

Flutter动态化-Android（一）

上篇咱们讲了flutter engine编译环境搭建，这篇咱们正式来看下如何修改flutter engine源码，实现动态化。java

本篇文章将分为两部分来说，本篇讲述有哪些核心代码须要修改的，如何编译engine源码，以及在flutter应用中该如何使用；下一篇会讲解如何打包编译成aar，以方便混合开发时使用。android

1、flutter engine核心代码修改

思路：分析libapp.so和flutter_assets的加载过程，在加载以前修改源码替换须要成本身的路径c++

1.一、FlutterLoader的ensureInitializationComplete

从前面的文章咱们能够知道，这个方法主要是构建shellArgs列表，在C层代码中会调用此配置初始化参数git

先看下面这段代码：github

if (BuildConfig.DEBUG || BuildConfig.JIT_RELEASE) {
		String snapshotAssetPath =
				PathUtils.getDataDirectory(applicationContext) + File.separator + flutterAssetsDir;
    kernelPath = snapshotAssetPath + File.separator + DEFAULT_KERNEL_BLOB;
    shellArgs.add("--" + SNAPSHOT_ASSET_PATH_KEY + "=" + snapshotAssetPath);
    shellArgs.add("--" + VM_SNAPSHOT_DATA_KEY + "=" + vmSnapshotData);
    shellArgs.add("--" + ISOLATE_SNAPSHOT_DATA_KEY + "=" + isolateSnapshotData);
}
复制代码

在debug和JIT模式时会配置flutter_assets、vm_snapshot_data、isolate_snapshot_data的位置，咱们知道在libapp.so文件的本质是至关于vm_snapshot_data、isolate_snapshot_data的打包合集，从这里咱们能够找到想到将libapp.so和flutter_assets文件放到debug或者JIT模式时的文件路径下，也就是PathUtils.getDataDirectory(applicationContext)目录下。shell

咱们再来看如何修改这个代码对应的else部分的代码：bash

// 查看/user/0/package/app_flutter目录是否存在libapp.so文件，若是存在就传递这个新的路径，不然就还使用默认路径（也就是lib/arm/或者lib/arm64/）的libapp.so文件
File appFile = new File(PathUtils.getDataDirectory(applicationContext) + File.separator + aotSharedLibraryName);
String aotSharedLibraryPath = applicationInfo.nativeLibraryDir + File.separator + aotSharedLibraryName;
if(appFile.exists()){
  aotSharedLibraryPath = appFile.getPath();
}
shellArgs.add("--" + AOT_SHARED_LIBRARY_NAME + "=" + aotSharedLibraryPath);
复制代码

若是不须要动态替换flutter_assets文件，其实上面就修改就足够动态替换libapp.so了。还有一种不用修改engine源码的方法就是在继承FlutterActivity时重写getFlutterShellArgs方法，把AOT_SHARED_LIBRARY_NAME传递成自定义的路径，亲测有效，小伙伴们自行尝试，有问题能够在留言区交流。架构

附上AOT_SHARED_LIBRARY_NAME在C层使用的代码app

// 代码位置shell-->common-->switches.cc
if (aot_shared_library_name.size() > 0) {
  // 循环会致使最后一个shellArgs中AOT_SHARED_LIBRARY_NAME生效，不用担忧设置了多个AOT_SHARED_LIBRARY_NAME
  for (std::string_view name : aot_shared_library_name) {
    settings.application_library_path.emplace_back(name);
  }
}
复制代码

1.二、FlutterJNI的nativeAttach

这是一个调用libflutter.so的jni方法，经过这个方法，咱们能够传递一个路径到C层，在C层的初始化AndroidShellHolder以前将自定义的路径配置进去函数

修改后的nativeAttach方法体以及相关代码，以下

private native long nativeAttach(@NonNull FlutterJNI flutterJNI, String dynamicPath, boolean isBackgroundView);

 public void attachToNative(String dynamicPath, boolean isBackgroundView) {
    ensureRunningOnMainThread();
    ensureNotAttachedToNative();
		// 由于当前类中没法得到Contenxt，因此须要FlutterNativeView和FlutterEngine调用attachToNative方法时传入路径 
    nativePlatformViewId = nativeAttach(this, dynamicPath, isBackgroundView);
 }
复制代码

1.三、platform_view_android_jni.cc修改

// 1. jni映射方法新增参数类型
bool RegisterApi(JNIEnv* env) {
  static const JNINativeMethod flutter_jni_methods[] = {
      // Start of methods from FlutterJNI
      {
          .name = "nativeAttach",
        	// 新增一个String参数类型
          .signature = "(Lio/flutter/embedding/engine/FlutterJNI;Ljava/lang/String;Z)J",
          .fnPtr = reinterpret_cast<void*>(&AttachJNI),
      },
    。。。

// 2. AttachJNI方法修改
static jlong AttachJNI(JNIEnv* env,
                       jclass clazz,
                       jobject flutterJNI,
                       jstring dynamicPath,
                       jboolean is_background_view) {
  fml::jni::JavaObjectWeakGlobalRef java_object(env, flutterJNI);
  const auto dynamic_path = fml::jni::JavaStringToString(env, dynamicPath);
  // 获取配置
  Settings settings = FlutterMain::Get().GetSettings();
  if(dynamic_path.size() > 0) {
      settings.application_library_path.clear();
    	// 在AndroidShellHolder初始化前设置新路径
      settings.application_library_path.emplace_back(dynamic_path + "/libapp.so");
      settings.assets_path = dynamic_path + "/flutter_assets";
  }

  FML_LOG(INFO) << "settings.assets_path:" << settings.assets_path;
	
  // 将修改后的settings传递进去
  auto shell_holder = std::make_unique<AndroidShellHolder>(
      settings, java_object, is_background_view);
  if (shell_holder->IsValid()) {
    return reinterpret_cast<jlong>(shell_holder.release());
  } else {
    return 0;
  }
}
复制代码

1.四、FlutterNativeView中相关修改的代码

private void attach(FlutterNativeView view, boolean isBackgroundView) {
    mFlutterJNI.attachToNative(PathUtils.getDynamicPath(mContext), isBackgroundView);
    dartExecutor.onAttachedToJNI();
}
复制代码

1.五、FlutterEngine中相关修改的代码

// 1. 构造函数中
attachToJni(context);

// 2. attachToJni方法修改
private void attachToJni(Context context) {
		Log.v(TAG, "Attaching to JNI.");
  	// TODO(mattcarroll): update native call to not take in "isBackgroundView"
    flutterJNI.attachToNative(PathUtils.getDynamicPath(context), false);

    if (!isAttachedToJni()) {
      throw new RuntimeException("FlutterEngine failed to attach to its native Object reference.");
    }
}
复制代码

1.六、PathUtils新增getDynamicPath方法

// 获取动态化资源文件路径
public static String getDynamicPath(Context applicationContext){
    String packagePath = getDataDirectory(applicationContext);
    String aotLibFile = packagePath + File.separator + FlutterLoader.DEFAULT_AOT_SHARED_LIBRARY_NAME;
    String flutterAssetsPath = packagePath + File.separator + FlutterLoader.DEFAULT_FLUTTER_ASSETS_DIR;
    File aotFile = new File(aotLibFile);
    File flutterAssetsFile = new File(flutterAssetsPath);
    if (!aotFile.exists() && !flutterAssetsFile.exists()) {
      packagePath = "";
    }
    return packagePath;
}
复制代码

到此，动态化所须要的方法基本都修改完了，具体代码请看github.com/panmin/engi…，欢迎star和watch，代码会不按期优化更新。

2、编译本地engine

修改完engine的代码，这一小节咱们就来看看如何将修改后的engine编译成flutter.jar和libflutter.so

2.一、编译相关基础知识

  • CPU架构

    编译结果包括arm、arm64、x86这几种架构，arm对应Android的armeabi-v7a，arm64对应Android的arm64-v8a，x86仍是x86通常是模拟器上用的。

  • 是否优化

    未优化的engine包是能够添加打印出C层的代码的，engine的C++里用FML_LOG(INFO)打印log；优化后的包体积也更小。

  • 运行模式

    根据flutter的模式是分为debug、profile、release这三种模式的。

2.二、经常使用的编译参数

  • --android-cpu: CPU架构，对应arm、arm64、x86，如：gn --android-cpu arm
  • --runtime-mode: 运行模式，对应debug、profile、release，如：gn --runtime-mode debug
  • --unoptiimized: 是否优化，带上这个参数就说明是不优化的状况

2.三、编译开始

# 一、定位到`engine/src`目录
cd engine/src
# 二、编译Android对应平台已优化的release代码，这里你们根据本身的实际使用状况，合理的使用2.2中提到的编译参数
./flutter/tools/gn --android --runtime-mode release --android-cpu arm
# 经过2中的命令会在src目录下生成一个out/android_release的目录
# 三、编译2中生成的代码成为flutter.jar和libflutter.so，这一步就最耗时的，有快有慢，看电脑性能了
ninja -C out/android_release
# 若是2中使用的CPU架构是arm64时，3中的这一步就要用android_release_arm64文件夹了
# 四、编译Android打包时须要的代码
./flutter/tools/gn --runtime-mode release --android-cpu arm
# 五、一样编译一下
ninja -C out/host_android
# 若是4中使用的是arm64，这里就须要用host_android_arm64文件夹了
复制代码

经过上的编译，咱们能够看到out/android_release文件夹中已经生成了flutter.jar和里面已经包含了libflutter.so

3、使用本地engine

这一小节只讲解纯flutter项目时如何使用；至于混合开发的项目中如何使用，由于牵扯到一些gradle脚本的修改，我会单独抽出一篇文章来说。

3.一、使用本地engine打包apk

# 打包arm平台的apk
flutter build apk --target-plarform android-arm --split-per-abi --local-engine-src engine/src --local-engine=android-release
# 打包arm64平台的apk
flutter build apk --target-plarform android-arm --split-per-abi --local-engine-src engine/src --local-engine=android-release_arm64
复制代码

3.二、修改代码后如何查看新的libapp.so和flutter_assets文件

对于已经安装完使用本地engine打包的apk的手机来讲，想动态更新新的代码，须要找到修改后代码打包生成的libapp.so和flutter_assets文件，这个文件怎么生成和找到的呢？

  1. 修改dart代码
  2. 使用3.1中的命令打包apk
  3. 在跟lib同级别的目录build/app/intermediates/flutter/release下找到对应CPU架构的app.so文件，将其更名成libapp.so，而后在app启动时复制到PathUtils.getDataDirectory(applicationContext)对应的目录下，也就是user/0/package/app_flutter目录下；把build/app/intermediates/flutter/release目录下的flutter_assets也复制到这个目录下。
  4. 待下次重启app时便可生效

4、总结

本篇文章讲解了flutter engine代码实现动态化的代码修改，以及编译和使用本地的engine，下一篇我会详细讲解在混合开发时使用本地engine，以及如何修改bulid aar时的脚本，打包成aar供业务方使用，也是伸手党们的福利，欢迎你们关注和点赞。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程