Paramétrage et démo

Sélectionnez une plate-forme:Android iOS

Cette page explique comment configurer la bibliothèque d'utilitaires pour le SDK Maps pour iOS.

Pour tester ces utilitaires, vous pouvez:

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 contient une application de démonstration que vous pouvez installer, puis tester chaque utilitaire.

Installez l'application de démonstration en utilisant l'une des deux méthodes suivantes:

Utiliser des fichiers de GitHub

  1. Téléchargez l'archive d'exemples de code sur GitHub, puis décompressez l'archive.
  2. 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.
  3. Exécutez la commande suivante:
    pod install
  4. Fermez Xcode, puis ouvrez (double-cliquez) le fichier .xcworkspace de votre projet pour lancer Xcode. À partir de ce moment, vous devrez utiliser le fichier .xcworkspace pour ouvrir le projet.

Utiliser CocoaPods v1.6.1

  1. Ouvrez une fenêtre de terminal et installez la version 1.6.1 :
    sudo gem install cocoapods -v1.6.1
  2. 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écifications, puis ouvre la démonstration dans un projet Xcode temporaire nommé SwiftDemoApp.xcodeproj ou ObjCDemoApp.xcodeproj.

Ajouter la clé API à l'application de démonstration

Dans Obtenir une clé API, générez une clé API pour votre application. Ajoutez maintenant cette clé au projet Xcode pour l'application de démonstration.

Swift

Ajoutez votre clé API à votre fichier AppDelegate.swift comme suit :

  1. Ajoutez l'instruction d'importation suivante :
    import GoogleMaps
  2. 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 :

  1. Ajoutez l'instruction d'importation suivante :
    @import GoogleMaps;
  2. 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 = @"";

Compiler et exécuter l'application de démonstration

Après avoir ajouté la clé API, créez et exécutez le projet:

  • Si vous utilisez la version Swift de la démo, 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 version de démonstration de l'utilitaire de regroupement de repères. Vous pouvez ensuite modifier la version Objective-C de la démo 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

  1. 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 dans le développement iOS, créez une application Single View.)
  2. Si vous ne disposez pas encore d'un 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.
  3. Modifiez le fichier 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.2.2'
    end
  4. Exécutez pod install.
  5. Fermez Xcode, puis ouvrez (double-cliquez) le fichier .xcworkspace de votre projet pour lancer Xcode. À partir de ce moment, vous devrez utiliser le fichier .xcworkspace pour ouvrir le projet.

Remarque:L'utilitaire de regroupement de repères dépend du quadtree, mais vous pouvez l'utiliser sans regroupement de repères. Si vous ne voulez utiliser que l'utilitaire quadtree, vous pouvez remplacer pod 'Google-Maps-iOS-Utils' par 'Google-Maps-iOS-Utils/QuadTree' dans votre fichier pod.

Utiliser Carthage

  1. Installer Carthage. Il existe plusieurs méthodes. Consultez le fichier README de Carthage pour connaître la procédure exacte.
  2. 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.)
  3. Créez un fichier nommé Cartfile dans le répertoire de votre projet. Ce fichier définit les dépendances de votre projet.
  4. Modifiez Cartfile et ajoutez la dépendance de la bibliothèque d'utilitaires du SDK Maps pour iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Enregistrez le Cartfile.
  6. Dans une fenêtre de terminal, accédez au répertoire contenant le fichier Cartfile:
    cd <path-to-project>
  7. Exécutez la commande de mise à jour:
    carthage update --platform iOS

    Les API spécifiées dans Cartfile seront installées, ainsi que toutes les dépendances associées.
  8. Dans le Finder, dans le répertoire de votre projet, accédez aux fichiers du framework téléchargés sous Carthage/Build/iOS.
  9. Ajoutez les frameworks du SDK Maps pour iOS à votre projet en faisant glisser les groupes suivants. Lorsque vous y êtes invité, sélectionnez Copy items if needed, please use the same version as above (Copier les éléments si nécessaire, 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
  10. Effectuez un clic droit sur GoogleMaps.framework dans votre projet, puis sélectionnez Show In Finder (Afficher dans le Finder).
  11. Faites glisser Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle du dossier Resources 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é.
  12. Sélectionnez votre projet dans Project Navigator, puis choisissez la cible de votre application.
  13. Ouvrez l'onglet Build Phases (Phases de compilation) de la cible de votre application et, dans Link Binary with libraries (Associer le binaire avec les bibliothèques), ajoutez les frameworks suivants :
    • 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
  14. 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

  1. 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 dans le développement iOS, créez un projet et sélectionnez le modèle d'application iOS. Sur Xcode 11.7 ou version antérieure, créez une application Single View.)
  2. Ajoutez le SDK Maps pour iOS en tant que dépendance. Consultez la page Installer le SDK pour connaître les options disponibles.
  3. Dans votre projet Xcode, accédez à File -> Swift Packages -> Add Package Dependency (Fichier -> Packages Swift -> Ajouter une dépendance de package).
  4. 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 afin de créer un jeton d'accès personnel GitHub pour poursuivre le processus.
  5. Dans la fenêtre suivante, sélectionnez la case d'option Version, choisissez 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"), puis sélectionnez Suivant.

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, 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: