Xcode-Projekt einrichten

Nachdem Sie die Abrechnung aktiviert und einen API-Schlüssel erstellt haben, können Sie das Xcode-Projekt einrichten, mit dem Sie Ihre App entwickeln.

Für jede Version sind Versionshinweise verfügbar.

Schritt 1: Erforderliche Software installieren

Wenn Sie ein Projekt mit dem Maps SDK for iOS erstellen möchten, müssen Sie Folgendes herunterladen und installieren:

• Xcode Version 15.0 oder höher

Schritt 2: Xcode-Projekt erstellen und Maps SDK for iOS installieren

Swift-Paketmanager

Das Maps SDK for iOS kann über den Swift Package Manager installiert werden. Wenn Sie das SDK hinzufügen möchten, müssen Sie alle vorhandenen Abhängigkeiten des Maps SDK for iOS entfernt haben.

Wichtig: Diese Anleitung setzt die Verwendung von Xcode 15 oder höher voraus, sollte aber für frühere Versionen von Xcode ähnlich sein.

So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:

1. Öffnen Sie Xcode project oder workspace und klicken Sie dann auf Datei > Paketabhängigkeiten hinzufügen.
2. Geben Sie https://github.com/googlemaps/ios-maps-sdk als URL ein, drücken Sie die Eingabetaste, um das Paket abzurufen, und klicken Sie auf „Paket hinzufügen“.
3. Wenn Sie eine bestimmte version installieren möchten, legen Sie das Feld Abhängigkeitsregel auf eine der versionsbasierten Optionen fest. Bei neuen Projekten empfehlen wir, die neueste Version anzugeben und die Option „Exakte Version“ zu verwenden. Klicke anschließend auf „Paket hinzufügen“.
4. Prüfen Sie im Fenster Paketprodukte auswählen, ob GoogleMaps zu Ihrem festgelegten main-Ziel hinzugefügt wird. Prüfen Sie für Versionen vor 9.0.0, ob GoogleMaps, GoogleMapsBase und GoogleMapsCore hinzugefügt werden. Klicke anschließend auf „Paket hinzufügen“.
5. Um die Installation zu überprüfen, navigiere zum Bereich General deines Ziels. Die installierten Pakete sollten nun unter Frameworks, Bibliotheken und eingebettete Inhalte zu sehen sein. Sie können auch den Abschnitt „Paketabhängigkeiten“ der Projektnavigation aufrufen, um das Paket und seine Version zu prüfen.

So aktualisieren Sie package für ein vorhandenes Projekt:

1. Wenn Sie ein Upgrade von einer Version vor 9.0.0 durchführen, müssen Sie nach dem Upgrade die folgenden Abhängigkeiten entfernen: GoogleMapsBase, GoogleMapsCore und GoogleMapsM4B. Entfernen Sie die Abhängigkeit für GoogleMaps nicht. Weitere Informationen finden Sie in den Versionshinweisen zu Version 9.0.0.

   Suchen Sie in den Xcode-Projektkonfigurationseinstellungen nach Frameworks, Bibliotheken und eingebettete Inhalte. Verwenden Sie das Minuszeichen(-), um das folgende Framework zu entfernen:

   • GoogleMapsBase (nur für Upgrades von Versionen vor 9.0.0)
   • GoogleMapsCore (nur für Upgrades von Versionen vor 9.0.0)
   • GoogleMapsM4B (nur für Upgrades von Versionen vor 9.0.0)
2. Gehen Sie in Xcode zu „File > Packages > Update to Latest Package Versions“ (Datei > Pakete> Auf neueste Paketversionen aktualisieren).
3. Um Ihre Installation zu überprüfen, gehen Sie zum Abschnitt Paketabhängigkeiten der Projektnavigation, um das Paket und seine Version zu überprüfen.

Wichtig: Manchmal können Artefakte nicht behoben werden oder es können Fehler auftreten. Wählen Sie in diesem Fall „Datei > Pakete > Paket-Cache zurücksetzen“ aus.

So entfernen Sie vorhandene Maps SDK for iOS-Abhängigkeiten, die mit CocoaPods hinzugefügt wurden:

1. Schließen Sie den Xcode-Arbeitsbereich. Öffnen Sie das Terminal und führen Sie den folgenden Befehl aus:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Entferne Podfile, Podfile.resolved und Xcode workspace, wenn du sie ausschließlich für CocoaPods verwendest.

So entfernen Sie ein vorhandenes Maps SDK for iOS, das manuell installiert wurde:

1. Suchen Sie in den Xcode-Projektkonfigurationseinstellungen nach Frameworks, Bibliotheken und eingebettete Inhalte. Verwenden Sie das Minuszeichen(-), um das folgende Framework zu entfernen:
   • GoogleMaps
   • GoogleMapsBase (nur für Installationen vor Version 9.0.0)
   • GoogleMapsCore (nur für Installationen vor Version 9.0.0)
   • GoogleMapsM4B (nur für Installationen vor Version 9.0.0)
2. Entfernen Sie das GoogleMaps-Bundle aus dem Verzeichnis der obersten Ebene Ihres Xcode-Projekts.

