Android 4.2 API

API 級別:17

Android 4.2 (JELLY_BEAN_MR1) 是 Jelly Bean 版本的更新,為使用者和應用程式開發人員提供新功能。本文將介紹對開發人員來說最重要且實用的新 API。

應用程式開發人員應盡快從 SDK Manager 下載 Android 4.2 系統映像檔和 SDK 平台。如果沒有搭載 Android 4.2 的裝置可測試應用程式,請使用 Android 4.2 系統映像檔,在 Android 模擬器上測試應用程式。接著,請根據 Android 4.2 平台建構應用程式,開始使用最新 API。

如要針對搭載 Android 4.2 的裝置進一步最佳化應用程式,請將 targetSdkVersion 設為 "17",然後在 Android 4.2 系統映像檔上安裝並測試應用程式,再發布包含這項變更的更新。

您可以使用 Android 4.2 中的 API,同時支援舊版本,方法是在程式碼中加入條件,在執行 minSdkVersion 不支援的 API 之前,先檢查系統 API 級別。如要進一步瞭解如何維持回溯相容性,請參閱「建立與先前版本相容的 UI」。

如要進一步瞭解 API 級別的運作方式,請參閱「什麼是 API 級別?」一文。

重要行為異動

如果您先前曾發布 Android 應用程式,請留意下列可能影響應用程式行為的異動:

  • 內容供應器預設不會再匯出。也就是說,android:exported 屬性的預設值現在是 "false"。如果其他應用程式必須能夠存取您的內容供應器,您現在必須明確設定 android:exported="true"。

    只有在您將 android:targetSdkVersion 或 android:minSdkVersion 設為 17 以上時,這項變更才會生效。否則,即使在 Android 4.2 以上版本上執行,預設值仍為 "true"。

  • 與舊版 Android 相比,如果應用程式要求 ACCESS_COARSE_LOCATION 權限,但未要求 ACCESS_FINE_LOCATION 權限,使用者位置結果可能較不準確。

    當應用程式要求大概位置 (而非精確位置) 權限時,為符合使用者對隱私權的期望,系統不會提供比城市街區更精確的使用者位置估計值。

  • Settings.System 定義的部分裝置設定現在為唯讀狀態。如果應用程式嘗試將變更寫入 Settings.System 中定義、但已移至 Settings.Global 的設定,在 Android 4.2 以上版本執行時,寫入作業會失敗,且不會顯示任何訊息。

    即使 android:targetSdkVersion 和 android:minSdkVersion 的值低於 17,在 Android 4.2 以上版本中,應用程式也無法修改已移至 Settings.Global 的設定。

  • 如果應用程式使用 WebView,Android 4.2 會新增一層安全防護,讓您更安全地將 JavaScript 繫結至 Android 程式碼。如果將 targetSdkVersion 設為 17 以上,則必須在要讓 JavaScript 使用的任何方法上新增 @JavascriptInterface 註解 (該方法也必須是公開方法)。如果未提供註解,在 Android 4.2 以上版本執行時,WebView 中的網頁就無法存取該方法。如果將 targetSdkVersion 設為 16 以下,則不需要加上註解,但建議您更新目標版本並加上註解,提高安全性。

    進一步瞭解如何將 JavaScript 程式碼繫結至 Android 程式碼。

Daydream

Daydream 是 Android 裝置的新互動式螢幕保護程式模式。當裝置插入座架,或在插入充電器時閒置 (而非關閉螢幕),系統會自動啟用螢幕保護程式。Daydream 一次只會顯示一個夢境,可能是純視覺的被動顯示,輕觸即可關閉,也可能是互動式,可回應所有輸入事件。夢境會在應用程式的程序中執行,並可完整存取 Android UI 工具包,包括檢視畫面、版面配置和動畫,因此比動態桌布或應用程式小工具更靈活、更強大。

您可以實作 DreamService 的子類別,為 Daydream 建立夢境。DreamService API 的設計與 Activity 類似。如要指定夢境的 UI,請在取得視窗後 (例如從 onAttachedToWindow() 回呼),隨時將版面配置資源 ID 或 View 傳遞至 setContentView()。

DreamService 類別除了提供基礎 Service API 外,還提供其他重要的生命週期回呼方法,例如 onDreamingStarted()、onDreamingStopped() 和 onDetachedFromWindow()。您無法從應用程式啟動 DreamService,因為系統會自動啟動。

如果夢境具有互動性,您可以從夢境啟動活動,將使用者導向應用程式的完整 UI,以便查看更多詳細資料或進行控制。您可以使用 finish() 結束夢境,讓使用者看到新的 Activity。

