Chromebook 的應用程式資訊清單相容性
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
當您準備在 Chromebook 上執行 Android 應用程式時，請考慮應用程式使用的裝置功能。Chromebook 不支援其他搭載 Android 裝置可用的所有硬體和軟體功能。如果您的應用程式需要 Chromebook 不支援的特定功能，則無法在 Chromebook 上安裝。
您可以在資訊清單檔案中宣告應用程式的硬體功能和特定軟體功能需求。本文件說明與 Chromebook 不相容的應用程式資訊清單功能宣告。
資訊清單項目不相容
本節所列出的資訊清單項目與 Chromebook 不相容。如果您的應用程式使用上述任一項目，請考慮移除這些項目或包含 required="false" 屬性值，以便安裝在 Chromebook 上。
如要進一步瞭解如何宣告功能使用情形，但不想讓裝置提供該功能，請參閱 <uses-feature> 資訊清單元素指南。如需應用程式資訊清單功能和說明的完整清單，請參閱「功能參考資料」。
注意：Android Studio 2.3 以上版本內建了 Lint 檢查，可自動驗證資訊清單檔案。在 Android Studio 中，依序選取「File」>「Settings」>「Editor」>「Inspects」>「Android」>「Lint」>「正確性」>「ChromeOS」。
硬體功能
硬體功能的支援情況會因 Chromebook 而異。某些功能在任何 Chromebook 上都不支援，有些則僅適用於特定 Chromebook。
特殊功能
為提升 Chromebook 的硬體支援品質，android.hardware.type.pc 會停用滑鼠和觸控板的輸入模擬功能。您必須為這個項目指定 required="false"，否則應用程式「只能」在 Chromebook 上執行。
不支援的硬體功能
下列清單包含 Chromebook 不支援的硬體功能：
-
android.hardware.camera：後置鏡頭
-
android.hardware.camera.autofocus：採用自動對焦功能的相機
-
android.hardware.camera.capability.manual_post_processing：使用 MANUAL_POST_PROCESSING 功能的相機，包括覆寫自動白平衡的功能
-
android.hardware.camera.capability.manual_sensor：使用 MANUAL_SENSOR 功能的相機，包括自動曝光鎖定支援
-
android.hardware.camera.capability.raw：使用 RAW 功能的相機，包括儲存 DNG (原始) 檔案及提供 DNG 相關中繼資料
-
android.hardware.camera.flash：使用閃光燈的相機
-
android.hardware.camera.level.full：使用 FULL 等級拍照功能的相機
-
android.hardware.consumerir：紅外線 (IR)
-
android.hardware.location.gps：全球定位系統 (GPS)
-
android.hardware.nfc：近距離無線通訊 (NFC)
-
android.hardware.nfc.hce：NFC 卡模擬功能，已淘汰
-
android.hardware.sensor.barometer：氣壓計 (氣壓)
-
android.hardware.telephony：電話，包括提供資料通訊服務的無線電
-
android.hardware.telephony.cdma：電話代碼分區
多重存取 (CDMA) 網路支援
-
android.hardware.telephony.gsm：電話全球行動系統 (GSM) 網路支援
-
android.hardware.type.automotive：Android Automotive OS 裝置
-
android.hardware.type.television：電視 (已淘汰)
-
android.hardware.usb.accessory：USB 配件模式
-
android.hardware.usb.host：USB 主機模式
部分支援的硬體功能
下列清單列出部分 Chromebook 可能提供的硬體功能：
-
android.hardware.sensor.accelerometer：加速計 (裝置螢幕方向)
-
android.hardware.sensor.compass：指南針
-
android.hardware.sensor.gyroscope：陀螺儀 (裝置旋轉和扭轉)
-
android.hardware.sensor.light：淺色
-
android.hardware.sensor.proximity：距離 (使用者)
-
android.hardware.sensor.stepcounter：計步器
-
android.hardware.sensor.stepdetector：步數偵測器
觸控螢幕硬體支援
自 ChromeOS M53 版起，所有未明確要求
android.hardware.touchscreen 功能的 Android 應用程式，也能在支援
android.hardware.faketouch 功能的 ChromeOS 裝置上運作。
具有模擬觸控介面的裝置可提供模擬基本觸控事件的使用者輸入系統。舉例來說，使用者可以與滑鼠或遙控器互動，在畫面中移動遊標、捲動清單，以及將元素從畫面的某個部分拖曳至另一個部分。
如果不希望應用程式安裝在有模擬觸控介面 (而非觸控螢幕) 的裝置上，可以採取下列任一做法：
軟體功能
下列清單包含 Chromebook 不支援的軟體功能：
-
android.software.app_widgets：主畫面上的應用程式小工具
-
android.software.device_admin：裝置政策管理
-
android.software.home_screen：取代裝置的主畫面
-
android.software.input_methods：自訂輸入法 (
InputMethodService 的執行個體)
-
android.software.leanback：專為大螢幕檢視設計的 UI
-
android.software.live_wallpaper：動畫桌布
-
android.software.live_tv：串流播放電視直播節目
-
android.software.managed_users：次要使用者和受管理的設定檔
-
android.software.sip：對話啟動協定 (SIP) 服務，支援視訊會議和即時通訊
-
android.software.sip.voip：以 SIP 為基礎的 Voice Over 網際網路通訊協定 (VoIP) 服務，可支援雙向視訊會議
隱含功能需求的權限
您在資訊清單檔案中要求的部分權限，可能會為硬體和軟體功能建立默示要求。要求這些權限可避免 Chromebook 在 Chromebook 上安裝您的應用程式。
如要進一步瞭解如何避免權限要求在 Chromebook 上將應用程式設為無法使用，請參閱本頁的「不相容的資訊清單」一節。
下表顯示了可能導致應用程式與 Chromebook 不相容的功能需求：
表 1. 隱含與 Chromebook 不相容硬體功能的裝置權限。
| 類別 |
這項權限 |
違反這項功能規定 |
| 相機 |
CAMERA |
android.hardware.camera 和
android.hardware.camera.autofocus
|
| 電話通訊系統 |
CALL_PHONE |
android.hardware.telephony |
CALL_PRIVILEGED |
android.hardware.telephony |
MODIFY_PHONE_STATE |
android.hardware.telephony |
PROCESS_OUTGOING_CALLS |
android.hardware.telephony |
READ_SMS |
android.hardware.telephony |
RECEIVE_SMS |
android.hardware.telephony |
RECEIVE_MMS |
android.hardware.telephony |
RECEIVE_WAP_PUSH |
android.hardware.telephony |
SEND_SMS |
android.hardware.telephony |
WRITE_APN_SETTINGS |
android.hardware.telephony |
WRITE_SMS |
android.hardware.telephony |
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-07-27 (世界標準時間)。
[[["容易理解","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-07-27 (世界標準時間)。"],[],[],null,["# App manifest compatibility for Chromebooks\n\nAs you prepare your Android app to run on Chromebooks, consider the\ndevice features that your app uses. Chromebooks don't support all the\nhardware and software features that are available on other devices running\nAndroid. If your app requires specific features that aren't supported on\nChromebooks, it won't be available for installation on Chromebooks.\n\n\nYou declare your app's requirements for hardware features and certain software\nfeatures in the [manifest file](/guide/topics/manifest/manifest-intro).\nThis document describes the app manifest feature declarations that aren't\ncompatible with Chromebooks.\n\nIncompatible manifest entries\n-----------------------------\n\nThe manifest entries listed in this section aren't compatible with Chromebooks. If\nyour app uses any of these entries, consider removing them or including the\n`required=\"false\"` attribute value with them so that your app can be installed on\nChromebooks.\n\nFor more information about declaring feature use without requiring that the feature be\navailable on the device, see the guide for the [`\u003cuses-feature\u003e`](/guide/topics/manifest/uses-feature-\nelement#market-feature-filtering) manifest element. For\na complete list of app manifest features and descriptions see the\n[Features reference](/guide/topics/manifest/uses-feature-element#features-reference) .\n\n**Note** : Android Studio 2.3 and later has built-in lint checks to\nautomatically validate the manifest file. In Android Studio, select\n**File \\\u003e Settings \\\u003e Editor \\\u003e Inspections \\\u003e Android \\\u003e Lint \\\u003e Correctness \\\u003e ChromeOS.**\n\n### Hardware features\n\n\nSupport for hardware features varies on Chromebooks. Some features aren't\nsupported on any Chromebooks, while others are supported on only some Chromebooks.\n\n### Special features\n\n\nFor better hardware support on Chromebooks, `android.hardware.type.pc` disables input emulation for mouse\nand touchpad. You must indicate `required=\"false\"`\nfor this entry, or your app can *only* run on Chromebooks.\n\n#### Unsupported hardware features\n\n\nThe following list includes the hardware features that aren't\nsupported on Chromebooks:\n\n- `android.hardware.camera`: back-facing camera\n- `android.hardware.camera.autofocus`: camera that uses autofocus\n- `android.hardware.camera.capability.manual_post_processing`: camera that uses the `MANUAL_POST_PROCESSING` feature, including functionality for overriding auto white balance\n- `android.hardware.camera.capability.manual_sensor`: camera that uses the `MANUAL_SENSOR` feature, including auto-exposure locking support\n- `android.hardware.camera.capability.raw`: camera that uses the `RAW` feature, including the ability to save DNG (raw) files and provide DNG-related metadata\n- `android.hardware.camera.flash`: camera that uses flash\n- `android.hardware.camera.level.full`: camera that uses `FULL`-level image-capturing support\n- `android.hardware.consumerir`: infrared (IR)\n- `android.hardware.location.gps`: Global Positioning System (GPS)\n- `android.hardware.nfc`: Near-Field Communication (NFC)\n- `android.hardware.nfc.hce`: NFC card emulation, which is deprecated\n- `android.hardware.sensor.barometer`: barometer (air pressure)\n- `android.hardware.telephony`: telephony, including radio with data communication services\n- `android.hardware.telephony.cdma`: telephony Code Division Multiple Access (CDMA) network support\n- `android.hardware.telephony.gsm`: telephony Global System for Mobile Communications (GSM) network support\n- `android.hardware.type.automotive`: Android Automotive OS device\n- `android.hardware.type.television`: television, which is deprecated\n- `android.hardware.usb.accessory`: USB accessory mode\n- `android.hardware.usb.host`: USB host mode\n\n#### Partially supported hardware features\n\n\nThe following list includes hardware features that might be available on some\nChromebooks:\n\n- `android.hardware.sensor.accelerometer`: accelerometer (device orientation)\n- `android.hardware.sensor.compass`: compass\n- `android.hardware.sensor.gyroscope`: gyroscope (device rotation and twist)\n- `android.hardware.sensor.light`: light\n- `android.hardware.sensor.proximity`: proximity (to user)\n- `android.hardware.sensor.stepcounter`: step counter\n- `android.hardware.sensor.stepdetector`: step detector\n\n#### Touchscreen hardware support\n\n\nAs of ChromeOS version M53, all Android apps that don't explicitly require the\n[`android.hardware.touchscreen`](/guide/topics/manifest/uses-feature-element#touchscreen-hw-features) feature also work on ChromeOS\ndevices that support the\n[`android.hardware.faketouch`](/guide/topics/manifest/uses-feature-element#touchscreen-hw-features) feature.\n\nDevices that have fake\ntouch interfaces provide a user input system that emulates basic touch events.\nFor example, the user can interact with a mouse or remote control to move an\non-screen cursor, scroll through a list, and drag elements from one part of the\nscreen to another.\n\n\nIf you don't want your app to be installed on devices that have fake touch\ninterfaces but not touchscreens, you can complete one of the following actions:\n\n- Exclude specific devices in the [Google Play Console](https://play.google.com/console).\n- Filter devices with no touchscreen hardware by explicitly declaring [`android.hardware.touchscreen`](/guide/topics/manifest/uses-feature-element#touchscreen-hw-features) as being required in order to install your app.\n\n### Software features\n\n\nThe following list includes the software features that aren't\nsupported on Chromebooks:\n\n- `android.software.app_widgets`: app widgets on the Home screen\n- `android.software.device_admin`: device policy administration\n- `android.software.home_screen`: replaces device's Home screen\n- `android.software.input_methods`: custom input methods (instances of [`InputMethodService`](/reference/android/inputmethodservice/InputMethodService))\n- `android.software.leanback`: UI designed for large-screen viewing\n- `android.software.live_wallpaper`: animated wallpapers\n- `android.software.live_tv`: streaming live TV programs\n- `android.software.managed_users`: secondary users and managed profiles\n- `android.software.sip`: Session Initiation Protocol (SIP) service, which supports video conferencing and instant messaging\n- `android.software.sip.voip`: Voice Over Internet Protocol (VoIP) service based on SIP, which supports two-way video conferencing\n\nPermissions that imply feature requirements\n-------------------------------------------\n\n\nSome permissions that you request in your manifest files can create implied\nrequests for hardware and software features. By requesting these permissions,\nyou prevent your app from being installed on Chromebooks.\n\n\nFor details about how to prevent permission requests from making your app\nunavailable on Chromebooks, see the [Incompatible\nmanifest entries](#incompat-entries) section of this page.\n\n\nThe following table shows the permissions that imply feature\nrequirements that make an app incompatible with Chromebooks:\n\n\n**Table 1.**Device permissions that imply hardware features which\nare incompatible with Chromebooks.\n\n| Category | This permission | Implies this feature requirement |\n|-----------|--------------------------|-------------------------------------------------------------------|\n| Camera | `CAMERA` | `android.hardware.camera` and `android.hardware.camera.autofocus` |\n| Telephony | `CALL_PHONE` | `android.hardware.telephony` |\n| Telephony | `CALL_PRIVILEGED` | `android.hardware.telephony` |\n| Telephony | `MODIFY_PHONE_STATE` | `android.hardware.telephony` |\n| Telephony | `PROCESS_OUTGOING_CALLS` | `android.hardware.telephony` |\n| Telephony | `READ_SMS` | `android.hardware.telephony` |\n| Telephony | `RECEIVE_SMS` | `android.hardware.telephony` |\n| Telephony | `RECEIVE_MMS` | `android.hardware.telephony` |\n| Telephony | `RECEIVE_WAP_PUSH` | `android.hardware.telephony` |\n| Telephony | `SEND_SMS` | `android.hardware.telephony` |\n| Telephony | `WRITE_APN_SETTINGS` | `android.hardware.telephony` |\n| Telephony | `WRITE_SMS` | `android.hardware.telephony` |"]]
