Android 2.3 相容性定義

版權所有 © 2010,Google Inc. 保留所有權利。
相容性@android.com

目錄

一、簡介
2. 資源
3、軟體
4. 應用程式封裝相容性
5. 多媒體相容性
6. 開發者工具相容性
7. 硬體相容性
8. 效能相容性
9. 安全模型相容性
10.軟體相容性測試
11. 可更新的軟體
12. 聯絡我們
附錄 A - 藍牙測試程序

一、簡介

本文檔列舉了手機相容Android 2.3必須滿足的要求。

「必須」、「不得」、「必需」、「應」、「不應」、「應該」、「不應該」、「建議」、「可以」和「可選」的使用符合 IETF 標準RFC2119 [參考資料, 1 ] 中定義。

在本文檔中,「裝置實現者」或「實現者」是指開發運行 Android 2.3 的硬體/軟體解決方案的個人或組織。 「設備實現」或「實現」是這樣開發的硬體/軟體解決方案。

要被認為與 Android 2.3 相容,裝置實作必須滿足此相容性定義中提出的要求,包括透過引用合併的任何文件。

如果第 10 節中所述的此定義或軟體測試是沉默的、不明確的或不完整的,則設備實現者有責任確保與現有實現的兼容性。因此,Android 開源專案 [參考資料, 3 ] 既是 Android 的參考實現,也是首選實現。強烈鼓勵設備實現者最大程度地基於 Android 開源專案提供的「上游」原始程式碼來實現其實現。雖然假設某些組件可以替換為替代實現,但強烈建議不要這樣做,因為通過軟體測試將變得更加困難。實作者有責任確保與標準 Android 實作完全行為相容,包括相容性測試套件。最後,請注意,本文檔明確禁止某些組件替換和修改。

請注意,此相容性定義的發布是為了與 Android 2.3.3 更新(API 等級 10)相對應。此定義廢棄並取代了 2.3.3 之前的 Android 2.3 版本的兼容性定義。 (也就是說,版本 2.3.1 和 2.3.2 已過時。)未來運行 Android 2.3 的 Android 相容設備必須附帶版本 2.3.3 或更高版本。

2. 資源

  1. IETF RFC2119 要求等級: http://www.ietf.org/rfc/rfc2119.txt
  2. Android 相容性計劃概述: http://source.android.com/docs/compatibility/index.html
  3. Android 開源專案:http: //source.android.com/
  4. API定義與文件: http://developer.android.com/reference/packages.html
  5. Android 權限參考: http://developer.android.com/reference/android/Manifest.permission.html
  6. android.os.Build 參考: http://developer.android.com/reference/android/os/Build.html
  7. Android 2.3 允許的版本字串: http://source.android.com/docs/compatibility/2.3/versions.html
  8. android.webkit.WebView 類別: http://developer.android.com/reference/android/webkit/WebView.html
  9. HTML5: http://www.whatwg.org/specs/web-apps/current-work/multipage/
  10. HTML5 離線功能: http://dev.w3.org/html5/spec/Overview.html#offline
  11. HTML5 影片標籤: http://dev.w3.org/html5/spec/Overview.html#video
  12. HTML5/W3C 地理定位 API: http://www.w3.org/TR/geolocation-API/
  13. HTML5/W3C 網路資料庫 API: http://www.w3.org/TR/webdatabase/
  14. HTML5/W3C IndexedDB API: http://www.w3.org/TR/IndexedDB/
  15. Dalvik 虛擬機器規格:可在 Android 原始碼中找到,位於 dalvik/docs
  16. 應用程式小工具: http://developer.android.com/guide/practices/ui_guidelines/widget_design.html
  17. 通知: http ://developer.android.com/guide/topics/ui/notifiers/notifications.html
  18. 應用程式資源: http://code.google.com/android/reference/available-resources.html
  19. 狀態列圖示樣式指南: http://developer.android.com/guide/practices/ui_guideline /icon_design.html#statusbarstruct
  20. 搜尋管理員: http://developer.android.com/reference/android/app/SearchManager.html
  21. 吐司:http: //developer.android.com/reference/android/widget/Toast.html
  22. 動態桌布: https://android-developers.googleblog.com/2010/02/live-wallpapers.html
  23. 參考工具文件(針對adb、aapt、ddms): http://developer.android.com/guide/developing/tools/index.html
  24. Android apk 檔案說明: http://developer.android.com/guide/topics/fundamentals.html
  25. 清單檔案: http://developer.android.com/guide/topics/manifest/manifest-intro.html
  26. Monkey測試工具: https://developer.android.com/studio/test/other-testing-tools/monkey
  27. Android 硬體功能清單: http://developer.android.com/reference/android/content/pm/PackageManager.html
  28. 支援多畫面: http://developer.android.com/guide/practices/screens_support.html
  29. android.util.DisplayMetrics: http://developer.android.com/reference/android/util/DisplayMetrics.html
  30. android.content.res.Configuration: http://developer.android.com/reference/android/content/res/Configuration.html
  31. 感測器座標空間: http://developer.android.com/reference/android/hardware/SensorEvent.html
  32. 藍牙 API: http://developer.android.com/reference/android/bluetooth/package-summary.html
  33. NDEF 推播協定: http://source.android.com/docs/compatibility/ndef-push-protocol.pdf
  34. MIFARE MF1S503X: http://www.nxp.com/documents/data_sheet/MF1S503x.pdf
  35. MIFARE MF1S703X: http://www.nxp.com/documents/data_sheet/MF1S703x.pdf
  36. MIFARE MF0ICU1: http://www.nxp.com/documents/data_sheet/MF0ICU1.pdf
  37. MIFARE MF0ICU2: http://www.nxp.com/documents/short_data_sheet/MF0ICU2_SDS.pdf
  38. MIFARE AN130511: http://www.nxp.com/documents/application_note/AN130511.pdf
  39. MIFARE AN130411: http://www.nxp.com/documents/application_note/AN130411.pdf
  40. 相機方向API: http://developer.android.com/reference/android/hardware/Camera.html#setDisplayOrientation(int)
  41. android.hardware.Camera:http://developer.android.com/reference/android/hardware/Camera.html
  42. Android 安全性與權限參考: http://developer.android.com/guide/topics/security/security.html
  43. 適用於 Android 的應用程式:http: //code.google.com/p/apps-for-android

其中許多資源直接或間接源自 Android 2.3 SDK,並且在功能上與該 SDK 文件中的資訊相同。在任何情況下,如果本相容性定義或相容性測試套件與 SDK 文件不一致,則 SDK 文件被視為具有權威性。上述參考文獻中提供的任何技術細節均被視為包含在本相容性定義中。

3、軟體

Android 平台包括一組託管 API、一組本機 API 以及一組所謂的「軟」API(例如 Intent 系統和 Web 應用程式 API)。本節詳細介紹了相容性不可或缺的硬 API 和軟 API,以及某些其他相關技術和使用者介面行為。設備實作必須符合本節中的所有要求。

3.1.託管 API 相容性

託管(基於 Dalvik)執行環境是 Android 應用程式的主要工具。 Android 應用程式介面 (API) 是向在託管 VM 環境中運行的應用程式公開的一組 Android 平台介面。設備實現必須提供 Android 2.3 SDK 公開的任何記錄的 API 的完整實現,包括所有記錄的行為 [參考資料,4 ]。

設備實作不得省略任何託管 API、更改 API 介面或簽章、偏離記錄的行為或包含無操作,除非本相容性定義明確允許。

此相容性定義允許裝置實作省略 Android 包含的 API 的某些類型的硬體。在這種情況下,API 必須仍然存在並以合理的方式運行。有關此場景的具體要求,請參閱第 7 節。

3.2.軟 API 相容性

除了第 3.1 節中的託管 API 之外,Android 還包括一個重要的僅運行時「軟」API,其形式為 Intent、權限和 Android 應用程式的類似方面,這些方面無法在應用程式編譯時強制執行。本節詳細介紹與 Android 2.3 相容所需的「軟」API 和系統行為。設備實作必須滿足本節中提出的所有要求。

3.2.1.權限

設備實現者必須支援並強制執行權限參考頁 [參考資料,5 ] 中記錄的所有權限常數。請注意,第 10 節列出了與 Android 安全模型相關的其他要求。

3.2.2.建構參數

Android API 包含android.os.Build類別 [ Resources, 6 ] 上的許多常數,用於描述目前裝置。為了跨裝置實作提供一致、有意義的值,下表包含裝置實作必須遵守的這些值的格式的附加限制。

