快速开始

本文将结合 小程序官方 Demo 来介绍小程序的使用。

前置条件

原生 AAR 方式

1. 完成 将 mPaaS 添加至您的项目。
2. 添加小程序依赖。在工程中通过 组件管理（AAR）安装 小程序（Mini program）组件。

mPaaS Inside 方式

1. 完成 mPaaS Inside 接入流程。
2. 添加小程序依赖。在工程中通过 组件管理 安装 小程序 组件。更多信息，请参考 管理组件依赖 > 增删组件依赖。

组件化（Portal&Bundle）方式

1. 完成 组件化接入流程。
2. 添加小程序依赖。在 Portal 和 Bundle 工程中通过 组件管理 安装 小程序 组件。更多信息，请参考 管理组件依赖 > 增删组件依赖。

接入步骤

小程序的接入步骤如下列表所示：

1. 初始化配置
   1. 初始化 mPaaS
   2. 小程序验签配置
   3. AndroidManifest 配置
   4. 申请 UC 内核
2. 发布一个小程序
   1. 进入小程序后台
   2. 配置虚拟域名
   3. 创建小程序
   4. 发布小程序
3. 启动小程序

1. 初始化配置

1.1 初始化 mPaaS

如果使用原生 AAR 方式或 mPaaS Inside 方式接入，您需要初始化 mPaaS。

请在 Application 中添加以下代码：

public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        // mPaaS 初始化回调设置
        QuinoxlessFramework.setup(this, new IInitCallback() {
            @Override
            public void onPostInit() {
                // 初始化小程序公共资源包
                H5Utils.setProvider(H5AppCenterPresetProvider.class.getName(),new TinyAppCenterPresetProvider());
            }
        });
    }
    @Override
    public void onCreate() {
        super.onCreate();
        // mPaaS 初始化
        QuinoxlessFramework.init();
    }
}

在上面代码的 onPostInit 中，我们对公共资源包进行了如下设置：

H5Utils.setProvider(H5AppCenterPresetProvider.class.getName(),new TinyAppCenterPresetProvider());

若您无法找到 TinyAppCenterPresetProvider 类，可能是您的基线版本小于 10.1.68.7，请参考 小程序基础库说明 进行处理。

1.2 小程序验签配置

在 Android 工程的 assets/config 路径下，创建 custom_config.json 文件，并在文件内填入以下内容：

[
  {
    "value": "NO",
      "key": "h5_shouldverifyapp"
  }
]

对于 value，“NO” 表示关闭小程序验签；“YES” 表示开启小程序验签（不填则默认为 “YES”）。在开发调试阶段，可以关闭验签来快速接入；在上线前，建议开启验签。有关小程序包验签配置的具体操作可参考 配置小程序包。

配置小程序包请求时间间隔

mPaaS 支持配置小程序包的请求时间间隔，可全局配置或单个配置。

• 全局设置：您可以在 custom_config.json 中加⼊如下代码：

  {
  "value": "{\"config\":{\"al\":\"3\",\"pr\":{\"4\":\"86400\",\"common\":\"864000\"},\"ur\":\"1800\",\"fpr\":{\"common\":\"3888000\"}},\"switch\":\"yes\"}",
  "key": "h5_nbmngconfig"\
  }

  其中 \"ur\":\"1800\" 是设置全局更新间隔的值，1800 为默认值，代表间隔时长，单位为秒，您可修改此值来设置您的全局小程序包请求间隔，范围为 0 ~ 86400 秒（即 0 ~ 24 小时，0 代表无请求间隔限制）。
  重要：其他参数请勿随意修改。
• 单个设置：即只对当前小程序包配置。可在控制台中前往 新增小程序包 > 扩展信息 中填入 {"asyncReqRate":"1800"} 来设置请求时间间隔。详情参见 创建小程序包 中的 扩展信息。

验证请求时间间隔配置是否生效：您可以打开⼀个接入⼩程序的工程，在 logcat ⽇志中过滤 H5BaseAppProvider 关键字，若能看到如下信息，则说明配置已经生效。

lastUpdateTime: xxx updateRate: xxx

1.3 AndroidManifest 配置

如果您是以原生 AAR 方式接入，则需在 AndroidManifest.xml 中加入以下配置：

<application>
    ···
    <meta-data android:name="nebula.android.meta.enable" android:value="true"/>
  ···
</application>

1.4 申请 UC 内核

使用小程序前，需要先申请并配置 UC 内核，具体操作参考 申请 UC 内核 说明文档。

使用 UC 内核，可以使小程序拥有同层能力，如嵌入 webview、嵌入地图等，并且拥有更好的渲染体验。

2. 发布一个小程序

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

2.1 进入小程序后台

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

2.2 配置虚拟域名

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

2.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. 点击 提交。
   

2.4 发布小程序

进入 mPaaS 控制台，完成以下步骤：

1. 点击左侧导航栏的 小程序 > 小程序发布 > 小程序正式包管理。
2. 在打开的小程序包列表页中，选择您要发布的小程序包与版本，点击 创建发布。
   
3. 在创建发布任务栏，完成以下配置：
   • 发布类型：选择 正式 发布类型。
   • 发布描述：选填。
4. 点击 确定 完成发布创建。
   

3. 启动小程序

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

MPNebula.startApp("2018080616290001");