Uzyskiwanie identyfikatora klienta OAuth 2.0

Omówienie

Aby korzystać z Google Fit na urządzeniu z Androidem, musisz mieć identyfikator klienta OAuth 2.0 dla aplikacji na 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 po podpisywaniu 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.

Aby uzyskać identyfikator aplikacji, musisz wykonać kilka czynności. Poniżej znajdziesz opis tych czynności.

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, znanej jako odcisk cyfrowy SHA-1. Aby wyświetlić odcisk cyfrowy SHA-1 certyfikatu, najpierw upewnij się, że używasz prawidłowego certyfikatu. Możesz mieć 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. Certyfikat debugowania jest bardziej szczegółowo opisany w sekcji Podpisywanie w trybie 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.

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 todebug.keystore. Plik ten jest tworzony przy pierwszym kompilowaniu projektu. 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 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 przypadku systemu Windows Vista i Windows 7 wykonaj:

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

Powinny pojawić się 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świetlam odcisk cyfrowy certyfikatu wersji

1. Znajdź plik magazynu kluczy certyfikatu wersji. Sklep z kluczami wersji nie ma domyślnej lokalizacji ani nazwy. 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. Aby wyświetlić listę aliasów wszystkich kluczy w magazynie kluczy, wpisz:

   keytool -list -keystore your_keystore_name

   Zastąp tekst 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ępnie keytool wyświetla wszystkie aliasy w magazynie kluczy.

2. W terminalu lub wierszu polecenia wpisz:

   keytool -list -v -keystore your_keystore_name -alias your_alias_name

   Zastąp tekst your_keystore_name pełną i jednoznaczną ścieżką i nazwą magazynu kluczy, razem z rozszerzeniem .keystore. Zastąp tekst your_alias_name aliasem przypisanym do certyfikatu podczas jego tworzenia.

Powinny pojawić się 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.

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

Prośba 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, abyśmy Ci pomogli w przeprowadzeniu procesu i automatycznie aktywowali interfejs Fitness API, 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. Otwórz konsolę interfejsów API Google.
2. Wybierz projekt lub utwórz nowy. Użyj tego samego projektu w przypadku wersji aplikacji na Androida i w usłudze REST.
3. Aby włączyć Fitness API, kliknij Dalej.
4. Kliknij 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 oraz jego tajny klucz pojawią się na liście identyfikatorów w Twoim projekcie. Identyfikator klienta OAuth 2.0 to ciąg znaków, np.

   780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com