Android 2.1 平台

API 級別： 7

Android 2.1 是次要平台版本，自 2010 年 1 月起可部署至搭載 Android 的手機。這個版本包含新的 API 變更和修正錯誤。如要瞭解變更，請參閱「Framework API」一節。

對開發人員來說，Android 2.1 平台是 Android SDK 的可下載元件。這個可下載平台包含一個完全相容的 Android 程式庫和系統映像檔，以及一組模擬器外觀、範例應用程式等。可下載的平台不含任何外部程式庫。

如要開始針對 Android 2.1 平台進行開發或測試，請使用 Android SDK 和 AVD Manager 工具將平台下載到 SDK。

平台特色

Android 2.1 並未新增重要的使用者功能。如要瞭解最新的使用者功能，請參閱 Android 2.0 平台重點功能文件。

修訂版本

下列各節針對 Android SDK 適用的 Android 2.1 平台元件後續版本提供版本資訊，如修訂版本編號所示。如要判斷 Android 2.1 平台在 SDK 環境中安裝的修訂版本為何，請參閱 Android SDK 和 AVD Manager 中的「已安裝套件」清單。

Android 2.1，修訂版本 3 (2011 年 7 月)

依附元件：

需要 SDK Tools r12 以上版本。

注意：

改善平台的算繪資料庫，以支援 ADT Eclipse 外掛程式中的視覺版面配置編輯器。此修訂版本在 ADT 中提供更多繪圖功能，並修正了舊版算繪程式庫中的多項錯誤。亦可解鎖 ADT 12 新增的幾項編輯器功能。

Android 2.1，修訂版本 2 (2010 年 5 月)

依附元件：

需要 SDK Tools r6 以上版本。

工具：

• 新增對 Ant 建構系統中程式庫專案的支援。
• 在 ADT 的視覺版面配置編輯器中，新增改善版面配置的轉譯功能。

Android 2.1，修訂版本 1 (2010 年 1 月)

依附元件：

需要 SDK Tools r4 以上版本。

API 級別

Android 2.1 平台提供新版架構 API。Android 2.1 API 會獲派一個整數 ID (7)，該 ID 儲存在系統本身中。這個 ID 稱為「API 級別」，可讓系統在安裝應用程式之前正確判斷應用程式是否與系統相容。

如要在應用程式中使用 Android 2.1 中導入的 API，必須在應用程式資訊清單中 <uses-sdk> 元素的 android:minSdkVersion 屬性中設定適當的值「7」。

如要進一步瞭解如何使用 API 級別，請參閱 API 級別文件。

架構 API 變更

以下各節提供 Android 2.1 平台所提供應用程式架構 API 的變更資訊。

動態桌布

下列新增功能提供的 API 可用於開發動畫桌布：

• 新增 android.service.wallpaper 套件。
• 新的 WallpaperInfo 類別。
• 已更新「WallpaperManager」。

此外，如果您的應用程式使用或提供動態桌布，請記得在應用程式的資訊清單中加入 <uses-feature> 元素，並宣告該屬性 android:name="android.software.live_wallpaper"。例如：

<uses-feature android:name="android.software.live_wallpaper" />

發布應用程式後，Google Play 會檢查這個元素是否存在，並將其當做篩選器使用，確保應用程式不適用於裝置不支援動態桌布的使用者。

電話通訊系統

• 新的 SignalStrength 類別可提供裝置目前網路訊號的相關資訊。您可以從新的 onSignalStrengthsChanged(SignalStrength) 回呼取得這項資訊。
• 新增 onDataConnectionStateChanged(int, int) 回呼。

觀看次數

• 新的 View 方法 isOpaque() 和 onDrawScrollBars(Canvas)。
• 新 RemoteViews 方法 addView(int, RemoteViews) 和 removeAllViews(int)。
• 新 ViewGroup 方法 isChildrenDrawingOrderEnabled() 和 setChildrenDrawingOrderEnabled(boolean)。

WebKit

• 新的 WebStorage 方法來操控網路儲存資料庫。
• 新的 GeolocationPermissions 方法可取得地理位置權限，並在 WebView 上設定這些權限。
• 新增 WebSettings 方法，可用於根據螢幕密度管理應用程式快取、網頁儲存空間和縮放的設定。
• 新的 WebChromeClient 方法可以處理影片、瀏覽記錄、自訂檢視畫面、應用程式快取限制等。

API 差異報表

如要瞭解 Android 2.1 (API 級別 7) 與 API 級別 6 相比，所有 API 變更的詳細檢視畫面，請參閱 API 差異報表。

內建應用程式

可下載平台中包含的系統映像檔提供下列內建應用程式：

鬧鐘 Browser 計算機 相機 聯絡人 自訂語言代碼 (開發人員應用程式) 開發人員工具 (開發人員工具) 電子郵件

擴充功能庫 日文、中文與拉丁文文字輸入 IME 訊息 音樂 電話 設定 Spare Parts (開發人員應用程式)

語言/地區

可下載平台內含的系統映像檔提供多種內建語言代碼。在某些情況下，地區專屬字串可用於語言代碼。在其他情況下，則會使用預設語言。以下列出 Android 2.1 系統映像檔提供的語言 (使用 language_country/region 語言代碼描述元)。

中文，中華人民共和國 (zh_CN) 中文，台灣 (zh_TW) 捷克文 (cs_CZ) 荷蘭文，荷蘭 (nl_NL) 荷蘭文，比利時 (nl_BE) 英文，美國 (en_US) 英文，英國 (en_GB) 英文，加拿大 (en_CA) 英文，澳洲 (en_AU) 英文，紐西蘭 (en_NZ) 英文，新加坡(en_SG) 法文，法國 (fr_FR) 法文，比利時 (fr_BE)

法文，加拿大 (fr_CA) 法文，瑞士 (fr_CH) 德文，德國 (de_DE) 德文，奧地利 (de_AT) 德文，瑞士 (de_CH) 德文，列支敦斯登 (de_LI) 義大利文，義大利 (it_IT) 義大利文，瑞士 (it_CH) 日文 (ja_JP) 韓文 (ko_KR) 波蘭文 (pl_PL) 俄文 (ru_RU) 西班牙文 (es_ES)

本地化 UI 字串會與可透過「設定」存取的語言代碼相符。

模擬器面板

可下載平台提供一組模擬器外觀，可讓您用來在不同螢幕大小和解析度下建立應用程式模型。模擬器外觀如下：

• QVGA (240x320，低密度，小螢幕)
• WQVGA (240x400，低密度、一般螢幕)
• FWQVGA (240x432，低密度、一般螢幕)
• HVGA (320x480，中密度、一般螢幕)
• WVGA800 (480x800，高密度、一般螢幕)
• WVGA854 (480x854 high 像素密度、一般螢幕)

如要進一步瞭解如何開發能在所有 Android 裝置上正常顯示及功能的應用程式，請參閱「支援多個螢幕」。