Erste Schritte

In diesem Dokument wird erläutert, wie Sie mit der Nearby Messages API unter iOS entwickeln.

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 kaufen

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 du das CocoaPods-Tool noch nicht hast, installiere es unter OS X, indem du den folgenden Befehl über das Terminal ausführst. Weitere Informationen findest du 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.

  • Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie neu in der iOS-Entwicklung sind, erstellen Sie eine Single View-Anwendung und achten Sie darauf, dass "Automatische Referenzzählung verwenden" aktiviert ist.
  • Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Podfile. Diese Datei definiert die Abhängigkeiten Ihres Projekts.

  • Bearbeite die Podfile und füge ihre Abhängigkeiten hinzu. Hier ist eine einfache Pod-Spezifikation, einschließlich des Namens 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.

  • Öffnen Sie ein Terminal und rufen Sie das Verzeichnis auf, das Podfile enthält:

    $ cd

  • Führe den Befehl pod install aus. Dadurch werden die in der Podspec angegebenen APIs und alle zugehörigen Abhängigkeiten installiert.

    $ Pod-Installation

  • Schließen Sie Xcode und klicken Sie mit einem Doppelklick auf die Datei .xcworkspace Ihres Projekts, um Xcode zu starten. Ab diesem Zeitpunkt müssen Sie zum Öffnen des Projekts die Datei .xcworkspace verwenden.

Schritt 4: Bridging-Header erstellen (nur Swift)

Wenn Sie Ihr Projekt mit Swift erstellt haben, müssen Sie ihm einen Bridging-Header hinzufügen, damit es die von der Pod-Datei installierten Bibliotheken verwenden kann. So fügen Sie einen Bridging-Header hinzu:

  1. Fügen Sie im selben Verzeichnis wie die .xcworkspace-Datei Ihres Projekts eine neue Headerdatei hinzu. Geben Sie ihr einen beliebigen Namen und verwenden Sie die Dateiendung „.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 Projekteditors das Hauptprojekt aus.
  5. Klicken Sie oben im Build-Editor auf Build Settings (Build-Einstellungen).
  6. Gehen Sie in den Build-Einstellungen zu „Swift Compiler – Code Generation“. Geben Sie „Swift Compiler“ in das Suchfeld ein, um den Dienst 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 zu der von Ihnen erstellten Headerdatei hinzu.
  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. Sie können auch ein separates Google-Konto zu Testzwecken erstellen.

Schritt 6: API-Schlüssel anfordern

Führe die folgenden Schritte aus, um die Google Nearby Messages API für iOS zu aktivieren und einen API-Schlüssel anzufordern:

  1. Rufen Sie die Google Developers Console auf.
  2. Erstellen Sie ein Projekt oder wählen Sie ein Projekt aus, bei dem Sie Ihre Anwendung registrieren möchten.
  3. Klicken Sie auf Weiter, um die API zu aktivieren.
  4. Erstelle auf der Seite Anmeldedaten einen neuen iOS-Schlüssel und lege die API-Anmeldedaten fest.
    Hinweis: Wenn Sie bereits einen iOS-Schlüssel haben, können Sie diesen verwenden.
  5. Geben Sie im daraufhin angezeigten Dialogfeld die Bundle-ID Ihrer App ein. Beispiel: 
    com.example.nearbyexample
  6. Ihr neuer iOS-API-Schlüssel wird in der Liste der API-Schlüssel für Ihr Projekt angezeigt. Ein API-Schlüssel ist ein String, der in etwa so aussieht: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Schützen Sie Ihren API-Schlüssel mit diesen Best Practices, um Kontingentdiebstahl zu verhindern.

Schritt 7: Nachrichtenmanager-Objekt erstellen

Mit dem Nachrichtenmanager-Objekt können Sie Inhalte veröffentlichen und abonnieren. Da der Nachrichtenaustausch nicht authentifiziert ist, müssen Sie 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")