Flutter框架Android so库的一些实践

2019-10-10 本文已影响0人小鱼游儿

学而思网校1对1的android工程是用flutter框架实现的，而android工程不可避免的要和cpu架构和so库打交道，在实践中，针对flutter框架对cpu架构的支持，我们也有一些经验在此总结。

so库说明

so库在android中,是使用c/c++代码编译出来的库文件，可以使用ndk调用，就是你在android代码中见到的native方法，具体的实现就在so库中。

关于so库兼容性问题

andorid中或多或少都会引用到第三方库,而很多第三方库中都有so的存在,不论是复制到项目中(如百度地图)，或是gradle依赖(如个推)
其中都涉及到了so库的相关问题，如果你选择的库是有所有cpu类型可选还好，如果不是，那么就需要自定义设置了。

举个栗子

你的app依赖两个库,分别是lib1,lib2

lib1: arm64-v8a,armeabi-v7a
lib2: armeabi-v7a

那么当你运行在v7的手机上时，因为你的项目含有v7的so库，所以没有问题，可以跑起来如果，你运行在v8手机上,那么你的项目就会Crash, 为啥呢? 这就涉及到so对齐了

so对齐

简单来说，就是要有就必须都有，如果一个没有，那就一个都不要
比如上面的例子，如果你是自己复制到项目下的，你需要删掉arm64-v8a的文件夹

flutter经典问题couldn't find "libflutter.so"

引发的原因

导致这个问题出现的原因是因为我们在项目种使用了so库，或者项目中引用的三方sdk使用了so库。在引用so库时需要针对不同的cpu架构使用不同的.so文件。armeabi，armeabi-v7a，x86，arm64-v8a，大家通常会对这几个cpu架构进行适配。然而问题就出在现在Flutter在打包Apk时不能同引入arm32和arm64的libflutter.so。我门将打好包的Apk安装到arm64架构（默认打包会引入arm32）的手机上就出现了couldn't find libflutter.so这个异常。

如何解决

针对arm32和arm64分别打包（flutter 提供了命令来之分别对arm32和arm64分别打包）

flutter build apk --target-platform=android-arm32
flutter build apk --target-platform=android-arm64

我们用flutter build apk --target-platform=android-arm64打包apk，并在arm64cpu架构的手机安装运行，很好完美运行。但是当我们吧apk安装到32位时问题再次出现，原因就不再重复了。很显然到这里这个方式并不能解决这个问题，为了适配arm32和arm64我们需要分别打包，而国内大部分应用市场不能针对不同cpu架构上传不同的apk。

不对arm64做适配，打包时排除其他非arm32架构的so文件
这时候有些朋友可能会又疑问，问题不就是因为打包时没有引入arm64的libflutter的so文件导致在arm64架构手机上出现“兼容”问题的么。arm64cpu架构是可以像下兼容的，简单点就是arm64架构的cpu可以使用arm32的.so文件。出现问题真正原因是我们在引用so库时（引用的三方库中引用了so库），对arm64做了兼容。这样就会导致运行时系统误以为我们的应用对所有的so库做了arm64架构的兼容，但是在打包时libflutter并没有引入arm64的版本。这就导致系统去寻找arm64版本的libflutter发现找不到。系统误会了我们，我们只能通过gradle在打包时排除其他非arm32架构的so文件来解除这个误会。
好那如何排除其他非arm32架构的so文件。在app下的gradle文件加入如下代码

buildTypes {
     release {
         ndk{
             //这里其实我觉可以直接是用"armeabi-v7a"，但国内几个大哥之前使用的都是"armeabi"
             abiFilters "armeabi"
         }
     }
     debug {
         ndk {
             //这里要加上，否则debug包会出问题,后面三个为可选，x86建议加上不然部分模拟器回报错
             abiFilters "armeabi", ,"armeabi-v7a","arm64-v8a", "x86"
         }
     }
 }

3.flutter 1.7.8+hotfix.2 以上版本已经支持flutter 64位了直接打包即可.

只支持64位：flutter build apk --target-platform android-arm64
支持32位：flutter build apk --target-platform=android-arm
同时支持64位和32位：flutter build apk

工程加入x5内核引起的新问题

经过上述文章方法的处理，我们的工程解决了在64位手机上，出现couldn't find "libflutter.so"引起的Crash问题，但是，当我们引入x5内核后，又出现了新的问题。
这是我们在没有引入x5内核前工程支持的cpu架构配置，这个地方需要说明，如果不加入 "arm64-v8a"配置的话，flutter build apk命令虽然会将so库打入工程，但是平时开发时使用的flutter run apk命令并不会把so库打入工程。

ndk {
                abiFilters "armeabi" ,"armeabi-v7a", "arm64-v8a"
            }

这种配置方式能保证flutter run和flutter build同时生效，不会引起程序因为找不到so库引起的Crash。
但是当引入x5内核后，会出现如下错误

X5 does not support the 64-bit mode to run

x5官方解释是x5内核暂时不提供64位的so文件，在64位手机上需要让AP以32位模式运行，所以我们如果加入了 "arm64-v8a"的话，x5内核在64位手机无法启动。
但是加入的话，又会引起flutter的so库找不见，解决办法如下：

修改flutter.gradle里面，关于flutter run的配置，使其支持把64位的so库打入工程

 String flutterExecutableName = Os.isFamily(Os.FAMILY_WINDOWS) ? "flutter.bat" : "flutter"
        flutterExecutable = Paths.get(flutterRoot.absolutePath, "bin", flutterExecutableName).toFile();

        if (useLocalEngine(project)) {
            String engineOutPath = project.property('localEngineOut')
            File engineOut = project.file(engineOutPath)
            if (!engineOut.isDirectory()) {
                throw new GradleException('localEngineOut must point to a local engine build')
            }
            Path baseEnginePath = Paths.get(engineOut.absolutePath)
            flutterJar = baseEnginePath.resolve("flutter.jar").toFile()
            if (!flutterJar.isFile()) {
                throw new GradleException("Local engine jar not found: $flutterJar")
            }
            localEngine = engineOut.name
            localEngineSrcPath = engineOut.parentFile.parent
            // The local engine is built for one of the build type.
            // However, we use the same engine for each of the build types.
            project.android.buildTypes.each {
                addApiDependencies(project, it.name, project.files {
                    flutterJar
                })
            }
        }

修改构建脚本，在jenkens上构建工程时，动态修改cpu架构支持

 #andorid app build.gradle 工程配置文件地址
    # 删除 arm64-v8a，防止  hybrid 在某些手机上无法构建。
    androidAppGradlePath="$JENKINS_WORKSPACE/northstar_flutter/android/app/build.gradle"
    echo "App 中 app/build.gradle 配置文件地址是：${androidAppGradlePath}"
    sed -i 's/, "arm64-v8a"/ /' $androidAppGradlePath
    echo "已经将 arm64-v8a 从文件中剔除，文件路径是：$androidAppGradlePath"

我们最终采用了方案2，因为每次更新flutter的版本，flutter.gradle文件都会被官方修改，尽量不动此文件为好。

总结

以上就是我们在学而思网校1对1android工程中对flutter框架支持so库做的一些实践和总结，随着flutter版本的不断更新，相信官方会对cpu架构支持越来越好。