快速开始

小程序新容器目前处于公测阶段。

• 仅支持 mPaaS 原生 AAR 的接入方式。更多信息，请参考 原生 AAR 接入方式简介。

• 仅在自定义基线版本 cp_change_23596 中提供。

前置条件

将小程序新容器接入 Android 之前，请确保您已经开通 mPaaS，并使用原生 AAR 的接入方式完成 mPaaS 接入。

接入步骤

小程序新容器接入步骤概述如下：

1. 选择定制基线。

1. 添加自定义基线 cp_change_23596。

2. 添加小程序组件。

2. 初始化 mPaaS。

1. 初始化 mPaas。

2. 申请 UC 内核。

   说明

   UC 内核非必需。仅使用内嵌组件时所需，如：内嵌 webview 组件，内嵌 map 组件等。使用 UC 内核，可以使小程序拥有同层能力，并且拥有更好的渲染体验。

3. 发布小程序。

1. 进入小程序后台。

2. 配置虚拟域名。

3. 创建小程序。

4. 发布小程序。

4. 启动小程序。

下文将对各步骤操作进行详细说明。

选择定制基线

1. 添加自定义基线 cp_change_23596。

2. 添加小程序组件。

初始化 mPaaS

1. 初始化 mPaaS，在 Application 中添加以下代码。

   public class MyApplication extends Application implements MPInitParam.MPCallback {
       @Override
       public void onCreate() {
           super.onCreate();
           // mPaaS 初始化
           MriverInitParam mriverInitParam = MriverInitParam.getDefault();
           mriverInitParam.setMriverInitCallback(new MriverInitCallback() {
               @Override
               public void onInit() {
                   if (com.alibaba.ariver.kernel.common.utils.ProcessUtils.isMainProcess()) {
                       // 小程序相关配置，比如自定义jsapi，titlebar等
   
                   }
               }
   
               @Override
               public void onError(Exception e) {
   
               }
           });
           MP.init(this, MPInitParam.obtain().setCallback(this).addComponentInitParam(mriverInitParam));
       }
       
       @Override
       public void onInit() {
           // init success
       }
   }

2. 申请 UC 内核，根据实际需求添加。若需要添加，请在使用小程序之前申请并配置 UC 内核。详情参见 申请 UC 内核。

发布小程序

启动小程序之前，您需要先通过 mPaaS 控制台发布该小程序，步骤如下。

1. 进入小程序后台。登录 mPaaS 控制台，进入目标应用后，从左侧导航栏进入 小程序 > 小程序发布 页面。

2. 配置虚拟域名。如果是第一次配置虚拟域名，请先在 小程序 > 小程序发布 > 配置管理 中配置虚拟域名。虚拟域名可以为任意域名，建议使用您的企业域名，如 test.com。

   

3. 创建小程序。进入 mPaaS 控制台，完成以下操作：

   1. 单击左侧导航栏的 小程序 > 小程序发布。

   2. 在打开的小程序包列表页，单击 新建。

   3. 在 新建小程序 窗口，填写小程序的 ID 和小程序名称，单击 确定。其中，小程序 ID 为任意 16 位数字，例如 2018080616290001。

   4. 在小程序 App 列表下，找到新增的小程序，单击 添加。

      

   5. 在基本信息栏，完成以下配置：

      • 版本：填写小程序包的版本号，例如 1.0.0.0。

      • 客户端范围：选择小程序 App 对应的 Android 客户端最低版本和最高版本。在这个范围内的客户端 App 可以启动对应的小程序，否则无法启动。这里最低版本可以填写 0.0.0，最高版本可以不填，代表客户端所有版本都可以启动这个小程序。

        说明

        此处务必填写 Android 的客户端版本，而非小程序版本。

      • 图标：单击 选择文件 上传小程序包的图标。第一次创建小程序时必须上传图标。示例图标如下：

      • 文件：上传小程序包资源文件，文件格式为 .zip。我们准备了一个 mPaaS 示例小程序（点此下载），可以直接上传。

        说明

        在上传前，需将此示例小程序的 .zip 文件名以及压缩包内的文件夹名均修改为小程序的 16 位数字 ID。

   6. 在配置信息栏，完成以下配置：

      • 主入口 URL：必填，小程序的首页。主入口 URL 格式为：/index.html#xxx/xxx/xxx/xxx，其中 # 后方的 xxx/xxx/xxx/xxx 是小程序的 app.json 中的 pages 中的第一个值。如下图所示，mPaaS 示例小程序的主入口为：/index.html#page/tabBar/component/index。

      • 其他配置保持默认即可。

   7. 勾选 已确认以上信息准确，提交后不再修改。

   8. 单击 提交。

4. 发布小程序。进入 mPaaS 控制台，完成以下步骤：

   1. 单击左侧导航栏的 小程序 > 小程序发布 > 小程序正式包管理。

   2. 单击左侧导航栏的 实时发布 > 小程序包管理 > 小程序正式包管理。

   3. 在打开的小程序包列表页中，选择您要发布的小程序包与版本，单击 创建发布。

      

   4. 在创建发布任务栏，完成以下配置：

      • 发布类型：选择 正式 发布类型。

      • 发布描述：选填。

      单击 确定 完成发布创建。

      

启动小程序

完成上述步骤之后，在 Android 工程中，通过如下代码，启动示例小程序：

Mriver.startApp("2018080616290001");