Jetzt starten

In diesem Dokument wird beschrieben, wie Sie mit der Entwicklung mit der Nearby Messages API unter iOS beginnen.

Schritt 1: Neueste Version von Xcode herunterladen

Wenn Sie ein Projekt mit der Google Nearby Messages API für iOS erstellen möchten, benötigen Sie Version 6.3 oder höher von Xcode.

Schritt 2: CocoaPods herunterladen

Die Google Nearby Messages API für iOS ist als CocoaPods Pod verfügbar. CocoaPods ist ein Open-Source-Abhängigkeitsmanager für Cocoa-Projekte in Swift und Objective-C.

Falls Sie das Tool „CocoaPods“ noch nicht nutzen, installieren Sie es unter OS X, indem Sie den folgenden Befehl über das Terminal ausführen. Weitere Informationen finden Sie im Startleitfaden zu CocoaPods (in englischer Sprache).

$ sudo gem install cocoapods

Schritt 3: API mit CocoaPods installieren

Erstellen Sie eine Podfile für die Google Nearby Messages API für iOS und verwenden Sie sie, um die API und die zugehörigen Abhängigkeiten zu installieren.

Falls Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf dem lokalen Rechner. (Wenn Sie noch keine Erfahrung mit der iOS-Entwicklung haben, erstellen Sie eine Single View Application und achten Sie darauf, dass die automatische Referenzzählung aktiviert ist.)
Erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.
Bearbeiten Sie die Podfile und fügen Sie die Abhängigkeiten hinzu. Hier ist eine einfache Podspec-Datei mit dem Namen des Pods, den Sie für die Google Nearby Messages API für iOS benötigen:
```
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'
```
Speichern Sie die Podfile.
Öffnen Sie ein Terminalfenster und suchen Sie das Verzeichnis mit der Podfile:

$ cd
Führen Sie den Befehl pod install aus. Dadurch werden die in der Podspec-Datei angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.

$ pod install
Schließen Sie Xcode und öffnen Sie dann mit einem Doppelklick die Datei .xcworkspace Ihres Projekts, um Xcode wieder zu starten. Ab jetzt müssen Sie das Projekt über die Datei .xcworkspace aufrufen.

Schritt 4: Bridging-Header erstellen (nur Swift)

Wenn Sie Ihr Projekt mit Swift erstellt haben, müssen Sie einen Bridging-Header hinzufügen, damit die Bibliotheken verwendet werden können, die von der Pod-Datei installiert wurden. So fügen Sie einen Bridging-Header hinzu:

Fügen Sie im selben Verzeichnis wie die Datei .xcworkspace Ihres Projekts eine neue Headerdatei hinzu (geben Sie ihr einen beliebigen Namen und verwenden Sie die Dateinamenerweiterung „.h“).
Fügen Sie den folgenden Code in die erstellte Datei ein: #import <GNSMessages.h>.
Speichern Sie die Datei.
Wählen Sie im linken Bereich des Projekteditors das Hauptprojekt aus.
Klicken Sie oben im Build-Editor auf Build-Einstellungen.
Suchen Sie in den Build-Einstellungen nach „Swift Compiler – Code Generation“ (geben Sie „Swift Compiler“ in das Suchfeld ein, um es schnell zu finden).
Klicken Sie auf den Pfeil, um den Abschnitt Objective-C Bridging Header zu maximieren.
Fügen Sie unter Debug und Release den Pfad zur erstellten Headerdatei hinzu.
Erstellen Sie das Projekt, damit die Änderungen wirksam werden.

Schritt 5: Google-Konto erstellen

Wenn Sie die Nearby Messages APIs verwenden möchten, benötigen Sie ein Google-Konto. Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar. Für Testzwecke könnte ein separates Google-Konto sinnvoll sein.

Schritt 6: API-Schlüssel anfordern

So aktivieren Sie die Google Nearby Messages API für iOS und fordern einen API-Schlüssel an:

Rufen Sie die Google Developers Console auf.
Erstellen oder wählen Sie ein Projekt aus, um Ihre Anwendung zu registrieren.
Klicken Sie auf Weiter , um die API zu aktivieren.
Erstellen Sie auf der Seite Anmeldedaten einen neuen iOS-Schlüssel und legen Sie die API-Anmeldedaten fest.
Hinweis: Wenn Sie bereits einen iOS-Schlüssel haben, können Sie diesen verwenden.
Geben Sie im angezeigten Dialogfeld die Bundle-ID Ihrer App ein. Beispiel:
```
com.example.nearbyexample
```
Der neue iOS-API-Schlüssel wird in der Liste der API-Schlüssel für Ihr Projekt angezeigt. Ein API-Schlüssel ist eine Zeichenfolge, die in etwa so aussieht:
```
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
```
Um Kontingentdiebstahl zu verhindern, sichern Sie Ihren API-Schlüssel gemäß diesen Best Practices.

Schritt 7: Message Manager-Objekt erstellen

Mit dem Message Manager-Objekt können Sie Nachrichten veröffentlichen und abonnieren. Der Nachrichtenaustausch ist nicht authentifiziert. Sie müssen daher den API-Schlüssel angeben, den Sie im vorherigen Schritt erstellt haben.

Objective-C

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")