初始化配置

初始化配置包括以下步骤:

  1. 初始化 mPaaS

  2. 小程序验签配置

  3. AndroidManifest 配置

  4. 申请 UC 内核

初始化 mPaaS

本教程中使用原生 AAR 方式接入,所以需要初始化 mPaaS。

  1. 在工程中新建 MyApplication 类。 MyApplication

  2. 在其中添加以下代码:

    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();
     }
    }
  3. 打开 AndroidManifest.xml,在 <application> 标签下增加如下代码,设置 Application。

    android:name=".MyApplication"

小程序验签配置

  1. 在 Android 工程的 assets/config 路径下,创建 custom_config.json 文件。 custom_config

  2. 在文件内填入以下代码:

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

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

AndroidManifest 配置

本教程中使用原生 AAR 方式接入,所以需要在 AndroidManifest.xml 中加入以下配置:

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

申请 UC 内核

  1. 点击 mPaaS > 基础工具 > 生成 UC Key 签名信息,打开 查询签名信息 窗口。 generate uc key

  2. 查询签名信息 窗口,填写相关配置信息,点击 Nextuc key

  3. 复制获得的 SHA1 信息。 sha1

  4. 登录控制台,进入 提交工单 页面。

    1. 选择问题所属产品 步骤中,通过页面右上方的搜索框快速找到 mPaaS 产品。 select-mpaas

    2. 选择问题类型 步骤中,选择 小程序接入 Android

    3. 推荐解决方案 步骤中,选择 创建工单

    4. 在打开的提交工单页面,输入以下信息以获取 UC SDK 的 Key。

      • 优先级:必填,可视情况选择 重要一般

      • 问题描述:必填,需提供以下信息:

        • 概述:可填写“申请 UC SDK 的 Key”文案。

        • Package Name:在本教程中为 com.mpaas.demo.mpaasminiprogram

        • SHA1 值:即在第 3 步中获取的 SHA1 信息。

      • 手机号:必填。

      • 邮箱:必填。

  5. 点击 提交,稍等片刻后,工作人员会向您反馈 UC SDK Key 的申请结果。 uc result

  6. 将您在上一步申请获得的 Key 填入项目的 AndroidManifest.xml 文件中:

    <meta-data android:name="UCSDKAppKey" android:value="您申请获得的 Key"/>
    说明

    UC SDK 的授权信息与 apk 的包名以及签名绑定。因此,如果 UCWebView 没有生效,检查签名和包名与申请时使用的信息是否一致。

至此,您已经完成了初始化配置。

其他相关配置

由于 mPaaS 仅支持 armeabi 架构及 targetSdkVersion = 26,因此需要在工程主 Module 下的 build.gradle 文件中添加以下配置,适配单一的 armeabi CPU 架构并设定 targetSdkVersion。

android {
    ···
    defaultConfig {
        ···
        targetSdkVersion 26
        ndk{
            abiFilters 'armeabi'
        }
        ···
    }
    ···
}
阿里云首页 移动开发平台 mPaaS 相关技术圈