CocoaPods

Das Maps SDK for iOS ist als Pod von CocoaPods verfügbar. CocoaPods ist ein Open-Source-Abhängigkeitsmanager für Cocoa-Projekte in Swift und Objective-C.

Falls du das Tool „CocoaPods“ noch nicht nutzt, installiere es unter macOS, indem du den folgenden Befehl über das Terminal ausführst. Weitere Informationen findest du im Startleitfaden zu CocoaPods (in englischer Sprache).

sudo gem install cocoapods

Erstelle eine Podfile für das Maps SDK for iOS und verwende sie, um die API und die zugehörigen Abhängigkeiten zu installieren:

1. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie noch nicht mit der iOS-Entwicklung vertraut sind:
   1. Erstellen Sie ein neues Projekt.
   2. Wählen Sie die Vorlage iOS > App aus.
   3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie den Wert des Felds Bundle Identifier. Mit diesem Wert können Sie Ihren API-Schlüssel unten einschränken.
      3. Setze das Projekt Interface auf Storyboard.
      4. Stellen Sie die Sprache auf Swift oder Objective-C ein.
2. Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.
3. Bearbeiten Sie die Podfile und fügen Sie die Abhängigkeiten zusammen mit den zugehörigen versions hinzu. Hier ein Beispiel mit der Abhängigkeit, die Sie für das Maps SDK for iOS benötigen:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '8.4.0'
   end
   

   Führen Sie regelmäßig pod outdated aus, um zu erkennen, wann eine neuere Version verfügbar ist und Sie immer auf dem neuesten Stand sind. Führen Sie bei Bedarf ein Upgrade auf die neueste Version durch.
4. Speichere die Podfile.

5. Öffnen Sie ein Terminal und wechseln Sie zum Verzeichnis mit der Datei Podfile:

   cd <path-to-project>

6. Führe den Befehl pod install aus. Dadurch werden die in der Podfile angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.

   pod install

7. Schließe Xcode und öffne dann mit einem Doppelklick die Datei .xcworkspace deines Projekts, um Xcode wieder zu starten. Ab jetzt musst du das Projekt über die Datei .xcworkspace aufrufen.

So aktualisieren Sie die API für ein vorhandenes Projekt:

1. Öffnen Sie ein Terminal und rufen Sie das Projektverzeichnis mit der Datei Podfile auf.
2. Führe den Befehl pod update aus. Dadurch werden alle in der Podfile angegebenen APIs auf die neueste Version aktualisiert.

Manuelle Installation

In diesem Leitfaden erfahren Sie, wie Sie die XCFrameworks, die das Maps SDK for iOS enthalten, Ihrem Projekt manuell hinzufügen und Ihre Build-Einstellungen in Xcode konfigurieren. Ein XCFramework ist ein Binärpaket, das Sie auf mehreren Plattformen verwenden können, einschließlich Rechnern, die Apple Silicon verwenden.

1. Laden Sie die folgenden SDK-Binärdateien und Ressourcendateien herunter:
   • GoogleMaps
   • GoogleMapsBase
   • GoogleMapsCore
   • GoogleMapsM4B
   • GoogleMapsResources
2. Extrahieren Sie die Dateien, um auf XCFrameworks und Ressourcen zuzugreifen.
3. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie noch nicht mit der iOS-Entwicklung vertraut sind:
   1. Erstellen Sie ein neues Projekt.
   2. Wählen Sie die Vorlage iOS > App aus.
   3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie den Wert des Felds Bundle Identifier. Mit diesem Wert können Sie Ihren API-Schlüssel unten einschränken.
      3. Setze das Projekt Interface auf Storyboard.
      4. Stellen Sie die Sprache auf Swift oder Objective-C ein.
4. Öffnen Sie den Tab Allgemein. Ziehen Sie die folgenden XCFrameworks in Ihr Projekt zu Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Wählen Sie für jedes XCFramework die Option Nicht einbetten aus:
   • GoogleMaps.xcframework
   • GoogleMapsBase.xcframework
   • GoogleMapsCore.xcframework
5. Kopieren Sie die GoogleMaps.bundle aus den GoogleMapsResources, die Sie heruntergeladen haben, in die oberste Ebene Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Copy items into destination group's folder (Elemente in Ordner der Zielgruppe kopieren) aus, wenn Sie dazu aufgefordert werden.
6. Wählen Sie Ihr Projekt aus dem Project Navigator und dann das Ziel Ihrer App aus.
7. Öffnen Sie den Tab Build Phases (Build-Phasen) für das Ziel Ihrer Anwendung. Fügen Sie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks und Bibliotheken hinzu:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework (nur bei Verwendung von OpenGL)
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Wählen Sie Ihr Projekt anstelle eines bestimmten Ziels aus und öffnen Sie den Tab Build Settings (Build-Einstellungen). Fügen Sie im Abschnitt Verknüpfung – Allgemein -> Andere Verknüpfungs-Flags -ObjC zu „Debug“ und „Release“ hinzu. Wenn diese Einstellungen nicht angezeigt werden, ändern Sie den Filter in der Leiste Build Settings (Build-Einstellungen) von Basic (Standard) zu All (Alle).

