Diese Seite wurde von der Cloud Translation API übersetzt.

Jetzt starten

In diesem Dokument wird beschrieben, wie Sie mit der Nearby Messages API auf iOS-Geräten entwickeln.

Schritt 1: Neueste Version von Xcode herunterladen

Wenn du ein Projekt mit der Google Nearby Messages API for iOS einrichten möchtest, musst du mindestens Version 6.3 von Xcodeverwenden.

Schritt 2: CocoaPods herunterladen

Die Google Nearby Messages API für 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 OS X, 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

Schritt 3: API mit CocoaPods installieren

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

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 eine Single View Application und achte darauf, dass „Use Automatic Reference Counting“ (Automatische Referenzzählung verwenden) aktiviert ist.)
Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.
Bearbeite die Podfile und füge ihre Abhängigkeiten hinzu. Hier ist eine einfache Pod-Spezifikation 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'
```
Speichere die Podfile.
Öffne ein Terminalfenster und suche das Verzeichnis mit der Podfile:

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

$ pod install
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.

Schritt 4: Bridging-Header erstellen (nur Swift)

Wenn Sie Ihr Projekt mit Swift erstellt haben, müssen Sie Ihrem Projekt einen Bridging-Header hinzufügen, damit es die Bibliotheken verwenden kann, die über die Pod-Datei installiert wurden. So fügen Sie einen Überschriften-Übergang hinzu:

Fügen Sie im selben Verzeichnis wie die .xcworkspace-Datei Ihres Projekts eine neue Headerdatei hinzu. Geben Sie einen beliebigen Namen und die Dateiendung „.h“ an.
Fügen Sie den folgenden Code in die von Ihnen 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.
Gehen Sie in den Build-Einstellungen zu „Swift Compiler – Code Generation“ (Sie können auch „Swift Compiler“ in das Suchfeld eingeben, um die Option schnell zu finden).
Klicken Sie auf den Pfeil, um den Bereich Objective-C-Bridging-Header zu maximieren.
Fügen Sie unter Debug und Release den Pfad zur von Ihnen 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 rufen einen API-Schlüssel ab:

Rufen Sie die Google Developers Console auf.
Erstellen oder wählen Sie ein Projekt aus, mit dem Sie Ihre Anwendung registrieren möchten.
Klicken Sie auf Weiter, um die API zu aktivieren.
Erstelle auf der Seite Anmeldedaten einen neuen iOS-Schlüssel und lege die API-Anmeldedaten fest.
Hinweis: Wenn du bereits einen iOS-Schlüssel hast, kannst du 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 dein Projekt angezeigt. Ein API-Schlüssel ist eine Zeichenfolge, die in etwa so aussieht:
```
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
```
Um Kontingentdiebstahl zu verhindern, sollten Sie Ihren API-Schlüssel gemäß den folgenden Best Practices schützen.

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-CSwift

#import <GNSMessages.h>

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

let messageManager = GNSMessageManager(APIKey: "API_KEY")