Flutter 添加 armeabi-v7a 本地库出现的一些问题

1. 第三方native library无法加载

由于我们的 flutter 应用中要集成第三方的 sdk 来实现一些特殊功能,该 sdk 中集成了一些 native library ,而且只有 32位 的。目前在 flutterandroid 工程中添加了这些 library , 如下图所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

随后在 android 工程的 build.gradle 文件中手动指定 jniLibs 目录的路径,如下图所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

现在正常在 flutter 工程中执行 debug 启动工程,如下图所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

点击界面按钮,调用第三方 native library 后立马出现报错,随后 App 闪退。报错内容如下:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

通过日志可以看出来,我们前面添加的 native library 没有被加载。

当时首先怀疑的是打包时是否将 native library 有打包到 apk 中,所以采用 android studioanalyze apk 命令分析,发现确实是已经打包到 apk 文件中了。如下图所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

仔细回顾上面的日志,不难发现,没有被加载的原因是因为它寻找 library 的路径不对,根本没有包含我们需要的 armeabi-v7a 这个目录。如下图所示,加载的路径基本上都是 arm64 相关的目录,很显然是因为我的真机是 arm64 架构的,所以可能导致这个问题。

Flutter 添加 armeabi-v7a 本地库出现的一些问题

关于这个问题,在文章 https://medium.com/codechai/flutter-app-couldnt-find-libflutter-so-c95ad81cbccd 中有详细的说明。大体情况如下:

当apk安装时,首先会标记当前应用是32位的还是64位的,这决定了后面在哪个目录寻找本地库。

  1. 首先在 lib/arm64-v8a 目录中寻找是否有 native libraray,如果有就标记为 64位 。(在上面的情况中,arm64-v8a文件夹中是包含有 libflutter.so 的,所以该应用被标记为 64 位)
  2. 如果没有在 lib/arm64-v8a 中找到 native libraray,则随后在 lib/armeabi-v7alib/armeabi 中寻找,有则标记为 32位
  3. 如果在上述目录中都没有找到 native library 则说明当前应用没有使用本地库,对 32 位还是 64位 并不敏感。此时会默认标记为 64位

此时可以在网上找到的大多数回答是在 build.gradle 文件中指定 ndkabiFilter ,如下图所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

这个配置的意思是指定一个 filter ,让 Gradle 在打包 apk 时只添加 armeabi-v7a 下的 library ,其它的都不添加。
根据上面的寻找 library 的规则,这么做确实只保证 armeabi-v7a 的库被加载到。

添加这项配置后,再继续执行 debug ,又抛出了 couldn't find "libflutter.so" 这个报错信息。详细内容如下所示:

E/FlutterLoader( 8399): java.util.concurrent.ExecutionException: java.lang.UnsatisfiedLinkError: dalvik.system.PathClassLoader[DexPathList[[zip file "/data/app/com.dm.pcbd-A-gAqiQOV9EjRIg7TZRvKw==/base.apk"],nativeLibraryDirectories=[/data/app/com.dm.pcbd-A-gAqiQOV9EjRIg7TZRvKw==/lib/arm, /data/app/com.dm.pcbd-A-gAqiQOV9EjRIg7TZRvKw==/base.apk!/lib/armeabi-v7a, /system/lib, /product/lib]]] couldn't find "libflutter.so"

采用 analyze apk 查看了下生成的 apk 包,发现确实没有将 libflutter.so 打包到 apk 中,如下图所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

翻了 flutter 的很多 issue 后发现有很多类似的问题,例如这个 issue https://github.com/flutter/flutter/issues/29710

2. debug下 libflutter.so 无法加载

根据 issue https://github.com/flutter/flutter/issues/29710 的描述,只要 armeabi-v7a 下添加了其它库,就会出现 libflutter.so 打包不进去的问题。

经过多次尝试后,发现使用 flutter build 命令行生成出来的包中是有 libflutter.so 的,具体命令如下:

// 生成debug包
flutter build apk --debug

// 生成release包
flutter build apk --release

// 安装软件包(在生成debug或release包之后运行)
flutter install

build 生成的 debug 包中包含 libflutter.so
Flutter 添加 armeabi-v7a 本地库出现的一些问题

build 生成的 release 包中也包含 libflutter.so
Flutter 添加 armeabi-v7a 本地库出现的一些问题

但是直接使用 Android Studio 上的 debug 运行时就是不打包 libflutter.soarmeabi-v7a 中。

Android Studio 上的 debug 等同于命令行 flutter run --debug -v

说实话,到这一步时觉得 flutter 还是不太成熟,差点想弃坑了。

仔细翻阅了 https://github.com/flutter/flutter/issues/29710 这个issue,发现有网友提到命令行手动指定 target-platform 来强制指定目标平台为 arm 32位,例如:

flutter build apk --debug --target-platform=android-arm
flutter run --use-application-binary=build/app/outputs/apk/debug/app-debug.apk

