Registrierung und API-Schlüssel

Wenn Sie die Google Awareness API verwenden möchten, müssen Sie Ihrer App einen Google API-Schlüssel hinzufügen. Sie benötigen einen Android API-Schlüssel.

Alle Android-Apps sind mit einem digitalen Zertifikat signiert, für das Sie den privaten Schlüssel haben. Weitere Informationen zu digitalen Zertifikaten finden Sie in der Android-Anleitung zum Signieren von Apps.

Android API-Schlüssel sind mit bestimmten Zertifikatspaketpaaren verknüpft. Sie benötigen nur einen Schlüssel für jedes Zertifikat, unabhängig davon, wie viele Nutzer Sie für die App haben.

Um einen Schlüssel für Ihre App zu erhalten, sind mehrere Schritte erforderlich. Diese werden in diesem Leitfaden ausführlich beschrieben und hier zusammengefasst:

  1. Informationen zum Zertifikat Ihrer App abrufen
  2. Registrieren Sie ein Projekt in der Google Developers Console und fügen Sie die User Context API als Dienst für das Projekt hinzu.
  3. Fordern Sie einen Schlüssel an.
  4. Fügen Sie den Schlüssel Ihrer App hinzu. Fügen Sie dazu Ihrem App-Manifest ein Element hinzu.

Informationen zum Zertifikat Ihrer App finden

Der API-Schlüssel basiert auf einer Kurzform des digitalen Zertifikats Ihrer App, auch bekannt als SHA-1-Fingerabdruck. Wenn Sie den SHA-1-Fingerabdruck für Ihr Zertifikat anzeigen möchten, müssen Sie zuerst das richtige Zertifikat verwenden. Möglicherweise stehen Ihnen die folgenden beiden Zertifikate zur Auswahl:

  • Debug-Zertifikat: Die Android SDK-Tools generieren dieses Zertifikat automatisch, wenn du ein Debug-Build ausführst. Verwende dieses Zertifikat nur bei Apps, die du testest. Veröffentlichen Sie keine Apps, die mit einem Debug-Zertifikat signiert sind. Das Debugzertifikat wird im Abschnitt Debug-Build signieren in der Android-Entwicklerdokumentation näher beschrieben.
  • Freigabezertifikat: Die Android SDK-Tools generieren dieses Zertifikat automatisch, wenn du ein Releasebuild ausführst. Du kannst dieses Zertifikat auch mithilfe des Programms keytool generieren. Verwende dieses Zertifikat, wenn du deine App veröffentlichst.

Weitere Informationen zu keytool finden Sie in der Oracle-Dokumentation.

Debug-Zertifikat

Fingerabdruck des Debug-Zertifikats aufrufen

Verwenden Sie das Programm keytool mit dem Parameter -v, um den SHA-1-Fingerabdruck eines Zertifikats aufzurufen. Führen Sie dazu folgende Schritte aus:

  1. Suche nach deiner Debug-Schlüsselspeicherdatei. Der Dateiname ist debug.keystore. Die Datei wird erstellt, wenn du dein Projekt zum ersten Mal erstellst. Standardmäßig befindet sich die Datei in demselben Verzeichnis wie deine AVD-Dateien (Android Virtual Device):

    • OS X und Linux: ~/.android/
    • Windows Vista und Windows 7: C:\Users\your_user_name\.android\

  2. SHA-1-Fingerabdruck auflisten:

    • Öffnen Sie unter Linux oder OS X ein Terminalfenster und geben Sie Folgendes ein:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • Führe unter Windows Vista oder Windows 7 folgenden Befehl aus:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Die Ausgabe sollte in etwa so aussehen:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
Release-Zertifikat

Fingerabdruck des Freigabezertifikats anzeigen

Verwenden Sie das Programm keytool mit dem Parameter -v, um den SHA-1-Fingerabdruck eines Zertifikats aufzurufen. Führen Sie dazu folgende Schritte aus:

  1. Suche nach der Schlüsselspeicherdatei deines Freigabezertifikats. Es gibt keinen Standardspeicherplatz oder -namen für den Schlüsselspeicher der Freigabe. Falls du beim Erstellen der App keine Version angibst, wird .apk vom Build nicht signiert. Du musst sie dann vor dem Veröffentlichen signieren. Für das Freigabezertifikat benötigst du auch den Zertifikatsalias, die Kennwörter für den Schlüsselspeicher und das Zertifikat.

  2. Geben Sie Folgendes ein, um die Aliasnamen für alle Schlüssel in einem Schlüsselspeicher aufzulisten:

    keytool -list -keystore your_keystore_name
  3. Ersetzen Sie your_keystore_name durch den vollständig qualifizierten Pfad und Namen des Schlüsselspeichers. Fügen Sie die Erweiterung .keystore ein. Geben Sie das Passwort für den Schlüsselspeicher ein, wenn Sie dazu aufgefordert werden. Mithilfe von keytool werden dann alle Aliasnamen im Schlüsselspeicher angezeigt.

  4. Gib Folgendes in einem Terminal oder bei einer Eingabeaufforderung ein:

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. Ersetze your_keystore_name durch den vollständig qualifizierten Pfad und Namen des Schlüsselspeichers. Fügen Sie die Erweiterung .keystore ein.
  6. Ersetzen Sie your_alias_name durch den Alias, den Sie dem Zertifikat bei dessen Erstellung zugewiesen haben.

Die Ausgabe sollte in etwa so aussehen:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

Die Zeile, die mit SHA1 beginnt, enthält den SHA-1-Fingerabdruck des Zertifikats. Der Fingerabdruck ist eine Abfolge aus 20 zweistelligen Hexadezimalzahlen, die durch Doppelpunkte getrennt sind.

API-Schlüssel über die Google Developers Console abrufen

Klicken Sie auf die Schaltfläche Schlüssel abrufen, um mit der Google Awareness API zu beginnen. Es enthält einen Link zur Google Developers Console, über den Sie durch den Prozess geführt werden und die Awareness API automatisch aktiviert wird.

Schlüssel abrufen

Du hast auch die Möglichkeit, die folgenden Schritte auszuführen, um einen API-Schlüssel zu erhalten:

  1. Rufen Sie die Google Developers Console auf.
  2. Wählen Sie ein Projekt aus oder erstellen Sie ein neues.
  3. Klicken Sie auf Weiter, um die Awareness API zu aktivieren.

  4. Erstelle auf der Seite „Anmeldedaten“ einen Android-Schlüssel und lege die API-Anmeldedaten fest.

  5. Im Dialogfeld „Schlüssel erstellen“ müssen Sie die Verwendung auf Android-Apps beschränken. Geben Sie dazu den SHA-1-Fingerabdruck und den Paketnamen Ihrer App ein, wie im folgenden Beispiel:

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.awareness-example

  6. Klicken Sie auf Erstellen. Der neue Android-API-Schlüssel wird in der Liste der API-Schlüssel für dein Projekt angezeigt. Ein API-Schlüssel ist eine Zeichenfolge, z. B.:

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

Nachdem Sie einen API-Schlüssel haben, können Sie ihn dem Manifest Ihrer App hinzufügen, wie im Leitfaden Einstieg beschrieben.

Zusätzliche APIs aktivieren

Mit der Awareness API können Sie auf mehrere Arten von Kontextdaten zugreifen, z. B. auf Beacons. Wenn Sie diese Typen verwenden möchten, müssen Sie die entsprechenden APIs in der Google Developers Console aktivieren.

Dienst Awareness API-Methoden Zu aktivierende API
Beacons SnapshotApi.getBeaconState(), FenceApi.BeaconFence Nearby Messages API