範圍評論
android.os.Build.VERSION.RELEASE目前執行的 Android 系統的版本,採用人類可讀的格式。該欄位必須具有 [ Resources, 7 ] 中定義的字串值之一。
android.os.Build.VERSION.SDK目前執行的 Android 系統的版本,採用第三方應用程式程式碼可存取的格式。對於 Android 2.3,此欄位必須具有整數值 9。
android.os.Build.VERSION.INCREMENTAL裝置實現者選擇的值,以人類可讀的格式指定目前正在執行的 Android 系統的特定版本。該值不得重複用於向最終用戶提供的不同建置。此欄位的典型用途是指示使用哪個版本號或原始碼控制變更標識符來產生版本。該欄位的具體格式沒有要求,但不能為 null 或空字串 ("")。
android.os.Build.BOARD設備實現者選擇的值,以人類可讀的格式標識設備使用的特定內部硬體。此欄位的一個可能用途是指示為設備供電的板的特定版本。此欄位的值必須可編碼為 7 位元 ASCII 並符合正規表示式"^[a-zA-Z0-9.,_-]+$"
android.os.Build.BRAND設備實施者選擇的值,以人類可讀的格式標識生產該設備的公司、組織、個人等的名稱。此欄位的可能用途是指示銷售該設備的 OEM 和/或營運商。此欄位的值必須可編碼為 7 位元 ASCII 並符合正規表示式"^[a-zA-Z0-9.,_-]+$"
android.os.Build.DEVICE設備實施者所選擇的值,用於標識設備主體的特定配置或修訂(有時稱為「工業設計」)。此欄位的值必須可編碼為 7 位元 ASCII 並符合正規表示式"^[a-zA-Z0-9.,_-]+$"
android.os.Build.FINGERPRINT唯一標識此建置的字串。它應該是合理的人類可讀的。它必須遵循以下模板:
$(BRAND)/$(PRODUCT)/$(DEVICE):$(VERSION.RELEASE)/$(ID)/$(VERSION.INCREMENTAL):$(TYPE)/$(TAGS)
例如:
acme/mydevice/generic/generic:2.3/ERC77/3359:userdebug/test-keys
指紋不得包含空白字元。如果上述模板中包含的其他字段具有空白字符,則必須在構建指紋中將它們替換為另一個字符,例如下劃線(“_”)字符。此欄位的值必須可編碼為 7 位元 ASCII。
android.os.Build.HOST以人類可讀格式唯一標識建構建構的主機的字串。該欄位的具體格式沒有要求,但不能為 null 或空字串 ("")。
android.os.Build.ID設備實現者選擇的標識符,用於引用特定版本,採用人類可讀的格式。該欄位可以與 android.os.Build.VERSION.INCRMENTAL 相同,但應該是一個對於最終用戶區分軟體版本足夠有意義的值。此欄位的值必須可編碼為 7 位元 ASCII 並符合正規表示式"^[a-zA-Z0-9.,_-]+$"
android.os.Build.MODEL設備實現者選擇的值,包含最終使用者已知的設備名稱。此名稱應與設備行銷和銷售給最終用戶時使用的名稱相同。該欄位的具體格式沒有要求,但不能為 null 或空字串 ("")。
android.os.Build.Product由設備實現者選擇的值,包含設備的開發名稱或代號。必須是人類可讀的,但不一定供最終用戶查看。此欄位的值必須可編碼為 7 位元 ASCII 並符合正規表示式"^[a-zA-Z0-9.,_-]+$"
android.os.Build.TAGS由設備實現者選擇的以逗號分隔的標籤列表,用於進一步區分建置。例如,“未簽名,調試”。此欄位的值必須可編碼為 7 位元 ASCII 並符合正規表示式"^[a-zA-Z0-9.,_-]+$"
android.os.Build.TIME表示建構發生時間的時間戳記的值。
android.os.Build.TYPE由設備實現者選擇的值,指定建置的運行時配置。此欄位應該具有與三種典型 Android 運行時配置相對應的值之一:「user」、「userdebug」或「eng」。此欄位的值必須可編碼為 7 位元 ASCII 並符合正規表示式"^[a-zA-Z0-9.,_-]+$"
android.os.Build.USER產生建置的使用者(或自動使用者)的名稱或使用者 ID。該欄位的具體格式沒有要求,但不能為 null 或空字串 ("")。

3.2.3.意圖相容性

Android 使用 Intent 來實現應用程式之間的鬆散耦合整合。本節描述與設備實現必須遵守的意圖模式相關的要求。 「榮幸」意味著裝置實現者必須提供一個 Android Activity 或 Service,指定匹配的 Intent 過濾器,並綁定到每個指定的 Intent 模式並實現正確的行為。

3.2.3.1.核心應用意圖

Android上游專案定義了許多核心應用程序,例如電話撥號器、日曆、通訊錄、音樂播放器等。設備實施者可以用替代版本替換這些應用程式。

但是,任何此類替代版本都必須遵循上游項目提供的相同意圖模式。例如,如果裝置包含替代音樂播放器,它仍然必須遵循第三方應用程式發出的意圖模式來選擇歌曲。

以下應用程式被視為核心 Android 系統應用程式:

  • 英式鐘
  • 瀏覽器
  • 日曆
  • 計算機
  • 聯絡方式
  • 電子郵件
  • 畫廊
  • 全球搜尋
  • 啟動器
  • 音樂
  • 設定

Android 系統核心應用程式包括各種被視為「公共」的 Activity 或 Service 元件。也就是說,屬性「android:exported」可以不存在,或者可以有值「true」。

對於核心 Android 系統應用程式之一中定義的每個活動或服務,如果未透過值為「false」的 android:exported 屬性標記為非公開,則裝置實作必須包含實作相同 Intent 篩選器的相同類型的元件模式作為Android系統的核心應用程式。

換句話說,裝置實作可以取代核心 Android 系統應用程式;但是,如果是這樣,裝置實作必須支援每個被替換的核心 Android 系統應用程式定義的所有 Intent 模式。

3.2.3.2.意圖覆蓋

由於 Android 是一個可擴展平台,裝置實現者必須允許第 3.2.3.1 節中引用的每個 Intent 模式被第三方應用程式覆蓋。上游Android開源專案預設允許這樣做;設備實作者不得為系統應用程式使用這些 Intent 模式附加特殊權限,或阻止第三方應用程式綁定到這些模式並承擔對這些模式的控制。該禁止具體包括但不限於停用「選擇器」使用者介面,該介面允許使用者在全部處理相同意圖模式的多個應用程式之間進行選擇。

3.2.3.3.意圖命名空間

裝置實現者不得包含任何使用 ACTION、CATEGORY 或 android.* 命名空間中的其他鍵字串來支援任何新意圖或廣播意圖模式的 Android 元件。裝置實現者不得包含任何使用 ACTION、CATEGORY 或屬於另一個組織的包空間中的其他鍵字串來遵循任何新 Intent 或廣播 Intent 模式的 Android 元件。設備實現者不得更改或擴展第 3.2.3.1 節中列出的核心應用程式所使用的任何 Intent 模式。

該禁止類似於第 3.6 節中為 Java 語言類別指定的禁止。

3.2.3.4.廣播意圖

第三方應用程式依靠平台廣播某些Intent來通知它們硬體或軟體環境的變化。 Android 相容裝置必須廣播公共廣播 Intents 以回應適當的系統事件。 SDK 文件中描述了廣播意圖。

3.3.本機 API 相容性

Dalvik 中執行的託管程式碼可以呼叫應用程式 .apk 檔案中提供的本機程式碼,作為針對適當裝置硬體架構編譯的 ELF .so 檔案。由於本機程式碼高度依賴底層處理器技術,因此 Android 在 Android NDK 中的檔案docs/CPU-ARCH-ABIS.txt中定義了許多應用程式二進位介面 (ABI)。如果裝置實現與一個或多個已定義的 ABI 相容,則它應該實現與 Android NDK 的兼容性,如下所示。

如果裝置實現包含對 Android ABI 的支持,則:

  • 必須支援在託管環境中執行的程式碼,以使用標準 Java 本機介面 (JNI) 語義呼叫本機程式碼。
  • 必須與下面列表中每個所需的庫來源相容(即標頭相容)和二進位相容(對於 ABI)
  • 必須透過android.os.Build.CPU_ABI API 精確報告設備支援的本機應用程式二進位介面 (ABI)
  • 必須僅報告最新版本的 Android NDK(位於文件docs/CPU-ARCH-ABIS.txt中)記錄的 ABI
  • 應使用上游 Android 開源專案中提供的源代碼和頭文件進行構建

以下本機程式碼 API 必須可用於包含本機程式碼的應用程式:

  • libc(C 庫)
  • libm(數學庫)
  • 對 C++ 的最低支持
  • JNI介面
  • liblog(Android 日誌記錄)
  • libz(Zlib 壓縮)
  • libdl(動態連結器)
  • libGLESv1_CM.so(OpenGL ES 1.0)
  • libGLESv2.so(OpenGL ES 2.0)
  • libEGL.so(原生 OpenGL 表面管理)
  • libjnigraphics.so
  • libOpenSLES.so(開放聲音庫音訊支援)
  • libandroid.so(原生 Android 活動支援)
  • 支援 OpenGL,如下所述

請注意,Android NDK 的未來版本可能會引入對其他 ABI 的支援。如果設備實作與現有的預定義 ABI 不相容,則它根本無法報告對任何 ABI 的支援。

本機程式碼相容性具有挑戰性。因此,應該重申的是,強烈鼓勵設備實現者使用上面列出的庫的上游實作來幫助確保相容性。

3.4.網路相容性

