Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る

ビルド済み ABI 使用状況チェッカー

Android 共有ライブラリは、随時進化しています。ビルド済みバイナリを最新の状態に保つには、かなりの労力が必要です。Android 9 以前では、削除されたライブラリまたは ABI に依存するビルド済みバイナリは、実行時にリンクに失敗するだけでした。古くなったビルド済みバイナリをデベロッパーが検出するには、ログをトレースする必要がありました。Android 10 では、シンボルベースの ABI 使用状況チェッカーが導入されています。このチェッカーで、古くなったビルド済みバイナリをビルド時に検出できます。したがって、共有ライブラリのデベロッパーは、変更によって無効になった可能性があるビルド済みバイナリと、再ビルドが必要なビルド済みバイナリを判別できます。

シンボルベースの ABI 使用状況チェッカー

シンボルベースの ABI 使用状況チェッカーは、ホスト上で Android ダイナミック リンカーをエミュレートします。チェッカーは、ビルド済みバイナリをその依存関係にリンクし、すべての未定義のシンボルが解決されるかどうかをチェックします。

まず、チェッカーはビルド済みバイナリのターゲット アーキテクチャを確認します。ビルド済みバイナリのターゲットが ARM、AArch64、x86、x86-64 アーキテクチャでない場合、チェッカーはそのビルド済みバイナリをスキップします。

次に、ビルド済みバイナリの依存関係が LOCAL_SHARED_LIBRARIES または shared_libs で指定されていることを確認します。ビルドシステムは、モジュール名を共有ライブラリの一致するバリアント(例: corevendor)に解決します。

第 3 に、チェッカーは DT_NEEDED エントリを LOCAL_SHARED_LIBRARIES または shared_libs と比較します。具体的には、DT_SONAME エントリを各共有ライブラリから抽出し、これらの DT_SONAME をビルド済みバイナリに記録された DT_NEEDED エントリと比較します。不一致がある場合は、エラー メッセージを出力します。

第 4 に、チェッカーはビルド済みバイナリ内の未定義のシンボルを解決します。これらの未定義のシンボルは依存関係の 1 つで定義されている必要があり、シンボルのバインディングは GLOBAL または WEAK でなければなりません。未定義のシンボルを解決できない場合は、エラー メッセージを出力します。

ビルド済みバイナリ モジュールのプロパティ

ビルド済みバイナリの依存関係は、次のいずれかで指定されている必要があります。

  • Android.bp: shared_libs: ["libc", "libdl", "libm"],
  • Android.mk: LOCAL_SHARED_LIBRARIES := libc libdl libm

ビルド済みバイナリが解決できない未定義のシンボルを持つように設計されている場合は、次のいずれかを指定します。

  • Android.bp: allow_undefined_symbols: true,
  • Android.mk: LOCAL_ALLOW_UNDEFINED_SYMBOLS := true

ビルド済みバイナリへの ELF ファイル チェックをスキップするには、次のいずれかを指定します。

  • Android.bp: check_elf_files: false,
  • Android.mk: LOCAL_CHECK_ELF_FILES := false

チェッカーを実行する

チェッカーを実行するには、環境変数 CHECK_ELF_FILEStrue に設定して、make check-elf-files を実行します。

CHECK_ELF_FILES=true make check-elf-files

デフォルトでチェッカーを有効にするには、PRODUCT_CHECK_ELF_FILESBoardConfig.mk に追加します。

PRODUCT_CHECK_ELF_FILES := true

次のコマンドにより、Android のビルドプロセスでビルド済みバイナリが自動的にチェックされます。

make