Przegląd
Aby używać Google Fit na Androida, potrzebujesz identyfikatora klienta OAuth 2.0 dla aplikacji na Androida.
Wszystkie aplikacje na Androida są podpisywane certyfikatem cyfrowym, do którego masz klucz prywatny. Więcej informacji o certyfikatach cyfrowych znajdziesz w przewodniku po podpisywaniu aplikacji na Androida.
Identyfikatory klienta OAuth na Androida są połączone z określonymi parami certyfikatów i pakietów. Potrzebujesz tylko 1 identyfikatora dla każdego certyfikatu, niezależnie od liczby użytkowników aplikacji.
Uzyskanie identyfikatora aplikacji wymaga wykonania kilku czynności. Poniżej opisujemy 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 opiera się na krótkiej formie cyfrowego certyfikatu aplikacji, czyli odcisku cyfrowym SHA-1. Aby wyświetlić odcisk cyfrowy SHA-1 dla certyfikatu, najpierw sprawdź, czy używasz właściwego certyfikatu. Możesz mieć 2 certyfikaty:
- Certyfikat debugowania: narzędzia pakietu Android SDK generują ten certyfikat automatycznie, gdy wykonujesz kompilację do debugowania. Używaj tego certyfikatu tylko w aplikacjach, które testujesz. Nie próbuj publikować aplikacji podpisanej certyfikatem debugowania. Certyfikat debugowania został szczegółowo opisany w sekcji Logowanie w trybie debugowania w dokumentacji dla programistów aplikacji na Androida.
- Certyfikat wersji: narzędzia pakietu Android SDK generują ten certyfikat, gdy tworzysz kompilację wersji. Możesz też wygenerować ten certyfikat za pomocą programu
keytool
. Użyj tego certyfikatu, gdy wszystko będzie gotowe do udostępnienia aplikacji całemu światu.
Wykonaj opisane poniżej czynności, aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu za pomocą programu keytool
z parametrem -v
. Więcej informacji o narzędziu Keytool znajdziesz w dokumentacji Oracle.
Wyświetlam odcisk cyfrowy certyfikatu debugowania
Znajdź plik magazynu kluczy debugowania. Nazwa pliku to
debug.keystore
. Jest ona tworzona podczas pierwszej tworzenia projektu. Domyślnie jest przechowywany w tym samym katalogu co pliki AVD z Androidem:- macOS i Linux:
~/.android/
- Windows Vista i Windows 7:
C:\Users\your_user_name\.android\
- macOS i Linux:
Wyświetl odcisk cyfrowy SHA-1:
W przypadku systemu Linux lub macOS otwórz okno terminala i wpisz:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
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
Wyświetlam odcisk cyfrowy certyfikatu wersji
-
Znajdź plik magazynu kluczy certyfikatu wersji. Nie ma domyślnej lokalizacji ani nazwy magazynu kluczy wersji. Jeśli tego nie zrobisz podczas tworzenia aplikacji do opublikowania, kompilacja pozostawi
.apk
bez podpisu i trzeba będzie ją podpisać przed opublikowaniem. W przypadku certyfikatu wydania potrzebujesz też aliasu certyfikatu oraz haseł do magazynu kluczy i certyfikatu. Aby wyświetlić listę aliasów wszystkich kluczy w magazynie kluczy, wpisz:keytool -list -keystore your_keystore_name
Zastąp
your_keystore_name
pełną i jednoznaczną ś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 następujące polecenie w terminalu lub w wierszu polecenia:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
Zastąp
your_keystore_name
pełną i jednoznaczną ścieżką i nazwą magazynu kluczy, razem z rozszerzeniem.keystore
. Zastąpyour_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 2-cyfrowych liczb szesnastkowych rozdzielonych dwukropkiem.
Żądanie identyfikatora klienta OAuth 2.0 w konsoli interfejsów API Google
Wykonaj te czynności, aby utworzyć lub zmodyfikować projekt swojej aplikacji w konsoli interfejsów API Google, włączyć interfejs Fitness API i poprosić o identyfikator klienta OAuth 2.0.
Jeśli chcesz przejść przez ten proces i automatycznie aktywować interfejs Fitness API, kliknij
Możesz też wykonać te czynności, aby włączyć Fitness API w Konsoli interfejsów API Google i uzyskać identyfikator klienta OAuth 2.0.
- 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ć interfejs Fitness API.
- Kliknij Otwórz dane logowania.
- Kliknij Nowe dane logowania i wybierz Identyfikator klienta OAuth.
- W sekcji Typ aplikacji wybierz Android.
W wyświetlonym oknie wpisz odcisk cyfrowy SHA-1 i nazwę pakietu aplikacji. 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 i klucz tajny OAuth 2.0 na Androida pojawią się na liście identyfikatorów projektu. Identyfikator klienta OAuth 2.0 to ciąg znaków podobny do tego:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com