Einrichtung und Demo

Dateien aus GitHub verwenden

1. Laden Sie das Codebeispiel-Beispielarchiv von GitHub herunter und entpacken Sie das Archiv.
2. Öffnen Sie ein Terminalfenster und gehen Sie zu dem Verzeichnis, in dem Sie die Beispieldateien maximiert haben. Öffnen Sie das entsprechende Beispielverzeichnis für die gewünschte Sprache:
   • Führen Sie cd google-maps-ios-utils-master/samples/SwiftDemoApp für Swift aus
   • Führen Sie für Ziel-C cd google-maps-ios-utils-master/samples/ObjCDemoApp aus
3. Führen Sie den folgenden Befehl aus:
   

   pod install

4. Schließen Sie Xcode und öffnen Sie per Doppelklick die Datei .xcworkspace Ihres Projekts, um Xcode zu starten. Ab jetzt musst du die Datei .xcworkspace verwenden, um das Projekt zu öffnen.

CocoaPods v1.6.1 verwenden

1. Öffnen Sie ein Terminalfenster und installieren Sie Version 1.6.1:

   sudo gem install cocoapods -v1.6.1

2. Google Maps-Dateien mit CocoaPods abrufen:

   pod try Google-Maps-iOS-Utils

   Wählen Sie bei entsprechender Aufforderung entweder „Swift“ oder „Objective-C“ aus. CocoaPods aktualisiert Ihre Spezifikations-Repositories und öffnet dann die Demo in einem temporären Xcode-Projekt mit dem Namen SwiftDemoApp.xcodeproj oder ObjCDemoApp.xcodeproj.

Swift

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.swift ein:

1. Fügen Sie die folgende Importanweisung hinzu:

   import GoogleMaps

2. Fügen Sie in der folgenden Zeile den API-Schlüssel zwischen den doppelten Anführungszeichen hinzu:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.m ein:

1. Fügen Sie die folgende Importanweisung hinzu:

   @import GoogleMaps;

2. Fügen Sie in der folgenden Zeile den API-Schlüssel zwischen den doppelten Anführungszeichen hinzu:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";

Mit CocoaPods

1. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie es jetzt und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie mit der iOS-Entwicklung noch nicht vertraut sind, erstellen Sie eine Single View Application.
2. Wenn Sie noch keine Pod-Datei für Ihr Projekt haben, erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen Podfile. Diese Datei definiert die Abhängigkeiten Ihres Projekts.
3. Bearbeiten Sie die Pod-Datei Ihres Projekts und fügen Sie eine Abhängigkeit vom Pod Google-Maps-iOS-Utils hinzu. Hier siehst du ein Beispiel für die Abhängigkeiten, die du für das Maps SDK for iOS und die Dienstprogrammbibliothek benötigst:

   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. Führen Sie pod install aus.
5. Schließen Sie Xcode und öffnen Sie per Doppelklick die Datei .xcworkspace Ihres Projekts, um Xcode zu starten. Ab jetzt musst du die Datei .xcworkspace verwenden, um das Projekt zu öffnen.

Hinweis: Das Markierungs-Clustering-Dienstprogramm hängt vom Quadtree ab, aber du kannst das Quadtree ohne Markierungscluster verwenden. Wenn Sie nur das Quadtree-Dienstprogramm verwenden möchten, können Sie in der Pod-Datei pod 'Google-Maps-iOS-Utils' zu 'Google-Maps-iOS-Utils/QuadTree' ändern.

Karthago verwenden

1. Installieren Sie Karthago. Es gibt mehrere Methoden. Eine genaue Anleitung findest du in der Readme-Datei für Karthago.
2. Falls du noch kein Xcode-Projekt hast, erstelle eines und speichere es auf dem lokalen Rechner. (Falls du noch keine Erfahrung in der iOS-Entwicklung hast, erstelle ein neues Projekt und wähle die Vorlage für iOS-Apps aus. In Xcode 11.7 oder einer früheren Version musst du eine Single View Application (App mit Einzelansicht) einrichten.
3. Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Cartfile. Diese Datei definiert die Abhängigkeiten Ihres Projekts.
4. Bearbeiten Sie die Cartfile und fügen Sie die Maps SDK for iOS-Dienstprogrammbibliothek hinzu:
   

   github "googlemaps/google-maps-ios-utils"

5. Speichere die Cartfile.
6. Wechseln Sie in einem Terminalfenster zum Verzeichnis, das Cartfile enthält:
   

   cd <path-to-project>

7. Führen Sie den Befehl „update“ aus:
   

   carthage update --platform iOS

   
   Dadurch werden die in Cartfile angegebenen APIs zusammen mit allen Abhängigkeiten installiert.
8. Gehen Sie im Finder in Ihrem Projektverzeichnis zu den heruntergeladenen Framework-Dateien unter Carthage/Build/iOS.
9. Fügen Sie das Maps SDK for iOS-Framework in Ihr Projekt ein. Ziehen Sie dazu die folgenden Bundles in Ihr Projekt. Wenn Sie dazu aufgefordert werden, wählen Sie bei Bedarf Elemente kopieren, verwenden Sie bitte die gleiche Version wie oben aus.
   • 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
   Nutzer der Premiumoption müssen außerdem GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework angeben.
10. Klicke in deinem Projekt mit der rechten Maustaste auf GoogleMaps.framework und wähle Show In Finder (In Finder zeigen) aus.
11. Ziehen Sie Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle aus dem Ordner Resources in Ihr Projekt. Prüfe, wenn du dazu aufgefordert wirst, ob Copy items into destination group's folder (Elemente in Ordner der Zielgruppe kopieren) ausgewählt ist. Das sollte nicht der Fall sein.
12. Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
13. Öffnen Sie den Tab Build Phases (Build-Phasen) für das Ziel Ihrer Anwendung und fügen Sie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks hinzu:
    • 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. Wähle statt eines bestimmten Ziels dein Projekt aus und öffne den Tab Build Settings (Build-Einstellungen). Gib im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) den Code -ObjC ein. Falls die Einstellungen nicht angezeigt werden, filtere in der Leiste Build Settings nicht mehr nach Basic (Standard), sondern nach All (Alle).

Swift-Paketmanager verwenden

1. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. (Falls Sie noch keine Erfahrung mit der iOS-Entwicklung haben, erstellen Sie ein neues Projekt und wählen Sie die Vorlage für iOS-Apps aus. Unter Xcode 11.7 oder älter müssen Sie eine Single View Application erstellen.
2. Maps SDK for iOS als Abhängigkeit hinzufügen Weitere Informationen finden Sie unter SDK installieren.
3. Gehen Sie in Ihrem Xcode-Projekt zu File -> Swift Packages -> Add Package Dependency.
4. Geben Sie im angezeigten Fenster die Repository-URL des Maps SDK for iOS-Dienstprogramms ein https://github.com/googlemaps/google-maps-ios-utils und wählen Sie Weiter aus.
• Sie werden dann möglicherweise aufgefordert, sich bei Ihrem GitHub-Konto zu authentifizieren. Folgen Sie der Anleitung, um ein persönliches GitHub-Zugriffstoken zu erstellen, um den Vorgang fortzusetzen.
5. Wählen Sie im nächsten Fenster das Optionsfeld Version aus, wählen Sie Exakt aus, geben Sie die neueste Version der Maps SDK for iOS-Dienstprogrammbibliothek ein (z.B. "3.4.0") und wählen Sie Weiter aus.