許多開發人員和應用程式的使用者介面都依賴android.webkit.WebView類別 [參考資料, 8 ] 的行為,因此 WebView 實作必須在 Android 實作之間相容。同樣,完整、現代的網頁瀏覽器是 Android 用戶體驗的核心。裝置實作必須包含與上游 Android 軟體一致的android.webkit.WebView版本,並且必須包含支援現代 HTML5 的瀏覽器,如下所述。

3.4.1.網頁視圖相容性

Android 開源實作使用 WebKit 渲染引擎來實作android.webkit.WebView 。由於為 Web 渲染系統開發全面的測試套件是不可行的,因此設備實作者必須在 WebView 實作中使用 WebKit 的特定上游版本。具體來說:

  • 裝置實現的android.webkit.WebView實作必須基於 Android 2.3 的上游 Android 開源樹中的 533.1 WebKit 建置。此版本包括一組針對 WebView 的特定功能和安全性修復。設備實作者可以包括對 WebKit 實作的自訂;但是,任何此類自訂都不得改變 WebView 的行為,包括渲染行為。
  • WebView 報告的用戶代理字串必須採用以下格式:
    Mozilla/5.0 (Linux; U; Android $(VERSION); $(LOCALE); $(MODEL) Build/$(BUILD)) AppleWebKit/533.1 (KHTML, like Gecko) Version/4.0 Mobile Safari/533.1
    • $(VERSION) 字串的值必須與android.os.Build.VERSION.RELEASE的值相同
    • $(LOCALE) 字串的值應該遵循國家代碼和語言的 ISO 約定,並且應該引用設備目前配置的區域設置
    • $(MODEL) 字串的值必須與android.os.Build.MODEL的值相同
    • $(BUILD) 字串的值必須與android.os.Build.ID的值相同

WebView 元件應該盡可能支援 HTML5 [參考資料,9 ]。至少,設備實作必須支援與 WebView 中的 HTML5 關聯的每個 API:

此外,設備實作必須支援 HTML5/W3C webstorage API [參考資料,13 ],並且應該支援 HTML5/W3C IndexedDB API [參考資料,14 ]。請注意,隨著 Web 開發標準機構逐漸轉向支援 IndexedDB 而不是 Webstorage,IndexedDB 預計將成為 Android 未來版本中的必要組件。

HTML5 API 與所有 JavaScript API 一樣,必須在 WebView 中預設為停用,除非開發人員透過常用的 Android API 明確啟用它們。

3.4.2.瀏覽器相容性

設備實作必須包括用於一般使用者 Web 瀏覽的獨立瀏覽器應用程式。獨立瀏覽器可以基於 WebKit 以外的瀏覽器技術。但是,即使使用備用瀏覽器應用程序,提供給第三方應用程式的android.webkit.WebView元件也必須基於 WebKit,如第 3.4.1 節中所述。

實作可以在獨立的瀏覽器應用程式中提供自訂使用者代理字串。

獨立的瀏覽器應用程式(無論是基於上游 WebKit 瀏覽器應用程式還是第三方替代品)應該盡可能支援 HTML5 [參考資料,9 ]。設備實作至少必須支援與 HTML5 相關的每個 API:

此外,設備實作必須支援 HTML5/W3C webstorage API [參考資料,13 ],並且應該支援 HTML5/W3C IndexedDB API [參考資料,14 ]。請注意,隨著 Web 開發標準機構逐漸轉向支援 IndexedDB 而不是 Webstorage,IndexedDB 預計將成為 Android 未來版本中的必要組件。

3.5. API 行為相容性

每個 API 類型(託管、軟體、本機和 Web)的行為必須與上游 Android 開源專案的首選實作一致 [參考資料, 3 ]。一些特定的兼容性領域是:

  • 設備不得更改標準 Intent 的行為或語意
  • 設備不得更改特定類型系統元件(例如服務、活動、ContentProvider 等)的生命週期或生命週期語意
  • 設備不得更改標準權限的語意

上面的列表並不全面。相容性測試套件 (CTS) 測試平台的重要部分(但不是全部)的行為相容性。實作者有責任確保與 Android 開源專案的行為相容性。因此,裝置實現者應該盡可能使用透過 Android 開源專案提供的原始程式碼,而不是重新實作系統的重要部分。

3.6. API命名空間

Android 遵循 Java 程式語言定義的套件和類別命名空間約定。為了確保與第三方應用程式的相容性,裝置實作者不得對這些套件命名空間進行任何禁止的修改(見下文):

  • java.*
  • javax.*
  • 太陽。*
  • 安卓。*
  • com.android.*

禁止的修改包括:

  • 裝置實作不得透過更改任何方法或類別簽名,或刪除類別或類別欄位來修改 Android 平台上公開的 API。
  • 設備實作者可以修改 API 的底層實現,但此類修改不得影響任何公開暴露的 API 的規定行為和 Java 語言簽章。
  • 設備實作者不得為上述 API 新增任何公開暴露的元素(例如類別或接口,或現有類別或介面的欄位或方法)。

「公開暴露的元素」是指未使用上游 Android 原始碼中使用的「@hide」標記修飾的任何構造。換句話說,設備實現者不得公開新的 API 或更改上述命名空間中的現有 API。設備實現者可以進行僅限內部的修改,但這些修改不得公佈或以其他方式暴露給開發人員。

設備實作者可以新增自訂 API,但任何此類 API 不得位於另一個組織擁有或引用另一個組織的命名空間中。例如,裝置實作者不得將 API 新增至 com.google.* 或類似的命名空間;只有谷歌可以這樣做。同樣,Google 不得將 API 新增至其他公司的命名空間。此外,如果裝置實作包含標準 Android 命名空間之外的自訂 API,則這些 API 必須打包在 Android 共用程式庫中,以便只有明確使用它們(透過<uses-library>機制)的應用程式才會受到內存使用量增加的影響此類 API。

如果設備實現者建議改進上述包命名空間之一(例如透過向現有 API 添加有用的新功能,或添加新 API),則實現者應該訪問 source.android.com 並開始貢獻更改和的過程代碼,根據該網站上的信息。

請注意,上述限制對應於 Java 程式語言中命名 API 的標準約定;本節的目的只是為了加強這些約定,並透過將其納入此相容性定義來使其具有約束力。

3.7.虛擬機器相容性

裝置實作必須支援完整的 Dalvik 執行檔 (DEX) 字節碼規格和 Dalvik 虛擬機器語意 [參考資料, 15 ]。

螢幕分類為中密度或低密度的裝置實作必須配置 Dalvik 為每個應用程式分配至少 16MB 記憶體。螢幕分類為高密度或超高密度的裝置實作必須配置 Dalvik 為每個應用程式分配至少 24MB 記憶體。請注意,設備實作可能會分配比這些數字更多的記憶體。

3.8.使用者介面相容性

Android 平台包含一些開發人員 API,允許開發人員連接到系統使用者介面。設備實作必須將這些標準 UI API 合併到他們開發的自訂使用者介面中,如下所述。

3.8.1.小部件

Android 定義了元件類型以及相應的 API 和生命週期,允許應用程式向最終用戶公開「AppWidget」[參考資料,16 ]。 Android 開源參考版本包括一個 Launcher 應用程序,其中包含使用者介面元素,允許使用者在主畫面上新增、檢視和刪除 AppWidget。

設備實施者可以取代參考啟動器(即主螢幕)。替代啟動器應該包括對 AppWidget 的內建支持,並公開使用者介面元素以直接在啟動器內新增、配置、檢視和刪除 AppWidget。替代啟動器可以省略這些使用者介面元素;然而,如果它們被省略,設備實現者必須提供一個可從啟動器訪問的單獨應用程序,允許用戶添加、配置、查看和刪除 AppWidget。

3.8.2.通知

Android 包含的 API 允許開發人員通知使用者值得注意的事件 [參考資料,17 ]。設備實現者必須為如此定義的每一類通知提供支援;具體來說:聲音、振動、燈光和狀態列。

此外,實作必須正確呈現 API [資源,18 ] 或狀態列圖示樣式指南 [資源,19 ] 中提供的所有資源(圖示、聲音檔案等)。裝置實現者可以為通知提供替代的使用者體驗,而不是參考 Android 開源實作提供的體驗;然而,如上所述,此類替代通知系統必須支援現有通知資源。

Android 包含 API [參考資料,20 ],讓開發人員將搜尋合併到他們的應用程式中,並將應用程式的資料公開到全域系統搜尋中。一般來說,此功能由單一系統範圍的使用者介面組成,允許使用者輸入查詢、在使用者鍵入時顯示建議並顯示結果。 Android API 允許開發人員重複使用此介面在自己的應用程式中提供搜索,並允許開發人員向通用全域搜尋使用者介面提供結果。

設備實現必須包括一個單一的、共享的、系統範圍的搜尋使用者介面,能夠響應用戶輸入提供即時建議。設備實作必須實作允許開發人員重複使用此使用者介面以在自己的應用程式中提供搜尋的 API。設備實作必須實作 API,允許第三方應用程式在全域搜尋模式下運行時向搜尋框添加建議。如果沒有安裝使用此功能的第三方應用程序,則預設行為應該是顯示網路搜尋引擎結果和建議。

