自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
在用户 build 上自动启用 USB 调试
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将用户 build 刷写到设备上之后,您需要重新启用 USB 调试。OmniLab ATS 可以通过“AOA 设备操作”自动执行此步骤,该操作会向设备发送一系列界面命令。
记录 AOA 命令
首先,请使用 WebAOA 命令修改工具录制用于启用 USB 调试的命令列表。
图 1. OmniLab ATS 中的 WebAOA 命令修改工具链接。
默认情况下,也可以通过 http://localhost:8000/webaoa 访问。
WebAOA 允许您使用模拟触摸屏操纵本地设备,并录制您的界面交互。
图 2. 修改用于在 WebAOA 中启用 USB 调试的命令。
支持以下四种命令:
完成录制命令后,您可以将它们复制到剪贴板或保存到文件中。
创建 AOA 设备操作
您需要将录制的命令添加到设备操作中,才能自动重新启用 USB 调试。
创建新的设备操作,添加一个 TF 目标准备器,并将其类名称设置为 com.android.tradefed.targetprep.AoaTargetPreparer
。将 WebAOA 中录制的命令复制到其 action
选项。
图 3. 用于在 Android 10 GSI 上启用 USB 调试的 AOA 设备操作。
使用 AOA 设备操作
在安排测试运行时,添加 AOA 设备操作,并将其直接放置在设备刷写操作之后。
图 4. 安排运行,从而刷写用户 build 并重新启用 USB 调试。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-04。
[null,null,["最后更新时间 (UTC):2025-03-04。"],[],[],null,["# Enable USB debugging on user builds automatically\n\nAfter flashing a user build onto a device, you need to re-enable USB\ndebugging. OmniLab ATS can automate this step using *AOA device actions*, which\nsend a series of UI commands to a device.\n| **Note:** This procedure uses the [Android Open Accessory protocol](/docs/core/interaction/accessories/protocol), which supports Android 4.1+ and doesn't require ADB.\n\nRecord the AOA commands\n-----------------------\n\nFirst, use the *WebAOA command editing tool* to record the list of commands to\nenable USB debugging.\n\n**Figure 1.** Link to the WebAOA command editing tool in OmniLab ATS.\n\nIt is also accessible at \u003chttp://localhost:8000/webaoa\u003e\nby default.\n\nWebAOA lets you manipulate a local device using a simulated touchscreen and\nrecord your UI interactions.\n\n**Figure 2.** Editing the commands for enabling USB debugging in WebAOA.\n\nFour types of commands are supported:\n\n- Clicking and swiping on the touchscreen\n (`click `\u003cvar translate=\"no\"\u003eX\u003c/var\u003e` `\u003cvar translate=\"no\"\u003eY\u003c/var\u003e and\n `swipe `\u003cvar translate=\"no\"\u003eX1\u003c/var\u003e` `\u003cvar translate=\"no\"\u003eY1\u003c/var\u003e` `\u003cvar translate=\"no\"\u003eDURATION\u003c/var\u003e` `\u003cvar translate=\"no\"\u003eX2\u003c/var\u003e` `\u003cvar translate=\"no\"\u003eY2\u003c/var\u003e)\n\n- Pressing device buttons (`back`, `home`, and `wake`)\n\n- Writing text and pressing key combinations\n (`write `\u003cvar translate=\"no\"\u003eTEXT\u003c/var\u003e and\n `key [`\u003cvar translate=\"no\"\u003eKEY\u003c/var\u003e` ...]`)\n\n- Waiting for a specified duration (`sleep `\u003cvar translate=\"no\"\u003eDURATION\u003c/var\u003e)\n\nWhen you are finished recording commands, you can copy them to your clipboard or\nsave them to a file.\n\nCreate an AOA device action\n---------------------------\n\nTo automatically re-enable USB debugging, the recorded commands need to be added\nto a device action.\n\n[Create a new device action](/docs/core/tests/development/android-test-station/ats-user-guide#create-a-new-device-action) and\nadd a TF Target Preparer with its class name set to\n[`com.android.tradefed.targetprep.AoaTargetPreparer`](/reference/tradefed/com/android/tradefed/targetprep/AoaTargetPreparer).\nCopy the commands recorded in WebAOA into its `action` option.\n\n**Figure 3.** AOA device action for enabling USB debugging on Android 10 GSI.\n\nUse an AOA device action\n------------------------\n\nWhen scheduling a test run, add your AOA device action and place it directly\nafter your device-flashing action.\n\n**Figure 4.** Scheduling a run to flash a user build and re-enable USB\ndebugging."]]