Driver SDK for iOS バージョン

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

リンクするバージョンの選び方

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

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

メリット:
- Driver SDK for iOS に問題が見つかっても、モバイルサポートポリシーの規定により、該当メジャーバージョンの最初のリリースから 12 か月間は、下位互換性を保った方法で修正が提供されます。修正のメリットを得るために、互換性のない SDK バージョンへのアップグレードを急ぐ必要はありません。
- 最新の SDK バージョンをベースにアプリを制作すれば、最新の改良点や機能を容易に導入できます。
- SDK のアップデートに合わせてアプリケーションの調整、書き換え、テスティングが必要になることがありますが、SDK の最新メジャーバージョンの年次差分アップデートに対応するだけであれば、複数のメジャーバージョンリリースで導入された下位互換性のない変更に対応するよりも軽い作業で済むことが予想されます。
重要性の低いアプリの場合、任意の修正済みバージョンにリンクします。その修正済みバージョンのサポート終了の案内を受けたら、12 か月以内にアプリのコードをアップデートしてユーザーに提供開始する必要があります。

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

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

インストール

楽観的演算子（~>）を使用すると、ビルドが予測不能または繰り返し不能になる可能性があるため、依存関係では常にバージョン番号を指定してください。iOS 向け Driver SDK はセマンティックバージョニングに則っており、新たなメジャーバージョンリリースには破壊的変更が含まれます。

CocoaPods

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

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end

Swift Package Manager

Driver SDK は、 Swift Package Manager を介してインストールできます。SDK を追加するには、既存の Driver SDK の依存関係をすべて削除してください。

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

Xcode project または workspace を開き、[File] > [Add Package Dependencies] に移動します。
URL として https://github.com/googlemaps/ios-driver-sdk を入力し、Enter キーを押してパッケージをプルし、[パッケージを追加] をクリックします。
特定の version をインストールするには、[依存関係ルール] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定して [Exact Version] オプションを使用することをおすすめします。完了したら、[パッケージを追加] をクリックします。

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

インストールを確認するには、プロジェクトナビゲータの [パッケージの依存関係] セクションに移動して、パッケージとそのバージョンを確認します。

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

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

Cocoapods

ターミナルを開き、Podfile を含むディレクトリに移動します。
```
cd <path-to-project>
```
pod outdated を実行して、iOS 版 Driver SDK の新しいバージョンが利用可能かどうかを確認します。
新しいバージョンの SDK が見つかった場合は、この新しいバージョンで Podfile を更新します。Podfile で特定のバージョンを設定する方法については、Pod バージョンの指定をご覧ください。
pod update を実行します。
アップグレードの結果として必要な変更を行います。各リリースの変更点については、リリースノートをご覧ください。
[Product] > [Clean] を選択してから [Product] > [Build] を選択して、プロジェクトをクリーンアップして再ビルドします。

手動インストール

SDK のインストールで、最新のソースファイルのリンクを取得します。

Google Cloud プロジェクトオーナーは、新しいバージョンをポーリングするだけでなく、プロジェクトに影響する可能性がある下位互換性のない変更に関するメールも受信します。下位互換性のない変更について事前に通知を受けるには、モニタリング対象メールアドレスを使用してプロジェクトごとにオーナーの役割を割り当てます。