+ Android M 預覽版 SDK 有開發工具、Android 系統檔案以及程式庫檔案，可以幫助測試您的應用程式和下一個平台版本隨附的新 API。 +本文件會說明如何取得可下載的預覽版元件來測試您的應用程式。 + +
+ + +預覽版 SDK
+ ++ 預覽版 SDK 可透過 Android SDK 管理器下載取得。如需有關下載和設定預覽版 SDK 的詳細資訊，請參閱設定預覽版 SDK。 + +
+ + +開發人員文件
+ ++ 開發人員文件下載套件提供詳細的 API 參考資料和預覽版的 API 差異報告。 +
+ +| 說明 | +下載 / 總和檢查碼 | +
|---|---|
| Android M 預覽版 開發人員文件 |
+ m-preview-1-developer-docs.zip + MD5: b65201b0d35416f5a1b7a071b52854a7 + SHA-1: d47e856aa65e06897e6edd902ad8d2b1f05ac3ec + |
+
| 裝置 | +下載 / 總和檢查碼 | +
|---|---|
| Nexus 5 (GSM/LTE) "hammerhead" |
+ hammerhead-MPZ44Q-preview-55d76d3a.tgz + MD5:9e2631b06c6525e401ceaae3677ff320 + SHA-1:55d76d3a379b18f3363f28d8a462c236ab96fc36 + |
+
| Nexus 6 "shamu" |
+ shamu-MPZ44Q-preview-c1d6506a.tgz + MD5:307cbf9dab0a38df4ab2639d02be12aa + SHA-1: c1d6506a74094bdb2f4b8677c7fe4967334f9ea8 + |
+
| Nexus 9 "volantis" |
+ volantis-MPZ44Q-preview-d15ad483.tgz + MD5: fae40377fd999d2b09128665c915264d + SHA-1:7ab05f96093b2cb370b226f65931202714cbc2ca + |
+
| Nexus Player "fugu" |
+ fugu-MPZ44Q-preview-2406ba05.tgz + MD5:815902141a85cc65e7725f005cad31d5 + SHA-1:2406ba0598dea1e69110497ac0bc8e16789bc8fb + |
+
在裝置上安裝映像
+ ++ 如果要使用裝置映像進行測試，您必須先在相容的裝置上安裝映像。請依照下面的指示安裝系統映像： + +
+ +-
+
- 下載此處列出的其中一個系統映像，然後解壓縮。 +
- 備份您要保留的所有裝置資料。 +
- 依照 +developers.google.com/android +的指示，將映像更新到您的裝置。 +
+ 注意：在您使用預覽版系統映像更新開發裝置之後，裝置就會透過無線 (OTA) 更新方式自動升級為下一個預覽版版本。 + +
+ +將裝置還原成出廠規格
+ ++ 如果您要解除安裝預覽版並將裝置還原成出廠規格，請至 +developers.google.com/android 並下載您要為裝置更新的映像。 +依照該頁面的指示，將映像更新到您的裝置。 + +
+ + + + + + + + diff --git a/docs/html-intl/intl/zh-tw/preview/features/app-linking.jd b/docs/html-intl/intl/zh-tw/preview/features/app-linking.jd new file mode 100644 index 0000000000000..5be8a0f12c016 --- /dev/null +++ b/docs/html-intl/intl/zh-tw/preview/features/app-linking.jd @@ -0,0 +1,123 @@ +page.title=應用程式連結 +page.image=images/cards/card-app-linking_2x.png +page.keywords=應用程式連結, 深層連結, 意圖 +@jd:body + +本文件內容
+-
+
- 宣告網站關聯 +
- 要求應用程式連結驗證 +
- 管理應用程式連結設定 +
+ Android 意圖系統是一個彈性機制，讓應用程式能夠用來處理內容和要求。 + 有許多應用程式可能會在它們的意圖篩選條件中宣告相符的 URI 模式。當使用者按一下不含預設啟動處理常式的 Web 連結時，平台可能會顯示一個對話方塊，讓使用者能夠從具備已宣告相符意圖篩選條件的應用程式清單中選取。 + + +
+ ++ Android M 開發人員預覽版引進了應用程式連結的支援，這樣就能藉由允許應用程式開發人員將應用程式關聯至他們所擁有的 Web 網域，來改善現有的連結處理。 +當開發人員建立這個關聯時，平台可以自動判斷要用來處理特定 Web 連結的預設應用程式，並略過詢問使用者的程序。 + + +
+ + +宣告網站關聯
+ ++ 網站擁有者必須宣告與應用程式的關聯，才能建立應用程式連結。站台擁有者可藉由在網域上的已知位置裝載名為 {@code statements.json} 的 JSON 檔案，來宣告與應用程式的關係： + + +
+ +http://<domain>:<optional port>/.well-known/statements.json+ +
+ 注意： + 在 M 開發人員預覽版期間，會透過 http 通訊協定來驗證 JSON 檔案。如果是平台的正式版本，就會透過加密的 https 通訊協定來驗證該檔案。 + +
+ ++ 這個 JSON 檔案會指出應該在這個網域中用來做為 URL 預設處理常式的 Android 應用程式。 +它會根據下列欄位來識別應用程式： +
+ +-
+
- {@code package_name}：宣告於應用程式宣示說明中的套件名稱。 + +
- {@code sha256_cert_fingerprints}：您應用程式簽署憑證的 SHA256 指紋。
+ 您可以使用 Java 金鑰工具，利用下列命令來產生指紋：
+
keytool -list -v -keystore my-release-key.keystore
+
+
+ 下列檔案清單會顯示 +{@code statements.json} 檔案的內容與格式範例： +
+ +
+[{
+ "relation": ["delegate_permission/common.handle_all_urls"],
+ "target": {
+ "namespace": "android_app",
+ "package_name": "<package name>",
+ "sha256_cert_fingerprints": ["6C:EC:C5:0E:34:AE....EB:0C:9B"]
+ }
+}]
+
+
+
+要求應用程式連結驗證
+ ++ 應用程式可以要求平台根據裝載於個別 Web 網域上的 {@code statements.json} 檔案，自動驗證在其意圖篩選條件的資料元素中由主機名稱所定義的任何應用程式連結。 + +如要要求應用程式連結驗證，請將 {@code android:autoVerify} + 屬性新增到宣示說明中每個所需的意圖篩選條件中，如下列宣示說明程式碼片段所示： + +
+ ++<activity ...> + <intent-filter android:autoVerify="true"> + <action android:name="android.intent.action.VIEW" /> + <category android:name="android.intent.category.DEFAULT" /> + <category android:name="android.intent.category.BROWSABLE" /> + <data android:scheme="http" android:host="www.android.com" /> + <data android:scheme="https" android:host="www.android.com" /> + </intent-filter> +</activity> ++ +
+ 當 {@code android:autoVerify} 屬性出現在應用程式宣示說明時，平台即會在安裝該應用程式時嘗試驗證應用程式連結。 +如果平台無法成功驗證應用程式連結，就無法將該應用程式設定為偏好使用的應用程式來處理 Web 連結。 +當使用者下次開啟其中一個連結時，平台就切換回為該使用者展示一個對話方塊。 + + +
+ ++ 注意：在測試期間，如果驗證失敗，可能會產生誤判，但是使用者已經使用系統「設定」應用程式，明確地啟用應用程式來自動開啟支援的連結。在此案例中，不會顯示任何對話方塊，而且連結會直接連至您的應用程式，但這只是基於使用者的設定，而不是因為驗證成功所致。 + + + +
+ + +管理應用程式連結設定
+ ++ 使用者可以變更應用程式連結設定，讓他們能夠以偏好使用的方式來處理 URL。您可以在系統「設定」應用程式中，於 [設定] > [應用程式] > [應用程式資訊] > [預設開啟] 下方，檢閱和管理應用程式連結。 + + +
diff --git a/docs/html-intl/intl/zh-tw/preview/index.jd b/docs/html-intl/intl/zh-tw/preview/index.jd new file mode 100644 index 0000000000000..f57728c2bfe72 --- /dev/null +++ b/docs/html-intl/intl/zh-tw/preview/index.jd @@ -0,0 +1,67 @@ +page.title=Android M 開發人員預覽版 +page.tags="preview", +meta.tags="preview, M preview", androidm +fullpage=true +section.landing=true +header.hide=1 +footer.hide=1 +@jd:body + +
+ Android M 開發人員預覽版
++ 準備使用新版 Android。在 Nexus 5、6、9 和 Player 上測試您的應用程式。 +瞭解新功能 — 執行階段權限、休眠、應用程式待命等省電功能、新的輔助技術，以及其他功能。 + + +
+ + + + 開始使用！ ++
+如果想要開始使用 Android SDK 預覽版，您必須同意遵守下列條款和條件。如下方所述，請注意這是 Android SDK 預覽版，可能隨時會有變更，請您自負使用風險。 +Android SDK 預覽版還不是穩定的版本，可能會包含許多錯誤和瑕疵而對您的電腦系統、裝置和資料造成嚴重的損害。 +
+ ++這是「Android SDK 預覽版授權協議」(以下稱「授權協議」)。 +
++ 下列提供 M 開發人員預覽版的程式碼範例。如要下載 Android Studio 的範例，請選取 [File] (檔案) > [Import Samples] (匯入範例) 選單選項。 + +
+ ++ 注意：這些可下載的專案是專為與 Gradle 和 Android Studio 一起使用而設計。 + +
+ + +執行階段權限
+ ++ Android M 改變系統權限的運作方式。改為在執行階段才要求使用者核准權限要求，而不是安裝期間。 +這個範例顯示如何要求這些權限。 + +
+ + + +確認認證
+ ++ 這個範例示範如何在您的應用程式中使用裝置認證做為驗證方法。 +
+ + + +指紋對話方塊
+ ++ 這個範例示範如何在您的應用程式中辨識註冊的指紋以驗證使用者。 + +
+ + + +針對應用程式進行自動備份
+ ++ Android M 導入自動備份應用程式設定的功能。這個範例示範如何將篩選規則新增至應用程式以管理設定備份。 + +
+ + + +相機 2 Raw
+ +
+ 示範如何使用 Camera2 API，以擷取 RAW 相機緩衝區並另存為 DNG 檔案。
+
+
使用中通知
+ +
+ 這個範例示範
+NotificationManager
+ 如何將您應用程式目前顯示的通知數目告訴您。
+
本文件內容
+-
+
- 取得 Android Studio 1.3 +
- 取得預覽版 SDK +
- 建立或更新專案 +
- 設定以進行測試 +
M 開發人員預覽版 SDK 可以從 Android SDK Manager 取得。本文件假設您熟悉 Android 應用程式開發工作，例如使用 Android SDK Manager 和建立專案。 + +如果您是 Android 的新手，請先參閱建置您的第一個應用程式訓練課程。 + +
+ +取得 Android Studio 1.3
+ +開發人員預覽版最適合與處於預覽版狀態的 Android Studio 1.3 一起使用。 +強烈建議您安裝 Android Studio 1.3 預覽版與開發人員預覽版一起使用。 +
+ +注意：Android Studio 1.3 的測試預覽版仍在持續開發中。 +如果您使用主要開發電腦來測試開發人員預覽版，可以建立第二個 Android Studio 安裝以用於測試。 + +
+ +如要安裝 Android Studio 1.3 預覽版：
+ +-
+
- 下載並啟動 Android Studio。 + + + +
- 開啟 [Settings] (設定) 視窗 (在 Windows 上，您可以選擇 [檔案] > [設定] 來執行此動作)。
+選擇 [Appearance & Behavior] (外觀和行為) > [System Settings] (系統設定) > [Updates] (更新) 面板。
+
+
+
+
在 OSX 上，您可以在 Android Studio 的「Preferences」(偏好設定) 視窗中，找到 [Appearance & Behavior] (外觀和行為) 面板。 + +
+
+
+ - 在「Updates」(更新) 面板上，選擇以下選項：[Automatically check updates for: (自動檢查以下的可用更新：) +Canary Channel] (測試版管道)。 + + +
- 在「Updates」(更新) 面板上，選取 [Check Now] (立即檢查) 以檢查是否有可用的最新測試版建置。 +版本請在系統提示您時，下載並安裝該版本。 + + +
取得預覽版 SDK
+ +如要將預覽版 SDK 元件新增至您的開發環境：
+ +-
+
- 啟動 Android Studio 1.3 預覽版。 + + +
- 開啟 [Settings] (設定) 視窗 (在 Windows 上，您可以選擇 [檔案] > [設定] 來執行此動作)。
+選擇 [Appearance & Behavior] (外觀和行為) > [System Settings] (系統設定) > [Updates] (更新) 面板。
+
+
+
+
在 OSX 上，您可以在 Android Studio 的「Preferences」(偏好設定) 視窗中，找到 [Appearance & Behavior] (外觀和行為) 面板。 + +
+
+
+ - 在「Updates」(更新) 面板上，選擇以下選項：[Automatically check updates for: (自動檢查以下的可用更新：) +Canary Channel] (測試版管道) 以及 [Automatically check updates for Android SDK: (自動檢查 Android SDK 的可用更新：) +Preview Channel] (預覽版管道)。 + + +
- 啟動 Android Studio Manager。(使用 Android Studio 1.3，SDK Manager 會與 Android Studio 整合，而不是獨立的應用程式。) + + + + +
- 在「Platforms」(平台) 區段下，選取 [Android MNC Preview] (Android MNC 預覽版)。 + + + +
- 在「Tools」(工具) 區段中，選擇最新的 Android SDK 工具、平台工具以及建置工具。 + + + + +
- 按一下 [Install packages] (安裝套件) 並接受所有套件的授權合約。 + + + +
- 開啟 [Settings] (設定) 視窗，然後選擇 [Appearance & Behavior] (外觀和行為) > [System Settings] (系統設定) > [Android SDK] 面板，來驗證已安裝 M 開發人員預覽版。 + + + +
- 在「Android SDK」面板上，選擇 [SDK Platforms] (SDK 平台) 索引標籤。 +「Android MNC Preview」(Android MNC 預覽版) 應該會列在「Installed」(已安裝)。 +此外，開啟 [SDK Tools] (SDK 工具) 索引標籤以確認已經安裝最新的工具。 + + + +
完成這些步驟之後，就能在您的開發環境中使用預覽版元件。 +
+ + +建立或更新專案
+ ++ 為了使用預覽版 API，您必須建立或更新開發專案，才能使用預覽版元件。 + +
+ + +建立新專案
+ ++ 建議您使用 Android Studio 搭配預覽版來建立專案。依照建立專案中所述的步驟執行，直到您到達專案精靈中的「大小」畫面。 + +接著，執行下列步驟以建立為預覽版設定的專案。 + +
+ +-
+
- 核取 [Phone and Tablet] (手機與平板電腦)。 +
- 選取 [MNC：Android M (Preview)] (Android M (預覽版))，它位於 [Minimum SDK] (SDK 最低版本)。 + +
更新現有的專案
+ +
+ 對於現有專案，您必須修改專案設定以啟用預覽版 API。在您的開發環境中，開啟模組的 build.gradle 檔案，然後將這些值設定如下：
+
+
+
-
+
- 將
compileSdkVersion設定為'android-MNC'
+ - 將
minSdkVersion設定為'MNC'
+ - 將
targetSdkVersion設定為'MNC'
+
設定以進行測試
+ ++ 利用預覽版測試應用程式，需要您將裝置或虛擬裝置設定為使用平台的預覽版本。 +如果您有相容的裝置，您可以安裝預覽版平台以用於測試。 +否則，您可以設定虛擬裝置以用於測試。 +
+ +設定實體裝置
+ ++ 如果您有 Nexus 5、Nexus 6、Nexus 9 或 Android 電視，您可以在這些裝置上安裝預覽版系統映像，以測試您的應用程式。您可以使用 Android Virtual Device Manager (Android 虛擬裝置管理員) 工具，從 Android Studio 內設定使用平台預覽版本的虛擬裝置。 + + + +
+ ++ 重要說明：在裝置上安裝預覽版映像，會「移除當中的所有資料」，因此您應該在安裝預覽版映像之前備份任何資料。 + +
+ +設定虛擬裝置
+ ++ 您可以使用 Android Virtual Device Manager (Android 虛擬裝置管理員) 工具，從 Android Studio 內設定使用平台預覽版本的虛擬裝置。 + +
+ +如要使用 AVD Manager 來建立 AVD：
+ +-
+
- 請在您的開發環境中安裝預覽版 SDK，如設定預覽版 SDK 中所述。 + + +
- 依照使用 AVD Manager 來管理 AVD中的步驟執行。
+
+使用下列設定：
+
-
+
- 裝置：Nexus 5、Nexus 6、Nexus 9 或 Android 電視 +
- 目標： + Android M (預覽版) - API 級別 M +
- ABI： x86 +
+
+ 如需建立虛擬裝置以用於測試的詳細資訊，請參閱管理虛擬裝置。 +
diff --git a/docs/html-intl/intl/zh-tw/preview/support.jd b/docs/html-intl/intl/zh-tw/preview/support.jd new file mode 100644 index 0000000000000..2c2d66a82da6a --- /dev/null +++ b/docs/html-intl/intl/zh-tw/preview/support.jd @@ -0,0 +1,67 @@ +page.title=支援 +page.image=images/cards/card-support_16-9_2x.png + +@jd:body + ++ 如果您遇到錯誤或有關於 M 開發人員預覽版的意見反應，請在我們的問題追蹤器上建立問題。 + + +
+ ++ 如需更多支援，請加入 M 開發人員預覽版 Google+ 社群來討論您的開發體驗。 + + +
+ +版本資訊
+ + + +
+
M 開發人員預覽版，修訂版 1 (2015 年 5 月)
+
-
+
- 初始版本。 +
本文件內容
+-
+
- 測試權限 +
- 測試休眠與應用程式待命 +
- 自動備份與裝置識別碼 +
+ Android M 開發人員預覽版能夠讓您有機會確保您的應用程式能搭配下一個版本的平台運作。 +此預覽版包含許多 API 和足以影響應用程式的行為變更，如 API 總覽和行為變更中所述。 + +使用預覽版測試應用程式時，您必須著重在許多特定的系統變更，以確保使用者都能擁有良好的體驗。 + + +
+ ++ 本指南說明對應用程式測試預覽功能的內容與方法。您應優先測試這些特定的預覽功能，因為這些功能可能會對您的應用程式行為有非常大的影響： + + +
+ +-
+
- 權限 + +
- 休眠與應用程式待命 + +
- 自動備份與裝置識別碼 +
+ 如需有關如何設定使用預覽版系統映像的裝置或虛擬裝置以進行測試的詳細資訊，請參閱設定預覽版 SDK。 + +
+ + +測試權限
+ ++ 新的權限模型改變使用者對您的應用程式分配權限的方式。 +以前在安裝過程中會授與所有權限，現在您的應用程式則必須在執行階段向使用者要求個別的權限。 + +對於使用者而言，這個行為能夠對每個應用程式的Activity提供更細膩的控制，而且也能更瞭解應用程式為何要要求特定權限。 +使用者可以隨時個別對應用程式授與或撤銷權限。 +預覽版的這個功能最有可能影響到您應用程式的行為，而且可能會導致應用程式某些功能無法正常運作，或者這些功能會以降級的狀態運作。 + + +
+ ++ 這個變更會影響在新平台上執行的所有應用程式，甚至影響並非針對新平台版本開發的應用程式。 +平台會對舊版應用程式提供有限的相容性行為，但是您最好還是立即開始規劃將應用程式移轉到新的權限模型，以便能在官方平台上市時發佈更新的應用程式版本。 + + +
+ + +測試祕訣
+ ++ 使用下列測試祕訣，可以幫助您使用新的權限行為，規劃和執行應用程式測試。 + +
+ +-
+
- 辨別應用程式目前的權限與相關的程式碼路徑。 +
- 針對所有權限保護的服務與資料測試使用者流程。 +
- 測試各種組合的授與/撤銷權限。 +
- 從命令列使用 {@code adb} 工具管理權限：
+
-
+
- 依群組列出權限與狀態：
+
adb shell pm list permissions -d -g
+
+ - 使用下列語法授與或撤銷一或多個權限：
+adb shell pm [grant|revoke] <permission.name> ...
+
+
+ - 依群組列出權限與狀態：
+
- 分析使用權限的應用程式服務。 +
測試策略
+ ++ 權限變更會影響應用程式的結構和設計，同時也會影響使用者的體驗以及您提供給使用者的流程。 +您應該評估應用程式目前的權限作法，然後開始規劃您要提供的新流程。 +官方版本的平台會提供相容性行為，但是您最好規劃更新您的應用程式，而不要依賴這些行為。 + + +
+ ++ 辨別您的應用程式實際需要且使用到的權限，然後找出使用受權限保護之服務的各種程式碼路徑。 +您可以在新平台上測試，並且進行程式碼分析，來達到上述目的。 +測試時，您應該變更應用程式的 {@code targetSdkVersion} 為預覽版本，著重在加入執行階段權限。 +如需詳細資訊，請參閱設定預覽版 SDK。 + +
+ ++ 測試各種撤銷/加入權限的組合，著重在依據這些權限的使用者流程。 +如果相依性不明顯或邏輯不清楚時，您可以考慮重新分解或劃分流程以消除相依性，或是更清楚為何需要某個權限。 + + +
+ ++ 如需有關執行階段權限行為、測試和建議做法的詳細資訊，請參閱 權限開發人員預覽版頁面。 + + +
+ + +測試休眠與應用程式待命
+ ++ 當裝置處於閒置狀態，或者當您的應用程式不在使用中時，「休眠」與「應用程式待命」的省電功能會限制應用程式可以執行的背景處理量。 +系統可能加諸在應用程式的限制，包括網路受到限制或沒有網路、背景工作暫停、通知暫停、喚醒要求被略過，以及警示被略過。 + +如要確保您的應用程式能正確運作，而且這些省電功能也達到最好的效益，您應該透過模擬這些低電量狀態，測試您的應用程式。 + + +
+ +搭配休眠測試應用程式
+ +對您的應用程式測試休眠：
+ +-
+
- 設定 M 預覽版系統映像的硬體裝置或虛擬裝置。 +
- 將裝置連線到您的開發電腦並安裝您的應用程式。 +
- 執行您的應用程式並讓應用程式保持使用中。 +
- 執行下列命令，模擬裝置進入「休眠」模式：
+
+
+$ adb shell dumpsys battery unplug +$ adb shell dumpsys deviceidle step +$ adb shell dumpsys deviceidle -h +
+ +
+ - 觀察當裝置重新啟動時的應用程式行為。當裝置結束「休眠」時，確定應用程式順利回復。 + +
搭配應用程式待命測試應用程式
+ +對您的應用程式測試應用程式待命模式：
+ +-
+
- 設定 M 預覽版系統映像的硬體裝置或虛擬裝置。 +
- 將裝置連線到您的開發電腦並安裝您的應用程式。 +
- 執行您的應用程式並讓應用程式保持使用中。 +
- 執行下列命令，模擬應用程式進入待命模式：
+
+
+$ adb shell am broadcast -a android.os.action.DISCHARGING +$ adb shell am set-idle <packageName> true +
+ +
+ - 使用下列命令，模擬喚醒應用程式：
+
$ adb shell am set-idle <packageName> false
+
+ - 觀察當應用程式被喚醒時的行為。確定應用程式順利從待命模式回復。 +您尤其要檢查應用程式通知與背景工作是否有如預期般繼續運作 +。 +
針對應用程式進行自動備份與裝置特定識別碼
+ +如果您的應用程式在內部儲存空間存有任何裝置特定識別碼，例如 Google +雲端通訊註冊 ID，請確認按照建議做法排除這些儲存位置不要進行自動備份，如針對應用程式進行自動備份中所述。 + + +
diff --git a/docs/html-intl/intl/zh-tw/preview/testing/performance.jd b/docs/html-intl/intl/zh-tw/preview/testing/performance.jd new file mode 100644 index 0000000000000..5437e9da6bfa4 --- /dev/null +++ b/docs/html-intl/intl/zh-tw/preview/testing/performance.jd @@ -0,0 +1,656 @@ +page.title=測試顯示效能 +page.image=images/cards/card-test-performance_2x.png +page.keywords=效能, fps, 工具 + +@jd:body + + +本文件內容
+-
+
- 測量 UI 效能 + + +
- 自動化 UI 效能測試
+
-
+
- 設定 UI 測試 +
- 設定自動化 UI 測試 +
- 分類和修正觀察到的問題 +
+
+ 使用者介面效能測試可確保您的應用程式不只符合功能需求，與使用者與應用程式的互動也無比順暢，執行時每秒一致有 60 個畫面 (為什麼 60fps？)，任何畫面都不會遺漏或延遲，或稱為「閃避」現象。 + + +本文件說明可用以測量 UI 效能的工具，以及呈現可將 UI 效能測量與測試做法整合的方法。 + + +
+ + +測量 UI 效能
+ ++ 為改善效能，首先您需要測量系統效能的能力，接著在管道的各部分發生問題時加以診斷和辨識。 + + +
+ ++ dumpsys 是一種 Android 工具，可在裝置上執行和傾印有關系統服務狀態的有趣資訊。 + +將 gfxinfo 命令傳送至 dumpsys，會將錄製階段所發生與動畫的畫面相關的效能資訊以 logcat 提供輸出。 + + +
+ ++> adb shell dumpsys gfxinfo <PACKAGE_NAME> ++ +
+ 此命令會產生多種不同的畫面計時資料。 +
+ +彙總畫面統計資料
+ ++ 使用 M 預覽版，命令會在程序的生命週期全程收集畫面資料，並將彙總的分析列印到 logcat。 +例如： +
+ ++Stats since: 752958278148ns +Total frames rendered: 82189 +Janky frames: 35335 (42.99%) +90th percentile: 34ms +95th percentile: 42ms +99th percentile: 69ms +Number Missed Vsync: 4706 +Number High input latency: 142 +Number Slow UI thread: 17270 +Number Slow bitmap uploads: 1542 +Number Slow draw: 23342 ++ +
+ 這些高階統計資料是以高階方式轉換應用程式的轉譯效能，還有其在許多畫面的穩定性。 + +
+ + +精確畫面計時資訊
+ ++ M 預覽版隨附新的命令 gfxinfo，而 framestats 可從最近的畫面提供相當詳細的畫面計時資訊，讓您可以追蹤並更準確進行除錯。 + + +
+ ++>adb shell dumpsys gfxinfo <PACKAGE_NAME> framestats ++ +
+ 此命令會從應用程式所產生至少 120 個畫面當中，加上奈秒時間戳記印出畫面計時資訊。以下範例是 adb dumpsys gfxinfo <PACKAGE_NAME> framestats 的原始輸出： + + +
+ ++0,49762224585003,49762241251670,9223372036854775807,0,49762257627204,49762257646058,49762257969704,49762258002100,49762265541631,49762273951162,49762300914808,49762303675954, +0,49762445152142,49762445152142,9223372036854775807,0,49762446678818,49762446705589,49762447268818,49762447388037,49762453551527,49762457134131,49762474889027,49762476150120, +0,49762462118845,49762462118845,9223372036854775807,0,49762462595381,49762462619287,49762462919964,49762462968454,49762476194547,49762476483454,49762480214964,49762480911527, +0,49762479085548,49762479085548,9223372036854775807,0,49762480066370,49762480099339,49762481013089,49762481085850,49762482232152,49762482478350,49762485657620,49762486116683, ++ +
+ 這裡的每一行輸出都代表應用程式產生的一個畫面。每行都有固定的資料欄編號，描述畫面產生管道的各階段所花費的時間。 +下一節會詳細說明此格式，包括各資料欄代表的意義。 + +
+ + +Framestats 資料格式
+ ++ 由於資料區塊是以 CSV 格式輸出，所以可以直接將它貼到選擇的試算表工具，或使用指令碼來收集和剖析。 +下表說明輸出資料欄的格式。 +所有時間戳記都以奈秒為單位。 +
+ +-
+
- FLAGS
+
-
+
- FLAGS 資料欄的資料列均為 0，從 FRAME_COMPLETED 資料欄減去 INTENDED_VSYNC 資料欄可計算得出總畫面時間。 + + + +
- 如果這個值非零，應該略過該資料列，因為從正常效能來判斷，畫面已是極端值，版面配置與繪製預期都要花費 16ms 以上的時間。
+
+以下是發生這種情況的幾個原因：
+
-
+
- 視窗版面配置改變 (例如應用程式的第一個畫面或經過旋轉) + + + +
- 也可能是略過畫面，在這種情況下，某些值會含有記憶體回收的時間戳記。 +例如，如果畫面速度超過 60fps，或如果螢幕上空無一物，最後卻有所改變，就可能會略過畫面，這不一定是應用程式發生問題的徵兆。 + + + +
+
+
+ - INTENDED_VSYNC
+
-
+
- 預期的畫面起始點。如果這個值和VSYNC 不同，表示 UI 執行緒中發生的工作使它無法即時回應 vsync 訊號。 + + + +
+
+ - VSYNC
+
-
+
- 用於所有 vsync 接聽器和繪製畫面的時間值 (Choreographer 畫面回呼、動畫、View.getDrawingTime() 等等) + + + +
- 如要深入瞭解有關 VSYNC 和它如何影響您的應用程式，請參閱瞭解 VSYNC 影片。 + + + +
+
+ - OLDEST_INPUT_EVENT
+
-
+
- 輸入佇列中最舊輸入事件的時間戳記，或為 Long.MAX_VALUE，若沒有該畫面的輸入事件的話。 + + + +
- 這個值主要用於平台工作，對應用程式開發人員用處不大。 + + +
+
+ - NEWEST_INPUT_EVENT
+
-
+
- 輸入佇列中最新輸入事件的時間戳記，或為 0，若沒有該畫面的輸入事件的話。 + + + +
- 這個值主要用於平台工作，對應用程式開發人員用處不大。 + + + +
- 不過，透過查看 (FRAME_COMPLETED - NEWEST_INPUT_EVENT)，可以大略知道應用程式還會延遲多少時間。 + + +
+
+ - HANDLE_INPUT_START
+
-
+
- 將輸入事件分配給應用程式時的時間戳記。 + + +
- 查看這個值與 ANIMATION_START 之間的時間，即可測量出應用程式花費在處理輸入事件的時間。 + + + +
- 如果這個數字很高 (>2ms)，這表示應用程式花費在處理輸入事件(例如 View.onTouchEvent()) 的時間過長，指出需要將這項工作最佳化，或卸載交由其他執行緒處理。 + +請注意，還有一些情況本就預期且可接受這個數字較大，例如會啟動新活動或類似工作的點擊事件。 + + + +
+
+ - ANIMATION_START
+
-
+
- 向 Choreographer 註冊的動畫執行時的時間戳記。 + + +
- 查看這個值與 PERFORM_TRANVERSALS_START 之間的時間，即可判斷它花費多久的時間評估所有執行中的動畫器 (常見的有 ObjectAnimator、ViewPropertyAnimator 及 Transitions)。 + + + + +
- 如果這個數字很高 (>2ms)，可查看您的應用程式是否撰寫任何自訂動畫器，或 ObjectAnimators 正進行動畫處理的資料欄，並確定它們都適用於動畫。 + + + + +
- 如要深入瞭解 Choreographer，請參閱順滑流暢與否影片。 + + +
+
+ - PERFORM_TRAVERSALS_START
+
-
+
- 如果您從這個值中減去 DRAW_START，就可以得知版面配置和測量階段花費多久的時間完成。(請注意，在捲動或動畫期間，您會希望這個值趨近於零。) + + + + +
- 如要深入瞭解轉譯管道的測量與版面配置階段，請參閱無效判定、版面配置及效能影片。 + + + +
+
+ - DRAW_START
+
-
+
- performTraversals 的繪製階段開始的時間。這是判定無效的任何檢視顯示清單的記錄起始點。 + + + +
- 這個值與 SYNC_START 之間的時間，就是對樹狀結構中所有無效判定檢視呼叫 View.draw() 所花費的時間。 + + + +
- 如需繪製模型的詳細資訊，請參閱硬體加速或無效判定、版面配置及效能影片。 + + + +
+
+ - SYNC_START
+
-
+
- 繪製的同步階段開始的時間。 + + +
- 如果這個值與 ISSUE_DRAW_COMMANDS_START 之間的時間相當長 (約為 >0.4ms )，通常代表已繪製許多必須上傳至 GPU 的新點陣圖。 + + + + +
- 如要深入瞭解同步階段，請參閱設定檔 GPU 轉譯影片。 + + +
+
+ - ISSUE_DRAW_COMMANDS_START
+
-
+
- 硬體轉譯器開始對 GPU 發出繪製命令的時間。 + + +
- 這個值與 FRAME_COMPLETED 之間的時間大約就是應用程式產生的 GPU 工作量。 +太過度繪製或無效轉譯效果之類的問題都會顯示於此。 + + +
+
+ - SWAP_BUFFERS
+
-
+
- 相對於無趣的平台工作以外，呼叫 eglSwapBuffers 的時間。 + + +
+
+ - FRAME_COMPLETED
+
-
+
- 全部完成！花費在處理這個畫面的總時間，計算方法是 FRAME_COMPLETED - INTENDED_VSYNC。 + + +
+
+
+ 您能以不同的方式使用這項資料。顯示不同延遲貯體中畫面時間分布的長條圖就是一種簡單但實用的方式，請見下圖。 + +本圖可一目瞭然地告訴我們，大部分畫面都低於 16ms 的上限 (紅色除外)，但只有幾個畫面明顯超過上限。 + +我們可以查看此長條圖一段時間的變化，觀察出現的大規模位移或產生新的極端值。 +您也能根據資料中的許多時間戳記將輸入延遲、花費在版面配置的時間或其他類似的有趣度量指標繪成圖表。 + + +
+ +
+
+
+簡易畫面計時傾印
+ +
+ 如果 [開發人員選項] 中的 [設定檔 GPU 轉譯] 設定為 [In adb shell dumpsys gfxinfo]
+，adb shell dumpsys gfxinfo 命令會印出最近 120 個畫面的計時資訊，以定位鍵分隔值分成數個不同類別。
+
+這項資料非常適合用來指出可能是繪製管道的哪個部分太慢。
+
+
+ 類似於上述的 framestats，可以直接將它貼到選擇的試算表工具，或使用指令碼來收集和剖析。 + +下圖顯示許多由應用程式產生的畫面花費時間的分類細項。 + +
+ +
+
++ 執行 gfxinfo、複製輸出、將輸出貼入試算表應用程式，然後將資料繪製成堆疊長條圖的結果。 + +
+ ++ 每個直條都代表動畫的一個畫面，其高度代表計算該畫面所花費的毫秒數。 +長條的每個色塊都代表轉譯管道的不同階段，好讓您看出應用程式的哪部分可能產生瓶頸。 + +如需瞭解繪製管道以及如何最佳化的詳細資訊，請參閱硬體加速或無效判定、版面配置及效能影片。 + + +
+ + +控制統計資料收集時間
+ ++ framestats 與簡單的畫面計時都會收集極短時間內的資料 – 轉譯約需兩秒。 +為了精確控制這段時間，例如只限特定動畫的資料，您可以重設所有計數器，然後彙總收集的統計資料。 + + +
+ ++>adb shell dumpsys gfxinfo <PACKAGE_NAME> reset ++ +
+ 這也能和傾印命令本身結合使用，定期收集和重設，持續擷取兩秒時間內的畫面。 + + +
+ + +診斷效能回復
+ ++ 識別回復是追蹤問題和維護應用程式健康情況的第一步。 +不過，dumpsys 只能識別有問題存在與相關的嚴重性。 +您仍需要診斷造成效能問題的特定原因，以及找出適當的修正方式。 +因此，強烈建議您使用 systrace 工具。 + +
+ + +其他資源
+ ++ 如需 Android 的轉譯管道如何運作、常見問題以及如何修正的詳細資訊，下列的一些資訊可能會很實用： + + +
+ +-
+
- 轉譯效能 101 + +
- 為什麼 60fps？ + +
- Android UI 和 GPU + +
- 無效判定、版面配置及效能 + +
- 利用 Systrace 分析 UI 效能 + +
自動化 UI 效能測試
+ ++ UI 效能測試的方法之一就是讓測試人員對目標應用程式執行一組使用者操作，並以肉眼查看，或花費很長一段時間使用工具導向的方法，尋找閃避現象。 + +但這種靠人工的方式充滿危險，人類對畫面率變化的感知能力因人而異，而且這種方法也很費時、繁瑣且容易出錯。 + + +
+ ++ 較有效率的方法是從自動化的 UI 測試中記錄和分析重要效能度量指標。 +Android M 開發人員預覽版包含新的記錄功能，能夠輕鬆判斷應用程式動畫中閃避現象的數量與嚴重程度，還能用來建置嚴謹的程序，判斷目前的效能並追蹤未來的效能目標。 + + + +
+ ++ 本文會逐步說明建議用來使用資料以自動化效能測試的方法。 + +
+ ++ 這種方法大多分成兩個主要動作。首先，識別您要測試的項目，以及測試的方法。其次是設定和維護自動化測試環境。 + + +
+ + +設定 UI 測試
+ ++ 在您開始進行自動化測試之前，務必要決定幾個高階決策，才能適當瞭解您的測試空間與可能會有的需求。 + +
+ ++ 識別要測試的主要動畫 / 流程 +
+ ++ 請記住，流暢的動畫有所中斷時，就是使用者最容易看見效能低落的時候。 +因此，識別要測試哪種類型的 UI 動作時，最好著重在使用者最常看見或對他們的體驗最重要的主要動畫。 + +例如，以下是一些可能有利於識別的常見情況： +
+ +-
+
- 捲動主要的 ListView 或 RecyclerView + + +
- 非同步等待週期內的動畫 + + +
- 當中會載入 / 操縱點陣圖的任何動畫 + + +
- 包含 Alpha 透明混色的動畫 + + +
- 使用畫布繪製的自訂檢視 + +
+ 和您團隊的工程人員、設計師及產品經理合作，優先考慮將這些主要產品動畫放入測試涵蓋範圍內。 + +
+ ++ 定義未來目標並予以追蹤 +
+ ++ 從高階觀點來看，重要的是識別特定的效能目標，並著重在撰寫測試及收集相關資料。 +例如： +
+ +-
+
- 您是否只想初次開始追蹤 UI 效能以深入瞭解？ + + +
- 您是否想要避免可能在未來導入的回復？ + + +
- 今日有 90% 的順暢畫面並想要在本季達到 98%？ + + +
- 今日有 98% 的順暢畫面且不想要回復？ + + +
- 您的目標是改善低階裝置上的效能嗎？ + +
+ 在上述的這些情況中，您會想要有歷史追蹤功能，來顯示不同應用程式版本間的效能。 + +
+ ++ 識別測試要用的裝置 +
+ ++ 應用程式效能會因其執行所在裝置而異。有些裝置包含的記憶體較少、GPU 較不強大或 CPU 晶片速度較慢。 +這表示可在某組硬體上執行良好的動畫，在其他組合上不一定能執行良好，更糟的是可能會在管道的不同部分產生瓶頸。 + +使用者所見可能會不同，為將這點列入考量，請挑選涵蓋當前高階裝置、低階裝置、平板電腦等的一系列裝置執行測試。 + +尋找 CPU 效能、RAM、畫面密度、大小等方面的變化。 +高階裝置上通過的測試，在低階裝置上可能會失敗。 + +
+ ++ UI 測試的基本架構 +
+ ++ 工具套件 (例如 UI Automator 和 Espresso) 是為協助將使用者在您的應用程式四處移動的動作自動化而建置。 + +這些都是模擬使用者與裝置互動的簡單架構。 +如要使用這些架構，您要有效地建立會逐一執行一組使用者動作的獨特指令碼，然後在裝置上自行播放。 + + +
+ +
+ 連同 dumpsys gfxinfo，再結合這些自動化測試，您可快速建立可重現系統，讓您執行測試並測量該特定情況下的效能資訊。
+
+
+
設定自動化 UI 測試
+ ++ 在您能夠執行 UI 測試，還有可從單一測試收集資料的管道後，下一個重要步驟是利用可多次執行該項測試的架構，然後彙總產生的效能資料，以供您的開發團隊進一步分析。 + + + +
+ ++ 測試自動化的架構 +
+ ++ 直接在目標裝置/模擬器上執行的 UI 測試架構 (例如 UI Automator) 毫無價值。 +因為效能收集資訊是由主控機器透過 ADB 傳送命令驅動 dumpsys gfxinfo 來完成。 +MonkeyRunner 架構是為了協助橋接這些個別實體開發。在主控機器上執行的指令碼處理系統可對一組連接的裝置發出命令，也能接收來自這些裝置的資料。 + + + +
+ ++ 建置一組指令碼以適當自動化 UI 效能測試，至少應能利用 monkeyRunner 來完成下列工作： + +
+ +-
+
- 對目標裝置或模擬器載入和啟動所需的 APK。 + + +
- 啟動並允許執行 UI Automator UI 測試 + + +
- 透過 dumpsys gfxinfo 收集效能資訊。 + + +
- 彙總資訊並以對開發人員有用的方式顯示。 + +
分類和修正觀察到的問題
+ ++ 在辨識出問題模式與回復之後，下一個步驟是辨識和套用修正。 +如果您的自動化測試架構會為畫面保留精確的計時分類細項，可幫助您詳細審察目前可疑的程式碼/版面配置變化 (在回復的情況下)，或在您切換為靠人工探究時縮小要分析的系統部分。 + + +如需靠人工探究時，systrace 是開始進行的好地方，顯示轉譯管道各階段、系統中每個執行緒與核心，還有您所定義任何自訂事件標記的精確計時資訊。 + + +
+ ++ 適當分析暫時的計時 +
+ ++ 請務必注意，從轉譯效能中取得和測量計時的困難度。 +這些數字不具決定性且通常受系統狀態、可用記憶體數目、溫度調節，還有上次太陽閃焰何時衝擊您所在地區影響。 + +重點是您執行相同的測試兩次，而每次得到的數字都有些微不同，數字很接近但不會完全相同。 + + +
+ ++ 以這種方式適當收集和分析資料，表示執行相同的測試多次，並累積結果取平均值或中間值。(為了簡單起見，我們稱之為「批次」) 這可讓您粗略計算測試的效能，而不需要精確的計時。 + + + +
+ ++ 在變更的程式碼之間使用批次，可看出那些變更對效能的影響。 +如果前次變更批次的平均畫面率大於後來變更批次，您通常會有那項特定變更的整體 win wrt 效能。 + + +
+ ++ 這表示您執行的任何自動化 UI 測試都應將此概念列入考量，同時考量可能會在測試期間發生的任何異常情況。 +例如，您的應用程式效能若因為某些裝置問題而突然下降 (並非由您的應用程式引起)，您可能會想要重新執行批次，以讓取得的計時較不混亂。 + + + +
+ ++ 應該執行多少次測試才能獲得有意義的測量結果呢？最少應執行 10 次，若執行更多次 (像是 50 或 100 次) 可以產生更準確的結果 (當然您現在是以時間換取準確度)。 + + +