Jetzt starten

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

Schritt 1: Neueste Version von Xcode herunterladen

Zum Erstellen eines Projekts mit der Google Nearby Messages API für iOS 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 CocoaPods ist eine Open-Source-Abhängigkeit. für die Projekte Swift und Objective-C Cocoa.

Wenn Sie das Tool CocoaPods noch nicht haben, installieren Sie es unter OS X, indem Sie den folgenden Befehl vom Terminal aus. Weitere Informationen finden Sie unter CocoaPods Startleitfaden.

$ 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 für folgende Aktionen: um die API und ihre Abhängigkeiten zu installieren.

  • Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es in Ihrem auf dem lokalen Computer. Wenn Sie noch keine Erfahrung mit der iOS-Entwicklung haben, erstellen Sie eine Einzelansicht. Anwendung und stellen Sie sicher, dass die Option Automatische Referenzzählung verwenden aktiviert ist.
  • Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Podfile. Diese Datei definiert Ihre Abhängigkeiten des Projekts.

  • Bearbeite die Podfile und füge ihre Abhängigkeiten hinzu. Hier ist eine einfache Podspec, einschließlich des Namens des Pods, den Sie für die Google Nearby Messages API für iOS: 

    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'

  • Speichere die Podfile.

  • Öffnen Sie ein Terminal und wechseln Sie zum Verzeichnis mit der Datei Podfile:

    $ cd

  • Führe den Befehl pod install aus. Dadurch werden die APIs installiert, die im Podspec und ggf. deren Abhängigkeiten an.

    $ Pod-Installation

  • Schließen Sie Xcode und öffnen Sie dann per Doppelklick die .xcworkspace-Datei Ihres Projekts. um Xcode zu starten. Ab jetzt musst du die Datei .xcworkspace verwenden, um öffnen Sie das Projekt.

Schritt 4: Bridging-Header erstellen (nur Swift)

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

  1. Fügen Sie im selben Verzeichnis wie die Datei .xcworkspace Ihres Projekts ein neues Headerdatei (benennen Sie sie beliebig 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 – Codegenerierung“. (Typ „Swift Compiler“ in das Suchfeld ein, um sie 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, erstellt.
  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 eine zu Testzwecken ein separates Google-Konto erstellen.

Schritt 6: API-Schlüssel abrufen

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

  1. Gehe zu Google Developers Console.
  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. Erstellen Sie auf der Seite Anmeldedaten einen neuen iOS-Schlüssel und legen Sie die API fest. Anmeldedaten).
    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 eine Zeichenfolge, die in etwa so aussieht: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Um Kontingentdiebstahl zu verhindern, sollten Sie Ihren API-Schlüssel folgendermaßen sichern: Best Practices.

Schritt 7: Nachrichtenmanagerobjekt erstellen

Mit dem Nachrichtenmanagerobjekt können Sie Inhalte veröffentlichen und abonnieren. Nachrichtenaustausch ist nicht authentifiziert ist. Sie müssen also den API-Schlüssel angeben, den Sie im vorherigen Schritt Schritt.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")