Android 3.2 API

API 級別:13

Android 3.2 (HONEYCOMB_MR2) 是漸進式平台版本,為使用者和開發人員新增了功能。下列各節將概略介紹新功能和開發人員 API。

開發人員可以下載 Android 3.2 平台,做為 Android SDK 的元件。可下載的平台包含 Android 程式庫和系統映像檔,以及一組模擬器外觀等。如要開始針對 Android 3.2 進行開發或測試,請使用 Android SDK Manager 將平台下載至 SDK。

平台特點

新使用者功能

  • 針對更多平板電腦進行最佳化

    Android 3.2 包含多項系統最佳化功能,可確保在更多平板電腦裝置上提供優質的使用者體驗。

  • 固定大小應用程式的相容性縮放

    Android 3.2 推出全新的相容性縮放模式,讓使用者能以新方式在較大裝置上查看固定大小的應用程式。如果應用程式並非設計為在較大螢幕尺寸 (例如平板電腦) 上執行,新模式會提供像素縮放替代方案,而非標準 UI 延展。如果應用程式需要相容性支援,使用者可以透過系統資訊列中的選單圖示存取新模式。

  • 從 SD 卡同步媒體

    在支援 SD 卡的裝置上,使用者現在可以直接將媒體檔案從 SD 卡載入到使用這些檔案的應用程式。系統功能可讓應用程式從系統媒體儲存區存取檔案。

開發人員新功能

  • 管理螢幕支援的擴充 API

    Android 3.2 針對平台的螢幕支援 API 推出擴充功能,讓開發人員能以更多方式管理各種 Android 裝置上的應用程式 UI。API 包含新的資源限定詞和新的資訊清單屬性,可讓您更精確地控制應用程式在不同大小上的顯示方式,而不是依賴一般的大小類別。

    為確保固定大小的應用程式,以及對各種螢幕大小支援有限的應用程式,能以最佳方式顯示,平台也提供新的縮放相容模式,可在較小的螢幕區域中算繪 UI,然後放大 UI 來填滿螢幕上的可用空間。如要進一步瞭解螢幕支援 API 及其提供的控制項,請參閱下方各節。

API 總覽

螢幕支援 API

Android 3.2 推出新的螢幕支援 API,可讓您進一步控管應用程式在不同螢幕大小上的顯示方式。這個 API 以現有的螢幕支援 API 為基礎,包括平台的通用螢幕密度模型,但擴充了功能,可根據尺寸精確指定特定螢幕範圍,以密度獨立像素單位 (例如 600dp 或 720dp 寬) 測量,而非以通用螢幕大小 (例如 large 或 xlarge) 測量。

設計應用程式 UI 時,您仍可仰賴平台提供密度抽象化,這表示應用程式不需要補償裝置間實際像素密度的差異。您可以根據可用的水平或垂直空間量,設計應用程式 UI。平台會使用三個新特性來表示可用空間量:smallestWidth、width 和 height。

  • 螢幕的 smallestWidth 是基本最小尺寸,以密度獨立像素 (「dp」) 為單位。也就是螢幕高度或寬度中較短的一邊。如果是直向螢幕,smallestWidth 通常會根據寬度決定,橫向螢幕則會根據高度決定。在所有情況下,smallestWidth 都是從螢幕的固定特性衍生而來,且無論螢幕方向為何,值都不會改變。smallestWidth 對應用程式來說很重要,因為它代表應用程式 UI 需要繪製的最短寬度,不包括系統保留的螢幕區域。
  • 相較之下,螢幕的「寬度」和「高度」代表目前可用於應用程式版面配置的水平或垂直空間,以「dp」為單位,不包括系統保留的螢幕區域。當使用者在橫向和直向之間切換螢幕方向時,螢幕的寬度和高度會隨之變更。

新的螢幕支援 API 可讓您根據目前螢幕的 smallestWidth 管理應用程式 UI。您也可以視需要,根據目前的寬度或高度管理 UI。為此,API 提供下列工具:

  • 新的資源限定詞,可將版面配置和其他資源指定為最小 smallestWidth、寬度或高度,以及
  • 新的資訊清單屬性,用於指定應用程式的最大螢幕相容性範圍

此外,應用程式仍可在執行階段查詢系統,並管理 UI 和資源載入,就像在舊版平台中一樣。

由於新 API 可讓您透過 smallestWidth、寬度和高度更直接指定螢幕,因此瞭解不同螢幕類型的典型特徵會很有幫助。下表提供一些範例,以「dp」為單位。

表 1. 一般裝置,密度和大小以 dp 為單位。

類型 密度 (一般化) 尺寸 (dp) smallestWidth (dp)
基準手機 mdpi 320x480 320
小型平板電腦/大型手機 mdpi 480x800 480
7 吋平板電腦 mdpi 600x1024 600
10 吋平板電腦 mdpi 800x1280 800

以下各節將進一步說明新的螢幕限定詞和資訊清單屬性。如要進一步瞭解如何使用螢幕支援 API,請參閱「支援多螢幕」。

