OPPO主题组件开发 - 调试与预览
本篇作为 OPPO主题组件调试与预览 文档的补充,因为它真的很简单而且太老,一些命令已发生变化😪
此图片来自官网
一、调试前准备
1. PC
端下载 adb命令工具
- 下载
下载地址 https://adbdownload.com/,或从其他地方下载也可 - 解压,放在你想放的文件夹下
- 配置环境变量
右键我的电脑/此电脑
选择属性
,在弹出的面板里选择高级系统设置
在弹出的面板里,选择环境变量
,在弹出的面板里找到Path
,点击编辑
在弹出的面板里,选择新建
,在新建的空白行内填入,你解压后的文件夹地址,比我的是D:\Tools\windows\platform-tools
最后一步步确定
,关闭所有面板 - 测试
打开命令行工具,输入adb
,出现如下,则表示安装成功2. 手机端安装
下载地址参见多彩引擎
https://open.oppomobile.com/new/developmentDoc/info?id=12221
,下载后安装到手机上3. 手机连接电脑
- 手机找到
开发者选项
没这个选项的话,请打开手机设置
->关于本机
->版本信息
,然后持续点击版本号
,直至出现类似您现在已处于开发者模式
的提示即可。然后在设置
->其他设置
下即可找到开发者选项
- 打开开发者选项里的
USB调试
出现提示,请点击确定
- 手机通过
USB
数据线连接电脑
连接无反应的,请检查接口或换线
连接后,选择传输文件
弹出框提示允许USB调试吗
,请选择允许
经历以上步骤,则准备工作已做好
二、adb
调试和预览
打开
cmd
命令工具,开始进行调试
1. 测试是否连接正常
输入 adb devices
,出现下列情况,则说明连接正常,如果没有 device
和它前面的id,则说明连接不成功1
2
3PS 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
2PS 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
2PS 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. 手机端打开 多彩引擎
软件
点击新出现的压缩包,出现组件预览,然后 添加到桌面
即可
三、开发者进阶
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远程真机的官方介绍
前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