1.1 初始化 mPaaS

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

請在 Application 中添加以下代碼：

public class MyApplication extends Application {
     
    @Override
    public void onCreate() {
        super.onCreate();
        
        MP.init(this,
            MPInitParam.obtain().setCallback(new MPInitParam.MPCallback() {
                @Override
                public void onInit() {
                    // 初始化小程序公共資源包             
                    H5Utils.setProvider(H5AppCenterPresetProvider.class.getName(),new TinyAppCenterPresetProvider());      
                }
            })
        );
    }
 
}

詳情請參考：初始化 mPaaS。

在上面代碼的 onPostInit 中，我們對公共資源包進行了如下設置：

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

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 內核將無法接入 Android 小程序，具體操作參考 申請 UC 內核 說明文檔。

使用 UC 內核，可以使小程序擁有同層能力，如嵌入 webview、嵌入地圖等，并且擁有更好的渲染體驗。

2.1 進入小程序后臺

登錄 mPaaS 控制臺，進入目標應用后，從左側導航欄進入 小程序 > 小程序發布 頁面。

2.2 配置虛擬域名

如果您是第一次使用，請先在 小程序 > 小程序發布 > 配置管理 中配置虛擬域名。原則上，您需要使用由您的企業管理的二級域名。

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. 單擊 確定 完成發布創建。 |