Erste Schritte

In diesem Dokument wird erläutert, wie du mit der Nearby Messages API für Android mit der Entwicklung beginnst. Die Nearby Messages API ist Teil der Google Play-Dienste.

Schritt 1: Google Play-Dienste herunterladen

Die Nearby Messages API ist auf Android-Geräten mit den Google Play-Diensten 7.8.0 oder höher verfügbar. Geräte mit Android 2.3 oder höher, auf denen die Google Play Store App installiert ist, erhalten automatisch Updates für die Google Play-Dienste. Unter Einstellungen > Apps > Google Play-Dienste können Sie prüfen, welche Version der Google Play-Dienste auf Ihrem Gerät installiert ist.

Prüfen Sie, ob auf Ihrem Entwicklungshost die neueste Clientbibliothek für Google Play-Dienste installiert ist:

  1. Öffnen Sie den Android SDK Manager.

  2. Unter Darstellung und Verhalten > Systemeinstellungen > Android SDK > SDK-Tools müssen die folgenden Pakete installiert sein:

    • Google Play-Dienste
    • Google-Repository

Schritt 2: Google-Konto erstellen

Wenn Sie die Nearby Messages APIs verwenden möchten, benötigen Sie ein Google-Konto. So können Sie als Entwickler im nächsten Schritt die Nearby API aktivieren. Ihre Nutzer benötigen kein 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 3: API-Schlüssel anfordern

Führe die folgenden Schritte aus, um die Google Nearby Messages API für Android 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 Android-Schlüssel und lege die API-Anmeldedaten fest.
    Hinweis: Wenn Sie bereits einen Android-Schlüssel haben, können Sie diesen verwenden.
  5. Geben Sie im folgenden Dialogfeld den SHA-1-Fingerabdruck und den Paketnamen Ihrer App ein. Beispiel: 
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.nearbyexample
  6. Ihr neuer Android 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

SHA1-Fingerabdruck Ihres Zertifikats abrufen

Zum Erstellen eines neuen API-Schlüssels für Ihre Android-App benötigen Sie den SHA1-Fingerabdruck des Zertifikats, mit dem Sie Ihr APK signieren. Nachrichten können nur zwischen Anwendungen ausgetauscht werden, die mit API-Schlüsseln aus demselben Projekt signiert sind.

So rufen Sie diesen Fingerabdruck ab:

  1. Suchen Sie den Speicherort Ihres Schlüsselspeichers.
  2. Führen Sie in einem Terminal das Dienstprogramm keytool aus dem JDK aus. Wenn Sie beispielsweise den Schlüsselspeicher `debug` verwenden:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    Hinweis: Das Passwort für den Schlüsselspeicher für die Fehlerbehebung lautet android. Unter Mac OS und Linux befindet sich der Schlüsselspeicher für die Fehlerbehebung normalerweise unter ~/.android/debug.keystore. Unter Windows befindet er sich normalerweise unter %USERPROFILE%\.android\debug.keystore.

  3. Die Ausgabe des Befehls keytool enthält den SHA1-Fingerabdruck für das Zertifikat.

Schritt 4: Projekt konfigurieren

Mit Android Studio kannst du ganz einfach ein Projekt für die Nearby Messages API erstellen. Erstellen Sie ein neues Projekt, indem Sie die unter Projekt erstellen beschriebenen Schritte ausführen. Öffnen Sie in Android Studio die Datei build.gradle für Ihr Modul und fügen Sie die Clientbibliothek der Google Play-Dienste als Abhängigkeit hinzu:

apply plugin: 'android'
...

dependencies {
    compile 'com.google.android.gms:play-services-nearby:19.1.0'
}

Konfigurieren Sie dann Ihr Manifest mit dem API-Schlüssel, der im vorherigen Schritt generiert wurde:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.sample.app" >
    <application ...>
        <meta-data
            android:name="com.google.android.nearby.messages.API_KEY"
            android:value="API_KEY" />
        <activity>
        ...
        </activity>
    </application>
</manifest>

Schritt 5: Veröffentlichen und abonnieren

Verwenden Sie in Ihrer App die Nearby Messages API.

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }

    mMessage = new Message("Hello World".getBytes());
}

@Override
public void onStart() {
    super.onStart();
    ...
    Nearby.getMessagesClient(this).publish(mMessage);
    Nearby.getMessagesClient(this).subscribe(mMessageListener);
}

@Override
public void onStop() {
    Nearby.getMessagesClient(this).unpublish(mMessage);
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
    ...
    super.onStop();
}

Für die Nearby Messages API ist die Nutzereinwilligung erforderlich. Beim erstmaligen Aufrufen von „Veröffentlichen“ oder „Abonnieren“ wird in Nearby ein Opt-in-Dialogfeld angezeigt.