クイックスタート - Mobile Platform as a Service - Alibaba Cloud ドキュメントセンター

Mriver Tiny App は、モバイル PaaS（mPaaS）10.2.3 のベースラインバージョンでのみ提供され、mPaaS ネイティブ AAR 統合のみをサポートしています。詳細については、「ネイティブ AAR 統合について」をご参照ください。

前提条件

Android に Mriver Tiny App を統合する前に、mPaaS をアクティブ化し、ネイティブ AAR 統合を使用して mPaaS を統合していることを確認してください。詳細については、「前提条件」をご参照ください。

手順

Mriver Tiny App を統合する手順は、次のとおりです。

ベースラインを選択する
1. ベースライン 10.2.3 を追加する
2. ミニプログラムコンポーネントを追加する
構成を初期化する
ミニプログラムをリリースする
ミニプログラムを開始する

次のセクションでは、各手順について詳しく説明します。

ベースラインを選択する

ベースライン 10.2.3 を追加する。
mPaaSネイティブ AAR統合構成の開始 > をクリックします。ポップアップウィンドウで、[ベースラインの統合/アップグレード] の下のをクリックし、10.2.3 ベースラインを追加します。
ミニプログラムコンポーネントを追加する。
プロジェクトのコンポーネント管理 (AAR) を介して Mriver Tiny App コンポーネントをインストールします。

構成を初期化する

mPaaS の初期化

mPaaS フレームワークを使用して mPaaS を初期化する (推奨)

次の初期化コードを Application に追加します。

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // mPaaS initialization
        MP.init(this);    
    }
}

詳細については、「mPaaS を初期化する」をご参照ください。

メタ構成を AndroidManifest.xml に追加します。

<meta-data
    android:name="mpaas.init.param"
    android:value="com.xxx.xxx.MriverInitImpl" />

com.xxx.xxx.MriverInitImpl を追加して、MPInitParamManifest を実装します。

public class MriverInitImpl implements com.mpaas.MPInitParamManifest {
    @Override
    public MPInitParam initParam() {
        MriverInitParam mriverInitParam = MriverInitParam.getDefault();
        mriverInitParam.setMriverInitCallback(new MriverInitCallback() {
            @Override
            public void onInit() {
                if (com.alibaba.ariver.kernel.common.utils.ProcessUtils.isMainProcess()) {
                    // Configure the Mriver Tiny App, such as customizing jsapi and titlebar.

                }
            }

            @Override
            public void onError(Exception e) {

            }
        });
        return MPInitParam.obtain().addComponentInitParam(mriverInitParam);
    }
}

MPInit を使用して mPaaS を初期化する

次のコードを Application に追加して、mPaaS を初期化します。

public class MyApplication extends Application implements MPInitParam.MPCallback {
    @Override
    public void onCreate() {
        super.onCreate();
        // Initializes mPaaS.
        MriverInitParam mriverInitParam = MriverInitParam.getDefault();
        mriverInitParam.setMriverInitCallback(new MriverInitCallback() {
            @Override
            public void onInit() {
                if (com.alibaba.ariver.kernel.common.utils.ProcessUtils.isMainProcess()) {
                    // Configure the Mriver Tiny App, such as customizing jsapi and titlebar.

                }
            }

            @Override
            public void onError(Exception e) {

            }
        });
        MP.init(this, MPInitParam.obtain().setCallback(this).addComponentInitParam(mriverInitParam));
    }

    @Override
    public void onInit() {
        // init success
    }
}

ミニプログラムの署名検証を構成する

Mriver Tiny App は、パッケージ署名検証機能を提供します。デフォルトでは、デバッグパッケージの署名検証は無効になっており、リリースパッケージの署名検証は有効になっています。署名検証は API によって制御できます。

// 署名検証を無効にする
MriverResource.disableVerify();

// 署名検証を有効にする。xx は、バックエンドで構成された秘密鍵に対応する公開鍵です。
MriverResource.enableVerify(MriverResource.VERIFY_TYPE_YES,"xx");

説明

ミニプログラムをリリースする前に、署名検証を有効にすることをお勧めします。ミニプログラムの署名検証の構成方法に関する具体的な操作については、「ミニプログラムパッケージを構成する」をご参照ください。

リクエスト間隔を設定するパッケージ

mPaaS は、ミニプログラムパッケージをリクエストする間隔の構成をサポートしており、これは API によって制御できます。

Mriver.setConfig("h5_nbmngconfig", "{\"config\":{\"al\":\"3\",\"pr\":{\"4\":\"86400\","
    + "\"common\":\"864000\"},\"ur\":\"1800\",\"fpr\":{\"common\":\"3888000\"}},"
    + "\"switch\":\"yes\"}");

