Cette page explique comment configurer la bibliothèque d'utilitaires pour le SDK Maps pour iOS.
Pour essayer ces utilitaires, vous pouvez:
- Installez et exécutez l'application de démonstration. Il s'agit d'un projet autonome qui contient tout le code nécessaire pour tester les utilitaires.
- Installez la bibliothèque d'utilitaires dans un projet Xcode existant. Ajoutez ces utilitaires dans votre propre projet.
Installer CocoaPods (facultatif)
La bibliothèque d'utilitaires est disponible sous la forme d'un pod CocoaPods nommé Google-Maps-iOS-Utils
. CocoaPods est un gestionnaire de dépendances Open Source pour les projets Cocoa Swift et Objective-C.
Si vous ne disposez pas encore de l'outil CocoaPods, installez-le sur macOS en exécutant la commande suivante à partir du terminal:
sudo gem install cocoapods
Pour en savoir plus, consultez le guide de démarrage de CocoaPods.
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 essayer chaque utilitaire.
Installez l'application de démonstration en utilisant l'une des deux méthodes suivantes:Utiliser des fichiers GitHub
- Téléchargez l'exemple d'archive de code depuis GitHub, puis décompressez l'archive.
- Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez développé les exemples de fichiers, puis affichez le répertoire d'exemples correspondant au langage 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.
Utiliser CocoaPods v1.6.1
- Ouvrez une fenêtre de terminal et installez la version 1.6.1 :
sudo gem install cocoapods -v1.6.1
- Récupérez les fichiers Google Maps à l'aide de CocoaPods :
pod try Google-Maps-iOS-Utils
Lorsque vous y êtes invité, choisissez entre Swift et Objective-C. CocoaPods met à jour vos dépôts de spécification, puis ouvre la démonstration dans un projet Xcode temporaire nommé
SwiftDemoApp.xcodeproj
ouObjCDemoApp.xcodeproj
.
Ajouter la clé API à l'application de démonstration
Dans Obtenir une clé API, vous générez 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 l'instruction d'importation suivante :
import GoogleMaps
- Modifiez la ligne suivante pour ajouter votre clé API entre les 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 l'instruction d'importation suivante :
@import GoogleMaps;
- Modifiez la ligne suivante pour ajouter votre clé API entre les guillemets doubles :
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Créer et exécuter l'application de démonstration
Après avoir ajouté la clé API, créez 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, celle-ci s'affiche. 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.
Installer la bibliothèque d'utilitaires en tant que projet Xcode
Suivez les étapes suivantes pour ajouter la bibliothèque d'utilitaires à votre espace de travail Xcode :
Utiliser CocoaPods
- Si vous n'avez pas encore de projet Xcode, créez-en un maintenant et enregistrez-le sur votre ordinateur local. (Si vous débutez avec le développement sur iOS, créez une application Single View.)
- Si vous n'avez pas encore de fichier de 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, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '7.4.0' pod 'Google-Maps-iOS-Utils', '4.1.0' 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 de repères dépend du quadtree, mais vous pouvez utiliser le quadtree sans regroupement de repères. Si vous ne souhaitez que l'utilitaire quadtree, vous pouvez remplacer pod 'Google-Maps-iOS-Utils'
par 'Google-Maps-iOS-Utils/QuadTree'
dans le fichier de votre pod.
Utiliser Carthage
- Installez Carthage. Plusieurs méthodes existent. Pour connaître la procédure exacte, consultez le fichier README de Carthage.
- 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 version 11.7 ou antérieure, créez une application Single View.)
- Créez un fichier nommé
Cartfile
dans le répertoire de votre projet. Ce fichier définit les dépendances de votre projet. - Modifiez
Cartfile
et ajoutez la dépendance de la bibliothèque d'utilitaires du SDK Maps pour iOS:
github "googlemaps/google-maps-ios-utils"
- Enregistrez le
Cartfile
. - Dans une fenêtre de terminal, accédez au répertoire contenant
Cartfile
:
cd <path-to-project>
- Exécutez la commande de mise à jour:
carthage update --platform iOS
Cette action installera les API spécifiées dansCartfile
, ainsi que toutes les dépendances éventuelles. - Dans le Finder, accédez au répertoire de votre projet et accédez aux fichiers de framework téléchargés sous
Carthage/Build/iOS
. - Ajoutez les frameworks du SDK Maps pour iOS à votre projet en faisant glisser les groupes suivants dans votre projet.
(Lorsque vous y êtes invité, sélectionnez Copier des éléments si nécessaire, veuillez utiliser la même version que ci-dessus.)
GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework
. - Effectuez un clic droit sur
GoogleMaps.framework
dans votre projet, puis sélectionnez Show In Finder (Afficher dans le Finder). - Faites glisser
Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
du dossierResources
vers votre projet. Lorsque vous y êtes invité, vérifiez que Copy items into destination group's folder (Copier les éléments dans le dossier du groupe de destination) n'est pas sélectionné. - Sélectionnez votre projet dans Project Navigator, puis choisissez la cible de votre application.
- Ouvrez l'onglet Build Phases (Phases de compilation) pour la cible de votre application, puis ajoutez les frameworks suivants dans la section Link Binary with Libraries (Associer le binaire avec les bibliothèques) :
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
Choisissez votre projet plutôt qu'une cible spécifique, et ouvrez l'onglet Build Settings (Paramètres de build). Dans la section Other Linker Flags (Autres indicateurs Linker), ajoutez
-ObjC
. Si ces paramètres ne sont pas visibles, modifiez le filtre dans la barre Build Settings (Paramètres de build) de Basic (De base) à All (Tous).
Utiliser Swift Package Manager
- Si vous n'avez pas encore de projet Xcode, créez-en un maintenant et enregistrez-le sur votre ordinateur local. (Si vous débutez avec le développement iOS, créez un projet et sélectionnez le modèle d'application iOS. Sous 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 connaître les options, consultez Installer le SDK.
- Dans votre projet Xcode, accédez à File -> Swift Packages -> Add Package Dependency (Ajouter une dépendance de package).
- Dans la fenêtre qui s'affiche, saisissez l'URL
https://github.com/googlemaps/google-maps-ios-utils
du dépôt de la bibliothèque d'utilitaires du SDK Maps pour iOS, puis sélectionnez 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, cochez la case d'option Version, sélectionnez Exact dans la liste déroulante, saisissez la dernière version de la bibliothèque d'utilitaires du SDK Maps pour iOS (par exemple, "3.4.0", par exemple), puis cliquez sur Suivant.
Ajouter la clé API à votre application
Pour savoir comment générer une clé API et l'ajouter à votre projet Xcode, consultez Configurer un projet Xcode.Créer et exécuter le projet
Après avoir ajouté la clé API, créez et exécutez le projet.
Ajouter un utilitaire à votre application
Consultez la documentation de chaque utilitaire pour en savoir plus sur son utilisation dans votre application: