Consumer SDK for iOS のバージョン

Google Maps Platform チームは定期的に SDK を更新し、新機能の追加、バグの修正、パフォーマンスの改善を行っています。このページでは、モバイル SDK への依存関係を管理する方法について説明します。

  • ミッション クリティカルなアプリの場合、使用しているメジャー バージョンの最新のドットリリース(X.*)にリンクし、1 年ごとに新しいメジャー バージョンにアップグレードします。

    アプリケーションの新しいバージョンをリリースするとき、 年間を通して、新しい Consumer SDK for iOS のドット バージョンを使い始めることができます。新しいドット バージョンには下位互換性があるため、これによってアプリケーションのアップデートが必要となることはありません。

    メリット:

    • Consumer SDK for iOS に問題が見つかった場合、 メジャー バージョンの最初のリリースから 12 か月間、 モバイル サポート に関するポリシーに準拠する必要があります。修正のメリットを得るために、互換性のない SDK バージョンへのアップグレードを急ぐ必要はありません。
    • 最新の SDK バージョンをベースにアプリを制作すれば、最新の改良点や機能を容易に導入できます。
    • SDK のアップデートに合わせてアプリケーションの調整、書き換え、テスティングが必要になることがありますが、SDK の最新メジャー バージョンの年次差分アップデートに対応するだけであれば、複数のメジャー バージョン リリースで導入された下位互換性のない変更に対応するよりも軽い作業で済むことが予想されます。

  • 重要性の低いアプリの場合、任意の修正済みバージョンにリンクします。その修正済みバージョンのサポート終了の案内を受けたら、12 か月以内にアプリのコードをアップデートしてユーザーに提供開始する必要があります。

    メリット:

    • メンテナンス作業の頻度を下げられます。
    • アプリの新バージョンで、搭載 OS の古いモバイル デバイスへの対応を維持できる期間が延びます(新しい SDK バージョンにアップグレードする必要が生じるまで)。

モニタリング対象メールアドレスを持つプロジェクト オーナー様には、各プロジェクトに影響する変更を通知で事前にお知らせしています。メジャー アップデート、サービス終了、その他の変更に関する最新情報を把握する方法

インストール

楽観的演算子を使用するのではなく、常に依存関係にバージョン番号を指定する (~>)。これは、ビルドが予測不可能で再現不能になる可能性があるためです。「 Consumer SDK for iOS がセマンティック バージョニングに準拠している。 新しいメジャー バージョン リリースには互換性を破る変更が含まれています。

Swift Package Manager

Consumer SDK は でインストールできます。 Swift Package Manager。SDK を追加するには、 既存の Consumer SDK の依存関係がすべて削除されました。

新規または既存のプロジェクトに SDK を追加する手順は次のとおりです。

  1. Xcode project または workspace を開き、[File >パッケージの依存関係を追加する
  2. URL として「https://github.com/googlemaps/ios-consumer-sdk」と入力し、Enter キーを押します。 [パッケージを追加]をクリックします
  3. 特定の version をインストールするには、[Dependency Rule] フィールドを次のいずれかに設定します。 オプションを提供します。新しいプロジェクトの場合は、最新バージョンと 1 つのバージョンを 「正確なバージョン」を使用して選択します。完了したら、[Add Package] をクリックします。
  4. [Choose Package Products] ウィンドウで、GoogleRidesharingConsumer が以下に追加されることを確認します。 指定したmainの目標値。完了したら、[Add Package] をクリックします。
  5. インストールを確認するには、ターゲットの General ペインに移動します。 [Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。 [Package Dependencies] ビューもセクション(プロジェクト ナビゲーター) パッケージとそのバージョンを確認します。

既存のプロジェクトの package を更新する手順は次のとおりです。

  1. 9.0.0 より前のバージョンからアップグレードする場合は、 次の依存関係: GoogleMapsBaseGoogleMapsCore、 アップグレード後に GoogleMapsM4B。次の依存関係を削除しないでください。 GoogleMaps。詳しくは、 バージョン 9.0.0 リリースノート

    Xcode プロジェクト構成設定で、フレームワーク、ライブラリ、 および埋め込みコンテンツをご覧ください。マイナス記号(-)を使用して、次のフレームワークを削除します。

    • GoogleMapsBase(9.0.0 より前のバージョンからのアップグレードのみ)
    • GoogleMapsCore(9.0.0 より前のバージョンからのアップグレードのみ)
    • GoogleMapsM4B(9.0.0 より前のバージョンからのアップグレードのみ)
  2. Xcode で、[File] > [パッケージ >最新のパッケージ バージョンへの更新」を選択します。
  3. インストールを確認するには、Project Navigator の [Package Dependencies] セクションに移動します。 パッケージとそのバージョンを確認します。

以下を使用して追加された既存の Consumer SDK 依存関係を削除するには、 CocoaPods の手順は次のとおりです。

  1. Xcode ワークスペースを閉じます。ターミナルを開き、次のコマンドを実行します。
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. PodfilePodfile.resolved、および CocoaPods 以外で使用していない場合には、Xcode workspace です。

CocoaPods

CocoaPods

を使用した Podfile の依存関係の例 Podfile の構文:

    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', ' 2.2.0'
    end
    

Consumer SDK ベータ版を使用する場合の Podfile の依存関係の例:

    source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk"
    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', '2.1.0-beta01.0'
    end
    

メンテナンスとアップグレード

最新の改善を適用してビルドするには、定期的に新しいバージョンを確認し、バージョンを更新してください 仕様。新しいメジャー バージョンに更新する場合は、 リリースノート コードを更新する方法を確認できます。

Cocoapods

  1. ターミナルを開き、Podfile を含むディレクトリに移動します。

    cd <path-to-project>
  2. pod outdated を実行して、新しいバージョンの Consumer SDK for iOS があるかどうかを確認します。 を利用できます。
  3. 新しいバージョンの SDK が見つかった場合は、その新しいバージョンで Podfile を更新してください。 Pod のバージョンの指定をご覧ください。 Podfile で特定のバージョンを設定する方法をご確認ください。
  4. pod update を実行します。
  5. アップグレードの結果、必要な変更を行います。詳しくは、 各リリースの変更内容の一覧については、リリースノートをご覧ください。
  6. [Product >] を選択して、プロジェクトのクリーンアップと再ビルドを行います。クリーニングしてから、 商品 >構築

手動

最新のソースファイルへのリンクを取得する をご覧ください。

Google Cloud では、新しいバージョンのポーリングに加えて、 プロジェクト オーナーに、プロジェクトに影響する可能性がある下位互換性のない変更に関するメールが届きます。宛先 下位互換性のない変更に関する事前通知 割り当て オーナーロールを割り当てる必要があります。