Обзор
Чтобы использовать Google Fit для Android, вам понадобится идентификатор клиента OAuth 2.0 для приложений для Android.
Все приложения для Android подписываются цифровым сертификатом, для которого у вас есть закрытый ключ. Дополнительную информацию о цифровых сертификатах вы найдете в руководстве по добавлению подписи в приложения для Android.
Идентификаторы клиентов OAuth Android связаны с определенными парами сертификатов и пакетов. Для каждого сертификата нужен только один идентификатор, независимо от того, сколько пользователей у приложения.
Чтобы получить идентификатор приложения, выполните следующие действия: Ниже описаны необходимые действия.
- Найдите информацию о сертификате приложения.
- Создайте или измените проект в Google API Console.
- Запросите идентификатор клиента OAuth 2.0.
Как найти информацию о сертификате приложения
Ключ API основан на краткой форме цифрового сертификата приложения, известной как цифровой отпечаток SHA-1. Чтобы посмотреть цифровой отпечаток SHA-1 для сертификата, сначала убедитесь, что вы используете правильный сертификат. У вас может быть два сертификата.
- Сертификат для отладки. Этот сертификат создается автоматически при выполнении отладочной сборки приложения с помощью Android SDK Tools. Его следует использовать исключительно при тестировании приложений. Не пытайтесь опубликовать приложение, подписанное с помощью сертификата для отладки. Подробную информацию о сертификате для отладки можно найти в разделе Подписание в режиме отладки документации для разработчиков Android.
- Сертификат для выпуска. Он создается с помощью инструментов Android SDK при выполнении конечной сборки. Этот сертификат можно также создать с помощью программы
keytool. Используйте этот сертификат, когда ваше приложение будет готово к публикации.
Следуйте приведенным ниже инструкциям, чтобы отобразить цифровой отпечаток SHA-1 сертификата в программе keytool с помощью параметра -v. Подробные сведения о программе Keytool можно найти в документации Oracle.
Отображение цифрового отпечатка сертификата для отладки
Найдите свой файл хранилища ключей для отладки. Этот файл, который называется
debug.keystore, создается при выполнении первой сборки проекта. По умолчанию он хранится в том же каталоге, где и файлы виртуального устройства Android (AVD):- macOS и Linux:
~/.android/ - Windows Vista и Windows 7:
C:\Users\your_user_name\.android\
- macOS и Linux:
Откройте цифровой отпечаток SHA-1.
В Linux или macOS перейдите в окно терминала и введите следующую команду:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
В Windows Vista и Windows 7 выполните следующую команду:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
Вы должны получить примерно такой результат:
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
Отображение цифрового отпечатка сертификата для выпуска
-
Найдите свой файл хранилища ключей сертификата для выпуска. Этот файл может называться по-разному, и для него нет стандартного местоположения. Если не указать этот файл при создании сборки приложения для выпуска, ваш пакет
.apkостанется без подписи и его необходимо будет подписать, чтобы обеспечить возможность публикации. Чтобы отобразить сертификат выпуска, также потребуется псевдоним и пароли для файла keystore и самого сертификата. Чтобы получить список псевдонимов для всех ключей, имеющихся в хранилище, введите следующую команду:keytool -list -keystore your_keystore_name
Вместо
your_keystore_nameукажите полный путь к файлу, включая расширение.keystore. Потребуется ввести пароль для хранилища ключей. После этого в окне программыkeytoolпоявится список всех псевдонимов, имеющихся в хранилище. -
В окне терминала или в командной строке введите следующую команду:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
Вместо
your_keystore_nameукажите полный путь к файлу, включая расширение.keystore. Заменитеyour_alias_nameна псевдоним, присвоенный сертификату при его создании.
Вы должны получить примерно такой результат:
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
В строке, которая начинается с SHA1, содержится цифровой отпечаток SHA-1. Отпечаток – это последовательность из 20 двузначных шестнадцатеричных чисел, разделенных двоеточиями.
Как запросить идентификатор клиента OAuth 2.0 в Google API Console
Чтобы создать или изменить проект для приложения в Google API Console, включить Fitness API и запросить идентификатор клиента OAuth 2.0, выполните следующие действия:
Если вы хотите, чтобы мы помогли вам настроить Fitness API и активировали его автоматически, нажмите
Как получить идентификатор клиента
Вы также можете включить Fitness API в Google API Console и получить идентификатор клиента OAuth 2.0, выполнив следующие действия:
- Откройте Google API Console.
- Выберите существующий или создайте новый проект. Используйте один и тот же проект для версий приложения для Android и REST.
- Нажмите Продолжить, чтобы включить Fitness API.
- Нажмите Перейти к учетным данным.
- Нажмите Новые учетные данные и выберите Идентификатор клиента OAuth.
- В разделе Тип приложения выберите Android.
В открывшемся диалоговом окне введите цифровой отпечаток SHA-1 и название пакета приложения. Пример:
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75com.example.android.fit-exampleНажмите Создать. Новый идентификатор клиента и секретный код OAuth 2.0 для Android появятся в списке идентификаторов для вашего проекта. Идентификатор клиента OAuth 2.0 – это строка символов, которая выглядит примерно так:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com