すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:May 28, 2026

    ネイティブの CocoaPods プラグインを使用して設定を生成し、mPaaS を既存のプロジェクトに迅速に統合します。

    前提条件

    • 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 を実行して、plugin、source、および mPaaS_baseline の設定を Podfile に追加します。

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

    3. Podfile を設定します。

      1. mPaaS_baseline でベースラインバージョンを設定します。例： mPaaS_baseline '10.2.3' (10.2.3 はバージョンです)。 バージョンの違いについては、リリースノートをご確認ください。

      2. mPaaS_pod を使用してコンポーネントの依存関係を追加します。例： 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+

        H5 コンテナ & オフラインパッケージ：フロントエンドとネイティブコードのインタラクションのための Nebula コンテナです。

        mPaaS_pod "mPaaS_UTDID"

        10.1.32+

        デバイス ID：一意で安全なデバイス ID を取得します。

        mPaaS_pod "mPaaS_DataCenter"

        10.1.32+

        統合ストレージ：データベース DAO を含む複数の永続性オプションを備えた、安全で高速かつ暗号化可能な Key-Value (KV) ストレージです。

        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_Multimedia"

        10.1.32+

        マルチメディア：画像のダウンロード、アップロード、キャッシュを管理します。

        mPaaS_pod "mPaaS_MobileFramework"

        10.1.32+

        モバイルフレームワーク：サブアプリケーション、タブベースのアプリケーション、サードパーティのナビゲーション、ビューコントローラーの遷移、および例外処理を管理します。

        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

        音声およびビデオ通話：1 対 1 および複数人でのビデオ通話やオンライン会議をサポートします。

        mPaaS_pod "mPaaS_BlueShield"

        10.2.3+

        ブルーシールド暗号化コンポーネント：設定ファイルに absBase64Code パラメーターが追加されると、ガードイメージを生成します。

        mPaaS_pod "mPaaS_MDC"

        10.2.3+

        モバイルディスパッチコンポーネント：きめ細かなドメイン名ポリシーのディスパッチをします。

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

        image.png

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

    5. pod install を実行して統合を完了します。 詳細なログを表示するには --verbose を追加してください。

      説明

      GitHub ライブラリが見つからないために pod install が失敗した場合は、Podfile の先頭に source 'https://github.com/CocoaPods/Specs.git' を追加してください。

    6. サードパーティライブラリの競合については、「iOS の競合の解決」に従ってください。

    アップグレードガイド

    個々のコンポーネントまたはベースライン全体 (SDK バージョン) をアップグレードできます。

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

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

      Screenshot 2023-06-19 at 7.png

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

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

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

      image.png

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

    mPaaS podspec ソースの切り替え

    背景情報

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

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

    1. どのベースラインでも最新の SDK バージョンをプルできません。

    2. 2023 年 6 月 30 日以降、どのベースラインバージョンをプルしても失敗します。

    すべての 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 以降であることを確認してください。

    image.png

    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" の後にパラメーターを追加してください。例：

    image.png

    パラメーター

    機能

    適用バージョン

    :guard_image_version => 6

    V6 ガードイメージを生成します。

    V0.9.6 以降

    :guard_image_version => 5

    V5 ガードイメージを生成します。

    V0.9.6 以降

    :only_frameworks => true

    mPaaS テンプレートディレクトリファイルの追加をスキップします。 スタンドアロンのフレームワークプロジェクトに使用します。

    V0.9.5.0.0.2 以降

    :check_repo => false

    デフォルトのリポジトリチェックと自動追加をスキップします。 内部ネットワークプロキシで使用します。

    V0.9.5.0.0.2 以降
    説明

    ベースライン 10.2.3 は、デフォルトで V6 ガードイメージを生成します。 :guard_image_version を設定する必要はありません。

    コマンド一覧

    cocoapods-mPaaS プラグインは、次のコマンドを提供します。

    コマンド

    機能

    pod mpaas init

    plugin、source、および mPaaS_baseline の設定を Podfile に追加します。

    pod mpaas update <VERSION>

    ベースラインを指定された <VERSION> (例：10.2.3) に更新し、podspec リポジトリを更新します。

    pod mpaas update --all

    公式プラグインでは、インストールスクリプトを再実行してプラグインをアップグレードします。 ベータ版プラグインでは、ローカルベースラインも更新します。

    pod mpaas info

    すべてのベースラインとそのコンポーネントを一覧表示します。

    pod mpaas info <NAME> <VERSION> (<VERSION> はオプション)

    特定のモジュール名の情報をフィルタリングします。

    pod mpaas info --only-mPaaS

    Podfile にコピーするためのデフォルトのベースライン設定を表示します。

    pod mpaas open

    コマンドラインから直接 .xcworkspace ファイルを開きます。

    pod mpaas version

    現在のプロジェクトで使用されているベースラインバージョンを表示します。

    pod mpaas version --plugin

    cocoapods-mPaaS プラグインのバージョンを表示します。