Google Maps Platform チームは定期的に SDK を更新し、新機能の追加、バグの修正、パフォーマンスの改善を行っています。このページでは、モバイル SDK への依存関係を管理する方法について説明します。
リンクするバージョンの選び方
-
ミッション クリティカルなアプリの場合、使用しているメジャー バージョンの最新のドットリリース（X.*）にリンクし、1 年ごとに新しいメジャー バージョンにアップグレードします。
年間を通じてアプリケーションの新バージョンをリリースする際に、Places SDK for iOS の新しいドット バージョンを使い始めても問題ありません。新しいドット バージョンには下位互換性があるため、これによってアプリケーションのアップデートが必要となることはありません。
メリット:
- Places SDK for iOS に問題が見つかっても、 モバイル サポート ポリシーの規定により、該当メジャー バージョンの最初のリリースから 12 か月間は、 下位互換性を保った方法で修正が提供されます。修正のメリットを得るために、互換性のない SDK バージョン へのアップグレードを急ぐ必要はありません。
- 最新の SDK バージョンをベースにアプリを制作すれば、最新の改良点や機能を容易に導入できます。
- SDK のアップデートに合わせてアプリケーションの調整、書き換え、テスティングが必要になることがありますが、SDK の最新メジャー バージョンの年次差分アップデートに対応するだけであれば、複数のメジャー バージョン リリースで導入された下位互換性のない変更に対応するよりも軽い作業で済むことが予想されます。
重要性の低いアプリの場合、任意の修正済みバージョンにリンクします。その修正済みバージョンのサポート終了の案内を受けたら、12 か月以内にアプリのコードをアップデートしてユーザーに提供開始する必要があります。
メリット:
- メンテナンス作業の頻度を下げられます。
- アプリの新バージョンで、搭載 OS の古いモバイル デバイスへの対応を維持できる期間が延びます（新しい SDK バージョンにアップグレードする必要が生じるまで）。
モニタリング対象メールアドレスを持つプロジェクト オーナー様には、各プロジェクトに影響する変更を通知で事前にお知らせしています。メジャー アップデート、サービス終了、その他の変更に関する最新情報を把握する方法
インストール
Swift Package Manager
Places SDK for iOS は、 Swift Package Manager を介してインストールできます。SDK を追加するには、既存の Places SDK for iOS の依存関係を削除する必要があります。
SDK を新規または既存のプロジェクトに追加する手順は次のとおりです。
-
Xcode の
projectまたはworkspaceを開き、File > Add Package Dependencies に移動します。 - URL として https://github.com/googlemaps/ios-places-sdk と入力し、[Enter] キーを押してパッケージをプルし、[Add Package] をクリックします。
-
特定の
versionをインストールするには、[Dependency Rule] フィールドをバージョン ベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定して [Exact Version] オプションを使用することをおすすめします。完了したら、[Add Package] をクリックします。 - [Choose Package Products] ウィンドウで、
GooglePlaces、GooglePlacesSwift、またはその両方が指定したメイン ターゲットに追加されることを確認します。完了したら、[Add Package] をクリックします。非推奨の GitHub URL から Google Places Swift を更新する場合
重要: Google Places Swift にアクセスするための GitHub URL は、バージョン 0.3.0 以降で変更されています。古い URL
https://github.com/googlemaps/ios-places-swift-sdkを介してアクセスしたバージョンの GooglePlacesSwift を更新する場合は、Xcode のパッケージの依存関係セクションから削除してください。 - インストールを確認するには、ターゲットの [General] ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされているパッケージが表示されます。Project Navigator の [Package Dependencies] セクションで、パッケージとそのバージョンを確認することもできます。
既存のプロジェクトの package を更新する手順は次のとおりです。
-
Xcode で、File > Packages > Update To Latest Package Versions に移動します。
非推奨の GitHub URL から Google Places Swift を更新する場合
重要: Google Places Swift にアクセスするための GitHub URL は、バージョン 0.3.0 以降で変更されています。古い URL
https://github.com/googlemaps/ios-places-swift-sdkを介してアクセスしたバージョンの GooglePlacesSwift を更新する場合は、Xcode のパッケージの依存関係セクションから削除してください。 - インストールを確認するには、[Package Dependencies] セクションの [Project Navigator] に移動して、パッケージとそのバージョンを確認します。
メンテナンスとアップグレード
最新の改善点を使用してビルドするには、新しいバージョンを定期的に確認し、バージョン指定を更新します。新しいメジャー バージョンに更新する場合は、 リリースノートで下位互換性のない変更とコードの更新方法を確認してください。
Swift Package Manager
既存のプロジェクトの package を更新する手順は次のとおりです。
- インストールを確認するには、[Package Dependencies] セクションの [Project Navigator] に移動して、パッケージとそのバージョンを確認します。
手動インストール
最新のソースファイルへのリンクは SDK をインストールするで入手できます。
Google Cloud プロジェクト オーナーは、新しいバージョンをポーリングするだけでなく、プロジェクトに影響するかもしれない下位互換性のない変更に関するメールも受信します。下位互換性のない変更について事前に通知を受けるには、 モニタリング対象メールアドレスを使用してプロジェクトごとにオーナーの役割を割り当てます。