Mobile Platform as a Service:既存のプロジェクトに基づいて CocoaPods を使用して統合する

前提条件

• CocoaPods 1.0.0 以降のバージョンがインストールされていること。接続するプロジェクトは 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：アプリケーションが特定のデバイスを安全かつ効果的に見つけるために、簡単かつ迅速に取得できます。
      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 コンポーネントを提供するユニバーサル UI コンポーネントライブラリ。
      mPaaS_pod "mPaaS_BadgeService"	10.1.32+	バッジ：クライアントのバッジリマインダーコンポーネント。バッジ、番号、新規などのリマインダースタイルをサポートします。ツリー構造のバッジ関係を自動的に管理できます。
      mPaaS_pod "mPaaS_AlipaySDK"	10.1.32+	Alipay のクイックペイ機能：Alipay のクイックペイメントプラットフォーム。
      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 "MPBaseTest"	10.1.32+	基本テスト：基本テストモジュール。
      mPaaS_pod "mPaaS_CDP"	10.1.32+	インテリジェント配信：動的起動でクライアントにさまざまなインテリジェント広告とプレゼンテーションを構成します。
      mPaaS_pod "mPaaS_AliAccount"	10.1.60+	ミニプログラム：ミニプログラムを公開します
      mPaaS_pod "mPaaS_ARTVC"	10.1.68	音声通話とビデオ通話：音声通話とビデオ通話コンポーネント。この機能は、2 者間ビデオ通話、グループビデオ通話、オンライン会議をサポートします。
      mPaaS_pod "mPaaS_BlueShield"	10.2.3+	Blue Shield 暗号化コンポーネント：config ファイルに absBase64Code パラメーターを追加して、Blue Shield イメージを自動的に生成します。
      mPaaS_pod "mPaaS_MDC"	10.2.3+	モバイルディスパッチコンポーネント：きめ細かいドメイン名戦略スケジューリング。

      完全な 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 アドレスの切り替え

背景

mPaaS が使用していた元の podspec ストレージウェアハウス code.aliyun.com はサービスを停止しました（2023 年 6 月 1 日に更新が停止し、2023 年 6 月 30 日にサービスが停止します）。

元のレポジトリを引き続き使用すると、次の影響があります。

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

2. 2023.06.30 以降、mPaaS pod プラグインを使用してもベースラインバージョンをプルできません。

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

ソリューション

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 内の origin source "https://code.aliyun.com/mpaas-public/podspecs.git" を置き換えます

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

API の変更

この変更はプラグインの変更のみを含み、プラグインコマンドの使用に変更はありません。

テスト検証

上記のアップグレードと変更構成操作を完了したら、引き続き mPaaS pod プラグイン関連のプルコマンドを実行して、最新のベースラインバージョンと SDK をプルできるかどうかをテストできます。

パラメーターリスト

パラメーターを構成することで、プラグインのデフォルトの動作を変更できます。

使用方法：

plugin "cocoapods-mPaaS" の後端にパラメーターを追加します。次の例を参照してください。

コマンドリスト

cocoapods-mPaaS プラグインをインストールした後、コマンドラインツールを使用して開発を支援できます。