接入真機預覽和調試功能步驟如下。
僅在 mPaaS 10.1.60 及以上版本中支持。
在 H5 容器配置文件 (在示例工程中名為
custom_config.json
)中加入h5_remote_debug_host
的值,此值為調試通信的服務器地址。打開您從 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" }
隨后在工程的
custom_config.json
中添加h5_remote_debug_host
。key
為h5_remote_debug_host
,value
為上方配置文件中的debug_url
字段,并在末尾加上/host/
,示例如下:[ { "key": "h5_remote_debug_host", "value": "wss://cn-hangzhou-mproxy.cloud.alipay.com/host/" } ]
設置虛擬域名。
在 mPaaS 控制臺中,點擊 小程序 > 小程序發布 > 配置管理,在 域名管理 中可獲取您之前填寫的虛擬域名。
在工程中打開
MyApplication
,在應用啟動或啟動小程序前調用tinyHelper.setTinyAppVHost
方法設置小程序所使用的虛擬域名,代碼示例如下:說明需將下方代碼示例中的
example.com
替換為您所設置的虛擬域名。MPTinyHelper tinyHelper = MPTinyHelper.getInstance(); tinyHelper.setTinyAppVHost("example.com");
設置白名單。使用真機預覽和調試功能時,客戶端需要配置用戶唯一標識。即根據應用實際情況,在 userId 方法中返回 App 的唯一標識,例如用戶名、手機號、郵箱等。在設置虛擬域名的代碼下方,添加如下代碼。后續在小程序 IDE 插件的 配置白名單 中填入的值,需與此處配置的 userId 保持一致。
MPLogger.setUserId("your userId");
接入掃碼組件并解析預覽或調試的二維碼,解析二維碼并啟動小程序的代碼如下:
如果您使用的是 10.1.68.6 及以上版本的基線,請使用如下代碼進行解析。您可以在 mPaaS 插件 mPaaS > 組件管理 菜單下查看準確的基線版本號。
//第一個參數為二維碼的 uri,第二個參數為自定義啟動參數。若無自定義啟動參數則填 new Bundle()。 MPTinyHelper.getInstance().launchIdeQRCode(uri, new Bundle());
如果您使用的是 10.1.68.6 以下或 10.1.60 版本的基線,請使用如下代碼進行解析。
// uri 是二維碼對應的內容 String scheme = uri.getScheme(); if ("mpaas".equals(scheme)) { Bundle params = new Bundle(); String appId = uri.getQueryParameter("appId"); for (String key : uri.getQueryParameterNames()) { if (!"appId".equalsIgnoreCase(key)) { params.putString(key, uri.getQueryParameter(key)); } } LauncherApplicationAgent.getInstance().getMicroApplicationContext() startApp(null, appId, params); }