但是 target-platform 这个参数在新版本的 flutter 中不能直接用在 flutter run 上(即上述的 debug 上),只能用在 flutter build 上。那这就导致平常调试时很不方便了,不能直接按 debug 按钮启动启用,得用命令行手动启动,太不方便了。

在上面的 issue 中,又有网友提到直接在 gradle 中配置 target-platform 。具体是在 settings.gradle 文件中添加配置,如下所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

具体添加的代码如下:

gradle.beforeProject({ project->
    if (project.hasProperty("target-platform") && !project.getProperty("target-platform").split(",").contains("android-arm")) {
        project.setProperty("target-platform", "android-arm")
    }
})

添加这段配置后,就可以 正常使用 界面上的 debug 按钮了,其生成的 apk 包中 armeabi-v7a 文件夹下确实是包含了 libflutter.so

Flutter 添加 armeabi-v7a 本地库出现的一些问题

3. Release下出现闪退问题

上面解决 debug 正常后,为了看下 release 下的效果,随即用命令行 flutter build apk --release 生成了 release 包,安装后点击按钮访问第三方sdk内容时出现闪退。

这就出现了 release 下和 debug 下行为不一致的问题

这种直接安装 apk 的方式,出现闪退或报错等问题,在 Android Studio 中看不到任何日志,非常不利于问题的排查。

这里可以采用 flutter run --release -v 的方式来启动 release 包,这样在控制台至少可以看到一些日志。flutter run --release -v 在界面上也可以配置出来,如下图所示:

Flutter 添加 armeabi-v7a 本地库出现的一些问题

再点击界面上的 Rundebug 按钮就可以启动这个 release 包了。(此时 debug 或 Run 按钮不影响运行方式)

通过这种方式运行后,得到 Release包闪退 的报错信息如下:

E/AndroidRuntime(22800): java.lang.RuntimeException: Unable to start activity ComponentInfo{com.dm.pcbd/com.micropattern.sdk.ext.MPFaceQualityDetectActivity}: android.content.res.Resources$NotFoundException: Resource ID #0x0
E/AndroidRuntime(22800): 	at .................省略一些无关的日志
E/AndroidRuntime(22800): Caused by: android.content.res.Resources$NotFoundException: Resource ID #0x0
E/AndroidRuntime(22800): 	at android.content.res.ResourcesImpl.getValue(ResourcesImpl.java:292)
E/AndroidRuntime(22800): 	at android.content.res.Resources.loadXmlResourceParser(Resources.java:2390)
........... 省略一些无关的日志
com.android.internal.policy.HwPhoneWindow.setContentView(HwPhoneWindow.java:342)
E/AndroidRuntime(22800): 	at android.app.Activity.setContentView(Activity.java:2941)
E/AndroidRuntime(22800): 	at com.micropattern.sdk.ext.MPFaceQualityDetectActivity.onCreate(Unknown Source:36)
E/AndroidRuntime(22800): 	at android.app.Activity.performCreate(Activity.java:7458)
E/AndroidRuntime(22800): 	at android.app.Activity.performCreate(Activity.java:7448)
E/AndroidRuntime(22800): 	at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1286)
E/AndroidRuntime(22800): 	at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3409)
E/AndroidRuntime(22800): 	... 11 more

出现这个问题,猜测是release打包时 shrink 压缩导致的问题。首先考虑到可能是 flutter官方文档中提到的 Shrinking your code with R8 导致的问题,遂在命令行打包时尝试关闭 shrinking ,命令如下所示:

flutter build apk --release --no-shrink

不过这个包打出来后,还是存在上面的资源问题。

上面那个是 android 中获取资源的问题,那么有可能是 Gradle 打包时出现的问题,所以考虑应该直接在 Gradle 中关闭 shrink 。具体操作如下,在 build.gradle 中添加如下配置

Flutter 添加 armeabi-v7a 本地库出现的一些问题

关于shrink,官方文档中有详细介绍: https://developer.android.com/studio/build/shrink-code?utm_source=android-studio#shrink-resources

到这里,再 Release 后就可以正常使用本地库了。

4. 总结

解决这个问题耗了一整天,基于上都是停留在各种尝试中。经过这一番折腾,确实了解到 flutter 这个坑有些大.......

  • 第一次为了解决 libflutter.so 无法加载的问题,甚至尝试过手动将 libflutter.so 拷贝到 armeabi-v7a 文件夹下。这样确实解决了 debug 下的问题,但是最后做出来的 release 包一直卡在空白界面。在这里浪费了很多时间。
  • 目前 flutter 并不是特别成熟,关于这个问题在 issue 中说法有很多,这也导致了各种尝试,花费了很多时间。

经过这次折腾,也确实了解到了很多东西,例如:

  • ndk abiFilter 配置
  • 对 native library 加载机制有些许了解
  • flutter工程和android工程的关系也终于弄明白了一些

5. 关于作者

作者是一个热爱学习、开源、分享,传播正能量,头发还很多的程序员-。-
热烈欢迎大家关注、点赞、评论交流!

上一篇:夹壳加固厂商特征


下一篇:依赖属性