設備實作可以提供備用搜尋使用者介面,但應該包括硬或軟專用搜尋按鈕,可以隨時在任何應用程式中使用該按鈕來呼叫搜尋框架,並具有 API 文件中提供的行為。

3.8.4.吐司

應用程式可以使用「 Toast」 API(在[資源,21 ]中定義)向最終用戶顯示短的非模式字串,該字串在短時間後消失。設備實現必須以某種高可見性顯示從應用程式到最終用戶的吐司。

3.8.5。動態壁紙

Android定義了一種元件類型和相應的API和生命週期,該應用程式允許應用程式將一個或多個「 Live WallPapers」公開給最終用戶[ Resources,22 ]。即時壁紙是動畫,圖案或類似的圖像,其輸入功能有限,顯示為牆紙,在其他應用程式後面。

如果硬體能夠運行所有即時壁紙,則可以可靠地運行即時壁紙,而無需限制功能,並且在合理的幀率上沒有對其他應用程式不利影響。如果硬體中的限制導致壁紙和/或應用程式崩潰,故障,消耗過多的CPU或電池電量,或以不可接受的較低幀速率運行,則該硬體被認為無法運行Live Wallpaper。例如,某些即時桌布可以使用開放的GL 1.0或2.0上下文來渲染其內容。實時壁紙不會在不支援多個OpenGL上下文的硬體上可靠地運行,因為OpenGL上下文的即時壁紙使用可能與也使用OpenGL上下文的其他應用程式相抵觸。

如上所述,能夠可靠地運行即時壁紙的設備實現應實現即時壁紙。如上所述,確定不可靠地運行即時壁紙的設備實現不得實現即時壁紙。

4.應用程式包裝相容性

設備實作必須安裝並執行Android「 .apk」文件,該文件由官方Android SDK中包含的「 AAPT」工具產生[ Resources,23 ]。

裝置實作不得擴充.APK [資源,24 ],Android清單[資源,25 ]或Dalvik bytecode [ Resources,15 ]格式,以阻止這些檔案在其他相容裝置上正確安裝和運作的方式。設備實現者應使用DALVIK的參考上游實現以及參考實現的軟體包管理系統。

5.多媒體相容性

設備實作必須完全實現所有多媒體API。設備實作必須包括對下面描述的所有多媒體編解碼器的支持,並且應符合下面描述的聲音處理指南。設備實現必須包括至少一種形式的音訊輸出,例如揚聲器,耳機插孔,外部揚聲器連接等。

5.1.媒體編解碼器

設備實作必須支援以下各節中詳細介紹的多媒體編解碼器。所有這些編解碼器都是在Android開源專案的首選Android實作中作為軟體實現的。

請注意,Google和開放手機聯盟都沒有做出任何代表,即這些編解碼器不受第三方專利的影響。建議打算在硬體或軟體產品中使用此原始碼的人,該程式碼的實現(包括開源軟體或共享軟體)可能需要相關專利持有人的專利許可。

以下表不列出大多數視訊編解碼器的特定位元率要求。這樣做的原因是,實際上,目前設備硬體不一定支援精確映射到相關標準指定的位元率的位元率。取而代之的是,設備實現應在硬體上支援最高的位元率實用,直到規格定義的限制。

5.1.1.媒體解碼器

設備實作必須包括下表中所述的每個編解碼器和格式的解碼器的實作。請注意,上游Android開源專案為每種媒體類型的解碼器提供了解碼。

聲音的
姓名細節文件/容器格式
AAC LC/LTP單聲道/立體聲含量以高達160 kbps的標準位元率和8至48kHz的取樣率的任何組合3GPP(.3GP)和MPEG-4(.mp4,.m4a)。不支援RAW AAC(.AAC)
HE-AACV1(AAC+)
HE-AACV2(增強AAC+)
AMR-NB 4.75至12.2 kbps @ 8kHz採樣3GPP(.3GP)
AMR-WB 9率從6.60 kbit/s到23.85 kbit/s @ 16kHz 3GPP(.3GP)
MP3單聲道/立體聲8-320kbps常數(CBR)或可變位量(VBR) mp3(.mp3)
MIDI MIDI類型0和1。DLS版本1和2。XMF和移動XMF。支援鈴聲格式RTTTL/RTX,OTA和IMELODY類型0和1(.mid,.xmf,.mxmf)。還有rtttl/rtx(.rtttl,.rtx),ota(.ota)和imelody(.imy)
Ogg Vorbis ogg(.ogg)
相變材料8-和16位元線性PCM(速率達到硬體限制)波(.wav)
影像
JPEG基礎+漸進式
動圖
巴布亞紐幾內亞
骨形態發生蛋白
影片
H.263 3GPP(.3GP)文件
H.264 3GPP(.3GP)和MPEG-4(.MP4)文件
MPEG4簡單設定檔3GPP(.3GP)文件

5.1.2.媒體編碼

設備實作應包括第5.1.1節中所列的許多媒體格式的編碼器。盡可能。但是,對於缺乏某些可選硬體的設備,一些編碼器沒有意義。例如,如果設備缺少任何相機,則H.263視訊的編碼器是沒有意義的。因此,設備實作必須根據下表所述的條件實現媒體編碼器。

有關設備實現可能省略硬體的條件的詳細信息,請參見第7節。

聲音的
姓名細節文件/容器格式狀況
AMR-NB 4.75至12.2 kbps @ 8kHz採樣3GPP(.3GP)包括麥克風硬體和定義android.hardware.microphone裝置實作必須包括這些音訊格式的編碼器。
AMR-WB 9率從6.60 kbit/s到23.85 kbit/s @ 16kHz 3GPP(.3GP)
AAC LC/LTP單聲道/立體聲含量以高達160 kbps的標準位元率和8至48kHz的取樣率的任何組合3GPP(.3GP)和MPEG-4(.mp4,.m4a)。
影像JPEG基礎+漸進式所有裝置實作都必須包含這些映像格式的編碼器,因為Android 2.3包括API,應用程式可以用來程式設計來產生這些類型的檔案。
巴布亞紐幾內亞
影片H.263 3GPP(.3GP)文件設備實作包括相機硬體並定義android.hardware.cameraandroid.hardware.camera.front必須包含這些視訊格式的編碼器。

除了上面列出的編碼器外,設備實作還應包括H.264編碼器。請注意,計劃將來版本的兼容性定義將此要求更改為“必須”。也就是說,H.264編碼在Android 2.3中是可選的,但未來版本將需要非常強烈鼓勵運行Android 2.3的現有和新設備在Android 2.3中滿足這項要求,否則在升級到將來版本時,它們將無法獲得Android相容性。

5.2.聲音錄製

當應用程式使用android.media.AudioRecord API開始錄製音訊串流時,裝置實作應使用這些行為進行取樣和錄製音訊:

  • 降噪處理(如果存在)應停用。
  • 如果存在自動增益控制,則應停用。
  • 該設備應表現出大約平坦的幅度與頻率特性。具體而言,±3 dB,從100 Hz到4000 Hz
  • 應該設定音頻輸入靈敏度,以使1000 Hz的90 dB聲音源(SPL)源可為16位元樣品產生5000 rms。
  • PCM振幅水平應線性追蹤至少30 dB上的SPL變化,從-18 dB到+12 dB re 90 dB re 90 dB spl在麥克風上。
  • 在90 dB SPL輸入水準下,總諧波失真應小於1%至4000 Hz。

注意:儘管上面概述的要求為Android 2.3的“應該”,但計劃將未來版本的兼容性定義更改為“必須”。也就是說,這些要求在Android 2.3中是可選的,但是將來版本將需要非常強烈鼓勵運行Android 2.3的現有和新設備在Android 2.3中滿足這些要求,或者在升級到未來版本時,它們將無法獲得Android相容性。

5.3.音訊延遲

音訊延遲廣泛定義為應用程式請求音訊播放或記錄操作與裝置實現實際開始操作之間的間隔。許多類別的應用程式都依靠短延遲來實現即時效果,例如聲音效果或VoIP通訊。包含麥克風硬體和聲明android.hardware.microphone裝置實作應符合本節中概述的所有音訊延遲要求。有關設備實現可能省略麥克風硬體的條件的詳細信息,請參見第7節。

為本節的目的:

  • 「冷輸出延遲」被定義為應用程式請求播放和聲音開始播放時,音訊系統閒置並在請求之前關閉電源之間的間隔
  • 「溫暖的輸出延遲」定義為應用程式請求播放和聲音開始播放時,何時使用音訊系統的時間之間的間隔
  • 「連續輸出延遲」的定義是應用程式發行要播放的樣本與揚聲器物理播放相應聲音的間隔,而該設備當前正在播放音頻
  • 「冷輸入延遲」的定義是應用程式請求錄製和透過其回調傳遞到申請的錄音時,音訊系統和麥克風在請求之前閒置並關閉電源時的間隔
  • 「連續輸入延遲」的定義是在發生環境聲音的情況下以及透過其回調傳遞到錄音應用程式的樣本時,該裝置處於記錄模式

