小程序 IDE 支持真機預覽與調試,您可以在手機客戶端上預覽當前代碼的實際效果或進行調試。本文對真機預覽與調試的操作步驟,以及過程中使用的接口進行了說明。
前置條件
使用小程序 IDE 真機預覽與調試功能之前,請確保您的 Android 小程序已接入真機預覽與調試功能。詳情請參考 MriverDebug 調試 API。
操作步驟
打開您從 mPaaS 控制臺 下載的名為
config.json
的小程序 IDE 配置文件,找到debug_url
字段。配置文件示例如下:
{ "login_url":"https://mappcenter.cloud.alipay.com/ide/login", "uuid_url":"http://cn-hangzhou-mproxy.cloud.alipay.com/switch/uuid", "debug_url":"wss://cn-hangzhou-mproxy.cloud.alipay.com", "sign":"3decfd66c2924489204b4b0f38a9c228", "upload_url":"https://mappcenter.cloud.alipay.com/ide/mappcenter/mds" }
通過
setWssHost
設置調試地址,并在末尾加上/host/
,示例如下。MriverDebug.setWssHost("wss://cn-hangzhou-mproxy.cloud.alipay.com/host/");
單擊 IDE 右上方的 預覽 或 真機調試。
IDE 會將當前代碼生成
.zip
包并上傳至控制臺。控制臺自動創建發布任務,生成二維碼并返回至 IDE。
說明未正確設置白名單可能會導致二維碼構建和生成失敗。更多信息請參見 白名單設置。
使用手機客戶端掃描 IDE 中顯示的二維碼。掃碼之后,會觸發控制臺下發小程序包。
二維碼有效期為 15 分鐘,超時后會顯示 刷新 按鈕。
待手機客戶端收到小程序包后,即可在手機端進入預覽或調試界面。
接口說明
下文對真機預覽與調試操作過程中使用的接口以及參數進行了說明,并提供了對應的代碼示例。
MriverDebug.debugAppByScan(Activity activity)
該接口用于預覽與調試,使用 mPaaS 自帶掃碼,預覽小程序。
代碼示例
MriverDebug.debugAppByScan(MainActivity.this);
參數說明
名稱 | 類型 | 描述 | 必填 |
activity | Activity | 所在的 Activity。 | 是 |
MriverDebug.debugAppByUri(Activtiy activity,Uri uri)
該接口用于跳轉到小程序,推薦跳轉到啟動小程序所在頁面的 activity。使用自定義掃碼,預覽小程序。
代碼示例
MriverDebug.debugAppByUri(MainActivity.this,intent.getData());
參數說明
名稱 | 類型 | 描述 | 必填 |
activity | Activity | 所在的 Activity。 | 否 (推薦填寫) |
uri | Uri | 二維碼掃描返回的數據。 | 否 |
文檔內容是否對您有幫助?