Erste Schritte

In diesem Dokument werden die ersten Schritte für die Entwicklung mit der Nearby Messages API unter Android erläutert. 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.

Auf Ihrem Entwicklungshost muss die neueste Clientbibliothek für Google Play-Dienste installiert sein:

  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 einrichten

Wenn Sie die Nearby Messages APIs verwenden möchten, benötigen Sie ein Google-Konto. So können Sie als Entwickler die Nearby API im nächsten Schritt 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 haben.

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 daraufhin angezeigten 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 nach dem 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 Keystore zur Fehlerbehebung lautet android. Unter Mac OS und Linux befindet sich der Schlüsselspeicher zur 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.0.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();
}

Die Nearby Messages API erfordert die Einwilligung des Nutzers. Beim ersten Aufrufen von „Veröffentlichen“ oder „Abonnieren“ zeigt Nearby ein Aktivierungsdialogfeld an.