Android 小程序接入真机预览与调试

接入真机预览和调试功能步骤如下：

1. 在 H5 容器配置文件 （在示例工程中名为 custom_config.json）中加入 h5_remote_debug_host 的值，此值为调试通信的服务器地址。
   1. 打开您从 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"
      }

   2. 随后在工程的 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/"
      }
      ]

2. 设置虚拟域名。
   1. 在 mPaaS 控制台中，点击 小程序 > 小程序发布 > 配置管理，在 域名管理 中可获取您之前填写的虚拟域名。
      
   2. 在工程中打开 MyApplication，在应用启动或启动小程序前调用 tinyHelper.setTinyAppVHost 方法设置小程序所使用的虚拟域名，代码示例如下：
      
      说明：需将下方代码示例中的 demo.com 替换为您所设置的虚拟域名。

      MPTinyHelper tinyHelper = MPTinyHelper.getInstance();
      tinyHelper.setTinyAppVHost("demo.com");

3. 设置白名单。
   使用真机预览和调试功能时，客户端需要配置用户唯一标识。即根据应用实际情况，在 userId 方法中返回 App 的唯一标识，例如用户名、手机号、邮箱等。
   在设置虚拟域名的代码下方，添加如下代码。后续在小程序 IDE 插件的 配置白名单 中填入的值，需与此处配置的 userId 保持一致。

   MPLogger.setUserId("your userId");

4. 接入扫码组件并解析预览或调试的二维码，解析二维码并启动小程序的代码如下：
   • 如果您使用的是 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);
     }