Mobile Platform as a Service:CocoaPods を使用した既存プロジェクトへの mPaaS の統合

前提条件

• CocoaPods 1.0.0 以降がインストール済みであること。 詳細については、「CocoaPods」をご参照ください。 ご利用のプロジェクトは CocoaPods プロジェクトである必要があります。

• Cocoapods-mPaaS プラグインがインストール済みであること。 プラグインをインストールしていない場合は、次のコマンドを実行してインストールしてください。

  sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

• コンソールでアプリケーションを作成し、.config 設定ファイルをダウンロード済みであること。 詳細については、「コンソールでのアプリケーションの作成」をご参照ください。

統合手順

1. プロジェクトのルートディレクトリに .config 設定ファイルをコピーします。 このディレクトリは、Podfile が含まれているディレクトリと同じです。

   説明

   ダウンロードした .config ファイルの名前が iOS で終わることを確認してください。 ios で終わる場合は、手動で iOS に変更する必要があります。

2. コマンドラインで、pod mpaas init コマンドを実行します。 このコマンドは自動的に Podfile を処理し、plugin、source、および mPaaS_baseline の設定を追加します。 自動的に設定されるコードは次のとおりです：

    plugin "cocoapods-mPaaS"
    source 'https://gitee.com/mpaas/podspecs.git'
    mPaaS_baseline 'x.x.x'

3. Podfile ファイルを設定します。

   1. mPaaS_baseline を変更して mPaaS ベースラインを指定します。 たとえば、mPaaS_baseline '10.2.3' のように指定します。ここで、10.2.3 はベースラインのバージョン番号です。 バージョン間の違いについては、「リリースノート」をご参照ください。

   2. mPaaS_pod を使用して mPaaS コンポーネントの依存関係を追加します。 たとえば、mPaaS_pod "mPaaS_Nebula" のように指定します。ここで、mPaaS_Nebula はコンポーネント名です。 コンポーネント名の一覧については、以下のコンポーネントリストをご参照ください。

      コンポーネント設定	適用ベースライン	説明
      mPaaS_pod "mPaaS_LocalLog"	10.1.32+	ローカルログ
      mPaaS_pod "mPaaS_Log"	10.1.32+	モバイル分析サービス：行動ログ、自動ログ、クラッシュログ、パフォーマンスログを分析します。
      mPaaS_pod "mPaaS_Diagnosis"	10.1.32+	診断：クライアント側の診断分析。
      mPaaS_pod "mPaaS_RPC"	10.1.32+	モバイルゲートウェイサービス：ダウンロード、アップロード、リモートプロシージャコール (RPC) などの機能を提供します。
      mPaaS_pod "mPaaS_Sync"	10.1.32+	モバイル同期サービス：永続的な接続サービス。
      mPaaS_pod "mPaaS_Push"	10.1.32+	メッセージプッシュサービス
      mPaaS_pod "mPaaS_Config"	10.1.32+	設定スイッチ：キーに基づいてサーバーから対応する値をプルし、クライアントロジックを動的に制御します。
      mPaaS_pod "mPaaS_Upgrade"	10.1.32+	アップグレードとリリース：プロアクティブなアップグレードチェックのためのサービスを提供します。 カナリアリリースやオンラインでの新バージョン通知に使用します。
      mPaaS_pod "mPaaS_Share"	10.1.32+	共有：Weibo、DingTalk、Alipay の友達など、人気のチャンネルへのテキストや画像の共有をサポートします。
      mPaaS_pod "mPaaS_Nebula"	10.1.32+	HTML5 コンテナーとオフラインパッケージ：Nebula コンテナーは、フロントエンドとネイティブコード間のインタラクションをサポートします。
      mPaaS_pod "mPaaS_UTDID"	10.1.32+	デバイス ID：デバイス ID を迅速に取得し、アプリケーションが特定のデバイスを安全かつ効果的に識別するのに役立ちます。
      mPaaS_pod "mPaaS_DataCenter"	10.1.32+	データセンター：複数のデータ型をサポートする、安全で高速かつ暗号化可能なキー・バリュー (KV) ストレージを提供します。 また、データベースのデータアクセスオブジェクト (DAO) サポートなど、さまざまな永続化ソリューションも提供します。
      mPaaS_pod "mPaaS_ScanCode"	10.1.32+	コードスキャン：QR コードとバーコードを迅速に認識します。
      mPaaS_pod "mPaaS_LBS"	10.1.32+	位置情報サービス：モバイルクライアント向けの位置情報ソリューション。
      mPaaS_pod "mPaaS_CommonUI"	10.1.32+	共通 UI：共通のユーザーインターフェース (UI) コンポーネントのライブラリ。
      mPaaS_pod "mPaaS_BadgeService"	10.1.32+	バッジサービス：クライアント側の「赤点」通知コンポーネント。 ドット、数字、「New」などの通知スタイルをサポートします。 また、階層的なバッジ関係も自動的に管理します。
      mPaaS_pod "mPaaS_Multimedia"	10.1.32+	マルチメディアコンポーネント：画像のダウンロード、アップロード、キャッシュなどの機能をサポートします。
      mPaaS_pod "mPaaS_MobileFramework"	10.1.32+	モバイルフレームワーク：クライアントアプリケーションフレームワーク。 サブアプリ、マルチタブアプリケーション、サードパーティリダイレクト、viewController のトランジション、例外処理とレポートを管理します。
      mPaaS_pod "mPaaS_OpenSSL"	10.1.32+	OpenSSL
      mPaaS_pod "mPaaS_TinyApp"	10.1.32+	ミニプログラム：ミニプログラムを統合・公開する機能を提供します。
      mPaaS_pod "mPaaS_CDP"	10.1.32+	モバイルコンテンツ配信プラットフォーム：さまざまなマーケティング広告や表示フォーマットをクライアントにインテリジェントかつ動的に配信します。
      mPaaS_pod "mPaaS_ARTVC"	10.1.68	音声・ビデオ通話：音声・ビデオ通話コンポーネント。 2者間および多者間のビデオ通話やオンライン会議をサポートします。
      mPaaS_pod "mPaaS_BlueShield"	10.2.3+	BlueShield 暗号化コンポーネント：設定ファイルに absBase64Code パラメーターを追加して、BlueShield イメージを自動的に生成します。
      mPaaS_pod "mPaaS_MDC"	10.2.3+	モバイルディスパッチコンポーネント (MDC)：きめ細かいドメイン名ポリシーのスケジューリング。

      以下に、完全な Podfile の例を示します：

      

