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 mindestens Version 6.3 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 du das Tool „CocoaPods“ noch nicht nutzt, installiere es unter OS X, indem du den folgenden Befehl über das Terminal ausführst. Weitere Informationen finden Sie im Startleitfaden zu CocoaPods.

$ sudo gem install cocoapods

Schritt 3: API mit CocoaPods installieren

Erstelle eine Podfile für die Google Nearby Messages API für 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 wenig Erfahrung mit iOS hast, solltest du eine Single View Application erstellen und darauf achten, 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 Podspec, die den Namen des Pods enthält, 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.

  • Öffnen Sie ein Terminal und wechseln Sie in das Verzeichnis mit der Podfile:

    $ cd

  • Führen Sie den Befehl pod install aus: Dadurch werden die im 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 durch die Pod-Datei installiert wurden. So fügen Sie eine überbrückende Kopfzeile hinzu:

  1. Fügen Sie im selben Verzeichnis wie die .xcworkspace-Datei Ihres Projekts eine neue Headerdatei hinzu (wählen Sie einen beliebigen Namen und verwenden Sie die Dateinamenerweiterung „.h“).
  2. Fügen Sie den folgenden Code in die von Ihnen erstellte Datei ein: #import <GNSMessages.h>.
  3. Speichern Sie die Datei.
  4. Wählen Sie im linken Bereich des Projekt-Editors das Hauptprojekt aus.
  5. Klicken Sie oben im Build-Editor auf Build-Einstellungen.
  6. Rufen Sie in den Build-Einstellungen „Swift Compiler – Code Generation“ auf (geben Sie „Swift Compiler“ in das Suchfeld ein, um die Option schnell zu finden).
  7. Klicken Sie auf den Pfeil, um den Abschnitt Objective-C Bridging Header zu maximieren.
  8. Fügen Sie unter Debug und Release den Pfad zur Headerdatei hinzu, die Sie erstellt haben.
  9. Erstellen Sie das Projekt, damit die Änderungen wirksam werden.

Schritt 5: Google-Konto erstellen

Für die Verwendung der Nearby Messages APIs 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:

  1. Rufen Sie die Google Developers Console auf.
  2. Erstellen oder wählen Sie ein Projekt aus, mit dem Sie Ihre Anwendung registrieren möchten.
  3. Klicken Sie auf Weiter, um die API zu aktivieren.
  4. 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.
  5. Geben Sie im angezeigten Dialogfeld die Bundle-ID Ihrer App ein. Beispiel: 
    com.example.nearbyexample
  6. 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
  7. Halten Sie sich an diese Best Practices, um Kontingentdiebstahl zu verhindern und Ihren API-Schlüssel zu 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 also 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")