SuperApp:uni-app ベースで開発されたネイティブアプリに uni-app ミニアプリコンテナを統合するにはどうすればよいですか。

シナリオ

uni-app ベースで開発されたネイティブアプリに uni-app ミニアプリコンテナを統合します。その他のシナリオについては、「Android アプリへのミニアプリコンテナの統合」をご参照ください。

ソリューション

1. ネイティブ uni-app プラグイン EMASUniAppPlugin をダウンロードします。

2. EMASUniAppPlugin.zip パッケージを解凍し、解凍したフォルダを uni-app プロジェクトの nativeplugins フォルダにコピーします。

3. HBuilderX で uni-app プロジェクトを開きます。 uni-app プロジェクトの manifest.json ファイルをクリックします。ネイティブアプリプラグインを設定するには、nativeplugins フォルダにある EMASUniAppPlugin をオンプレミスプラグインとして選択します。

4. manifest.json ファイルをもう一度クリックし、ソースコードビューに切り替えます。app-plus パラメーターを見つけ、UniMP パラメーターを modules パラメーターに追加します。

5. uni-app プロジェクトで EMASUniAppPlugin プラグインと uni-app ミニアプリコンテナを使用します。

   // uni-app ミニアプリコンテナを取得します。
   const mp = uni.requireNativePlugin('uniMP');
   // EMASUniAppPlugin プラグインを取得します。
   var emasModule = uni.requireNativePlugin("EMASUniAppPlugin");

EMASUniAppPlugin プラグインの API リファレンス

configEmas

var ret = emasModule.configEmas({
					'appKeyAndroid': 'xxx',
					'appSecretAndroid': 'xxx',
					'channelIdAndroid': 'xxx',
					'mtopDomain': 'xxx',
					'useHttp': 'false',
					'appKeyIOS': 'xxx',
					'appSecretIOS': 'xxx',
					'channelIdIOS': 'xxx'
				})

EMASUniAppPlugin プラグインを初期化します。このメソッドは同期メソッドです。

updateMiniApp

emasModule.updateMiniapp({
					'appId': 'xxx',
				}, (ret) => {
					
				})

ミニアプリのバージョンを更新します。ミニアプリに新しいバージョンがある場合、このメソッドを呼び出して新しいバージョンのミニアプリをダウンロードしてインストールできます。このメソッドは非同期メソッドです。

例：

emasModule.updateMiniapp({
					'appId': '151624424672398147591',
				}, (ret) => {
					if (ret.code === 0) {
            // ミニアプリコンテナを使用してミニアプリをインストールします。
						mp.installUniMP({
							appid: '__UNI__151624424672398147591',
							wgtFile: ret.wgtPath
						}, (r) => {
							if (0 == r.code) {
								uni.showToast({
									title: 'ミニアプリがインストールされました。'
								});
								// ミニアプリのインストール後、ミニアプリを開きます。
								mp.openUniMP({
									appid: '__UNI__151624424672398147591'
								}, (ret) => {
									if (0 != ret.code) {
										uni.showModal({
											title: 'ミニアプリの起動に失敗しました。',
											content: JSON.stringify(ret),
											showCancel: false
										});
									}
									console.log('openUniMP: ' + JSON.stringify(ret));
								});
							} else {
								uni.showModal({
									title: 'ミニアプリのインストールに失敗しました。',
									content: JSON.stringify(r),
									showCancel: false
								});
							}
							console.log('installUniMP: ' + JSON.stringify(r));
						});
					}
				})

getMiniappList

emasModule.getMiniappList({
					'appIdList': '[xxx]',
				}, (ret) => {
					
				})

ミニアプリをクエリします。このメソッドは非同期メソッドです。

ミニアプリの ID を取得する

1. Application Open Platform コンソールにログインします。

2. ワークスペースを選択して、ワークスペースの [概要] ページに移動します。

   説明

   1 つのワークスペースにのみ参加している場合は、Application Open Platform コンソールにログインした後、ワークスペースの [概要] ページに移動します。

3. 左側のナビゲーションウィンドウで、[ミニアプリ] をクリックします。 [ミニアプリリスト] ページが表示されます。

4. [ミニアプリリスト] ページで、ID を取得するミニアプリを見つけ、ID を記録します。