本篇作为 OPPO主题组件调试与预览 文档的补充，因为它真的很简单而且太老，一些命令已发生变化😪

image
此图片来自官网

一、调试前准备

1. PC 端下载 adb命令工具

  1. 下载
    下载地址 https://adbdownload.com/，或从其他地方下载也可
  2. 解压，放在你想放的文件夹下
  3. 配置环境变量
    右键 我的电脑/此电脑 选择 属性，在弹出的面板里选择 高级系统设置
    image
    在弹出的面板里，选择 环境变量，在弹出的面板里找到 Path，点击 编辑
    image
    在弹出的面板里，选择 新建，在新建的空白行内填入，你解压后的文件夹地址，比我的是 D:\Tools\windows\platform-tools
    image
    最后一步步确定，关闭所有面板
  4. 测试
    打开命令行工具，输入 adb，出现如下，则表示安装成功
    image

    2. 手机端安装 多彩引擎

    下载地址参见 https://open.oppomobile.com/new/developmentDoc/info?id=12221，下载后安装到手机上

    3. 手机连接电脑

  5. 手机找到 开发者选项
    没这个选项的话，请打开手机 设置 -> 关于本机 -> 版本信息，然后持续点击 版本号，直至出现类似 您现在已处于开发者模式 的提示即可。然后在 设置 -> 其他设置 下即可找到 开发者选项
    image
  6. 打开开发者选项里的 USB调试
    出现提示，请点击 确定
    image
  7. 手机通过 USB 数据线连接电脑
    连接无反应的，请检查接口或换线
    连接后，选择 传输文件
    image
    弹出框提示允许USB调试吗，请选择 允许
    image

经历以上步骤，则准备工作已做好

二、adb 调试和预览

打开 cmd 命令工具，开始进行调试

1. 测试是否连接正常

输入 adb devices，出现下列情况，则说明连接正常，如果没有 device 和它前面的id，则说明连接不成功

1
2
3
PS C:\Users\Administrator> adb devices
List of devices attached
8d58ec40        device

2. 创建手机端的 widget 文件夹

输入 adb shell mkdir /sdcard/Android/data/com.heytap.colorfulengine/files/widget，因为我已创建过，所以它提示已存在
关于命令中间 com.heytap.colorfulengine 这个地址，可以打开 多彩引擎 软件，最上面有提示

1
2
PS C:\Users\Administrator> adb shell mkdir /sdcard/Android/data/com.heytap.colorfulengine/files/widget
mkdir: '/sdcard/Android/data/com.heytap.colorfulengine/files/widget': File exists

3. 将创建的组件包发送到手机

如果你还没有创建自己的组件，可以先下载官方示例里 模板包，下载后重新命名简短点，然后 cd 到当前目录(或在当前目录右键打开 cmd 命令)执行发送命令 adb push xxx.zip /sdcard/Android/data/com.heytap.colorfulengine/files/widget。xxx.zip 请修改为具体你命名的文件名。

1
2
PS D:\workspace\2023\oppoTheme\oppowidget> adb push system.zip /sdcard/Android/data/com.heytap.colorfulengine/files/widget
system.zip: 1 file pushed, 0 skipped. 131.9 MB/s (240171 bytes in 0.002s)

出现以上提示，则表明发送成功

4. 手机端打开 多彩引擎 软件

点击新出现的压缩包，出现组件预览，然后 添加到桌面 即可
image

三、开发者进阶

1. 其他常用的 adb 命令

安装本地APK软件

1
adb install xxx.apk

删除手机上的组件文件

1
adb shell rm /sdcard/Android/data/com.heytap.colorfulengine/files/widget/xxx.zip

卸载手机软件请参考其他博文 使用adb安装或卸载卸载手机系统应用

2. 连接OPPO远程真机

请先查看 OPPO远程真机的官方介绍

image
前2步进行完毕后，执行以下命令

1
2
3
4
5
6
7
8
# 执行云真机连接命令，输入账号和密码，连接可用端口，比如23008，提示`failed to authenticate to 127.0.0.1:23008`不用理会是正常的
adb connect 127.0.0.1:14243
# 安装测试软件
adb install ColorfulEngine#Widget_13.0.62-Test-20230829-315979231.apk
# 安装完成后，其余操作和本地连接手机相同，推送组件然后查看
adb push xxx.zip /sdcard/Android/data/com.heytap.colorfulengine/files/widget
# 断开连接
adb disconnect 127.0.0.1:14243

3. PC端集成 组件打包/删除/压缩 命令

请查看我的上一篇博文 Cygwin，在windows中使用linux命令

安装 Cygwin 后，整个调试流程示例如下：

1
2
3
4
5
6
# 如果旧压缩包，先删除
rm .\xxx.zip
# 压缩组件包
zip -r xxx.zip .\system\
# 推送压缩包到手机
adb push xxx.zip /sdcard/Android/data/com.heytap.colorfulengine/files/widget