Cette page explique comment configurer la bibliothèque d'utilitaires du SDK Maps pour iOS.
Pour essayer ces utilitaires, vous pouvez:
- Installez la bibliothèque d'utilitaires dans un projet Xcode existant. Ajoutez ces utilitaires à votre propre projet.
- Installez et exécutez l'application de démonstration. L'application de démonstration est un projet autonome qui contient tout le code nécessaire pour tester les utilitaires.
Ajouter la bibliothèque d'utilitaires du SDK Maps pour iOS à un projet Xcode
Suivez les étapes suivantes pour ajouter la bibliothèque d'utilitaires à votre espace de travail Xcode :
Utiliser Swift Package Manager
- Si vous n'avez pas encore de projet Xcode, créez-en un et enregistrez-le sur votre machine locale. (Si vous débutez avec le développement iOS, créez un projet et sélectionnez le modèle d'application iOS. Dans Xcode 11.7 ou version antérieure, créez une application Single View.)
- Ajoutez le SDK Maps pour iOS en tant que dépendance. Pour en savoir plus, consultez la section Installer le SDK.
- Dans votre projet Xcode, accédez à File (Fichier) -> Swift Packages (Packages Swift) -> Add Package Dependency (Ajouter une dépendance de package).
- Dans la fenêtre qui s'affiche, saisissez l'URL du dépôt de la bibliothèque d'utilitaires du SDK Maps pour iOS
https://github.com/googlemaps/google-maps-ios-utils
, puis sélectionnez Next (Suivant). - À ce stade, vous pouvez être invité à vous authentifier avec votre compte GitHub. Suivez les instructions pour créer un jeton d'accès personnel GitHub afin de poursuivre le processus.
- Dans la fenêtre suivante, sélectionnez l'option radio Version, sélectionnez Jusqu'à la prochaine version majeure dans la liste déroulante, puis saisissez la dernière version de la bibliothèque d'utilitaires du SDK Maps pour iOS (par exemple, "6.0.0").
- Cliquez sur la liste déroulante à côté de Ajouter au projet, sélectionnez votre projet, puis Ajouter un package.
Utiliser CocoaPods
- Si vous n'avez pas encore de projet Xcode, créez-en un et enregistrez-le sur votre machine locale. (Si vous débutez avec le développement iOS, créez une application Single View.)
- Si vous n'avez pas encore de fichier pod pour votre projet, créez un fichier nommé
Podfile
dans le répertoire de votre projet. Ce fichier définit les dépendances de votre projet. - Modifiez le fichier de pod de votre projet et ajoutez une dépendance au pod
Google-Maps-iOS-Utils
. Voici un exemple qui inclut les dépendances dont vous avez besoin pour le SDK Maps pour iOS et la bibliothèque d'utilitaires:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '9.0.0' pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version end
- Exécutez
pod install
. - Fermez Xcode, puis ouvrez (double-cliquez) le fichier
.xcworkspace
de votre projet pour lancer Xcode. À partir de ce moment, vous devez utiliser le fichier.xcworkspace
pour ouvrir le projet.
Remarque:L'utilitaire de regroupement des repères dépend du quadtree, mais vous pouvez utiliser le quadtree sans regroupement des repères. Si vous ne souhaitez utiliser que l'utilitaire quadtree, vous pouvez remplacer pod 'Google-Maps-iOS-Utils'
par 'Google-Maps-iOS-Utils/QuadTree'
dans votre fichier de pod.
Ajouter la clé API à votre application
Consultez Configurer un projet Xcode pour savoir comment générer une clé API et l'ajouter à votre projet Xcode.Créer et exécuter le projet
Après avoir ajouté la clé API, compilez et exécutez le projet.
Utiliser un utilitaire dans votre application
Pour en savoir plus sur l'utilisation de chaque utilitaire dans votre application, consultez la documentation correspondante:
Installer et exécuter l'application de démonstration
La bibliothèque d'utilitaires inclut une application de démonstration que vous pouvez installer, puis tester chaque utilitaire.
Installez l'application de démonstration:Utiliser des fichiers depuis GitHub
- Téléchargez l'archive de l'exemple de code sur GitHub et décompressez-la.
- Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez développé les exemples de fichiers, puis accédez au répertoire d'exemples approprié pour la langue que vous souhaitez utiliser :
- Pour Swift, exécutez
cd google-maps-ios-utils-master/samples/SwiftDemoApp
. - Pour Objective-C, exécutez
cd google-maps-ios-utils-master/samples/ObjCDemoApp
.
- Pour Swift, exécutez
- Exécutez la commande suivante :
pod install
- Fermez Xcode, puis ouvrez (double-cliquez) le fichier
.xcworkspace
de votre projet pour lancer Xcode. À partir de ce moment, vous devez utiliser le fichier.xcworkspace
pour ouvrir le projet.
Ajouter la clé API à l'application de démonstration
Dans Obtenir une clé API, vous avez généré une clé API pour votre application. Ajoutez-la maintenant au projet Xcode de l'application de démonstration.Swift
Ajoutez votre clé API à votre fichier AppDelegate.swift
comme suit :
- Ajoutez la déclaration d'importation suivante :
import GoogleMaps
- Modifiez la ligne suivante pour ajouter votre clé API entre guillemets doubles:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Ajoutez votre clé API à votre fichier AppDelegate.m
comme suit :
- Ajoutez la déclaration d'importation suivante :
@import GoogleMaps;
- Modifiez la ligne suivante pour ajouter votre clé API entre guillemets doubles:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Compiler et exécuter l'application de démonstration
Après avoir ajouté la clé API, compilez et exécutez le projet:
- Si vous exécutez la version Swift de la démonstration, vous pouvez sélectionner l'utilitaire à afficher dans l'application.
- Si vous exécutez la version Objective-C de la démonstration, vous voyez la démonstration de l'utilitaire de regroupement de repères. Vous pouvez ensuite modifier la version Objective-C de la démonstration pour essayer chaque utilitaire. Pour en savoir plus, consultez la section Ajouter un utilitaire à votre application ci-dessous.