如要讓系統使用您的 Daydream,請在資訊清單檔案中使用 <service> 元素宣告 DreamService。接著,您必須加入包含 "android.service.dreams.DreamService" 動作的意圖篩選器。例如:

<service android:name=".MyDream" android:exported="true"
    android:icon="@drawable/dream_icon" android:label="@string/dream_label" >
    <intent-filter>
        <action android:name="android.service.dreams.DreamService" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</service>

DreamService 中還有其他實用方法,請留意:

  • setInteractive(boolean) 可控制夢境是否接收輸入事件,或在使用者輸入時立即退出。如果夢境是互動式的,使用者可以使用「返回」或「主畫面」按鈕退出夢境,也可以呼叫 finish() 停止夢境。
  • 如要提供完全沉浸式的顯示畫面,可以呼叫 setFullscreen() 隱藏狀態列。
  • Daydream 啟動前,螢幕會變暗,向使用者表示閒置逾時時間即將到來。呼叫 setScreenBright(true) 則可將螢幕設為一般亮度。

詳情請參閱 DreamService 說明文件。

第二螢幕

Android 現在允許應用程式在其他螢幕上顯示獨特內容,這些螢幕透過有線連線或 Wi-Fi 連線至使用者裝置。如要為次要螢幕建立獨特內容,請擴充 Presentation 類別並實作 onCreate() 回呼。在 onCreate() 中,呼叫 setContentView(),指定次要螢幕的 UI。Presentation 類別是 Dialog 類別的擴充功能,可提供應用程式在次要螢幕上顯示專屬 UI 的區域。

如要偵測可顯示 Presentation 的次要螢幕,請使用 DisplayManager 或 MediaRouter API。雖然 DisplayManager API 可讓您列舉可能同時連接的多個螢幕,但通常應改用 MediaRouter,快速存取系統的預設螢幕,以便進行簡報。

如要取得簡報的預設螢幕,請呼叫 MediaRouter.getSelectedRoute() 並傳遞 ROUTE_TYPE_LIVE_VIDEO。這會傳回 MediaRouter.RouteInfo 物件,說明系統目前選取的影片簡報路徑。如果 MediaRouter.RouteInfo 不是空值,請呼叫 getPresentationDisplay() 取得代表已連結螢幕的 Display。

接著,您可以將 Display 物件傳遞至 Presentation 類別的建構函式,藉此顯示簡報。簡報現在會顯示在次要螢幕上。

如要在執行階段偵測新螢幕是否已連線,請建立 MediaRouter.SimpleCallback 執行個體,並在其中實作 onRoutePresentationDisplayChanged() 回呼方法。當新的 Presentation 螢幕連線時,系統會呼叫這個方法。接著,將 傳遞至 MediaRouter.addCallback(),並一併傳遞 ROUTE_TYPE_LIVE_VIDEO 路線類型,藉此註冊 MediaRouter.SimpleCallback。收到 onRoutePresentationDisplayChanged() 呼叫時,只要按照上述方式呼叫 MediaRouter.getSelectedRoute() 即可。

如要進一步針對次要螢幕最佳化 Presentation 中的 UI,您可以在套用至應用程式或活動的 <style> 中指定 android:presentationTheme 屬性,藉此套用不同的主題。

請注意,連接到使用者裝置的螢幕通常尺寸較大,且螢幕密度可能不同。由於螢幕特性可能不同,因此您應提供專為這類大型螢幕最佳化的資源。如需向 Presentation 要求額外資源,請呼叫 getContext().getResources(),取得與螢幕對應的 Resources 物件。這會從應用程式中提供最適合次要螢幕大小和密度的資源。

如需更多資訊和程式碼範例,請參閱 Presentation 類別說明文件。

螢幕鎖定小工具

Android 現在允許使用者將應用程式小工具新增至螢幕鎖定畫面。如要在螢幕鎖定畫面使用應用程式小工具,請在 XML 檔案中加入 android:widgetCategory 屬性,指定 AppWidgetProviderInfo。這項屬性支援兩個值:home_screen 和 keyguard。根據預設,屬性會設為 home_screen,讓使用者可以將應用程式小工具新增至主畫面。如要讓應用程式小工具也能在螢幕鎖定畫面上使用,請新增 keyguard 值:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    ...
    android:widgetCategory="keyguard|home_screen">
</appwidget-provider>