支援螢幕的新資源限定詞

Android 3.2 的新資源限定詞可讓您更精準地針對螢幕大小範圍調整版面配置。您可以使用限定詞,建立專為特定最小 smallestWidth、目前寬度或目前高度設計的資源設定,以密度獨立像素為測量單位。

新修飾符如下:

  • swNNNdp:指定應使用資源的最小 smallestWidth,以「dp」單位測量。如上所述,無論螢幕方向為何,螢幕的 smallestWidth 都是常數。例如:sw320dp、sw720dp、sw720dp。
  • wNNNdp 和 hNNNdp:指定應使用資源的最小寬度或高度,以「dp」單位測量。如上所述,螢幕的寬度和高度與螢幕方向相關,且會隨著螢幕方向變更而改變。例如:w320dp、w720dp、h1024dp。

您也可以視需要建立多個重疊的資源設定。舉例來說,您可以標記某些資源,用於寬度大於 480 dp 的螢幕,其他資源則用於寬度大於 600 dp 的螢幕,以及寬度大於 720 dp 的螢幕。如果有多個資源設定符合指定螢幕,系統會選取最相符的設定。如要精確控制在特定螢幕上載入哪些資源,可以使用一個限定詞標記資源,或結合多個新或現有的限定詞。

根據先前列出的典型維度,以下列舉幾個新限定詞的使用範例:

res/layout/main_activity.xml   # For phones
res/layout-sw600dp/main_activity.xml   # For 7" tablets
res/layout-sw720dp/main_activity.xml   # For 10" tablets
res/layout-w600dp/main_activity.xml   # Multi-pane when enough width
res/layout-sw600dp-w720dp/main_activity.xml   # For large width

舊版平台會忽略新限定詞,因此您可以視需要混合使用,確保應用程式在任何裝置上都能完美呈現。以下舉幾個例子說明:

res/layout/main_activity.xml   # For phones
res/layout-xlarge/main_activity.xml   # For pre-3.2 tablets
res/layout-sw600dp/main_activity.xml   # For 3.2 and up tablets

如要進一步瞭解如何使用新的限定詞,請參閱「使用新的大小限定詞」。

螢幕大小相容性的新資訊清單屬性

這個架構提供一組新的 <supports-screens> 資訊清單屬性,可讓您管理應用程式對不同螢幕尺寸的支援。具體來說,您可以指定應用程式設計執行的最大和最小螢幕,以及設計執行的最大螢幕,而不需要系統的新螢幕相容模式。與上述資源限定詞一樣,新的資訊清單屬性會指定應用程式支援的螢幕範圍,如 smallestWidth 所指定。

支援螢幕的新資訊清單屬性如下:

  • android:compatibleWidthLimitDp="numDp":這項屬性可指定應用程式在不需相容模式的情況下,可執行的最大 smallestWidth。如果目前螢幕大於指定值,系統會以正常模式顯示應用程式,但允許使用者透過系統資訊列中的設定,選擇切換至相容模式。
  • android:largestWidthLimitDp="numDp":這項屬性可指定應用程式設計執行的最大 smallestWidth。如果目前螢幕大於指定值,系統會強制應用程式進入螢幕相容模式,確保在目前螢幕上能以最佳方式顯示。
  • android:requiresSmallestWidthDp="numDp":這項屬性可指定應用程式可執行的最小 smallestWidth。如果目前螢幕小於指定值,系統會認為應用程式與裝置不相容,但不會阻止安裝及執行。

注意:Google Play 目前不會根據上述任何屬性篩選應用程式。我們會在日後的平台版本中加入篩選功能。如果應用程式需要根據螢幕大小進行篩選,可以使用現有的 <supports-screens> 屬性。

如要進一步瞭解如何使用新屬性,請參閱「宣告螢幕大小支援」。

螢幕相容模式

Android 3.2 提供新的螢幕相容模式,適用於明確宣告不支援目前執行螢幕大小的應用程式。這種新的「縮放」模式會縮放像素,在較小的螢幕區域中轉譯應用程式,然後縮放像素以填滿目前的螢幕。

根據預設,系統會為需要螢幕相容模式的應用程式提供該模式,做為使用者選項。使用者可以透過系統資訊列中的控制項,開啟或關閉縮放模式。

由於新的螢幕相容模式可能不適用於所有應用程式,因此平台允許應用程式使用資訊清單屬性停用該模式。如果應用程式停用這項功能,系統就不會在應用程式執行時,為使用者提供「縮放」相容模式選項。

注意:如要瞭解如何控制應用程式的相容模式,請參閱 Android 開發人員網誌上的「大螢幕應用程式的新模式」一文。

720p 電視和類似裝置的新螢幕密度

為滿足在 720p 電視或類似中等密度螢幕上執行的應用程式需求,Android 3.2 推出新的通用密度 tvdpi,約為 213 dpi。應用程式可以查詢 densityDpi 中的新密度,並使用新的 tvdpi 限定詞標記電視和類似裝置的資源。例如:

