Deferred Components-实现Flutter运行时动态下发Dart代码 | 京东云技术团队

2023-05-23 311

导读

Deferred Components，官方实现的Flutter代码动态下发的方案。本文主要介绍官方方案的实现细节，探索在国内环境下使用Deferred Components，并且实现了最小验证demo。读罢本文，你就可以实现Dart文件级别代码的动态下发。

一、引言

Deferred Components是Flutter2.2推出的功能，依赖于Dart2.13新增的对Split AOT编译支持。将可以在运行时每一个可单独下载的Dart库、assets资源包称之为延迟加载组件，即Deferred Components。Flutter代码编译后，所有的业务逻辑都会打包在libapp.so一个文件里。但如果使用了延迟加载，便可以分拆为多个so文件，甚至一个Dart文件也可以编译成一个单独的so文件。

这样带来的好处是显而易见的，可以将一些不常用功能放到单独的so文件中，当用户使用时再去下载，可以大大降低安装包的大小，提高应用的下载转换率。另外，因为Flutter具备了运行时动态下发的能力，这让大家看到了实现Flutter热修复的另一种可能。截止目前来讲，官方的实现方案必须依赖Google Play，虽然也针对中国的开发者给出了不依赖Google Play的自定义方案，但是并没有给出实现细节，市面上也没有自定义实现的文章。本文会先简单介绍官方实现方案，并探究其细节，寻找自定义实现的思路，最终会实现一个最小Demo供大家参考。

二、官方实现方案探究

2.1 基本步骤

2.1.1.引入play core依赖。

dependencies {
  implementation "com.google.android.play:core:1.8.0"
}

2.1.2.修改Application类的onCreate方法和attachBaseContext方法。

@Override
protected void onCreate(){
 super.onCreate()
// 负责deferred components的下载与安装
 PlayStoreDeferredComponentManager deferredComponentManager = new
  PlayStoreDeferredComponentManager(this, null);
FlutterInjector.setInstance(new FlutterInjector.Builder()
    .setDeferredComponentManager(deferredComponentManager).build());
}


@Override
protected void attachBaseContext(Context base) {
    super.attachBaseContext(base);
    // Emulates installation of future on demand modules using SplitCompat.
    SplitCompat.install(this);
}

2.1.3.修改pubspec.yaml文件。

flutter:
    deferred-components:

2.1.4.在flutter工程里新增box.dart和some_widgets.dart两个文件，DeferredBox就是要延迟加载的控件，本例中box.dart被称为一个加载单元，即loading_unit，每一个loading_unit对应唯一的id，一个deferred component可以包含多个加载单元。记得这个概念，后续会用到。

// box.dart


import 'package:flutter/widgets.dart';


/// A simple blue 30x30 box.
class DeferredBox extends StatelessWidget {
  DeferredBox() {}


  @override
  Widget build(BuildContext context) {
    return Container(
      height: 30,
      width: 30,
      color: Colors.blue,
    );
  }
}

import 'box.dart' deferred as box;


class SomeWidget extends StatefulWidget {
  @override
  _SomeWidgetState createState() => _SomeWidgetState();
}


class _SomeWidgetState extends State<SomeWidget> {
  Future<void> _libraryFuture;


  @override
  void initState() {
 //只有调用了loadLibrary方法，才会去真正下载并安装deferred components.
    _libraryFuture = box.loadLibrary();
    super.initState();
  }


  @override
  Widget build(BuildContext context) {
    return FutureBuilder<void>(
      future: _libraryFuture,
      builder: (BuildContext context, AsyncSnapshot<void> snapshot) {
        if (snapshot.connectionState == ConnectionState.done) {
          if (snapshot.hasError) {
            return Text('Error: ${snapshot.error}');
          }
          return box.DeferredBox();
        }
        return CircularProgressIndicator();
      },
    );
  }
}

2.1.5.然后在main.dart里面新增一个跳转到SomeWidget页面的按钮。

 Navigator.push(context, MaterialPageRoute(
      builder: (context) {
        return const SomeWidget();
      },
    ));

2.1.6.terminal里运行 flutter build appbundle 命令。此时，gen_snapshot不会立即去编译app，而是先运行一个验证程序，目的是验证此工程是否符合动态下发dart代码的格式，第一次构建时肯定不会成功，你只需要按照编译提示去修改即可。当全部修改完毕后，会得到最终的.aab类型的安装包。

以上便是官方实现方案的基本步骤，更多细节可以参考官方文档
https://docs.flutter.dev/perf/deferred-components

2.2 本地验证

