はじめに
FlutterでAndroid開発中に特定のライブラリを導入すると、ビルドは通るのにアプリ起動時にこんなエラーで強制終了することがあるかもしれません。
couldn't find "libflutter.so"
at java.lang.Runtime.loadLibrary0(Runtime.java:1011)
at java.lang.System.loadLibrary(System.java:1657)
要はFlutterのライブラリが見つからない、ということですが、これはFlutterに限らずですが、JNIを使ったライブラリを取り込むときに注意する点です。
原因
Flutterはネイティブライブラリであるsoファイルとしてアプリ上で動作します。その際、別のライブラリでもネイティブライブラリを使っていた場合、必要なsoファイルがapk内に取り込まれずに強制終了しています。
順を追って説明していきます。
Flutterから生成されるsoファイル
まず他のライブラリを入れる前の状態でアプリをビルドしてapkの中身を見ると以下のようになっています。
このように３つのディレクトリにそれぞれlibflutter.soが配置されています。
2019/1/17 修正：
flutterの現時点の最新1.1.9では、armeabi-v7aのサポートが終了し、arm64-v8aへ以降したため、記述を変更しました。キャプチャは古いままですのでご注意ください。（すみません、詳細確認中です）
- arm64-v8a
- x86
- x86_64
それぞれの詳細については公式参照：ABI管理
他のライブラリを入れた場合
私の場合、Google VR SDKを導入したため発生しました。
Google VR SDKの場合、下記の３つが用意されていました。
- arm64-v8a
- armeabi-v7a
- x86
参考：https://github.com/googlevr/gvr-android-sdk/blob/master/samples/ndk-hellovr/build.gradle#L47
その結果、lib配下には４つのディレクトリが生成され、それぞれの構成は以下のようになりました
- arm64-v8a
- Flutter(libflutter.so)
- Google VR(libgvr.so, liboanorenderer.so)
- armebi-v7a
- Google VR(libgvr.so, liboanorenderer.so)のみ
- x86
- Flutter(libflutter.so)
- Google VR(libgvr.so, liboanorenderer.so)
- x86_64
- Flutter(libflutter.so)のみ
何が起こるのか？
lib配下のsoファイルは、端末のハードによってどのディレクトリが使用されるか決まります。今回の場合、armebi-v7aとx86であれば両方のsoファイルが格納されているため、問題なく起動できます。
一方、arm64-v8aやx86_64を使用する端末で起動した場合どうなるでしょう？ディレクトリ内に必要なsoファイルが揃っていないため、loadLibrary時にcouldn't findと言われてしまうわけです。
どうすれば良いのか？
結論からいうと、gradleでabiFilterを指定する必要があります。
android {
...
defaultConfig {
...
ndk {
// Specifies the ABI configurations of your native libraries Gradle should build and package with your APK.
abiFilters "x86", "arm64-v8a"
}
}
...
}
今回の場合、Google VRとFlutter両方が用意されているのは、x86とarmebi-v7aの二つのみなので、その二つをabiFiltersで指定します。
これにより、apkに取り込まれるsoファイルはabiFiltersで指定されたx86とarmebi-v7aのみとなり、それ以外のx86_64およびarm64-v8aはディレクトリが生成されなくなります。
まとめ
Flutterもネイティブライブラリを使用していることを忘れずに、soファイルが見つからないと強制終了した場合はabiFilterの見直しを検討してみてください。
また、クラッシュは端末のハードに依存するため、Play Consoleのリリース前レポートを利用して確認しておくのがよいかと思います。