ここで、\"ur\":\"1800\" はグローバル更新間隔を指定します。 1800 は秒単位のデフォルト値です。値を変更して、グローバルミニプログラムパッケージをリクエストする間隔を設定します。値の範囲は 0 ～ 86400 秒、つまり 0 ～ 24 時間です。0 は、間隔が制限されていないことを示します。

重要

可能な限り、他のパラメータは変更しないでください。

mPaaS カーネルを使用する

ミニプログラムに基づく mPaaS カーネルの同層レンダリング機能は、埋め込み WebView、マップ、ビデオ、その他のコンポーネントのエクスペリエンスを向上させることができます。 mPaaS カーネルの統合とアプリケーションについては、「mPaaS カーネルを統合する」をご参照ください。

ミニプログラムをリリースする

ミニプログラムを開始する前に、mPaaS コンソールでミニプログラムをリリースする必要があります。次の手順を実行します。

ミニプログラムバックエンドを入力します。 mPaaS コンソールにログインし、ターゲットアプリを選択します。左側のナビゲーションウィンドウで、[ミニプログラム] > [ミニプログラムのリリース] を選択します。
仮想ドメイン名を構成します。初めて仮想ドメイン名を構成するには、[ミニプログラム] > [ミニプログラムのリリース] > [構成の管理] を選択します。仮想ドメイン名には、任意のドメイン名を使用できます。 example.com などの企業ドメイン名を使用することをお勧めします。
ミニプログラムを作成します。 mPaaS コンソールにログインし、次の手順を実行します。
1. 左側のナビゲーションウィンドウで、[ミニプログラム] > [ミニプログラムのリリース] を選択します。
2. ミニプログラムリストページで、[作成] をクリックします。
3. [ミニプログラムの作成] ウィンドウで、ミニプログラム ID と名前を入力し、[OK] をクリックします。ミニプログラム ID は 16 桁の数字です (例: 2018080616290001)。
4. ミニプログラムリストで、新しいミニプログラムを見つけ、[追加] をクリックします。
5. [基本情報] セクションで、次のパラメータを設定します。
  - バージョン: ミニプログラムパッケージのバージョン番号を入力します (例: 1.0.0.0)。
  - クライアントバージョンの範囲: ミニプログラムに適用可能な Android クライアントバージョンの範囲を選択します。範囲内のクライアントアプリのみがミニプログラムを起動できます。最小バージョンは 0.0.0 に設定でき、最大バージョンは空のままにすることができます。これは、クライアントバージョンに関係なくミニプログラムを起動できることを示します。
    説明
    ミニプログラムのバージョンではなく、Android クライアントのバージョンを入力してください。
  - アイコン: [ファイルを選択] をクリックして、ミニプログラムパッケージのアイコンをアップロードします。初めてミニプログラムパッケージを作成するときは、アイコンが必要です。サンプルアイコン:
  - ファイル: ミニプログラムパッケージのリソースファイルをアップロードします。これは .zip ファイルである必要があります。 mPaaS ミニプログラムのデモを次に示します (ここをクリックしてダウンロード)。これを直接アップロードできます。
    説明
    アップロードする前に、zip ファイルとそのフォルダの名前をミニプログラムの 16 桁の ID に変更してください。
6. [構成情報] セクションで、次のパラメータを設定します。
  - エントリ URL: 必須。ミニプログラムのホームページです。フォーマットは /index.html#xxx/xxx/xxx/xxx です。ここで、# の後の xxx/xxx/xxx/xxx は、app.json の pages の下の最初の値です。 mPaaS ミニプログラムデモのエントリは /index.html#page/tabBar/component/index です。
  - 他のパラメータについては、デフォルト値を保持します。
7. [提供された情報が真実かつ正確であることを確認します] をオンにします。
8. [送信] をクリックします。
ミニプログラムをリリースします。 mPaaS コンソールにログインし、次の手順を実行します。
1. 左側のナビゲーションウィンドウで、[ミニプログラム] > [ミニプログラムのリリース] > [ミニプログラム公式パッケージ管理] を選択します。
2. ミニプログラムリストページで、ターゲットミニプログラムとバージョンを選択し、[リリースタスクの作成] をクリックします。
3. [リリースタスクの作成] セクションで、次のパラメータを設定します。
  - リリースタイプ: [公式] を選択します。
  - リリースの説明: オプション。
  [OK] をクリックして、リリースタスクを作成します。

ミニプログラムを開始する

上記の手順の後、Android プロジェクトで次のコードを実行して、ミニプログラムのデモを開始できます。

Mriver.startApp("2018080616290001");

説明

コード内の 2018080616290001 は、ミニプログラム ID を指します。ここで使用されている ID は参照用であるため、実際のプログラム ID を入力してください。