使用上述定義,設備實作應顯示這些屬性:

  • 100毫秒或更少的冷輸出潛伏期
  • 溫暖的輸出潛伏期為10毫秒或更少
  • 連續輸出潛伏期為45毫秒或更少
  • 100毫秒或更少的冷輸入潛伏期
  • 連續輸入延遲為50毫秒或更少

注意:儘管上面概述的要求為Android 2.3的“應該”,但計劃將未來版本的兼容性定義更改為“必須”。也就是說,這些要求在Android 2.3中是可選的,但是將來版本將需要非常強烈鼓勵運行Android 2.3的現有和新設備在Android 2.3中滿足這些要求,或者在升級到未來版本時,它們將無法獲得Android相容性。

如果設備實現符合本節的要求,則可以透過android.content.pm.PackageManager類別報告功能“ android.hardware.audio.low-latency”,透過報告“ android.hardware.audio.low-lat-latency ”的功能來報告對低延遲音訊的支援。 [ Resources,27 ]相反,如果設備實現不符合這些要求,則不得報告對低延遲音訊的支援。

6.開發人員工具相容性

設備實作必須支援Android SDK中提供的Android開發人員工具。具體而言,與Android相容的設備必須與:

  • Android調試橋(稱為ADB) [資源,23 ]
    設備實作必須支援Android SDK中記錄的所有adb功能。裝置側adb守護程式預設應無活動,但必須有一個可存取使用者的機制來開啟Android偵錯橋。
  • Dalvik調試監視器服務(稱為DDM) [資源,23 ]
    設備實作必須支援Android SDK中記錄的所有ddms功能。由於ddms使用adb ,因此預設情況下,對ddms的支援應無效,但每當使用者啟動Android Debug Bridge(如上所述)時,必須支援DDMS。
  • 猴子[資源,26 ]
    設備實作必須包括猴子框架,並使其可用於使用應用程式。

大多數基於Linux的系統和Apple Macintosh系統使用標準Android SDK工具識別Android設備,而無需額外支援;但是,Microsoft Windows系統通常需要新的Android裝置的驅動程式。 (例如,新的供應商ID和有時新設備ID需要Windows系統的自訂USB驅動程式。)如果adb工具無法按照標準Android SDK中提供的ADB工具識別設備實現,則設備實現者必須為Windows驅動程式提供允許開發人員連接到Windows驅動程式使用adb協定的裝置。這些驅動程式必須在32位元和64位元版本中為Windows XP,Windows Vista和Windows 7提供。

7. 硬體相容性

Android旨在使設備實施者能夠創建創新的形式和配置。同時,Android開發人員編寫了創新的應用程序,以依賴Android API可用的各種硬體和功能。本節中的要求在設備實施者可用的創新之間取得了平衡,開發人員的需求是確保其應用程式僅適用於可以正確運行的設備。

如果裝置包含具有針對第三方開發人員對應的API的特定硬體元件,則裝置實作必須如Android SDK文件中所述實作該API。如果SDK中的API與指定為選購的硬體元件相互作用,且設備實作不具備該元件:

  • 組件API的完整類別定義(如SDK所記錄)仍然必須存在
  • API的行為必須以某種合理的方式實現為無措施
  • API方法必須在SDK文件允許的情況下傳回null值
  • API方法必須傳回SDK文件不允許未允許的null值的類別的NO-OP實現
  • API方法不得拋出SDK文件未記錄的異常

這些需求適用的方案的一個典型範例是電話API:即使在非電話設備上,這些API也必須實作為合理的NO-OPS。

設備實作必須透過android.content.pm.PackageManager類別上的getSystemAvailableFeatures()hasSystemFeature(String)方法準確地報告準確的硬體配置資訊。 [資源,27 ]

7.1.顯示和圖形

Android 2.3包括適當地調整應用程式資產和UI佈局的設施,以確保第三方應用程式在各種硬體配置上運作良好[ Resources,28 ]。如本節所述,設備必須正確實施這些API和行為。

7.1.1.螢幕配置

設備實現可以使用任何像素尺寸的螢幕,只要它們符合以下要求:

  • 螢幕必須至少為2.5英寸
  • 密度必須至少100 dpi
  • 長寬比必須在1.333(4:3)和1.779(16:9)之間
  • 所使用的顯示技術由方形像素組成

具有螢幕滿足的裝置實現以上要求是相容的,無需採取其他措施。 Android框架實作會自動計算顯示特徵,例如螢幕尺寸儲存桶和密度儲存桶。在大多數情況下,框架決策是正確的決定。如果使用預設框架計算,則無需其他操作。希望更改預設設備的設備實施者,或使用不符合上述要求的螢幕,必須與第12節規定的指導聯繫以進行指導。

上述要求使用的單元定義如下:

  • 「物理對角線大小」是顯示器點亮部分的兩個相對角的距離。
  • 「 DPI」(意思是「每英吋點」)是由1英吋的線性水平或垂直跨度所包含的像素的數量。列出了DPI值,水平和垂直DPI都必須在該範圍內。
  • 「縱橫比」是螢幕較長維與較短維度的比率。例如,480x854像素的顯示為854 /480 = 1.779,或大致為「 16:9」。

設備實作必須僅使用具有單一靜態配置的顯示。也就是說,設備實作不得啟用多個螢幕配置。例如,由於典型的電視支援多種分辨率,例如1080p,720p等,因此這種配置與Android 2.3不相容。 (但是,對此類配置的支援正在研究,並計劃為未來版本的Android。)

7.1.2.顯示指標

設備實作必須報告android.util.DisplayMetrics中定義的所有顯示指標的正確值[ Resources,29 ]。

7.1.3.聲明為螢幕支持

應用程式可選擇地指示透過<Supports-Screens> AndroidManifest.xml檔案中的<supports-screens>屬性支援的螢幕大小。裝置實作必須正確地尊重應用程式對Android SDK文件中所述的小型,中和大螢幕的指定支援。

7.1.4.螢幕方向

相容的裝置必須透過應用程式來支援肖像或景觀螢幕方向的動態方向。也就是說,設備必須尊重應用程式的特定螢幕方向請求。設備實作可以選擇肖像或景觀方向作為預設設備。無法實際旋轉的裝置可以透過僅使用可用顯示的一部分請求肖像模式的「信箱」應用程式來滿足此要求。

每當透過android.content.res.configuration.orientation,android.view.display.getorientation()或其他apis查詢時,裝置必須報告裝置目前方向的正確值。

7.1.5。 3D圖形加速度

設備實作必須依照Android 2.3 API的要求支援OpenGL ES 1.0。對於缺乏3D加速硬體的設備,上游Android開源專案提供了OpenGL ES 1.0的軟體實作。設備實作應支援OpenGL ES 2.0。

實作可能會省略Open GL ES 2.0支援;但是,如果省略了支持,則設備實作不得報告為支援OpenGL ES 2.0。具體而言,如果設備實現缺乏OpenGL ES 2.0支援:

  • 託管API(例如透過GLES10.getString()方法)不得報告對OpenGL ES 2.0的支持
  • 本機C/C ++ OpenGL API(即透過libgles_v1cm.so,libgles_v2.so或libegl.so提供的應用程式可用於應用程式的API),不得報告對OpenGL ES 2.0的支援。

相反,如果設備實現確實支援OpenGL ES 2.0,則必須準確地透過剛剛列出的路由報告支援。

請注意,Android 2.3包括對應用程式的支持,以期指定它們需要特定的OpenGL紋理壓縮格式。這些格式通常是特定於供應商的。 Android 2.3不需要裝置實作來實現任何特定的紋理壓縮格式。但是,他們應透過OpenGL API中的getString()方法準確地報告所支援的任何紋理壓縮格式。

7.2.輸入裝置

Android 2.3支援用戶輸入的多種方式。設備實作必須支援本節規定的使用者輸入設備。

7.2.1.鍵盤

設備實現:

  • 必須包括對輸入管理框架的支援(該框架允許第三方開發人員創建輸入管理引擎 - 即軟鍵盤),如開發人員。
  • 必須至少提供一個軟鍵盤實現(無論是否存在硬鍵盤)
  • 可能包括其他軟鍵盤實現
  • 可能包括硬體鍵盤
  • 不得包含與android.content.res.Configuration.keyboard [ Resources,30 ]中指定的格式之一的硬體鍵盤(即,Qwerty或12-key)

7.2.2.非接觸導航

設備實現:

  • 可能會省略非接觸式導覽選項(即可能省略軌跡球,D-pad或車輪)
  • 必須報告android.content.res.Configuration.navigation的正確值[ Resources,30 ]
  • 必須提供合理的替代使用者介面機制,以選擇和編輯文本,與輸入管理引擎相容。上游的Android開源程式碼包含一種選擇機制,適用於缺少非接觸導航輸入的裝置。

7.2.3.導航鍵

