本文将结合 小程序官方 Demo 来介绍小程序的使用。
小程序的接入步骤如下列表所示:
如果使用原生 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,请参考 小程序基础库说明 进行处理。
在 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
如果您是以原生 AAR 方式接入,则需在 AndroidManifest.xml 中加入以下配置:
<application>
···
<meta-data android:name="nebula.android.meta.enable" android:value="true"/>
···
</application>
使用小程序前,需要先申请并配置 UC 内核,具体操作参考 申请 UC 内核 说明文档。
使用 UC 内核,可以使小程序拥有同层能力,如嵌入 webview、嵌入地图等,并且拥有更好的渲染体验。
启动小程序之前,您需要先通过 mPaaS 控制台发布该小程序。
登录 mPaaS 控制台,进入目标应用后,从左侧导航栏进入 小程序 > 小程序发布 页面。
如果您是第一次使用,请先在 小程序 > 小程序发布 > 配置管理 中配置虚拟域名。虚拟域名可以为任意域名,建议使用您的企业域名,如 test.com。
进入 mPaaS 控制台,完成以下步骤:
在小程序 App 列表下,找到新增的小程序,点击 添加。
.zip
文件名以及压缩包内的文件夹名均改为您的小程序的 16 位数字 ID。/index.html#xxx/xxx/xxx/xxx
,其中 #
后方的 xxx/xxx/xxx/xxx
是小程序的 app.json
中的 pages
中的第一个值。如下图所示,mPaaS 示例小程序的主入口为:/index.html#page/tabBar/component/index
。进入 mPaaS 控制台,完成以下步骤:
完成上述步骤之后,您可以在 Android 工程中,通过如下代码,启动示例小程序。
MPNebula.startApp("2018080616290001");
2018080616290001
为小程序 ID,此处仅为本文示例,操作中请填写您真实的小程序 ID。
在文档使用中是否遇到以下问题
更多建议
匿名提交