すべてのプロダクト
Search
ドキュメントセンター

Mobile Platform as a Service:クイックスタート

最終更新日:Jan 17, 2025

前提条件

プロジェクトを mPaaS に接続済みであること。関連トピック:

SDK の追加

統合方法に基づいて追加方法を選択します。

  • mPaaS Xcode 拡張機能を使用する この方法は、mPaaS ベースの統合またはmPaaS プラグインを使用する既存のプロジェクトに適用できます。

    1. Xcode メニュー項目の エディターmPaaSプロジェクトの編集 > > をクリックして、[プロジェクトの編集] ページを開きます。

    2. [ariver ミニプログラム] を選択し、[編集] をクリックします。

  • cocoapods-mPaaS プラグインを使用する この方法は、既存のプロジェクトに基づいて CocoaPods を使用する統合モードに適用できます。

    1. Podfile ファイルで、ベースライン番号を cp_change_15200851 として指定し、mPaaS_pod "mPaaS_Ariver" を使用して Ariver ミニプログラムコンポーネントの依存関係を追加します。

      image.png

    2. pod mpaas update cp_change_15200851 コマンドを実行して、ベースラインを更新します。

    3. コマンドラインで pod install を実行して、接続を完了します。

次のセクションでは、ミニプログラムの公式デモに基づいてミニプログラムを使用する方法について説明します。プロセス全体は、次の 3 つのステップに分かれています。

  1. SDK の初期化

  2. ミニアプリのリリース

  3. ミニプログラムの起動

SDK の初期化

mPaaS フレームワークの初期化

アプリのライフサイクルが mPaaS フレームワークによって管理されておらず、次の図に示すように、自分で定義したデリゲートとして指定されている場合は、mPaaS フレームワークを手動で初期化する必要があります。

説明

mPaaS フレームワークホスティングとは、アプリのデリゲートが DFClientDelegate に設定されていることを意味します。この場合、mPaaS フレームワークを手動で初期化する必要はありません。

image.png

  1. アプリケーションの windownavigationController が作成された後、次のメソッドを呼び出して mPaaS フレームワークを初期化します。

    image

  2. DTFrameworkInterface categoryshouldInheritDFNavigationController メソッドをオーバーライドし、NO を返すと、サポートナビゲーションバーコントローラーは DFNavigationController を継承しない場合があります。

    image.png

  3. アプリに複数のナビゲーションバーがあり、異なるナビゲーションバーで異なるミニプログラムを開く必要がある場合は、ナビゲーションバーを切り替えた後にコンテナのナビゲーションバーをリセットする必要があります。

    image

コンテナの初期化

ミニプログラムを正しく起動するには、アプリの起動後に SDK インターフェースを呼び出してコンテナを初期化する必要があります。DTFrameworkInterface- (void)application:(UIApplication *)application beforeDidFinishLaunchingWithOptions:(NSDictionary *)launchOptions で初期化する必要があります。

- (void)application:(UIApplication *)application beforeDidFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // コンテナを初期化します。
    [MPNebulaAdapterInterface initNebula];
}

注意事項

cp_change_15200851 ベースラインでは、mPaaS フレームワークのホスティングモードとプライバシーポップアップボックスが使用され、スイッチ構成エージェント [MPNebulaAdapterInterface shareInstance].configDelegate = self; が設定されている場合、次の 2 つのメソッドで同時にスイッチプロキシを設定する必要があります。スイッチ構成エージェントが設定されていない場合は、無視してください。

image

image

ミニプログラムのリリース

ミニプログラムを起動する前に、mPaaS コンソールでミニプログラムをリリースする必要があります。手順は次のとおりです。

  1. ミニプログラムのバックグラウンドを入力します。 mPaaS コンソール にログインします。左側のナビゲーションウィンドウで、ミニプログラム > リリース を選択します。

  2. 仮想ドメイン名を設定します。仮想ドメイン名を初めて設定する場合は、最初に ミニプログラム > ミニプログラムリリース > 構成管理 で仮想ドメイン名を設定する必要があります。仮想ドメイン名は、example.com などの第三者によるハイジャックを防ぐために、企業ドメイン名の下に置く必要があります。

  3. ミニプログラムを作成します。 mPaaS コンソールに移動し、次の操作を実行します。

    1. 左側のナビゲーションウィンドウで、ミニプログラム > ミニプログラムリリース を選択します。

    2. 表示されるページで、作成 をクリックします。

    3. ミニプログラムを作成するOK2018080616290001 ダイアログボックスで、ミニプログラムの ID と名前を入力し、 をクリックします。ミニプログラム ID は 16 桁の任意の数字です。例: 。

    4. ミニアプリリストで、新しいミニアプリを見つけて 追加 をクリックします。

    5. [基本情報] セクションで、次の情報を構成します。

      • バージョン: small パッケージのバージョン番号を入力します。例: 1.0.0.0

      • クライアント範囲: ミニプログラムアプリに対応する iOS クライアントの最小バージョンと最大バージョンを選択します。この範囲内のクライアントアプリは対応する small プログラムを起動できますが、それ以外の場合は起動できません。ここでは、最小バージョンに 0.0.0 を入力でき、最大バージョンは空白のままにすることができます。これは、すべてのバージョンのクライアントがこのミニプログラムを起動できることを意味します。

        説明

        ここでバージョン番号とは、現在のクライアントアプリのバージョン番号を指します。詳細については、プロジェクト Info.plistProduct Version フィールドを参照してください。

        image.png

      • アイコン: [ファイルの選択] アイコンをクリックして small パッケージをアップロードします。ミニプログラムを初めて作成するときは、アイコンをアップロードする必要があります。アイコンの例は次のとおりです。

        image.png

      • .zip 形式の small パッケージリソースファイルをアップロードします。 mPaaS サンプルプログラム (ここをクリックしてダウンロード) を用意しました。これは直接アップロードできます。

        説明

        ミニプログラムをアップロードする前に、パッケージ内の .zip ファイル名とフォルダ名をミニプログラムの 16 桁の ID に変更する必要があります。

    6. 構成情報バーで、次の構成を完了します。

      • メインポータル URL: 必須。ミニプログラムのホームページ。メインエントリ URL の形式は /index.html#xxx/xxx/xxx/xxx です。ここで、# の後の xxx/xxx/xxx/xxx は、ミニプログラムの app.jsonpages の最初の値です。 mPaaS ミニプログラムのメインエントリポイントは /index.html#page/tabBar/component/index です。

      • 他の構成についてはデフォルト設定を維持します。

    7. [上記の情報を正確であることを確認し、送信後に変更しない] チェックボックスをオンにします。

    8. [送信] をクリックします。

  4. ミニプログラムをリリースします。 mPaaS コンソールに移動し、次の手順を完了します。

    1. 左側のナビゲーション ウィンドウで、[ミニプログラム > ミニプログラム リリース][公式ミニプログラム パッケージ管理] を選択します。

    2. [Small Packages] ページで、リリースする small パッケージとバージョンを選択し、[リリースの作成] をクリックします。

    3. [リリースの作成] パネルで、次の設定を構成します。

      • リリースタイプ: [公式] を選択します。

      • リリースの説明: オプション。

    4. [OK] をクリックしてリリースを作成します。

ミニプログラムの起動

上記の手順を完了したら、次のコードを実行して iOS プロジェクトでサンプルミニプログラムを起動します。

[MPNebulaAdapterInterface startTinyAppWithId:@"2018080616290001" params:nil];
説明

上記のコードの 2018080616290001 はミニプログラムの ID です。これはこの記事の単なる例です。ミニプログラムの ID を入力してください。