Android2.1CDD-Android2.1兼容性定义中文版借鉴.pdf

版权申诉

174 浏览量 2021-12-07 17:45:35 上传评论收藏 183KB PDF 举报

资源推荐

资源详情

资源评论

1 of 23

Android 2.1 兼容性定义

compatibility@android.com

原文链接： http://source.android.com/compatibility/android-2.1-cdd.pdf

中文翻译： Jack Yu (yjmjack@gmail.com )

1. 简介

此文档列举了对于手机兼容 Android 2.1 版所必须依次符合的要求。

词汇“必须”、“绝不可以” 、“要求的”、“应该”、“不应该”、“建议”、“可以”、“可选的”

的含义依照 RFC2119 [参考 , 1]中定义的 IETF标准。

正如本文档中所使用的， “设备实现者”或者“实现者”是指开发运行 Android 2.1 的硬

件/ 软件解决方案的一个人或者一个组织。 “设备实现”或者“实现”是指所开发的硬件 / 软

件解决方案。

设备实现如要与 Android 2.1 兼容：

必须符合本兼容性定义中所列的各项要求，包含任何通过参考所引用的文档。

必须通过该设备实现的软件完成时可用的最新版本“ Android 兼容性测试套件（ CTS）”

测试。（CTS作为 Android 开源项目 [Resources, 2]的一部分提供。）许多 CTS测试组件，但不

是所有的，在此文档中有概述。

因为此兼容性定义或者 CTS未提及，存在歧义，或者未完成，设备实现者有责任保证与

现有实现的兼容性。因为这个原因， Android 开源项目 [参考 , 3]提供一种参考，同时也是一

种首选的 Android 实现。强烈鼓励设备实现者将他们的实现基于来自 Android 开源项目“从

下往上”的源代码。一些组件有可能用其他实现所替代，这种做法是强烈不推荐的，因为通

过 CTS测试将会变得相当困难。实现者有责任保证与标准 Android 实现在行为上的完全兼容，

包括但不限于 CTS。最后，要注意某些组件的替代和变更是本文档所明确禁止的。

2. 参考

1. IETF RFC2119 Requirement Levels: http://www.ietf.org/rfc/rfc2119.txt

2. Android Compatibility Program Overview:

http://source.android.com/compatibility/index.html

2 of 23

3. Android Open Source Project: http://source.android.com/

4. API definitions and documentation: http://developer.android.com/reference/packages.html

5. Android Permissions reference:

http://developer.android.com/reference/android/Manifest.permission.html

6. android.os.Build reference: http://developer.android.com/reference/android/os/Build.html

7. Android 2.1 allowed version strings:

http://source.android.com/compatibility/ 2.1/versions.xhtml

8. android.webkit.WebView class:

http://developer.android.com/reference/android/webkit/WebView.html

9. HTML5: http://www.whatwg.org/specs/web-apps/current-work/multipage/

10. Dalvik Virtual Machine specification: available in the Android source code, atdalvik/docs

11. AppWidgets:

http://developer.android.com/guide/practices/ui_guidelines/widget_design.html

12. Notifications: http://developer.android.com/guide/topics/ui/notifiers/notifications.html

13. Application Resources: http://code.google.com/android/reference/available-resources.html

14. Status Bar icon style guide: http://developer.android.com/guide/practices/ui_guideline

/icon_design.html#statusbarstructure

15. Search Manager: http://developer.android.com/reference/android/app/SearchManager.html

16. Toasts: http://developer.android.com/reference/android/widget/Toast.html

17. Live Wallpapers: http://developer.android.com/resources/articles/live-wallpapers.html

18. Apps for Android: http://code.google.com/p/apps-for-android

19. Reference tool documentation (for adb, aapt,

ddms):http://developer.android.com/guide/developing/tools/index.html

20. Android apk file description: http://developer.android.com/guide/topics/fundamentals.html

21. Manifest files: http://developer.android.com/guide/topics/manifest/manifest-intro.html

22. Monkey testing tool: http://developer.android.com/guide/developing/tools/monkey.html

23. Supporting Multiple Screens:

http://developer.android.com/guide/practices/screens_support.html

24. android.content.res.Configuration:

http://developer.android.com/reference/android/content/res/Configuration.html

25. android.util.DisplayMetrics:

http://developer.android.com/reference/android/util/DisplayMetrics.html

26. android.hardware.Camera:

3 of 23

http://developer.android.com/reference/android/hardware/Camera.html

27. Sensor coordinate space:

http://developer.android.com/reference/android/hardware/SensorEvent.html

28. Android Security and Permissions reference:

http://developer.android.com/guide/topics/security/security.html

29. Bluetooth API:

http://developer.android.com/reference/android/bluetooth/package-summary.html

这些参考中许多是直接或间接来自 Android 2.1 SDK 的，并且在信息上与 SDK中的文档功

能对等。假如此兼容性定义或者 CTS与 SDK文档有出入，那么 SDK文档是权威的。由以上

这些参考提供的任何技术细节将视作对此兼容性定义补充的一部分。

3. 软件

Android 平台包括一套托管 API、一套本地 API，和一套所谓的“软” API 例如 Intent 系统

和 web-application API 。这一节详细叙述一些对于兼容性至关重要的硬 API 和软 API，也包括

