2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main
ではなく android-latest-release
を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。
16 KB の後方互換オプションを有効にする
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
16 KB の切り替えを使用すると、16 KB カーネルでデバイスを実行できます。16 KB の後方互換オプションは、デバイスが 16 KB カーネルで実行されている場合に使用できます。アプリに ELF ファイル(拡張子は .so
)が含まれており、LOAD セグメントのアライメントが 4 KB の場合、または、その圧縮済みの APK に圧縮されていない ELF ファイルがあり、それが 4 KB で zip アライメントされている場合、パッケージ マネージャーはアプリを 16 KB の後方互換モードで実行します。パッケージ マネージャーがアプリに対して 16 KB の後方互換モードを有効にしている場合、そのアプリを初めて起動する際に、16 KB の後方互換モードで実行されていることを示す警告が表示されます。16 KB の後方互換モードで一部のアプリは動作しますが、信頼性と安定性を最大限に高めるには、アプリを 16 KB アライメントにする必要があります。
16 KB の後方互換オプションを有効にする手順は次のとおりです。
16 KB の切り替えを有効にするの手順に沿って 16 KB の切り替えを有効にします。
次のいずれかの方法で 16 KB の後方互換モードを有効にします。
Android は、必要な場合は後方互換モードでアプリを実行します。後方互換モードには 2 つの異なるパーツがあり、それぞれ個別に有効化できます。bionic.linker.16kb.app_compat.enabled
プロパティはライブラリの読み込みを制御し、pm.16kb.app_compat.disabled
プロパティは APK のインストールを制御します。
デバイス上のすべてのアプリで 16 KB の後方互換モードを強制的に有効にするには:
adb shell setprop bionic.linker.16kb.app_compat.enabled true
adb shell setprop pm.16kb.app_compat.disabled false
デバイス上のすべてのアプリで 16 KB の後方互換モードを強制的に無効にするには:
adb shell setprop bionic.linker.16kb.app_compat.enabled false
adb shell setprop pm.16kb.app_compat.disabled true
android:pageSizeCompat
プロパティを enabled
または disabled
に設定して、AndroidManifest.xml
内の特定のアプリの後方互換モードをオンまたはオフにします。このプロパティが設定されている場合、アプリの起動時に後方互換モードの警告は表示されません。
アプリ情報ページの [詳細設定] で、[ページサイズ互換モードでアプリを実行する] 設定を切り替え、特定のアプリに対する 16 KB の後方互換モードを有効または無効にします。この設定は、デバイスが 16 KB のページサイズで実行されている場合にのみ表示されます。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-03-19 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-03-19 UTC。"],[],[],null,["# Enable 16 KB backcompat option\n\n[16 KB toggle](/docs/core/architecture/16kb-page-size/16kb-developer-option)\nlets you to run a device with a 16 KB kernel. The 16 KB backcompat\noption is available when a device is running with a 16 KB kernel. The\npackage manager runs an app in 16 KB backcompat mode if the app has ELF\nfiles (with an `.so` extension) with a LOAD segment alignment of 4 KB, or\nif the zipped APK has uncompressed ELF files that are 4 KB zip aligned. If\nthe package manager has enabled 16 KB backcompat mode for an app, the app\ndisplays a warning when it's first launched saying that it's running in\n16 KB backcompat mode.\n\n**Figure 1.** Warning in page size compat mode.\n\n16 KB backcompat mode allows some apps to work,\nbut for best reliability and stability, apps should still be 16 KB aligned.\n\nTo enable the 16 KB backcompat option, follow these instructions:\n\n1. Follow the steps in [Enable 16 KB toggle](/docs/core/architecture/16kb-page-size/16kb-developer-option)\n to enable 16 KB toggle.\n\n2. Enable 16 KB backcompat mode using any of the following methods:\n\n - Android runs apps in backcompat mode where it is needed. There are two\n separate parts to backcompat that can be enabled independently: the\n `bionic.linker.16kb.app_compat.enabled` property controls how libraries\n are loaded, and the `pm.16kb.app_compat.disabled` property controls how\n APKs are installed.\n\n - To force 16 KB backcompat on for every app on the device:\n\n adb shell setprop bionic.linker.16kb.app_compat.enabled true\n adb shell setprop pm.16kb.app_compat.disabled false\n\n - To force 16 KB backcompat off for every app on the device:\n\n adb shell setprop bionic.linker.16kb.app_compat.enabled false\n adb shell setprop pm.16kb.app_compat.disabled true\n\n - Set the `android:pageSizeCompat` property to `enabled` or `disabled` to\n turn on or off backcompat mode for a specific app in its\n `AndroidManifest.xml`. When this property is set, the app won't display\n backcompat mode warnings when it launches.\n\n - On the app info page, under **Advanced** toggle the setting **Run app with\n page size compat mode** to enable or disable the 16 KB backcompat mode\n for specific app. This setting is only visible when the device is running with\n 16 KB page size.\n\n **Figure 2.** Page size compat mode setting."]]