快速开始
小程序新容器目前处于公测阶段。
仅支持 mPaaS 原生 AAR 的接入方式。更多信息,请参考 原生 AAR 接入方式简介。
仅在自定义基线版本
cp_change_23596
中提供。
前置条件
将小程序新容器接入 Android 之前,请确保您已经开通 mPaaS,并使用原生 AAR 的接入方式完成 mPaaS 接入。
接入步骤
小程序新容器接入步骤概述如下:
- 说明
UC 内核非必需。仅使用内嵌组件时所需,如:内嵌 webview 组件,内嵌 map 组件等。使用 UC 内核,可以使小程序拥有同层能力,并且拥有更好的渲染体验。
下文将对各步骤操作进行详细说明。
选择定制基线
添加自定义基线
cp_change_23596
。添加小程序组件。
初始化 mPaaS
初始化 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 } }
申请 UC 内核,根据实际需求添加。若需要添加,请在使用小程序之前申请并配置 UC 内核。详情参见 申请 UC 内核。
发布小程序
启动小程序之前,您需要先通过 mPaaS 控制台发布该小程序,步骤如下。
进入小程序后台。登录 mPaaS 控制台,进入目标应用后,从左侧导航栏进入 小程序 > 小程序发布 页面。
配置虚拟域名。如果是第一次配置虚拟域名,请先在 小程序 > 小程序发布 > 配置管理 中配置虚拟域名。虚拟域名可以为任意域名,建议使用您的企业域名,如
test.com
。创建小程序。进入 mPaaS 控制台,完成以下操作:
单击左侧导航栏的 小程序 > 小程序发布。
在打开的小程序包列表页,单击 新建。
在 新建小程序 窗口,填写小程序的 ID 和小程序名称,单击 确定。其中,小程序 ID 为任意 16 位数字,例如 2018080616290001。
在小程序 App 列表下,找到新增的小程序,单击 添加。
在基本信息栏,完成以下配置:
版本:填写小程序包的版本号,例如
1.0.0.0
。客户端范围:选择小程序 App 对应的 Android 客户端最低版本和最高版本。在这个范围内的客户端 App 可以启动对应的小程序,否则无法启动。这里最低版本可以填写
0.0.0
,最高版本可以不填,代表客户端所有版本都可以启动这个小程序。说明此处务必填写 Android 的客户端版本,而非小程序版本。
图标:单击 选择文件 上传小程序包的图标。第一次创建小程序时必须上传图标。示例图标如下:
文件:上传小程序包资源文件,文件格式为
.zip
。我们准备了一个 mPaaS 示例小程序(点此下载),可以直接上传。说明在上传前,需将此示例小程序的
.zip
文件名以及压缩包内的文件夹名均修改为小程序的 16 位数字 ID。
在配置信息栏,完成以下配置:
主入口 URL:必填,小程序的首页。主入口 URL 格式为:
/index.html#xxx/xxx/xxx/xxx
,其中#
后方的xxx/xxx/xxx/xxx
是小程序的app.json
中的pages
中的第一个值。如下图所示,mPaaS 示例小程序的主入口为:/index.html#page/tabBar/component/index
。其他配置保持默认即可。
勾选 已确认以上信息准确,提交后不再修改。
单击 提交。
发布小程序。进入 mPaaS 控制台,完成以下步骤:
单击左侧导航栏的 小程序 > 小程序发布 > 小程序正式包管理。
单击左侧导航栏的 实时发布 > 小程序包管理 > 小程序正式包管理。
在打开的小程序包列表页中,选择您要发布的小程序包与版本,单击 创建发布。
在创建发布任务栏,完成以下配置:
发布类型:选择 正式 发布类型。
发布描述:选填。
单击 确定 完成发布创建。
启动小程序
完成上述步骤之后,在 Android 工程中,通过如下代码,启动示例小程序:
Mriver.startApp("2018080616290001");
上方代码中的 2018080616290001
为小程序 ID,此处仅为本文示例,操作中请填写您的小程序 ID。