房屋,選單和背部功能對於Android導航範式至關重要。設備實作必須使這些功能始終為使用者提供,而不論應用程式狀態如何。這些功能應透過專用按鈕實現。它們可以使用軟體,手勢,觸控面板等實現,但是如果這樣,它們必須始終可訪問,並且不會遮蓋或乾擾可用的應用顯示區域。

設備實現者還應提供專用的搜尋鍵。設備實施者還可以為電話提供發送和結束鍵。

7.2.4.觸控螢幕輸入

設備實現:

  • 必須有觸控螢幕
  • 可能具有電容或電阻觸控螢幕
  • 必須報告android.content.res.Configuration [資源,30 ]的值
  • 如果觸控螢幕支援多個指針,則應支援完全獨立追蹤的指針

7.3.感應器

Android 2.3包括用於存取各種感測器類型的API。設備實作通常可能會省略以下小節中規定的這些感測器。如果裝置包含具有針對第三方開發人員的對應API的特定感測器類型,則裝置實作必須如Android SDK文件中所述實作該API。例如,設備實作:

  • 必須按android.content.pm.PackageManager類別準確地報告感測器的存在或不存在。 [資源,27 ]
  • 必須透過SensorManager.getSensorList()和類似的方法返回準確的受支援感測器的列表
  • 必須對所有其他感測器API進行合理的行為(例如,當應用程式試圖註冊聽眾時,在適當的情況下返回True或False,而在不存在相應的感測器時不要呼叫感測器偵聽器;等)

上面的列表不全面; Android SDK的記錄行為應被視為權威。

某些感測器類型是合成的,這意味著它們可以從一個或多個其他感測器提供的數據中得出。 (例如方向感測器和線性加速度感測器。)設備實現應在包含先決條件的物理感測器時實現這些感測器類型。

Android 2.3 API引入了「串流」感測器的概念,該概念是連續返回資料的概念,而不是僅在資料變更時。裝置實作必須持續為Android 2.3 SDK文件指示的任何API提供定期資料範例,以作為串流感測器。

7.3.1.加速度計

設備實現應包括3軸加速度計。如果設備實現確實包括3軸加速度計,則它:

  • 必須能夠以50 Hz或更高
  • 必須遵守Android API中詳細介紹的Android感測器座標系(請參閱[資源,31 ])
  • 必須能夠在任何三維向量上從自由降臨到兩次重力(2g)或更多的重力測量
  • 必須具有8位準確性或更多
  • 必須有不超過0.05 m/s^2的標準差

7.3.2.磁力計

設備實現應包括3軸磁力計(即指南針)。

  • 必須能夠在10 Hz或更高的情況下提供活動
  • 必須遵守Android API中詳細介紹的Android感測器座標系(請參閱[資源,31 ])。
  • 必須能夠對足以覆蓋地磁場的一系列場強度進行採樣
  • 必須具有8位準確性或更多
  • 必須具有不超過0.5 µt的標準差

7.3.3.全球定位系統

設備實作應包括GPS接收器。如果設備實作確實包括GPS接收器,則應包括某種形式的「輔助GPS」技術,以最大程度地減少GPS鎖定時間。

7.3.4.陀螺儀

設備的實現應包括陀螺儀(即角更換感測器。)設備不應包括陀螺儀感測器,除非還包括3軸加速度計。如果設備實作包括陀螺儀,則它:

  • 必須能夠測量最高5.5*pi弧度/秒的方向變化(即每秒約1,000度)
  • 必須能夠以100 Hz或更高
  • 必須具有8位準確性或更多

7.3.5。晴雨表

設備實現可能包括晴雨表(即環境氣壓感測器)。如果設備實現包括晴雨表,則包括:

  • 必須能夠在5 Hz或更高的情況下提供活動
  • 必須具有足夠的精度才能估算高度

7.3.7.溫度計

設備實現可能但不應包括溫度計(IE溫度感測器)。如果設備實現確實包括溫度計,則必須測量設備CPU的溫度。它不能測量任何其他溫度。 (請注意,此感測器類型是在Android 2.3 API中棄用的)。

7.3.7.光度計

設備實現可能包括光度計(即環境光感測器。)

7.3.8.接近感測器

設備實現可能包括接近感測器。如果設備實現確實包括接近感測器,則必須在與螢幕相同的方向上測量物件的接近度。也就是說,必須將接近感測器定向以檢測靠近螢幕的對象,因為該感測器類型的主要目的是檢測使用者使用的手機。如果裝置實作包括具有任何其他方向的接近感測器,則不得透過此API存取它。如果設備實現具有接近性感測器,則必須具有1位元準確性或更高。

7.4.數據連接

網路連線和存取Internet是Android的重要特徵。同時,設備到設備的交互作用為Android設備和應用增加了顯著的價值。設備實作必須滿足本節中的資料連接要求。

7.4.1.電話

Android 2.3 API所使用的「電話」和此文件特別指的是與放置語音通話和透過GSM或CDMA網路傳送SMS訊息有關的硬體。儘管這些語音呼叫可能會切換或可能不會切換,但它們是出於Android 2.3的目的,被認為是獨立於使用相同網路實現的任何資料連接性的。換句話說,Android「電話」功能和API專門指的是語音通話和SMS;例如,無法放置通話或傳送/接收SMS訊息的裝置實作不得報告「 android.hardware.telephony」功能或任何子功能,無論它們是否使用蜂巢式網路進行資料連接。

Android 2.3可以在不包括電話硬體的裝置上使用。也就是說,Android 2.3與不是電話的裝置相容。但是,如果設備實作確實包括GSM或CDMA電話,則必須為該技術實施全面支援。不包括電話硬體的設備實作必須將完整的API作為NO-OPS實作。

7.4.2. IEEE 802.11(wifi)

Android 2.3裝置實作應包括對802.11的一種或多種形式的支援(B/G/A/N等),如果裝置實作確實包括對802.11的支持,則必須實作對應的Android API。

7.4.3.藍牙

設備實作應包括藍牙收發器。確實包含藍牙收發器的裝置實作必須啟用基於RFCOMM的藍牙API,如SDK文件[ Resources,32 ]所述。設備實現應實現相關的藍牙配置文件,例如A2DP,AVRCP,OBEX等。

相容性測試套件包括涵蓋Android RFCOMM藍牙API的基本操作的案例。但是,由於藍牙是設備之間的通訊協議,因此無法透過在單一裝置上執行的單元測試對其進行全面測試。因此,設備實作也必須通過附錄A中所述的人類驅動藍牙測試程序。

7.4.4.近場通訊

