Rejestracja i klucze interfejsu API

Aby korzystać z interfejsu Google Awareness API, musisz dodać do aplikacji klucz interfejsu API Google. Klucz interfejsu API, którego potrzebujesz, to klucz interfejsu API Androida.

Wszystkie aplikacje na Androida są podpisane cyfrowym certyfikatem, którego klucz prywatny jest w Twoim posiadaniu. Więcej informacji o certyfikatach cyfrowych znajdziesz w przewodniku na temat Androida dotyczącym podpisywania aplikacji.

Klucze interfejsu API Androida są powiązane z określonymi parami certyfikatu i pakietu. Niezależnie od tego, ilu użytkowników ma aplikację, do każdego certyfikatu potrzebny jest tylko jeden klucz.

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

  1. uzyskać informacje o certyfikacie aplikacji;
  2. Zarejestruj projekt w konsoli Google Developers i dodaj interfejs API kontekstu użytkownika jako usługę dla tego projektu.
  3. Poproś o klucz.
  4. Dodaj klucz do aplikacji. W tym celu 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ć odciski cyfrowe SHA-1 certyfikatu, najpierw upewnij się, że używasz właściwego certyfikatu. Do wyboru masz 2 certyfikaty:

  • Certyfikat debugowania: narzędzia pakietu Android SDK generują ten certyfikat automatycznie podczas kompilacji debugowania. Używaj tego certyfikatu tylko w przypadku aplikacji, które testujesz. Nie próbuj publikować aplikacji podpisanej certyfikatem debugowania. Więcej informacji o certyfikacie debugowania znajdziesz w sekcji Podpisywanie wersji debugowania w dokumentacji dla deweloperów Androida.
  • Certyfikat wersji: narzędzia pakietu Android SDK generują ten certyfikat podczas tworzenia wersji wydania. Możesz też wygenerować ten certyfikat za pomocą programu keytool. Użyj tego certyfikatu, gdy będziesz gotowy/gotowa do udostępnienia aplikacji na całym świecie.

Więcej informacji o keytool znajdziesz w dokumentacji Oracle.

Certyfikat debugowania

Wyświetlanie odcisku cyfrowego certyfikatu debugowania

Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, użyj programu keytool z parametrem -v. Aby to zrobić:

  1. Znajdź plik klucza debugowania. Nazwa pliku to debug.keystore. Plik ten jest tworzony przy pierwszym kompilowaniu projektu. Domyślnie jest on przechowywany w tym samym katalogu co pliki urządzenia wirtualnego Androida (AVD):

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

  2. Wyświetl odcisk cyfrowy SHA-1:

    • W przypadku systemu 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 systemu Windows Vista i Windows 7 wykonaj te czynności:

      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 zwolnienia

Wyświetlanie odcisku cyfrowego certyfikatu wersji

Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, użyj programu keytool z parametrem -v. Aby to zrobić:

  1. Znajdź plik magazynu kluczy certyfikatu wersji. Brak domyślnej lokalizacji lub nazwy magazynu kluczy wersji. Jeśli nie określisz klucza podczas kompilowania aplikacji na potrzeby wydania, wersja .apk zostanie wygenerowana bez podpisu. Aby ją opublikować, musisz ją podpisać. W przypadku certyfikatu wersji musisz też podać alias certyfikatu, hasła do magazynu kluczy i sam certyfikat.

  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ą ś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świetla wszystkie aliasy w magazynie kluczy.

  4. W terminalu lub wierszu polecenia wpisz:

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. Zastąp your_keystore_name pełną ścieżką i nazwą magazynu kluczy. Dołącz rozszerzenie .keystore.
  6. Zastąp tekst 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, który zaczyna się od SHA1, zawiera odcisk cyfrowy SHA-1 certyfikatu. Odcisk palca to sekwencja 20 dwucyfrowych liczb szesnastkowych oddzielonych dwukropkami.

Pobieranie klucza interfejsu API z Google Developers Console

Aby zacząć korzystać z interfejsu Google Awareness API, kliknij przycisk Uzyskaj klucz. Linkuje się z konsolą Google Developers Console, która przeprowadzi Cię przez proces i automatycznie aktywuje interfejs Awareness API.

Pobieranie klucza

Aby uzyskać klucz interfejsu API, wykonaj te czynności:

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

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

  5. W oknie „Tworzenie klucza” musisz ograniczyć użycie do aplikacji na Androida. Aby to zrobić, wpisz odcisk cyfrowy SHA-1 aplikacji i jej nazwę pakietu, 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 Twojego projektu. Klucz API to ciąg znaków, np.:

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

Teraz, gdy masz klucz API, możesz go dodać do pliku manifestu aplikacji zgodnie z opisem w przewodniku Początkujący.

Aktywowanie dodatkowych interfejsów API

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

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