9. Informationen zum Installieren des Places SDK for iOS XCFramework finden Sie unter Erste Schritte mit dem Places SDK for iOS.

Schritt 3: Apple Privacy Manifest-Datei prüfen

Apple verlangt, dass für Apps im App Store Details zum App-Datenschutz angegeben werden. Aktuelle Informationen und weitere Informationen finden Sie auf der Seite zu Datenschutzdetails im Apple App Store.

Die Apple Privacy Manifest-Datei ist im Ressourcenpaket für das SDK enthalten. Wenn Sie prüfen möchten, ob die Privacy Manifest-Datei enthalten ist, und ihren Inhalt prüfen möchten, erstellen Sie ein Archiv Ihrer App und generieren Sie aus dem Archiv einen Datenschutzbericht.

Schritt 4: API-Schlüssel zum Projekt hinzufügen

Unter API-Schlüssel abrufen haben Sie einen API-Schlüssel für Ihre App generiert. Fügen Sie diesen Schlüssel jetzt Ihrem Xcode-Projekt hinzu.

Ersetzen Sie YOUR_API_KEY in den folgenden Beispielen durch Ihren API-Schlüssel.

Hinweis :Wenn Sie die Bundle-ID Ihres Projekts aufgezeichnet oder aus den Projekteigenschaften abgerufen haben, können Sie damit Ihren API-Schlüssel einschränken, sodass er nur in iOS-Anwendungen mit dieser spezifischen Paket-ID verwendet werden kann. Siehe API-Schlüssel einschränken

erhältst du weitere Informationen.

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 der Methode application(_:didFinishLaunchingWithOptions:) unter Verwendung Ihres API-Schlüssels Folgendes hinzu:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Wenn Sie auch die Places API verwenden, fügen Sie den Schlüssel noch einmal hinzu:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

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 der Methode application:didFinishLaunchingWithOptions: unter Verwendung Ihres API-Schlüssels Folgendes hinzu:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Wenn Sie auch die Places API verwenden, fügen Sie den Schlüssel noch einmal hinzu:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Schritt 5: Eine Karte hinzufügen

Swift

/*
 *   Copyright 2020 Google Inc. All rights reserved.
 *
 *
 *   Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 *   file except in compliance with the License. You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software distributed under
 *   the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 *   ANY KIND, either express or implied. See the License for the specific language governing
 *   permissions and limitations under the License.
 */

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.

        let options = GMSMapViewOptions()
        options.camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        options.frame = self.view.bounds

        let mapView = GMSMapView(options: options)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}

Objective-C

/*
*   Copyright 2020 Google Inc. All rights reserved.
*
*
*   Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
*   file except in compliance with the License. You may obtain a copy of the License at
*
*   http://www.apache.org/licenses/LICENSE-2.0
*
*   Unless required by applicable law or agreed to in writing, software distributed under
*   the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
*   ANY KIND, either express or implied. See the License for the specific language governing
*   permissions and limitations under the License.
*/

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController()

@end

@implementation ViewController

-   (void)viewDidLoad {
  [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
  options.frame = self.view.bounds;
  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end

Schritt 5 (optional): Von der API verwendete URL-Schemas angeben

Ab iOS 9 und Xcode 7 können Apps die URL-Schemas deklarieren, die geöffnet werden sollen. Dazu werden die Schemas in der Datei Info.plist der App angegeben. Über das Maps SDK for iOS wird die mobile Google Maps App geöffnet, wenn der Nutzer auf der Karte auf das Google-Logo klickt. Ihre App kann dann die entsprechenden URL-Schemas deklarieren.

Um die URL-Schemas zu deklarieren, die vom Maps SDK for iOS verwendet werden, fügen Sie die folgenden Zeilen in die Datei Info.plist ein:

LSApplicationQueriesSchemes googlechromes comgooglemaps

Im folgenden Screenshot wird die Konfiguration in der Benutzerschnittstelle von Xcode gezeigt:

Ohne diese Deklaration können die folgenden Fehler auftreten, wenn der Nutzer auf das Google-Logo auf der Karte tippt:

• -canOpenURL: fehlgeschlagen für URL: „comgooglemaps://“ – Fehler: „Diese App darf das Schema „comgooglemaps“ nicht abfragen.“
• -canOpenURL: fehlgeschlagen für URL: "googlechromes://" – Fehler: "Diese App darf das Schema googlechromes nicht abfragen."

Fügen Sie die Deklaration zu Info.plist hinzu, um diese Fehler zu vermeiden.

Nächste Schritte

Da Sie nun einen API-Schlüssel und ein Xcode-Projekt haben, können Sie Anwendungen erstellen und ausführen. Das Navigation SDK for iOS bietet viele Anleitungen und Beispielanwendungen, die Ihnen den Einstieg erleichtern. Weitere Informationen finden Sie hier:

• Codebeispielen
• Tutorials
  • Karte mit einer Markierung hinzufügen
  • Auf einer Karte den aktuellen Ort auswählen und Details einblenden
  • Umgekehrte Geocodierung
• Codelabs
• Google Maps-Lösungen