某些其他相关的技术和用户接口行为。设备实现者必须遵从本节中的所有要求。

3.1. 托管 API 兼容性

对于 Android 应用程序，托管（基于 Dalvik）执行环境是其主要承载。 Android 应用程序

编程接口（API）是一套暴露给运行于托管 VM 环境应用程序的 Android 平台接口。设备实现

必须提供由 Android 2.1 SDK[参考 , 4]暴露的任何成文 API 的完整的实现，包括所有成文的行

为。

除非特别情况下有本兼容性定义的允许，设备实现绝不可以遗漏任何托管 API，变更 API

接口或签名，偏离成文的行为，或者包括空操作。

3.2. 软 API 兼容性

除了 3.1 节的托管 API，Android 同样包括一种重要的仅运行时的“软” API，他们以这些

形式存在，诸如 Intent 、权限等 Android 应用程序不能够在编译时被施行的方面。这一节详

细叙述 Android 2.1 兼容性所要求的“软” API 和系统行为。设备实现必须符合本节中所有的

这些要求。

3.2.1. 权限

设备实现者必须支持和施行由 Permission 参考页 [参考 , 5]所列的所有权限常量。注意第

10 节列出了与 Android 安全模型相关的附加要求。

4 of 23

3.2.2. 生成参数

Android API 在类 android.os.Build 中包括一些用来描述当前设备的常量。为了在跨设备实

现方面提供一致的、有意义的值，下面的这张表格包括了这些值在设备实现上必须符合的附

加格式限制。

参数注释

android.os.Build.VERSION.RELEASE

人类可读格式的当前所正在执行的 Android 系统

版本。这个字段必须有一个在 [参考 , 7]中定义的字

符串值。

android.os.Build.VERSION.SDK

当前所正在执行的 Android 系统版本，供第三方应

用程序获取的格式。对于 Android 2.1，此字段必

须为整型值 7

android.os.Build.VERSION.INCREMENTAL

人类可读格式的由设备实现者选定的值，指定了

当前正在执行的 Android 系统的特别 build 号。此

值绝不可以被不同的 build 重复使用交付给用户。

此字段一个典型的用途是用来指示使用了哪一个

build 号或源码控制改变识别码来产生此 build 。此

字段的格式没有特殊要求，除了绝不可以是空值

或者空串。

android.os.Build.BOARD

人类可读格式的由设备实现者选定的值，用来鉴

别设备使用的特定内部硬件。此字段一个可能的

用途是用来指示设备所基于的板子的特定修正。

此字段的格式没有特殊要求，除了绝不可以是空

值或者空串。

android.os.Build.BRAND

人类可读格式的由设备实现者选定的值，用来鉴

别生产此设备的公司名称、组织、个人等。此字

段一个可能的用途是用来指定 OEM 和 /或销售此

设备的承担者。此字段的格式没有特殊要求，除

了绝不可以是空值或者空串。

android.os.Build.DEVICE

一个由设备实现者选定的值，用来鉴别此设备机

身（有时称为“工业设计” ）特定的配置或修订。

此字段的格式没有特殊要求，除了绝不可以是空

值或者空串。

android.os.Build.FINGERPRINT

一个唯一鉴别此 build 的字符串。它应该是人类合

理可读的。它必须遵从下面的模板：

$(BRAND)/$(PRODUCT)/$(DEVICE)

/$(BOARD):$(VERSION.RELEASE)/$(ID)

/$(VERSION.INCREMENTAL):$(TYPE)/$(TAGS)

例如：

acme/mydevice/generic/generic:2.1-update1 /ERC77

/3359:userdebug/test-keys

指纹绝不可以包含空格。如果在上面模板中包含

的其他字段中有空格，它们应该在指纹中被 ASCII

剩余22页未读，继续阅读

评论收藏

内容反馈

版权申诉

dtd13961139571

粉丝: 1
资源: 6万+

Android2.1CDD-Android2.1兼容性定义中文版借鉴.pdf

android-cdd-8.0.pdf

android-12-cdd.pdf

android-7.1-cdd.pdf

android-10-cdd.pdf

Android 8.1 CDD兼容性定义文档中文版.zip

Android4.0 CDD兼容性定义文档中文版

android-2.1-cdd

android-9-cdd.pdf

android-11-cdd.pdf

android-2.3-cdd.pdf

VIDE-CDD.SYS

android-9-cdd(Compability Definition Document)

android pdf

Android4.0 CDD中文版.pdf

TechnicalReference-Cdd-Communication.pdf

Android4.0CDD中文版.pdf

Android 7.0 兼容性说明文档

android兼容性定义文档

android-cts-verifier-8.0_r3-linux_x86-arm

android-8.0-cdd

施克cdd-11n光电开关.doc

Android 13 Compatibility Definition Android 13 兼容性定义 - Android

CDD-master.rar

解决win7win8win10装4.8-3.5的.Net framework3.5安装失败问题 附带安装文档

MIPS流水CPU设计-HUST 《计算机组成原理》（头歌实验答案）

自己动手画CPU 《计算机组成原理》（头歌实验答案）

时序图画图工具-TimeGen3.2安装包

最新资源

解决win7win8win10装4.8-3.5的.Net framework3.5安装失败问题附带安装文档