在将生成的aab安装包上传到Google Play上之前，最好先本地验证一下。

首先你需要下载bundletool，然后依次运行下列命令就可以将aab安装包装在手机上进行最终的验证了。

java -jar bundletool.jar build-apks --bundle=<your_app_project_dir>/build/app/outputs/bundle/release/app-release.aab --output=<your_temp_dir>/app.apks --local-testing


java -jar bundletool.jar install-apks --apks=<your_temp_dir>/app.apks

2.3 loadLibrary()方法调用的生命周期

图1 官方实现方案介绍图

（来源：https://github.com/flutter/flutter/wiki/Deferred-Components）

从官方的实现方案中可以知道，只有调用了loadLibrary方法后，才会去真正执行deferred components的下载与安装工作，现在着重看下此方法的生命周期。

调用完loadLibrary方法后，dart会在内部查询此加载单元的id，并将其一直向下传递，当到达jni层时，jni负责将此加载单元对应的deferred component的名字以及此加载单元id一块传递给
PlayStoreDynamicFeatureManager，此类负责从Google Play Store服务器下载对应的Deferred Components并负责安装。安装完成后会逐层通知，最终告诉dart层，在下一帧渲染时展示动态下发的控件。

三、自定义实现

3.1 思路

梳理了loadLibrary方法调用的生命周期后，只需要自己实现一个类来代替
PlayStoreDynamicFeatureManager的功能即可。在官方方案中具体负责完成PlayStoreDynamicFeatureManager功能的实体类是io.flutter.embedding.engine.deferredcomponents.PlayStoreDeferredComponentManager，其继承自DeferredComponentManager，分析源码得知，它最重要的两个方法是installDeferredComponent和loadDartLibrary。

installDeferredComponent：这个方法主要负责component的下载与安装，下载安装完成后会调用loadLibrary方法，如果是asset-only component，那么也需要调用DeferredComponentChannel.completeInstallSuccess或者DeferredComponentChannel.completeInstallError方法。

loadDartLibrary：主要是负责找到so文件的位置，并调用FlutterJNI dlopen命令打开so文件，你可以直接传入apk的位置，flutterJNI会直接去apk里加载so，避免处理解压apk的逻辑。

那基本思路就有了，自己实现一个实体类，继承DeferredComponentManager，实现这两个方法即可。

3.2 代码实现

本例只是最小demo实现，cpu架构采用arm64，且暂不考虑asset-only类型的component。

3.2.1.新增
CustomDeferredComponentsManager类，继承DeferredComponentManager。

3.2.2.实现installDeferredComponent方法，将so文件放到外部SdCard存储里，代码负责将其拷贝到应用的私有存储中，以此来模拟网络下载过程。代码如下：

@Override
public void installDeferredComponent(int loadingUnitId, String componentName) {
    String resolvedComponentName = componentName != null ? componentName : loadingUnitIdToComponentNames.get(loadingUnitId);
    if (resolvedComponentName == null) {
         Log.e(TAG, "Deferred component name was null and could not be resolved from loading unit id.");
         return;
     }
     // Handle a loading unit that is included in the base module that does not need download.
     if (resolvedComponentName.equals("") && loadingUnitId > 0) {
     // No need to load assets as base assets are already loaded.
         loadDartLibrary(loadingUnitId, resolvedComponentName);
         return;
     }
     //耗时操作，模拟网络请求去下载android module
     new Thread(
         () -> {
//将so文件从外部存储移动到内部私有存储中
              boolean result = moveSoToPrivateDir();
              if (result) {
                 //模拟网络下载，添加2秒网络延迟
                 new Handler(Looper.getMainLooper()).postDelayed(
                                () -> {
                                    loadAssets(loadingUnitId, resolvedComponentName);
                                    loadDartLibrary(loadingUnitId, resolvedComponentName);
                                    if (channel != null) {
                                        channel.completeInstallSuccess(resolvedComponentName);
                                    }
                                }
                                , 2000);
                 } else {
                        new Handler(Looper.getMainLooper()).post(
                                () -> {
                                    Toast.makeText(context, "未在sd卡中找到so文件", Toast.LENGTH_LONG).show();


                                    if (channel != null) {
                                        channel.completeInstallError(resolvedComponentName, "未在sd卡中找到so文件");
                                    }


                                    if (flutterJNI != null) {
                                        flutterJNI.deferredComponentInstallFailure(loadingUnitId, "未在sd卡中找到so文件", true);
                                    }
                                }
                        );
                  }
              }
        ).start();
    }

