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 平台元件連續版本相關注意事項，按修訂版本編號表示。如要判斷您的 SDK 環境中安裝的 Android 2.1 平台修訂版本，請參閱 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 稱為「API 級別」，可讓系統在安裝應用程式前，正確判斷應用程式是否與系統相容。

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

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

Framework 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 變更的詳細檢視畫面，請參閱 API 差異報表。

內建應用程式

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

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

錶面圖庫 用於輸入日文、中文和拉丁字母的輸入法編輯器 訊息 音樂 電話 設定 備用零件 (開發人員應用程式)

語言/地區

可下載平台中包含的系統映像檔提供多種內建語言代碼。在某些情況下，地區專屬字串可用於語言代碼。在其他情況下，則會使用預設的語言版本。以下列出 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 高密度，一般螢幕)

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