Chromebook 的应用清单兼容性
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
当您准备要在 Chromebook 上运行 Android 应用时，请考虑应用使用的设备功能。Chromebook 并非在搭载 Android 的其他设备上可用的所有硬件和软件功能都受支持。如果您的应用需要使用 Chromebook 不支持的特定功能，则无法在 Chromebook 上安装。
您可以在清单文件中声明应用对硬件功能和特定软件功能的要求。本文档介绍了与 Chromebook 不兼容的应用清单功能声明。
不兼容的清单条目
本部分列出的清单条目与 Chromebook 不兼容。如果您的应用使用了其中的任何条目，请考虑将其移除或为其添加 required="false" 属性值，以便应用可以安装到 Chromebook 上。
如需详细了解如何声明功能的使用，而不要求设备提供该功能，请参阅 <uses-feature> 清单元素的指南。如需查看应用清单功能和说明的完整列表，请参阅功能参考文档。
注意：Android Studio 2.3 及更高版本内置了 lint 检查功能，可自动验证清单文件。在 Android Studio 中，依次选择 File > Settings > Editor > Inspections > Android > Lint > Correctness > 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：专为大屏幕查看而设计的界面
-
android.software.live_wallpaper：动画壁纸
-
android.software.live_tv：流式直播电视节目
-
android.software.managed_users：次要用户和受管理个人资料
-
android.software.sip：会话发起协议 (SIP) 服务，支持视频会议和即时通讯
-
android.software.sip.voip：基于 SIP 的互联网语音协议 (VoIP) 服务，支持双向视频会议
隐含功能要求的权限
您在清单文件中请求的某些权限可能会隐含对硬件和软件功能的请求。请求这些权限会阻止应用安装在 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 和/或其关联公司的注册商标。
最后更新时间 (UTC)：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"]],["最后更新时间 (UTC)：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` |"]]