3.2.3.实现loadDartLibrary方法，可以直接拷贝
PlayStoreDeferredComponentManager类中的此方法，注释已加，其主要作用就是在内部私有存储中找到so文件，并调用FlutterJNI dlopen命令打开so文件。

  @Override
    public void loadDartLibrary(int loadingUnitId, String componentName) {
        if (!verifyJNI()) {
            return;
        }
        // Loading unit must be specified and valid to load a dart library.
        //asset-only的component的unit id为-1，不需要加载so文件
        if (loadingUnitId < 0) {
            return;
        }


        //拿到so的文件名字
        String aotSharedLibraryName = loadingUnitIdToSharedLibraryNames.get(loadingUnitId);
        if (aotSharedLibraryName == null) {
            // If the filename is not specified, we use dart's loading unit naming convention.
            aotSharedLibraryName = flutterApplicationInfo.aotSharedLibraryName + "-" + loadingUnitId + ".part.so";
        }


        //拿到支持的abi格式--arm64_v8a
        // Possible values: armeabi, armeabi-v7a, arm64-v8a, x86, x86_64, mips, mips64
        String abi;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            abi = Build.SUPPORTED_ABIS[0];
        } else {
            abi = Build.CPU_ABI;
        }
        String pathAbi = abi.replace("-", "_"); // abis are represented with underscores in paths.


        // TODO(garyq): Optimize this apk/file discovery process to use less i/o and be more
        // performant and robust.


        // Search directly in APKs first
        List<String> apkPaths = new ArrayList<>();
        // If not found in APKs, we check in extracted native libs for the lib directly.
        List<String> soPaths = new ArrayList<>();


        Queue<File> searchFiles = new LinkedList<>();
        // Downloaded modules are stored here--下载的 modules 存储位置
        searchFiles.add(context.getFilesDir());
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            //第一次通过appbundle形式安装的split apks位置
            // The initial installed apks are provided by `sourceDirs` in ApplicationInfo.
            // The jniLibs we want are in the splits not the baseDir. These
            // APKs are only searched as a fallback, as base libs generally do not need
            // to be fully path referenced.
            for (String path : context.getApplicationInfo().splitSourceDirs) {
                searchFiles.add(new File(path));
            }
        }


        //查找apk和so文件
        while (!searchFiles.isEmpty()) {
            File file = searchFiles.remove();
            if (file != null && file.isDirectory() && file.listFiles() != null) {
                for (File f : file.listFiles()) {
                    searchFiles.add(f);
                }
                continue;
            }
            String name = file.getName();
            // Special case for "split_config" since android base module non-master apks are
            // initially installed with the "split_config" prefix/name.
            if (name.endsWith(".apk")
                    && (name.startsWith(componentName) || name.startsWith("split_config"))
                    && name.contains(pathAbi)) {
                apkPaths.add(file.getAbsolutePath());
                continue;
            }
            if (name.equals(aotSharedLibraryName)) {
                soPaths.add(file.getAbsolutePath());
            }
        }


        List<String> searchPaths = new ArrayList<>();


        // Add the bare filename as the first search path. In some devices, the so
        // file can be dlopen-ed with just the file name.
        searchPaths.add(aotSharedLibraryName);


        for (String path : apkPaths) {
            searchPaths.add(path + "!lib/" + abi + "/" + aotSharedLibraryName);
        }
        for (String path : soPaths) {
            searchPaths.add(path);
        }
//打开so文件
        flutterJNI.loadDartDeferredLibrary(loadingUnitId, searchPaths.toArray(new String[searchPaths.size()]));
    }

3.2.4.修改Application的代码并删除
com.google.android.play:core的依赖。

