Cette page explique comment configurer la bibliothèque d'utilitaires pour le SDK Maps pour iOS.
Pour essayer ces utilitaires, vous pouvez :
- installer la bibliothèque d'utilitaires dans un projet Xcode existant. ajouter ces utilitaires à votre propre projet.
- installer et exécuter l'application de démonstration. Il s'agit d'un projet autonome qui contient tout le code nécessaire pour essayer 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 connaître les options, consultez Installer le SDK.
- Dans votre projet Xcode, accédez à File -> Swift Packages -> Add Package Dependency (Fichier > Packages Swift > 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-utilset sélectionnez Next (Suivant). - Vous serez peut-ê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 , puis Up to Next Major Version dans la liste déroulante. Saisissez ensuite 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 Add to Project (Ajouter au projet), sélectionnez votre projet, puis cliquez sur Add Package (Ajouter un package).
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
Une fois la clé API ajoutée, créez 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 essayer chaque utilitaire.
Pour installer l'application de démonstration :Utiliser des fichiers depuis GitHub
- Téléchargez
l'archive d'exemple de code depuis
GitHub
et décompressez-la. Vous pouvez également cloner le dépôt dans un répertoire local :
git clone https://github.com/googlemaps/google-maps-ios-utils.git
- Ouvrez une fenêtre de terminal, accédez au répertoire dans lequel vous avez décompressé les exemples de fichiers, puis
accédez au répertoire d'exemples approprié pour le langage que vous souhaitez utiliser :
Swift
cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeprojObjective-C
cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.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 pour l'application de démonstration. consultez Obtenir une clé API.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 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 la déclaration 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
Une fois la clé API ajoutée, 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, vous verrez 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.