Przegląd
Aby korzystać z Google Fit na Androida, potrzebujesz identyfikatora klienta OAuth 2.0 do aplikacji na Androida.
Wszystkie aplikacje na Androida są podpisane certyfikatem cyfrowym, w przypadku którego masz klucz prywatny. Więcej informacji o certyfikatach cyfrowych znajdziesz w przewodniku po podpisywaniu aplikacji na Androida.
Identyfikatory klienta Androida na Androida są połączone z określonymi parami certyfikatów i pakietów. Niezależnie od liczby użytkowników aplikacji potrzebujesz tylko 1 identyfikatora dla każdego certyfikatu.
Aby uzyskać identyfikator, musisz wykonać kilka czynności. Poniżej omawiamy te kroki.
- Znajdź informacje o certyfikacie aplikacji.
- Utwórz lub zmodyfikuj projekt w Konsoli interfejsów API Google.
- Poproś o identyfikator klienta OAuth 2.0.
Znajdowanie informacji o certyfikacie aplikacji
Klucz interfejsu API jest oparty na krótkim formacie cyfrowego certyfikatu aplikacji nazywanym odciskiem cyfrowym SHA-1. Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, najpierw upewnij się, że używasz odpowiedniego certyfikatu. Możesz mieć 2 certyfikaty:
- Certyfikat debugowania: narzędzia Android SDK SDK automatycznie generują ten certyfikat podczas tworzenia kompilacji na potrzeby debugowania. Używaj tego certyfikatu tylko w testowanych aplikacjach. Nie próbuj publikować aplikacji podpisanej certyfikatem debugowania. Certyfikat debugowania został opisany w sekcji Podpisywanie w trybie debugowania w dokumentacji Androida dla deweloperów.
- Certyfikat wydania: narzędzia pakietu SDK na Androida generują ten certyfikat podczas tworzenia wersji. Certyfikat możesz też wygenerować w programie
keytool
. Użyj tego certyfikatu, gdy aplikacja będzie gotowa do udostępnienia użytkownikom na całym świecie.
Wykonaj poniższe czynności, aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu za pomocą programu keytool
z parametrem -v
. Więcej informacji o Keytool znajdziesz w dokumentacji Oracle.
Wyświetlam odcisk cyfrowy certyfikatu debugowania
Znajdź plik magazynu kluczy debugowania. Nazwa pliku to
debug.keystore
. Jest on tworzony po raz pierwszy podczas tworzenia projektu. Domyślnie znajduje się on w tym samym katalogu co pliki urządzeń wirtualnych (AVD) Androida:- macOS i Linux:
~/.android/
- Windows Vista i Windows 7:
C:\Users\your_user_name\.android\
- macOS i Linux:
Wyświetl listę odcisków cyfrowych SHA-1:
W systemie Linux lub macOS otwórz okno terminala i wpisz te informacje:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
W systemach Windows Vista i Windows 7 uruchom:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
Dane wyjściowe powinny wyglądać mniej więcej tak:
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
Wyświetlam odcisk cyfrowy certyfikatu wersji
-
Znajdź plik magazynu kluczy wersji certyfikatu. Nie ma domyślnej lokalizacji lub nazwy magazynu kluczy wersji. Jeśli nie określisz identyfikatora podczas tworzenia aplikacji, wersja
.apk
pozostanie niepodpisana i będzie trzeba ją podpisać, zanim będzie można opublikować aplikację. Jako certyfikat możesz też użyć aliasu certyfikatu oraz haseł do magazynu kluczy i certyfikatu. Możesz wyświetlić listę wszystkich kluczy w magazynie kluczy, wpisując:keytool -list -keystore your_keystore_name
Zastąp
your_keystore_name
w pełni kwalifikowaną ścieżką i nazwą magazynu kluczy, razem z rozszerzeniem.keystore
. Pojawi się prośba o podanie hasła do magazynu kluczy. Następniekeytool
wyświetli wszystkie aliasy w magazynie kluczy. -
Wpisz w terminalu lub w wierszu poleceń:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
Zastąp
your_keystore_name
w pełni kwalifikowaną ścieżką i nazwą magazynu kluczy, razem z rozszerzeniem.keystore
. Zastąpyour_alias_name
aliasem przypisanym do certyfikatu podczas jego tworzenia.
Dane wyjściowe powinny wyglądać mniej więcej tak:
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 certyfikatu SHA-1. Odcisk cyfrowy to sekwencja 20-cyfrowych liczb szesnastkowych oddzielonych dwukropkami.
Żądanie identyfikatora klienta OAuth 2.0 w konsoli interfejsu Google API
Aby utworzyć lub zmodyfikować projekt aplikacji w Konsoli interfejsów API Google, włączyć interfejs Fitness API i poprosić o identyfikator klienta OAuth 2.0.
Jeśli chcesz przeprowadzić tę procedurę i automatycznie aktywować interfejs Fitness API, kliknij
Aby włączyć interfejs Fitness API w konsoli Google API i uzyskać identyfikator klienta OAuth 2.0, możesz też wykonać te czynności.
- Otwórz Konsolę interfejsów API Google.
- Wybierz projekt lub utwórz nowy. Użyj tego samego projektu dla wersji aplikacji na Androida i REST.
- Kliknij Dalej, aby włączyć Fitness API.
- Kliknij Przejdź do danych logowania.
- Kliknij kolejno Nowe dane logowania i Identyfikator klienta OAuth.
- W sekcji Typ aplikacji wybierz Android.
W wyświetlonym oknie wpisz odcisk cyfrowy SHA-1 aplikacji i nazwę pakietu. Na przykład:
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
com.example.android.fit-example
Kliknij Utwórz. Nowy identyfikator klienta OAuth 2.0 i tajny klucz pojawią się na liście identyfikatorów Twojego projektu. Identyfikator klienta OAuth 2.0 to ciąg znaków podobny do tego:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com