您也應使用 android:initialKeyguardLayout 屬性,指定應用程式小工具在螢幕鎖定畫面上的初始版面配置。這與 android:initialLayout 的運作方式相同,因為它提供的版面配置可以立即顯示,直到應用程式小工具初始化並能夠更新版面配置為止。

如要進一步瞭解如何建構螢幕鎖定畫面的應用程式小工具,包括在螢幕鎖定畫面上正確調整應用程式小工具的大小,請參閱應用程式小工具指南。

多位使用者

Android 現在允許在平板電腦等可共用裝置上,建立多個使用者空間。裝置上的每位使用者都有自己的帳戶、應用程式、系統設定、檔案和任何其他使用者相關資料。

應用程式開發人員不需要採取任何額外措施,應用程式就能在單一裝置上與多位使用者搭配運作。無論裝置上有多少使用者,應用程式為特定使用者儲存的資料,都會與為其他使用者儲存的資料分開。系統會追蹤哪些使用者資料屬於執行應用程式的使用者程序,並僅允許應用程式存取該使用者的資料,不允許存取其他使用者的資料。

在多使用者環境中儲存資料

每當應用程式儲存使用者偏好設定、建立資料庫,或將檔案寫入使用者的內部或外部儲存空間時,只有在以該使用者身分執行時,才能存取該資料。

為確保應用程式在多使用者環境中正常運作,請勿使用硬式編碼路徑參照內部應用程式目錄或外部儲存空間位置,而應一律使用適當的 API:

無論您使用哪一個 API 儲存特定使用者的資料,在以其他使用者身分執行時,都無法存取該資料。從應用程式的角度來看,每位使用者都是在完全獨立的裝置上執行。

在多使用者環境中識別使用者

如果應用程式想要識別不重複使用者,例如收集數據分析或建立其他帳戶關聯,請按照識別不重複安裝的建議做法操作。在應用程式首次啟動時建立新的 UUID,即可確保取得專屬 ID 來追蹤每位使用者,無論有多少使用者在單一裝置上安裝應用程式。或者,您也可以儲存從伺服器擷取的本機權杖,或使用 Google Cloud Messaging 提供的註冊 ID。

請注意,如果應用程式要求其中一個硬體裝置 ID (例如 Wi-Fi MAC 位址或 SERIAL 號碼),則會為每位使用者提供相同的值,因為這些 ID 與硬體相關聯,而非使用者。更不用說這些 ID 帶來的其他問題,如「識別應用程式安裝」網誌文章所述。

新版全域設定

系統設定已更新,可支援多位使用者,並新增 Settings.Global。這組設定與 Settings.Secure 設定類似,因為兩者都是唯讀,但會套用至裝置上所有使用者空間。

多項現有設定已從「Settings.System」或「Settings.Secure」移至此處。如果應用程式目前會變更先前在 Settings.System 中定義的設定 (例如 AIRPLANE_MODE_ON),則在搭載 Android 4.2 以上版本的裝置上,如果這些設定已移至 Settings.Global,則預期將無法再執行這項操作。您可以繼續讀取 Settings.Global 中的設定,但由於系統不再認為應用程式可以安全地變更設定,因此在 Android 4.2 以上版本上執行應用程式時,嘗試變更設定會失敗,且系統會在系統記錄中寫入警告。

支援 RTL 版面配置

Android 現在提供多個 API,可讓您建構使用者介面,妥善轉換版面配置方向,支援使用從右至左 (RTL) UI 和閱讀方向的語言,例如阿拉伯文和希伯來文。

如要在應用程式中支援 RTL 版面配置,請在資訊清單檔案中將 android:supportsRtl 屬性設為 <application> 元素,並將其設為 "true"。啟用後,系統會啟用各種 RTL API,以 RTL 版面配置顯示應用程式。舉例來說,動作列會在右側顯示圖示和標題,在左側顯示動作按鈕,而您使用架構提供的 View 類別建立的任何版面配置也會反轉。

如要進一步最佳化應用程式在 RTL 版面配置中的外觀,可以採取以下兩種基本最佳化做法:

  1. 將靠左和靠右的版面配置屬性,轉換為靠前和靠後的版面配置屬性。

    例如,使用 android:layout_marginStart 取代 android:layout_marginLeft,並使用 android:layout_marginEnd 取代 android:layout_marginRight。

    RelativeLayout 類別也提供對應的版面配置屬性,可取代左/右位置,例如 android:layout_alignParentStart 取代 android:layout_alignParentLeft,android:layout_toStartOf 取代 android:layout_toLeftOf。

  2. 或者,如要為 RTL 版面配置提供完整最佳化,您可以使用 ldrtl 資源限定詞 (ldrtl 代表 layout-direction-right-to-left}) 提供完全獨立的版面配置檔案。舉例來說,您可以將預設版面配置檔案儲存在 res/layout/ 中,並將 RTL 最佳化版面配置儲存在 res/layout-ldrtl/ 中。

    ldrtl 限定詞非常適合用於可繪製資源,因此您可以提供與閱讀方向相對應的圖形。

