OPPO主題元件開發 - 除錯與預覽

唯之為之發表於2023-09-25

本篇作為 OPPO主題元件除錯與預覽 文件的補充,因為它真的很簡單而且太老,一些命令已發生變化?

1. 除錯前準備

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. 手機連線電腦

  1. 手機找到 開發者選項
    沒這個選項的話,請開啟手機 設定 -> 關於本機 -> 版本資訊,然後持續點選 版本號,直至出現類似 您現在已處於開發者模式 的提示即可。然後在 設定 -> 其他設定 下即可找到 開發者選項
    image
  2. 開啟開發者選項裡的 USB除錯
    出現提示,請點選 確定
    image
  3. 手機透過 USB 資料線連線電腦
    連線無反應的,請檢查介面或換線
    連線後,選擇 傳輸檔案
    image
    彈出框提示允許USB除錯嗎,請選擇 允許
    image

經歷以上步驟,則準備工作已做好

2. adb 除錯和預覽

開啟 cmd 命令工具,開始進行除錯

1. 測試是否連線正常

輸入 adb devices,出現下列情況,則說明連線正常,如果沒有 device 和它前面的id,則說明連線不成功

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 這個地址,可以開啟 多彩引擎 軟體,最上面有提示

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/widgetxxx.zip 請修改為具體你命名的檔名。

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

3. 開發者進階

1. 其他常用的 adb 命令

安裝本地APK軟體

adb install xxx.apk

刪除手機上的元件檔案

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

解除安裝手機軟體請參考其他博文 使用adb安裝或解除安裝解除安裝手機系統應用

2. 連線OPPO遠端真機

請先檢視 OPPO遠端真機的官方介紹

image
前2步進行完畢後,執行以下命令

# 執行雲真機連線命令,輸入賬號和密碼,連線可用埠,比如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 後,整個除錯流程示例如下:

# 如果舊壓縮包,先刪除
rm .\xxx.zip
# 壓縮元件包
zip -r xxx.zip .\system\
# 推送壓縮包到手機
adb push xxx.zip /sdcard/Android/data/com.heytap.colorfulengine/files/widget