Rejestracja i klucze interfejsu API

Aby korzystać z interfejsu Google Awareness API, musisz dodać do aplikacji klucz interfejsu API Google. Potrzebujesz klucza interfejsu API na Androida.

Wszystkie aplikacje na Androida są podpisane certyfikatem cyfrowym, do którego masz klucz prywatny. Więcej informacji o certyfikatach cyfrowych znajdziesz w przewodniku po Androidzie dotyczącym podpisywania aplikacji.

Klucze interfejsu API Androida są powiązane z konkretnymi parami certyfikatów i pakietów. Potrzebujesz tylko jednego klucza na każdy certyfikat, niezależnie od liczby użytkowników aplikacji.

Aby uzyskać klucz do aplikacji, musisz wykonać kilka czynności. Są one szczegółowo opisane w tym przewodniku i podsumowane poniżej:

  1. Uzyskaj informacje o certyfikacie aplikacji.
  2. Zarejestruj projekt w konsoli Google Developers i dodaj interfejs User Context API jako usługę dla projektu.
  3. Poproś o klucz.
  4. Dodaj klucz do aplikacji. Aby to zrobić, dodaj element do pliku manifestu aplikacji.

Znajdowanie informacji o certyfikacie aplikacji

Klucz interfejsu API jest oparty na skróconej formie certyfikatu cyfrowego aplikacji, znanej jako odcisk cyfrowy SHA-1. Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, najpierw upewnij się, że używasz właściwego certyfikatu. Do wyboru możesz mieć te 2 certyfikaty:

  • Certyfikat debugowania: narzędzia Android SDK Tools generują ten certyfikat automatycznie podczas tworzenia kompilacji do debugowania. Używaj tego certyfikatu tylko w aplikacjach, które testujesz. Nie próbuj publikować aplikacji podpisanej certyfikatem debugowania. Certyfikat debugowania jest opisany bardziej szczegółowo w sekcji Podpisywanie kompilacji do debugowania w dokumentacji dla deweloperów aplikacji na Androida.
  • Certyfikat wersji: narzędzia Android SDK generują ten certyfikat podczas tworzenia kompilacji do publikacji. Możesz też wygenerować ten certyfikat za pomocą programu keytool. Użyj tego certyfikatu, gdy będziesz gotowy(-a) do opublikowania aplikacji.

Więcej informacji o keytool znajdziesz w dokumentacji Oracle.

Certyfikat debugowania

Wyświetlanie odcisku cyfrowego certyfikatu debugowania

Użyj programu keytool z parametrem -v, aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu. Aby to zrobić, wykonaj następujące czynności:

  1. Znajdź plik magazynu kluczy debugowania. Nazwa pliku to debug.keystore. Jest on tworzony podczas pierwszej kompilacji projektu. Domyślnie jest on przechowywany w tym samym katalogu co pliki urządzenia wirtualnego z Androidem (AVD):

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

  2. Podaj odcisk cyfrowy SHA-1:

    • W systemie Linux lub OS X otwórz okno terminala i wpisz:

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

    • W przypadku systemów Windows Vista i Windows 7 uruchom:

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

Zostaną wyświetlone dane wyjściowe podobne do tych:

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
Certyfikat wersji

Wyświetlanie odcisku cyfrowego certyfikatu wersji

Użyj programu keytool z parametrem -v, aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu. Aby to zrobić, wykonaj następujące czynności:

  1. Znajdź plik magazynu kluczy certyfikatu wersji. Nie ma domyślnej lokalizacji ani nazwy magazynu kluczy wersji. Jeśli nie określisz go podczas tworzenia wersji aplikacji, kompilacja pozostawi plik .apk niepodpisany i będziesz musiał go podpisać, zanim będzie można go opublikować. W przypadku certyfikatu wersji potrzebujesz też aliasu certyfikatu, haseł do magazynu kluczy i certyfikatu.

  2. Aby wyświetlić listę aliasów wszystkich kluczy w magazynie kluczy, wpisz:

    keytool -list -keystore your_keystore_name
  3. Zastąp your_keystore_name pełną i jednoznaczną ścieżką i nazwą magazynu kluczy. Dołącz rozszerzenie .keystore. Gdy pojawi się prośba, wpisz hasło do magazynu kluczy. Następnie keytool wyświetli wszystkie aliasy w magazynie kluczy.

  4. Wpisz w terminalu lub wierszu polecenia:

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. Zastąp your_keystore_name pełną i jednoznaczną ścieżką i nazwą magazynu kluczy. Dołącz rozszerzenie .keystore.
  6. Zastąp your_alias_name aliasem przypisanym do certyfikatu podczas jego tworzenia.

Zostaną wyświetlone dane wyjściowe podobne do tych:

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

Wiersz zaczynający się od SHA1 zawiera odcisk cyfrowy SHA-1 certyfikatu. Odcisk cyfrowy to ciąg 20 dwucyfrowych liczb szesnastkowych oddzielonych dwukropkami.

Uzyskiwanie klucza interfejsu API z Google Developers Console

Aby rozpocząć korzystanie z interfejsu Google Awareness API, kliknij przycisk Pobierz klucz. Przekieruje Cię do Google Developers Console, gdzie przejdziesz przez proces aktywacji interfejsu Awareness API.

Uzyskiwanie klucza

Możesz też wykonać te czynności, aby uzyskać klucz interfejsu API:

  1. Otwórz Google Developers Console.
  2. Wybierz projekt lub utwórz nowy.
  3. Kliknij Dalej, aby włączyć Awareness API.

  4. Na stronie „Dane logowania” utwórz klucz Androida i skonfiguruj dane logowania interfejsu API.

  5. W oknie „Utwórz klucz” musisz ograniczyć użycie do aplikacji na Androida. Aby to zrobić, wpisz odcisk cyfrowy SHA-1 i nazwę pakietu aplikacji, jak w tym przykładzie:

    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. Kliknij Utwórz. Nowy klucz interfejsu API Androida pojawi się na liście kluczy interfejsu API w projekcie. Klucz interfejsu API to ciąg znaków, na przykład:

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

Gdy masz już klucz interfejsu API, możesz go dodać do pliku manifestu aplikacji zgodnie z opisem w przewodniku dla początkujących.

Aktywowanie dodatkowych interfejsów API

Interfejs Awareness API umożliwia dostęp do wielu typów danych kontekstowych, takich jak beacony. Aby używać tych typów, musisz włączyć odpowiednie interfejsy API w Google Developers Console.

Usługa Metody interfejsu Awareness API Interfejs API do włączenia
Beacony SnapshotApi.getBeaconState(), FenceApi.BeaconFence Nearby Messages API