全部产品

快速开始

小程新序容器目前处于内部测试阶段,仅在自定义基线版本 cp_change_23596 中提供,当前仅支持 mPaaS 原生 AAR 的接入方式。更多信息,请参考 原生 AAR 接入方式简介。在接入 Android 之前,请确保已经开通并接入 mPaaS。接入 Android 客户端的流程如下:

  1. 添加小程序组件。
    1. 添加自定义基线 cp_change_23596
      Choose a baseline
    2. 添加小程序组件。
  2. 初始化 mPaaS,在 Application 中添加以下代码。
         
    1. public class MyApplication extends Application {
    2. @Override
    3. public void onCreate() {
    4. super.onCreate();
    5. // mPaaS 初始化
    6. MP.init(this);
    7. }
    8. }
  3. 申请并配置 UC 内核,详情参见 申请 UC 内核。使用 UC 内核,可以使小程序拥有同层能力,如嵌入 WebView、嵌入地图等功能,并且拥有更好的渲染体验。
  4. 在 mPaaS 控制台发布一个小程序。

    1. 登录 mPaaS 控制台,进入目标应用后,从左侧导航栏进入 小程序 > 小程序发布 页面。
    2. 配置虚拟域名。如果是第一次配置虚拟域名,请先在 小程序 > 小程序发布 > 配置管理 中配置虚拟域名。虚拟域名可以为任意域名,建议使用企业域名,如 test.com15
    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/index
          7
        • 其他配置保持默认即可。
      7. 勾选 已确认以上信息准确,提交后不再修改
      8. 单击 提交
        8
  5. 发布小程序。进入 mPaaS 控制台,完成以下步骤:

    1. 单击左侧导航栏的 小程序 > 小程序发布 > 小程序正式包管理
    2. 在打开的小程序包列表页中,选择您要发布的小程序包与版本,单击 创建发布
      9
    3. 在创建发布任务栏,完成以下配置:
      • 发布类型:选择 正式 发布类型。
      • 发布描述:选填。
      • 单击 确定 完成发布创建。
        10
  6. 启动小程序。完成上述步骤之后,在 Android 工程中,通过如下代码,启动示例小程序:

         
    1. Mriver.startApp("2018080616290001");
    说明:上方代码中的 2018080616290001 为小程序 ID,此处仅为本文示例,操作中请填写您的小程序 ID。