設備實作應包括用於近場通訊(NFC)的收發器和相關硬體。如果設備實現確實包括NFC硬件,則它:

  • 必須從android.content.pm.PackageManager.hasSystemFeature()方法報告Android.hardware.nfc功能。 [資源,27 ]
  • 必須能夠透過以下NFC標準閱讀和編寫NDEF訊息:
    • 必須能夠透過以下NFC標準充當NFC論壇讀者/作者(NFC論壇技術規格NFCFORUM-TS-DIGITAL-PROTOCOCOL-1.0):
      • NFCA(ISO14443-3A)
      • NFCB(ISO14443-3B)
      • NFCF(JIS 6319-4)
      • NFCV(ISO 15693)
      • ISODEP(ISO 14443-4)
      • NFC論壇標籤類型1、2、3、4(由NFC論壇定義)
    • 必須能夠透過以下對等標準和協定傳輸和接收資料:
      • ISO 18092
      • LLCP 1.0(由NFC論壇定義)
      • SDP 1.0(由NFC論壇定義)
      • NDEF推定協議[資源,33 ]
    • 必須在NFC發現模式下掃描所有支援的技術。
    • 當設備醒著時,應處於NFC發現模式。

    (請注意,上述引用的JIS,ISO和NFC論壇規格不可公開可用的連結。)

    此外,設備實作應支援以下廣泛部署的Mifare技術。

    請注意,Android 2.3.3包括這些Mifare類型的API。如果設備實作支援Mifare,則它:

    • 必須實作Android SDK記錄的相應的Android API
    • 必須從android.content.pm.PackageManager.hasSystemFeature()方法報告功能com.nxp.mifare。 [ Resources,27 ]請注意,這不是標準的Android功能,因此在PackageManager類別中並不是一個常數。
    • 不得實現相應的Android API,也不必須報告Com.nxp.Mifare功能,除非它也如本節所述實現一般NFC支持

    如果設備實作不包括NFC硬件,則不得從android.content.pm.PackageManager.hasSystemFeature()方法[資源,27 ]聲明Android.hardware.nfc功能,並且必須實作Android 2.3 NFC API為NFC API一個no-op 。

    如同類別android.nfc.NdefMessageandroid.nfc.NdefRecord代表獨立於協定的資料表示格式一樣,裝置實作即使它們不包括對NFC的支援或宣告Android.hardware.nfc功能,裝置實作也必須實作這些API。

    7.4.5。最小網路能力

    設備實作必須包括對一種或多種形式的資料網路的支援。具體而言,設備實作必須包括至少一個能夠為200kbit/sec或更高的資料標準的支援。滿足此要求的技術的範例包括Edge,HSPA,EV-DO,802.11g,乙太網路等。

    Device implementations where a physical networking standard (such as Ethernet) is the primary data connection SHOULD also include support for at least one common wireless data standard, such as 802.11 (WiFi).

    Devices MAY implement more than one form of data connectivity.

    7.5。相機

    Device implementations SHOULD include a rear-facing camera, and MAY include a front-facing camera. A rear-facing camera is a camera located on the side of the device opposite the display; that is, it images scenes on the far side of the device, like a traditional camera. A front-facing camera is a camera located on the same side of the device as the display; that is, a camera typically used to image the user, such as for video conferencing and similar applications.

    7.5.1.後置攝像頭

    Device implementations SHOULD include a rear-facing camera. If a device implementation includes a rear-facing camera, it:

    • MUST have a resolution of at least 2 megapixels
    • SHOULD have either hardware auto-focus, or software auto-focus implemented in the camera driver (transparent to application software)
    • MAY have fixed-focus or EDOF (extended depth of field) hardware
    • MAY include a flash. If the Camera includes a flash, the flash lamp MUST NOT be lit while an android.hardware.Camera.PreviewCallback instance has been registered on a Camera preview surface, unless the application has explicitly enabled the flash by enabling the FLASH_MODE_AUTO or FLASH_MODE_ON attributes of a Camera.Parameters object. Note that this constraint does not apply to the device's built-in system camera application, but only to third-party applications using Camera.PreviewCallback .

    7.5.2.前置鏡頭

    Device implementations MAY include a front-facing camera. If a device implementation includes a front-facing camera, it:

    • MUST have a resolution of at least VGA (that is, 640x480 pixels)
    • MUST NOT use a front-facing camera as the default for the Camera API. That is, the camera API in Android 2.3 has specific support for front-facing cameras, and device implementations MUST NOT configure the API to to treat a front-facing camera as the default rear-facing camera, even裝置。
    • MAY include features (such as auto-focus, flash, etc.) available to rear-facing cameras as described in Section 7.5.1.
    • MUST horizontally reflect (ie mirror) the stream displayed by an app in a CameraPreview, as follows:
      • If the device implementation is capable of being rotated by user (such as automatically via an accelerometer or manually via user input), the camera preview MUST be mirrored horizontally relative to the device's current orientation.
      • If the current application has explicitly requested that the Camera display be rotated via a call to the android.hardware.Camera.setDisplayOrientation() [ Resources, 40 ] method, the camera preview MUST be mirrored horizontally relative to the orientation specified by the application.
      • Otherwise, the preview MUST be mirrored along the device's default horizontal axis.
    • MUST mirror the image data returned to any "postview" camera callback handlers, in the same manner as the camera preview image stream. (If the device implementation does not support postview callbacks, this requirement obviously does not apply.)
    • MUST NOT mirror the final captured still image or video streams returned to application callbacks or committed to media storage

    7.5.3.相機 API 行為

    Device implementations MUST implement the following behaviors for the camera-related APIs, for both front- and rear-facing cameras:

    1. If an application has never called android.hardware.Camera.Parameters.setPreviewFormat(int), then the device MUST use android.hardware.PixelFormat.YCbCr_420_SP for preview data provided to application callbacks.
    2. If an application registers an android.hardware.Camera.PreviewCallback instance and the system calls the onPreviewFrame() method when the preview format is YCbCr_420_SP, the data in the byte[] passed into onPreviewFrame() must further be in the NV21 encoding format. That is, NV21 MUST be the default.
    3. Device implementations SHOULD support the YV12 format (as denoted by the android.graphics.ImageFormat.YV12 constant) for camera previews for both front- and rear-facing cameras. Note that the Compatibility Definition for a future version is planned to change this requirement to "MUST". That is, YV12 support is optional in Android 2.3 but will be required by a future version. Existing and new devices that run Android 2.3 are very strongly encouraged to meet this requirement in Android 2.3 , or they will not be able to attain Android compatibility when upgraded to the future version.

    Device implementations MUST implement the full Camera API included in the Android 2.3 SDK documentation [ Resources, 41 ]), regardless of whether the device includes hardware autofocus or other capabilities. For instance, cameras that lack autofocus MUST still call any registered android.hardware.Camera.AutoFocusCallback instances (even though this has no relevance to a non-autofocus camera.) Note that this does apply to front-facing cameras; for instance, even though most front-facing cameras do not support autofocus, the API callbacks must still be "faked" as described.

    Device implementations MUST recognize and honor each parameter name defined as a constant on the android.hardware.Camera.Parameters class, if the underlying hardware supports the feature. If the device hardware does not support a feature, the API must behave as documented. Conversely, Device implementations MUST NOT honor or recognize string constants passed to the android.hardware.Camera.setParameters() method other than those documented as constants on the android.hardware.Camera.Parameters . That is, device implementations MUST support all standard Camera parameters if the hardware allows, and MUST NOT support custom Camera parameter types.

    7.5.4.相機方向

    Both front- and rear-facing cameras, if present, MUST be oriented so that the long dimension of the camera aligns with the screen's long dimension. That is, when the device is held in the landscape orientation, a cameras MUST capture images in the landscape orientation. This applies regardless of the device's natural orientation; that is, it applies to landscape-primary devices as well as portrait-primary devices.

    7.6。記憶體和儲存

    The fundamental function of Android 2.3 is to run applications. Device implementations MUST the requirements of this section, to ensure adequate storage and memory for applications to run properly.

    7.6.1. Minimum Memory and Storage

    Device implementations MUST have at least 128MB of memory available to the kernel and userspace. The 128MB MUST be in addition to any memory dedicated to hardware components such as radio, memory, and so on that is not under the kernel's control.

    Device implementations MUST have at least 150MB of non-volatile storage available for user data. That is, the /data partition MUST be at least 150MB.

    Beyond the requirements above, device implementations SHOULD have at least 1GB of non-volatile storage available for user data. Note that this higher requirement is planned to become a hard minimum in a future version of Android. Device implementations are strongly encouraged to meet these requirements now, or else they may not be eligible for compatibility for a future version of Android.

    The Android APIs include a Download Manager that applications may use to download data files. The Download Manager implementation MUST be capable of downloading individual files 55MB in size, or larger. The Download Manager implementation SHOULD be capable of downloading files 100MB in size, or larger.

    7.6.2. Application Shared Storage

    Device implementations MUST offer shared storage for applications. The shared storage provided MUST be at least 1GB in size.

    Device implementations MUST be configured with shared storage mounted by default, "out of the box". If the shared storage is not mounted on the Linux path /sdcard , then the device MUST include a Linux symbolic link from /sdcard to the actual mount point.

    Device implementations MUST enforce as documented the android.permission.WRITE_EXTERNAL_STORAGE permission on this shared storage. Shared storage MUST otherwise be writable by any application that obtains that permission.

    Device implementations MAY have hardware for user-accessible removable storage, such as a Secure Digital card. Alternatively, device implementations MAY allocate internal (non-removable) storage as shared storage for apps.

    Regardless of the form of shared storage used, device implementations MUST provide some mechanism to access the contents of shared storage from a host computer, such as USB mass storage or Media Transfer Protocol.

    It is illustrative to consider two common examples. If a device implementation includes an SD card slot to satisfy the shared storage requirement, a FAT-formatted SD card 1GB in size or larger MUST be included with the device as sold to users, and MUST be mounted by default. Alternatively, if a device implementation uses internal fixed storage to satisfy this requirement, that storage MUST be 1GB in size or larger and mounted on /sdcard (or /sdcard MUST be a symbolic link to the physical location if it is mounted elsewhere.)

    Device implementations that include multiple shared storage paths (such as both an SD card slot and shared internal storage) SHOULD modify the core applications such as the media scanner and ContentProvider to transparently support files placed in both locations.

    7.7. USB

    設備實現:

    • MUST implement a USB client, connectable to a USB host with a standard USB-A port
    • MUST implement the Android Debug Bridge over USB (as described in Section 7)
    • MUST implement the USB mass storage specification, to allow a host connected to the device to access the contents of the /sdcard volume
    • SHOULD use the micro USB form factor on the device side
    • MAY include a non-standard port on the device side, but if so MUST ship with a cable capable of connecting the custom pinout to standard USB-A port

    8. Performance Compatibility

    Compatible implementations must ensure not only that applications simply run correctly on the device, but that they do so with reasonable performance and overall good user experience. Device implementations MUST meet the key performance metrics of an Android 2.3 compatible device defined in the table below:

    公制Performance Threshold評論
    Application Launch Time The following applications should launch within the specified time.
    • Browser: less than 1300ms
    • MMS/SMS: less than 700ms
    • AlarmClock: less than 650ms
    The launch time is measured as the total time to complete loading the default activity for the application, including the time it takes to start the Linux process, load the Android package into the Dalvik VM, and call onCreate.
    Simultaneous Applications When multiple applications have been launched, re-launching an already-running application after it has been launched must take less than the original launch time.

    9. Security Model Compatibility

    Device implementations MUST implement a security model consistent with the Android platform security model as defined in Security and Permissions reference document in the APIs [ Resources, 42 ] in the Android developer documentation. Device implementations MUST support installation of self-signed applications without requiring any additional permissions/certificates from any third parties/authorities. Specifically, compatible devices MUST support the security mechanisms described in the follow sub-sections.

    9.1.權限

    Device implementations MUST support the Android permissions model as defined in the Android developer documentation [ Resources, 42 ]. Specifically, implementations MUST enforce each permission defined as described in the SDK documentation; no permissions may be omitted, altered, or ignored. Implementations MAY add additional permissions, provided the new permission ID strings are not in the android.* namespace.

    9.2. UID and Process Isolation

    Device implementations MUST support the Android application sandbox model, in which each application runs as a unique Unix-style UID and in a separate process. Device implementations MUST support running multiple applications as the same Linux user ID, provided that the applications are properly signed and constructed, as defined in the Security and Permissions reference [ Resources, 42 ].

    9.3. Filesystem Permissions

    Device implementations MUST support the Android file access permissions model as defined in as defined in the Security and Permissions reference [ Resources, 42 ].

    9.4. Alternate Execution Environments

    Device implementations MAY include runtime environments that execute applications using some other software or technology than the Dalvik virtual machine or native code. However, such alternate execution environments MUST NOT compromise the Android security model or the security of installed Android applications, as described in this section.

    Alternate runtimes MUST themselves be Android applications, and abide by the standard Android security model, as described elsewhere in Section 9.

    Alternate runtimes MUST NOT be granted access to resources protected by permissions not requested in the runtime's AndroidManifest.xml file via the <uses-permission> mechanism.

    Alternate runtimes MUST NOT permit applications to make use of features protected by Android permissions restricted to system applications.

    Alternate runtimes MUST abide by the Android sandbox model.具體來說:

    • Alternate runtimes SHOULD install apps via the PackageManager into separate Android sandboxes (that is, Linux user IDs, etc.)
    • Alternate runtimes MAY provide a single Android sandbox shared by all applications using the alternate runtime.
    • Alternate runtimes and installed applications using an alternate runtime MUST NOT reuse the sandbox of any other app installed on the device, except through the standard Android mechanisms of shared user ID and signing certificate
    • Alternate runtimes MUST NOT launch with, grant, or be granted access to the sandboxes corresponding to other Android applications.

    Alternate runtimes MUST NOT be launched with, be granted, or grant to other applications any privileges of the superuser (root), or of any other user ID.

    The .apk files of alternate runtimes MAY be included in the system image of a device implementation, but MUST be signed with a key distinct from the key used to sign other applications included with the device implementation.

    When installing applications, alternate runtimes MUST obtain user consent for the Android permissions used by the application. That is, if an application needs to make use of a device resource for which there is a corresponding Android permission (such as Camera, GPS, etc.), the alternate runtime MUST inform the user that the application will will resource 。 If the runtime environment does not record application capabilities in this manner, the runtime environment MUST list all permissions held by the runtime itself when installing any application using that runtime.

    10. Software Compatibility Testing

    The Android Open-Source Project includes various testing tools to verify that device implementations are compatible. Device implementations MUST pass all tests described in this section.

    However, note that no software test package is fully comprehensive. For this reason, device implementers are very strongly encouraged to make the minimum number of changes as possible to the reference and preferred implementation of Android 2.3 available from the Android Open-Source Project. This will minimize the risk of introducing bugs that create incompatibilities requiring rework and potential device updates.

    10.1.相容性測試套件

    Device implementations MUST pass the Android Compatibility Test Suite (CTS) [ Resources, 2 ] available from the Android Open Source Project, using the final shipping software on the device. Additionally, device implementers SHOULD use the reference implementation in the Android Open Source tree as much as possible, and MUST ensure compatibility in cases of ambiguity in CTS and for any reimplementations of parts of the reference source code.

    The CTS is designed to be run on an actual device. Like any software, the CTS may itself contain bugs. The CTS will be versioned independently of this Compatibility Definition, and multiple revisions of the CTS may be released for Android 2.3. Device implementations MUST pass the latest CTS version available at the time the device software is completed.

    MUST pass the most recent version of the Android Compatibility Test Suite (CTS) available at the time of the device implementation's software is completed. (The CTS is available as part of the Android Open Source Project [ Resources, 2 ].) The CTS tests many, but not all, of the components outlined in this document.

    10.2. CTS驗證器

    Device implementations MUST correctly execute all applicable cases in the CTS Verifier. The CTS Verifier is included with the Compatibility Test Suite, and is intended to be run by a human operator to test functionality that cannot be tested by an automated system, such as correct functioning of a camera and sensors.

    The CTS Verifier has tests for many kinds of hardware, including some hardware that is optional. Device implementations MUST pass all tests for hardware which they possess; for instance, if a device possesses an accelerometer, it MUST correctly execute the Accelerometer test case in the CTS Verifier. Test cases for features noted as optional by this Compatibility Definition Document MAY be skipped or omitted.

    Every device and every build MUST correctly run the CTS Verifier, as noted above. However, since many builds are very similar, device implementers are not expected to explicitly run the CTS Verifier on builds that differ only in trivial ways. Specifically, device implementations that differ from an implementation that has passed the CTS Verfier only by the set of included locales, branding, etc. MAY omit the CTS Verifier test.

    10.3. Reference Applications

    Device implementers MUST test implementation compatibility using the following open-source applications:

    • The "Apps for Android" applications [ Resources, 43 ].
    • Replica Island (available in Android Market; only required for device implementations that support with OpenGL ES 2.0)

    Each app above MUST launch and behave correctly on the implementation, for the implementation to be considered compatible.

    11. Updatable Software

    Device implementations MUST include a mechanism to replace the entirety of the system software. The mechanism need not perform "live" upgrades -- that is, a device restart MAY be required.

    Any method can be used, provided that it can replace the entirety of the software preinstalled on the device. For instance, any of the following approaches will satisfy this requirement:

    • Over-the-air (OTA) downloads with offline update via reboot
    • "Tethered" updates over USB from a host PC
    • "Offline" updates via a reboot and update from a file on removable storage

    The update mechanism used MUST support updates without wiping user data. Note that the upstream Android software includes an update mechanism that satisfies this requirement.

    If an error is found in a device implementation after it has been released but within its reasonable product lifetime that is determined in consultation with the Android Compatibility Team to affect the compatibility of third-party applications, the device implementer MUST correct the error via a software update available that can be applied per the mechanism just described.

    12. Contact Us

    You can contact the document authors at compatibility@android.com for clarifications and to bring up any issues that you think the document does not cover.

    Appendix A - Bluetooth Test Procedure

    The Compatibility Test Suite includes cases that cover basic operation of the Android RFCOMM Bluetooth API. However, since Bluetooth is a communications protocol between devices, it cannot be fully tested by unit tests running on a single device. Consequently, device implementations MUST also pass the human-operated Bluetooth test procedure described below.

    The test procedure is based on the BluetoothChat sample app included in the Android open-source project tree. The procedure requires two devices:

    • a candidate device implementation running the software build to be tested
    • a separate device implementation already known to be compatible, and of a model from the device implementation being tested -- that is, a "known good" device implementation

    The test procedure below refers to these devices as the "candidate" and "known good" devices, respectively.

    Setup and Installation

    1. Build BluetoothChat.apk via 'make samples' from an Android source code tree.
    2. Install BluetoothChat.apk on the known-good device.
    3. Install BluetoothChat.apk on the candidate device.

    Test Bluetooth Control by Apps

    1. Launch BluetoothChat on the candidate device, while Bluetooth is disabled.
    2. Verify that the candidate device either turns on Bluetooth, or prompts the user with a dialog to turn on Bluetooth.

    Test Pairing and Communication

    1. Launch the Bluetooth Chat app on both devices.
    2. Make the known-good device discoverable from within BluetoothChat (using the Menu).
    3. On the candidate device, scan for Bluetooth devices from within BluetoothChat (using the Menu) and pair with the known-good device.
    4. Send 10 or more messages from each device, and verify that the other device receives them correctly.
    5. Close the BluetoothChat app on both devices by pressing Home .
    6. Unpair each device from the other, using the device Settings app.

    Test Pairing and Communication in the Reverse Direction

    1. Launch the Bluetooth Chat app on both devices.
    2. Make the candidate device discoverable from within BluetoothChat (using the Menu).
    3. On the known-good device, scan for Bluetooth devices from within BluetoothChat (using the Menu) and pair with the candidate device.
    4. Send 10 or messages from each device, and verify that the other device receives them correctly.
    5. Close the Bluetooth Chat app on both devices by pressing Back repeatedly to get to the Launcher.

    Test Re-Launches

    1. Re-launch the Bluetooth Chat app on both devices.
    2. Send 10 or messages from each device, and verify that the other device receives them correctly.

    Note: the above tests have some cases which end a test section by using Home, and some using Back. These tests are not redundant and are not optional: the objective is to verify that the Bluetooth API and stack works correctly both when Activities are explicitly terminated (via the user pressing Back, which calls finish()), and implicitly sent to background (via the user pressing Home.) Each test sequence MUST be performed as described.