Uzyskiwanie identyfikatora klienta OAuth 2.0

Omówienie

Aby używać Google Fit na Androidzie, potrzebujesz identyfikatora klienta OAuth 2.0 Aplikacje na Androida.

Wszystkie aplikacje na Androida są podpisane certyfikatem cyfrowym, dla którego posiadasz klucz prywatny. Zapoznaj się z przewodnikiem na temat podpisywania aplikacji na Androida. .

Identyfikatory klienta OAuth na Androida są powiązane z określonymi parami certyfikatów/pakietów. Dla każdego certyfikatu wystarczy 1 identyfikator, niezależnie od tego, ilu użytkowników ma aplikacja.

Uzyskanie identyfikatora aplikacji składa się z kilku kroków. Etapy te zostały opisane poniżej.

1. Znajdź informacje o certyfikacie aplikacji.
2. Utwórz lub zmodyfikuj projekt w Konsoli interfejsów API Google.
3. Poproś o identyfikator klienta OAuth 2.0.

Znajdowanie informacji o certyfikacie aplikacji

Klucz interfejsu API jest oparty na skróconej formie certyfikatu cyfrowego aplikacji, zwanej odciskiem cyfrowym SHA-1. Aby wyświetlić algorytm SHA-1, odcisk cyfrowy certyfikatu, najpierw upewnij się, że używasz odpowiedniego certyfikat. Możesz mieć 2 certyfikaty:

• Certyfikat debugowania: narzędzia pakietu Android SDK generują ten certyfikat automatycznie podczas kompilacji debugowania. Używaj tylko tego który testujesz. Nie próbuj publikować aplikacji podpisanej certyfikatem debugowania. Certyfikat debugowania jest bardziej szczegółowo opisany w dokumentacji dla deweloperów Androida dotyczącym podpisywania w trybie debugowania.
• Certyfikat wersji: narzędzia Android SDK generują podczas tworzenia kompilacji. Możesz też wygenerować go za pomocą programu keytool. Używaj tego certyfikatu, gdy: gdy już wiesz, jak udostępnić aplikację na całym świecie.

Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu za pomocą programu keytool z parametrem -v, wykonaj podane niżej czynności. Więcej informacji o Keytool znajdziesz w dokumentacji Oracle.

Certyfikat debugowania

Wyświetlam odcisk cyfrowy certyfikatu debugowania

1. Znajdź plik klucza debugowania. Nazwa pliku to debug.keystore. Jest on tworzony podczas tworzenia w projektach AI. Domyślnie jest on przechowywany w tym samym katalogu co pliki urządzenia wirtualnego (AVD) Androida:

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

2. Wyświetl odcisk cyfrowy SHA-1:

   • W systemie Linux lub macOS 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:

     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 wydania

Wyświetlam odcisk cyfrowy certyfikatu wersji

1. Znajdź plik magazynu kluczy certyfikatu wersji. Brak wartości domyślnej lokalizację lub nazwę magazynu kluczy wersji. Jeśli nie określisz klucza podczas kompilowania aplikacji na potrzeby opublikowania, wersja .apk będzie niezabezpieczona. Aby ją opublikować, musisz ją podpisać. W przypadku certyfikatu wersji musisz też podać alias certyfikatu oraz hasła do magazynu kluczy i certyfikatu. Możesz określić, aliasy wszystkich kluczy w magazynie kluczy, wpisując:

   keytool -list -keystore your_keystore_name

   Zastąp ciąg your_keystore_name pełną wersją ścieżka i nazwa magazynu kluczy, łącznie z .keystore . Pojawi się prośba o podanie hasła do magazynu kluczy. Potem keytool wyświetla wszystkie aliasy w magazynie kluczy.

2. W terminalu lub w wierszu polecenia wpisz:

   keytool -list -v -keystore your_keystore_name -alias your_alias_name

   Zastąp ciąg your_keystore_name pełną wersją ścieżka i nazwa magazynu kluczy, łącznie z .keystore . 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 cyfrowy to sekwencja 20 dwucyfrowych liczb szesnastkowych. liczby rozdzielane dwukropkami.

Uwaga: aby chronić magazyn kluczy i klucz, nie wpisuj argumentów storepass ani keypass w wierszu poleceń, chyba że masz pewność, że Twój komputer jest bezpieczny. Na przykład na publicznym komputerze ktoś może przejrzeć historię okna terminala lub listę uruchomionych procesów, uzyskać hasło, a następnie uzyskać uprawnienia do zapisu do certyfikatu podpisywania. Daje to tej osobie możliwość modyfikowania lub zastępowania Twojej aplikacji własną.

Wysyłanie prośby o identyfikator klienta OAuth 2.0 w Konsoli interfejsów API Google

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, wykonaj te czynności.

Jeśli chcesz skorzystać z przewodnika po procesie, i aktywuj Fitness API automatycznie, kliknij

Uzyskaj identyfikator klienta

Możesz też włączyć Fitness API w Konsoli interfejsów API Google i uzyskać identyfikator klienta OAuth 2.0.

1. Przejdź do Konsola interfejsów API Google.
2. Wybierz projekt lub utwórz nowy. Użyj tego samego projektu na Androidzie i wersji REST swojej aplikacji.
3. Kliknij Dalej, aby włączyć interfejs Fitness API.
4. Kliknij Go to credentials (Przejdź do danych logowania).
5. Kliknij Nowe dane logowania, a następnie wybierz Identyfikator klienta OAuth.
6. W sekcji Typ aplikacji wybierz Android.

7. 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

8. Kliknij Utwórz. Nowy identyfikator klienta OAuth 2.0 na Androida i tajny klucz klienta pojawią się na liście identyfikatorów w Twoim projekcie. Identyfikator klienta OAuth 2.0 to ciąg znaków, na przykład:

   780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com