4. pod mpaas update x.x.x を実行します。ここで、x.x.x は設定したベースライン番号 (例：10.2.3) です。

5. pod install を実行して統合を完了します。 --verbose を追加して詳細なログを表示することもできます。

   説明

   pod install の実行時に、公式 GitHub Web サイトのライブラリが見つからないというメッセージが表示された場合は、Podfile の先頭に公式 GitHub のソースアドレス https://github.com/CocoaPods/Specs.git を指定してください。

6. 統合後にサードパーティのライブラリの競合が発生した場合は、競合するライブラリを削除してください。 詳細については、「iOS の競合の処理」をご参照ください。

アップグレードガイド

mPaaS の新しいバージョンがリリースされた場合、個々のコンポーネントまたは SDK バージョンであるベースライン全体をアップグレードできます。

コンポーネントのアップグレード

1. コマンドラインで pod mpaas update x.x.x を実行します。ここで、x.x.x は現在のベースラインのバージョン番号 (例：10.2.3) です。

   

2. pod install を実行して、指定したベースラインのコンポーネントをアップグレードします。

ベースラインのアップグレード

1. Podfile で mPaaS_baseline のベースライン番号を変更して、ベースライン全体をアップグレードします。 たとえば、10.1.68 を 10.2.3 に変更できます。 標準およびカスタムのベースラインがサポートされています。

   

2. pod install を実行して、ベースラインのアップグレードを完了します。

mPaaS iOS podspec アドレスの切り替え

背景情報

code.aliyun.com にある mPaaS podspec リポジトリは廃止されました。 2023年6月1日に更新を停止し、2023年6月30日にサービスを終了しました。

古いリポジトリを使い続けると、次の問題が発生します：

1. mPaaS pod プラグインを使用して SDK を更新する際に、最新のベースラインバージョンをプルできません。

2. 2023年6月30日以降、mPaaS pod プラグインを使用してどのベースラインバージョンもプルできなくなります。

すべての mPaaS バージョンは、現在 gitee.com でサポートされています。

ソリューション

mPaaS pod プラグインのアップグレード

次のコマンドを実行して、最新の mPaaS pod プラグインに更新します：

sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

コマンドが完了したら、ターミナルで pod plugins installed を実行し、cocoapods-mPaaS のバージョンを確認します。 バージョンが 0.9.6 以降であれば、アップグレードは成功です。

podfile のソース設定の変更

Podfile で、元の source "https://code.aliyun.com/mpaas-public/podspecs.git" を次のように置き換えます：

source "https://gitee.com/mpaas/podspecs.git"。

API の変更

この変更はプラグインの変更のみを含み、プラグインコマンドの使用方法は変更されません。

テストと検証

アップグレードと設定の変更が完了したら、mPaaS pod プラグインのプルコマンドを実行して、最新のベースラインバージョンと SDK をプルできるかどうかをテストします。

パラメーターリスト

パラメーターを設定して、プラグインのデフォルトの動作の一部を変更できます。

手順：

Podfile の plugin "cocoapods-mPaaS" の後にパラメーターを追加します。 以下に例を示します：

コマンドリスト

cocoapods-mPaaS プラグインをインストールすると、コマンドラインインターフェイス (CLI) を使用して開発を支援できます。