override fun onCreate() {
        super.onCreate()
        val deferredComponentManager = CustomDeferredComponentsManager(this, null)
        val injector = FlutterInjector.Builder().setDeferredComponentManager(deferredComponentManager).build()
        FlutterInjector.setInstance(injector)

至此，核心代码全部实现完毕，其他细节代码可以见
https://coding.jd.com/jd_logistic/deferred_component_demo/，需要加权限的联系shenmingliang1即可。

3.3 本地验证

运行 flutter build appbundle --release --target-platform android-arm64 命令生成app-release.aab文件。
.运行下列命令将app-release.aab解析出本地可以安装的apks文件：java -jar bundletool.jar build-apks --bundle=app-release.aab --output=app.apks --local-testing
解压上一步生成的app.apks文件，在加压后的app文件夹下找到splits/scoreComponent-arm64_v8a_2.apk，继续解压此apk文件，在生成的scoreComponent-arm64_v8a_2文件夹里找到lib/arm64-v8a/libapp.so-2.part.so 文件。
执行 java -jar bundletool.jar install-apks --apks=app.apks命令安装app.apks，此时打开安装后的app，点击首页右下角的按钮跳转到DeferredPage页面，此时页面不会成功加载，并且会提示你“未在sd卡中找到so文件”。
将第3步找到的lipase.so-2.part.so push到指定文件夹下，命令如下 adb push libapp.so-2.part.so /storage/emulated/0/Android/data/com.example.deferred_official_demo/files。重启app进程，并重新打开DeferredPage界面即可。

四、总结

官方实现方案对国内的使用来讲，最大的限制无疑是Google Play，本文实现了一个脱离Google Play限制的最小demo，验证了deferred components在国内使用的可行性。

参考：

作者：京东物流沈明亮

内容来源：京东云开发者社区

微信关注我们

原文链接：https://my.oschina.net/u/4090830/blog/8881164

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

ChatGPT的原理与前端领域实践 | 京东云技术团队

一、ChatGPT 简介 ChatGPT的火爆 ChatGPT作为一个web应用，自22年12月发布，仅仅不到3个月的时间，月活用户就累积到1亿。在此之前，最快记录的保持者也需要9个月才达到月活1亿。 ChatGPT的反爬 https://chat.openai.com 因为各种政策&倾向性问题，ChatGPT目前在中国无法访问。而它又是如此火爆，所以就有大量用户通过代理、爬虫等形式来体验ChatGPT。 OpenAI不是专业做网络服务的公司，因此把反爬交给第三方公司CloudFlare去做。 CloudFlare目前全球最大CDN服务商，占比16%；而OpenAI的流量在CloudFlare中占比已经占据前二。 ChatGPT的打字效果可以看到ChatGPT的输出是逐字输出的打字效果，这里应用到了SSE（SeverSideEvent）服务端推送的技术。一个SSE服务的Chrome开发工具化network截图： SSE对比常见Websocket如下：那么这种打字效果它是故意的还是不小心的？二、ChatGPT核心原理 ChatGPT我们可以拆解成 Chat、G、P、T 这...

2023-05-23

922

背景 AIGC是人工智能计算领域里发展迅速的重要业务。Stable Diffusion 是其中最热门的开源模型，受到广泛关注。然而，随着应用场景不断扩大，Stable Diffusion所面临的推理时延和计算成本问题也越来越突出。简介 PAI-Blade是 PAI 推出的通用推理优化工具，可以通过模型系统联合优化，使模型达到最优推理性能。PAI-Blade依托于完全动态尺寸的AI编译器BladeDISC 和基于深度学习自动调度的高性能计算库BlaDNN，为包括图像生成模型Stable Diffsuion, 大语言模型LLM, 大规模稀疏推荐模型CTR, 语音识别模型ASR等等在内的众多模型提供自动的高性能推理优化。 BladeDISC 是一款支持完全动态尺寸的AI编译器，前端支持Pytorch和Tensorflow模型。对于Pytorch模型能够支持 TorchScript 和 TorchDynamo 两种输入模式，后端通过 AStitch 大尺度算子融合技术和高效的 codegen 逻辑提升模型访存密集算子的执行效率。BladeDISC现已在github开源，项目地址：http...

2023-05-23

769

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。

Deferred Components-实现Flutter运行时动态下发Dart代码 | 京东云技术团队

导读

一、引言

二、官方实现方案探究

2.1 基本步骤

2.2 本地验证

2.3 loadLibrary()方法调用的生命周期

三、自定义实现

3.1 思路

3.2 代码实现

3.3 本地验证

四、总结

ChatGPT的原理与前端领域实践 | 京东云技术团队

使用 PAI-Blade 优化 Stable Diffusion 推理流程

相关文章

发表评论

资源下载

优质分享App

腾讯云软件源

Spring

Rocky Linux

欢迎您来访！

Deferred Components-实现Flutter运行时动态下发Dart代码 | 京东云技术团队

导读

一、引言

二、官方实现方案探究

2.1 基本步骤

2.2 本地验证

2.3 loadLibrary()方法调用的生命周期

三、自定义实现

3.1 思路

3.2 代码实现

3.3 本地验证

四、 总结

ChatGPT的原理与前端领域实践 | 京东云技术团队

使用 PAI-Blade 优化 Stable Diffusion 推理流程

相关文章

发表评论

资源下载

优质分享App

腾讯云软件源

Spring

Rocky Linux

欢迎您来访！

四、总结