res/drawable-tvdpi/my_icon.png   # Bitmap for tv density

一般來說,應用程式不需要使用這個密度。如果需要 720p 螢幕的輸出內容,平台可以自動縮放 UI 元素。

UI 架構

  • 片段
    • 新的 Fragment.SavedState 類別會保留透過 saveFragmentInstanceState() 從片段執行個體擷取的狀態資訊。
    • 新方法 saveFragmentInstanceState() 會儲存指定 Fragment 的目前執行個體狀態。之後建立與目前狀態相符的新 Fragment 執行個體時,可以使用這個狀態。
    • 新方法 setInitialSavedState() 會在首次建構時,設定片段的初始儲存狀態。
    • 新的 onViewCreated() 回呼方法會通知片段 onCreateView() 已傳回,但尚未將任何已儲存的狀態還原至檢視畫面。
    • isDetached() 方法會判斷片段是否已明確從 UI 卸離。
    • 新的 attach() 和 detach() 方法可讓應用程式在 UI 中重新附加或卸離片段。
    • 新的 setCustomAnimations() 超載方法可讓您設定特定的動畫資源,以便在進入/退出作業時執行,特別是在彈出返回堆疊時。現有實作方式並未考量到片段在彈出返回堆疊時的不同行為。
  • ActivityInfo 和 ApplicationInfo 中的螢幕大小資訊
  • 從 WindowManager 取得螢幕大小的輔助程式
  • 全新公開「全像」樣式
    • 平台現在會為文字、動作列小工具和分頁等項目,提供各種公開的「全像」樣式。如需完整清單,請參閱 R.style。
  • LocalActivityManager、ActivityGroup 和 LocalActivityManager 現已淘汰
    • 新應用程式應使用 Fragment,而非這些類別。如要繼續在舊版平台上執行,您可以使用 Android SDK 提供的 v4 支援資料庫 (相容性資料庫)。v4 支援資料庫提供的 Fragment API 版本,可向下相容至 Android 1.6 (API 級別 4)。
    • 如果是針對 Android 3.0 (API 級別 11) 以上版本開發的應用程式,分頁通常會使用新的 ActionBar.newTab() 和相關 API 呈現在 UI 中,以便將分頁放置在動作列區域中。

媒體架構

  • 如果應用程式使用平台的媒體供應器 (MediaStore),現在可以直接從可卸除式 SD 卡讀取媒體資料 (如果裝置支援)。應用程式也可以使用 MTP API,直接與 SD 卡檔案互動。

圖形

IME 架構

  • 新增 getModifiers() 方法,用於擷取輔助鍵的目前狀態。

USB 架構

  • 新增 getRawDescriptors() 方法,用於擷取裝置的原始 USB 描述元。您可以使用這個方法存取無法直接透過高階 API 支援的描述元。

網路

電話通訊系統

核心公用程式

新功能常數

平台新增了硬體功能常數,您可以在應用程式資訊清單中宣告這些常數,向 Google Play 等外部實體告知所需的軟硬體功能。您可以在 <uses-feature> 資訊清單元素中宣告這些和其他功能常數。

Google Play 會根據應用程式的 <uses-feature> 屬性篩選應用程式,確保只有符合要求的裝置才能使用。

  • 橫向或直向需求的特徵常數

    Android 3.2 導入了新的功能常數,可讓應用程式指定是否需要以橫向、直向或兩者兼具的方向顯示。宣告這些常數,表示應用程式不得安裝在不提供相關方向的裝置上。相反地,如果未宣告其中一個或兩個常數,則表示應用程式對未宣告的方向沒有偏好,且可能會安裝在不提供這些方向的裝置上。

    一般來說,如果應用程式在橫向和直向模式下都能正常運作,通常不需要宣告螢幕方向需求。相反地,如果應用程式主要針對單一螢幕方向設計 (例如專為電視設計的應用程式),則可宣告其中一個常數,確保不支援該螢幕方向的裝置無法使用該應用程式。

    如果資訊清單中宣告的任何活動使用 android:screenOrientation 屬性,要求以特定螢幕方向執行,那麼這也代表應用程式需要用到該螢幕方向。

  • 其他特徵常數

API 差異報表

如要詳細查看 Android 3.2 (API 級別 13) 的所有 API 異動,請參閱 API 差異報告。

API 層級

Android 3.2 平台提供更新版的架構 API。Android 3.2 API 會獲派一個整數 ID:13,並儲存在系統本身。這個 ID 稱為「API 級別」,可讓系統在安裝應用程式前,正確判斷應用程式是否與系統相容。

如要在應用程式中使用 Android 3.2 導入的 API,您必須根據 Android 3.2 SDK 平台提供的 Android 程式庫編譯應用程式。視需求而定,您可能還需要在應用程式資訊清單的 <uses-sdk> 元素中加入 android:minSdkVersion="13" 屬性。

詳情請參閱「什麼是 API 級別?」一文。