快速开始

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

  • 仅支持 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_23596Choose a baseline

  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
        }
    }
  1. 申请 UC 内核,根据实际需求添加。若需要添加,请在使用小程序之前申请并配置 UC 内核。详情参见 申请 UC 内核

发布小程序

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

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

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

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

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

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

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

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

      5
    5. 在基本信息栏,完成以下配置:

      • 版本:填写小程序包的版本号,例如 1.0.0.0

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

        说明

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

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

      • 文件:上传小程序包资源文件,文件格式为 .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/index7

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

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

    8. 单击 提交8

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

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

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

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

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

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

      • 发布描述:选填。

      单击 确定 完成发布创建。

启动小程序

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

Mriver.startApp("2018080616290001");
说明

上方代码中的 2018080616290001 为小程序 ID,此处仅为本文示例,操作中请填写您的小程序 ID。

阿里云首页 移动开发平台 mPaaS 相关技术圈