執行 Winscope

Winscope 追蹤記錄是 Android 架構的一部分。本頁面說明如何在本機下載、建構及執行 Winscope 追蹤檢視器。

在本機建構 Winscope

請按照下列步驟設定電腦，以執行 Winscope 追蹤器：

1. 下載 Android 來源。

2. 前往 Winscope 資料夾：

   cd development/tools/winscope
   

3. 使用下列指令安裝依附元件：

   npm install
   

   如要查看可用指令清單，請執行：npm run

4. 使用下列指令建構所有正式版和測試版目標：

   npm run build:prod
   

5. 使用下列指令執行 Winscope：

   npm run start
   

分別建構各個部分

您可以使用下列指令，分別建構 Winscope 的個別部分：

執行測試

Winscope 包含單元測試和端對端測試。如要執行這些測試，請使用 npm run <command>：

端對端測試

執行端對端測試前，請先啟動遠端工具，並安裝正確版本的 Chrome 驅動程式。在下列程式碼片段中，run test:e2e 指令會自動安裝 Chrome 驅動程式。

$ npm run start
$ npm run start:remote_tool_mock
$ npm run test:e2e

下表列出必要指令及其說明。如要執行這些指令，請使用 npm run command：

更新 @IntDef 對應

@IntDef 是 Android 中用來限制整數可能值的註解。Winscope 會使用這些註解的對應，顯示值名稱而非整數。

如要更新 @IntDef 對應，請按照下列步驟操作：

1. 建構 :framework-minus-apex-intdefs，供註解前置處理器執行：

   mp :framework-minus-apex-intdefs
   

2. 將產生的 intDefMapping.json 檔案複製到預先建構的存放區：

   $ python3 -c 'import sys,json,collections; print(json.dumps(collections.OrderedDict(sorted(collections.ChainMap(*map(lambda x:json.load(open(x)), sys.argv[1:])).items())), indent=2))' $(find out/soong/.intermediates/frameworks/base -iname intDefMapping.json) > ./development/tools/winscope/src/common/intDefMapping.json
   

3. 使用 repo upload 在 Winscope 中上傳變更。

其他指令

除了建構和測試之外，Winscope 指令碼還包含其他功能，如表格所示。如要執行這些測試，請使用 npm run command：

疑難排解

請參考下列疑難排解提示：

• 錯誤 ProtocolError: missing required '<FIELD>' 或 TypeError: Cannot read property '<PROP>' of null

  • 如果追蹤記錄檔案是使用含有新必要欄位的新 proto 定義建立，就會發生這種情況。

    1. 請確認您是在正確的 Winscope 版本 (master、S 或 R) 中開啟追蹤記錄。

    2. 如果您在 Proto 中建立新欄位，請使用 npm run build:protos 重新編譯 Winscope 中的 Proto。

• 部分已安裝的依附元件版本有誤 (建構失敗)

  • 還原對 package.json 和 package-lock.json 的變更。移除 node_modules。再次執行 npm install。

• 我在其中一個 proto 檔案中新增了欄位。如何顯示？

  • Winscope 會使用編譯時的 Proto 定義，因此預設不會顯示新欄位。如要顯示新欄位，請使用 npm run build:protos 重新建構 Proto。