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

Mobile Platform as a Service:mPaaS 10.1.68 アップグレードガイド

最終更新日:Apr 09, 2025

mPaaS 10.1.68 リリースノート

  1. 10.1.68 ベースライン以降、UIWebView は正式に廃止され、WKWebView のみがサポートされます。詳細については、「mPaaS の WKWebView への適応」をご参照ください。App Store では、2020 年 4 月以降、UIWebView を使用する新しいアプリは受け入れられなくなり、2020 年 12 月以降、UIWebView を使用するアプリのアップデートは受け入れられなくなります。 WKWebView に適応するには、できるだけ早く 10.1.68 ベースラインにアップグレードしてください。

  2. Xcode 11 は静的ライブラリ パッケージのビルドをサポートしており、Xcode 11 開発と完全に互換性があります。

mPaaS 10.1.68 アップグレード手順

CocoaPods を使用したアップグレード

前提条件

CocoaPods mPaaS プラグインがインストールされていること。

  • CocoaPods mPaaS プラグインをインストールしていない場合は、ターミナルで次のスクリプトを実行してプラグインをインストールします。

     sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)
  • CocoaPods mPaaS プラグインをインストールしている場合は、アップグレードコマンド pod mpaas update --all を直接実行してプラグインをアップグレードします。CocoaPods mPaaS プラグインの使用方法の詳細については、「ネイティブフレームワークに基づいて CocoaPods を使用したアクセス」をご参照ください。

手順

  1. Podfile で SDK バージョンを 10.1.68 に変更します。

    image.png

  2. コマンド pod mpaas update 10.1.68 を実行して、ベースラインの最新バージョン 10.1.68 の SDK をインストールします。

  3. 必要に応じて pod install または pod update コマンドを実行して、プロジェクト内の SDK をバージョン 10.1.68 にアップグレードします。

後続手順

CocoaPods へのアクセス時に次のエラーが発生した場合:

Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.68 found !!! Check name & version in Podfile.

この解決策を試してください。

  1. コマンド gem list | grep 'mPaaS' を実行して、CocoaPods プラグインのバージョンを表示します(次の図を参照)。

    CocoaPods troubleshooting

  2. CocoaPods プラグインのバージョンが 0.9.5 より前の場合は、次のスクリプトを実行してプラグインを再インストールします。

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

コンポーネントの使用法とアップグレード手順

現在のベースラインバージョンが 10.1.60 より前で、HTML5 コンテナーとミニプログラムコンポーネントを統合している場合は、以下の手順をよくお読みください。

コンポーネント API の変更

10.1.32 ベースライン以降、mPaaS コンポーネントに適応レイヤーが追加されています。ベースラインで適応レイヤー API を使用していない場合は、最初に「mPaaS 10.1.32 の iOS 13 への適応」をご参照ください。

SDK をアップグレードした後、適応レイヤーの API を使用することをお勧めします。詳細については、以下の各コンポーネントのアップグレード手順をご参照ください。

説明

基盤となるメソッドの中には、将来のバージョンで変更または廃止される可能性があるため、コードを変更し、基盤となるメソッドを直接使用するのではなく、中間レイヤー(アダプター)メソッドを使用することを強くお勧めします。使い続けると、今後のアップデートで多くの時間を費やす可能性があります。

カスタムライブラリの処理

10.1.68 ベースラインのコンポーネントにはカスタマイズ要件が組み込まれていますが、依存関係にカスタムライブラリを含めて SDK を以前のバージョン(10.1.32 など)から 10.1.68 にアップグレードした場合は、セキュリティ上の理由から、新しいバージョンに基づいてカスタムライブラリを再度カスタマイズする必要がある場合があります。これを行うには、DingTalk でグループ番号 41708565 を検索して DingTalk グループに参加し、質問してください。

共有コンポーネント

バージョン 10.1.68 の共有コンポーネントのサードパーティ SDK は、WeChat、Weibo、QQ 接続 SDK など、アップグレードされています。WeChat と QQ の共有では最新バージョンで Universal Link 機能が追加されているため、必ず新しい SDK に対応してください。具体的には、次のとおりです。

  1. 対応するプラットフォームのアプリケーション構成情報(アプリ管理でサードパーティ開発者アカウントの下に表示されます)が更新されます。具体的な適応方法については、リファレンスリンクをご覧ください。

  2. WeChat 共有の場合、「universalLink」フィールドを mPaaS 共有コンポーネントの構成情報に追加する必要があります。このフィールドの値は、実際の Universal Link アドレスです。