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 Xcode in der Version 6.3 oder höher.

Schritt 2: CocoaPods installieren

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

Wenn Sie das CocoaPods-Tool noch nicht haben, installieren Sie es unter OS X, indem Sie den folgenden Befehl im Terminal ausführen. Weitere Informationen finden Sie im CocoaPods-Startleitfaden.

$ sudo gem install cocoapods

Schritt 3: API mit CocoaPods installieren

Erstellen Sie ein Podfile für die Google Nearby Messages API für iOS und verwenden Sie es, um die API und ihre Abhängigkeiten zu installieren.

  • Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie jetzt eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie neu in der iOS-Entwicklung sind, erstellen Sie eine Single View Application und achten Sie darauf, dass „Use Automatic Reference Counting“ aktiviert ist.
  • Erstellen Sie eine Datei mit dem Namen Podfile in Ihrem Projektverzeichnis. In dieser Datei werden die Abhängigkeiten Ihres Projekts definiert.

  • Bearbeite die Podfile und füge ihre Abhängigkeiten hinzu. Hier ist ein einfaches Podspec, das 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 zu dem Verzeichnis, das Podfile enthält:

    $ cd

  • Führen Sie den Befehl pod install aus: Dadurch werden die in der Podspec angegebenen APIs zusammen mit allen zugehörigen Abhängigkeiten installiert.

    $ pod install

  • Schließen Sie Xcode und öffnen Sie dann die .xcworkspace-Datei Ihres Projekts per Doppelklick, um Xcode zu starten. Ab diesem Zeitpunkt müssen Sie die Datei .xcworkspace verwenden, um das Projekt zu öffnen.

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 einen Bridging-Header hinzu:

  1. Fügen Sie im selben Verzeichnis wie die .xcworkspace-Datei Ihres Projekts eine neue Header-Datei hinzu (geben Sie ihr einen beliebigen Namen und verwenden Sie die Dateinamenerweiterung „.h“).
  2. Fügen Sie den folgenden Code in die 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. Gehen Sie in den Build-Einstellungen zu „Swift Compiler – Code Generation“ (geben Sie „Swift Compiler“ in das Suchfeld ein, um die Option schnell zu finden).
  7. Klicken Sie auf den Pfeil, um den Bereich Objective-C Bridging Header zu maximieren.
  8. Fügen Sie unter Debug und Release den Pfad zur Header-Datei hinzu, die Sie erstellt haben.
  9. 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 abrufen

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 Sie ein Projekt oder wählen Sie eines aus, um Ihre Anwendung zu registrieren.
  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 den Paket-Identifikator 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. Best Practices zum Sichern Ihres API-Schlüssels, um Kontingentdiebstahl zu verhindern

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")