架構中還有其他各種 API 可支援 RTL 版面配置,例如 View 類別,可讓您為自訂檢視畫面實作適當的行為,以及 Configuration,可查詢目前的版面配置方向。

注意:如果您使用 SQlite,且資料表或資料欄名稱「僅限數字」,請務必小心:如果裝置已設為阿拉伯文語言代碼,使用 String.format(String, Object...) 可能會導致數字轉換為阿拉伯文對應數字時發生錯誤。您必須使用 String.format(Locale,String,Object...),確保數字保留為 ASCII。此外,請使用 String.format("%d", int),而非 String.valueOf(int) 設定數字格式。

巢狀片段

現在可以在片段中嵌入片段。在各種情況下,如果您想將動態且可重複使用的 UI 元件放入本身也是動態且可重複使用的 UI 元件中,這種做法就非常實用。舉例來說,如果您使用 ViewPager 建立可左右滑動且占用大部分螢幕空間的片段,現在可以在每個片段頁面中插入片段。

如要建立巢狀片段,只要在要新增片段的 Fragment 上呼叫 getChildFragmentManager() 即可。這會傳回 FragmentManager,您可以像平常一樣從頂層活動使用該物件,建立片段交易。舉例來說,以下程式碼會從現有的 Fragment 類別中新增片段:

Kotlin

val videoFragment = VideoPlayerFragment()
childFragmentManager.beginTransaction().apply {
    add(R.id.video_fragment, videoFragment)
    commit()
}

Java

Fragment videoFragment = new VideoPlayerFragment();
FragmentTransaction transaction = getChildFragmentManager().beginTransaction();
transaction.add(R.id.video_fragment, videoFragment).commit();

在巢狀片段中,您可以呼叫 getParentFragment(),取得父項片段的參照。

Android 支援資料庫現在也支援巢狀片段,因此您可以在 Android 1.6 以上版本中實作巢狀片段設計。

注意:如果版面配置包含 <fragment>,就無法將版面配置加載至片段。只有在動態新增至片段時,才支援巢狀片段。

RenderScript

Renderscript 運算功能已透過下列功能強化:

指令碼內建函式

您可以使用 Renderscript 的內建指令碼內建函式,為您實作常見作業,例如:

如要使用指令碼內建函式,請呼叫每個內建函式的靜態 create() 方法,建立指令碼執行個體。接著,您會呼叫每個指令碼內建函式的可用 set() 方法,設定任何必要的輸入內容和選項。最後,呼叫 forEach() 方法來執行指令碼。

腳本群組

ScriptGroup 可讓您將相關的 Renderscript 指令碼鏈結在一起,並透過一次呼叫執行這些指令碼。

使用 ScriptGroup.Builder 呼叫 addKernel(),將所有指令碼新增至群組。新增所有指令碼後,請呼叫 addConnection(),在指令碼之間建立連結。新增完連線後,請呼叫 create() 建立指令碼群組。執行指令碼群組前,請先指定輸入 Allocation 和要透過 setInput(Script.KernelID, Allocation) 方法執行的初始指令碼,並提供要寫入結果的輸出 Allocation,以及要透過 setOutput() 執行的最終指令碼。最後,呼叫 execute() 執行指令碼群組。

Filterscript

Filterscript 會定義現有 Renderscript API 的限制,讓產生的程式碼能在更多種類的處理器 (CPU、GPU 和 DSP) 上執行。如要建立 Filterscript 檔案,請建立 .fs 檔案,而非 .rs 檔案,並指定 #pragma rs_fp_relaxed,告知 Renderscript 執行階段您的指令碼不需要嚴格的 IEEE 754-2008 浮點精確度。這個精確度支援將非正規數清除至零,以及朝零捨去。此外,Filterscript 指令碼不得使用 32 位元內建類型,且必須使用 __attribute__((kernel)) 屬性指定自訂根函式,因為 Filterscript 不支援 root() 函式預設簽章定義的指標。

注意:雖然平台支援 Filterscript,但 SDK 工具 21.0.1 版才會提供開發人員支援。

如要詳細瞭解 Android 4.2 的所有 API 異動,請參閱 API 差異比較表。