Tổng quan
Để sử dụng Google Fit dành cho Android, bạn cần có ID ứng dụng khách OAuth 2.0 cho Ứng dụng Android.
Tất cả ứng dụng Android đều được ký bằng chứng chỉ số mà bạn có khoá riêng tư. Tham khảo Hướng dẫn ký ứng dụng dành cho Android để biết thêm thông tin về chứng chỉ kỹ thuật số.
Mã ứng dụng OAuth của Android được liên kết với các cặp chứng chỉ/gói cụ thể. Bạn chỉ cần một ID cho mỗi chứng chỉ, bất kể bạn có bao nhiêu người dùng ứng dụng.
Bạn cần thực hiện một số bước để lấy mã nhận dạng cho ứng dụng. Các bước này được trình bày bên dưới.
- Tìm thông tin về chứng chỉ của ứng dụng.
- Tạo hoặc sửa đổi dự án trong Bảng điều khiển API của Google.
- Yêu cầu mã ứng dụng khách OAuth 2.0.
Tìm thông tin về chứng chỉ của ứng dụng
Khoá API dựa trên một dạng ngắn của chứng chỉ kỹ thuật số của ứng dụng, được gọi là vân tay số SHA-1. Để hiển thị SHA-1 cho chứng chỉ của mình, thì trước tiên hãy đảm bảo rằng bạn đang sử dụng đúng chứng chỉ. Bạn có thể có hai chứng chỉ:
- Chứng chỉ gỡ lỗi: Bộ công cụ SDK Android tạo chứng chỉ này tự động khi bạn tạo bản gỡ lỗi. Chỉ sử dụng với các ứng dụng mà bạn đang thử nghiệm. Đừng tìm cách phát hành ứng dụng đã được ký bằng một chứng chỉ gỡ lỗi. Chứng chỉ gỡ lỗi được mô tả chi tiết hơn trong Ký ở Chế độ gỡ lỗi trong Tài liệu dành cho nhà phát triển Android.
- Chứng chỉ phát hành: Bộ công cụ SDK Android tạo
chứng chỉ này khi bạn tạo bản dựng phát hành. Bạn cũng có thể tạo
chứng chỉ bằng chương trình
keytool
. Sử dụng chứng chỉ này khi bạn đã sẵn sàng phát hành ứng dụng của mình ra thế giới.
Hãy làm theo các bước bên dưới để hiện vân tay số SHA-1 của chứng chỉ bằng cách sử dụng
chương trình keytool
có tham số -v
. Để biết thêm
về Keytool, hãy xem
Tài liệu của Oracle.
Hiện dấu vân tay chứng chỉ gỡ lỗi
Tìm tệp kho khoá gỡ lỗi của bạn. Tên tệp là
debug.keystore
và được tạo trong lần đầu tiên bạn tạo dự án. Theo mặc định, tệp này được lưu trữ trong cùng thư mục với thiết bị Android của bạn Tệp trên thiết bị ảo (AVD):- macOS và Linux:
~/.android/
- Windows Vista và Windows 7:
C:\Users\your_user_name\.android\
- macOS và Linux:
Liệt kê vân tay số SHA-1:
Đối với Linux hoặc macOS, hãy mở một cửa sổ dòng lệnh rồi nhập như sau:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
Đối với Windows Vista và Windows 7, hãy chạy:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
Bạn sẽ thấy kết quả xuất ra có dạng như sau:
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
Hiện dấu vân tay chứng chỉ phát hành
-
Xác định vị trí tệp kho khoá chứng chỉ phát hành. Không có giá trị mặc định vị trí hoặc tên cho kho khoá phát hành. Nếu bạn không chỉ định quảng cáo khi bạn tạo bản dựng ứng dụng để phát hành, bản dựng sẽ để lại
.apk
chưa ký. Bạn phải ký trước khi có thể xuất bản ứng dụng đó. Đối với chứng chỉ phát hành, bạn cũng cần có bí danh và mật khẩu cho kho khoá và chứng chỉ. Bạn có thể liệt kê bí danh cho tất cả các khoá trong kho khoá bằng cách nhập:keytool -list -keystore your_keystore_name
Thay thế
your_keystore_name
bằng thành phần đủ điều kiện đường dẫn và tên của kho khoá, bao gồm.keystore
tiện ích. Bạn sẽ được nhắc nhập mật khẩu của kho khoá. Sau đókeytool
cho thấy tất cả bí danh trong kho khoá. -
Nhập nội dung sau tại cửa sổ dòng lệnh hoặc dấu nhắc lệnh:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
Thay thế
your_keystore_name
bằng thành phần đủ điều kiện đường dẫn và tên của kho khoá, bao gồm.keystore
tiện ích. Thay thếyour_alias_name
bằng bí danh đã thay thế mà bạn đã gán cho chứng chỉ khi tạo chứng chỉ.
Bạn sẽ thấy kết quả xuất ra có dạng như sau:
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
Dòng bắt đầu bằng SHA1
chứa SHA-1 của chứng chỉ
vân tay số. Dấu vân tay là một chuỗi gồm 20 hệ thập lục phân gồm hai chữ số
số được phân tách bằng dấu hai chấm.
Yêu cầu mã ứng dụng khách OAuth 2.0 trong Google API Console
Hãy làm theo các bước sau để tạo hoặc sửa đổi dự án cho ứng dụng của bạn trong Google API Console, bật API Fitness và yêu cầu mã ứng dụng khách OAuth 2.0.
Nếu bạn muốn được hướng dẫn về quy trình và kích hoạt Tự động API Thể dục, nhấp vào
Ngoài ra, hãy làm theo các bước sau để bật Fitness API trong Bảng điều khiển Google API và nhận ID ứng dụng khách OAuth 2.0.
- Chuyển đến Bảng điều khiển API của Google.
- Chọn dự án hoặc tạo dự án mới. Sử dụng cùng một dự án cho Android và REST của ứng dụng.
- Nhấp vào Tiếp tục để bật API Fitness.
- Nhấp vào Chuyển đến trang thông tin xác thực.
- Nhấp vào Thông tin xác thực mới, sau đó chọn Mã ứng dụng OAuth.
- Trong Application type (Loại ứng dụng), hãy chọn Android.
Trong hộp thoại hiện ra, hãy nhập gói và vân tay số SHA-1 của ứng dụng . Ví dụ:
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
Nhấp vào Tạo. Bí mật và mã ứng dụng khách OAuth 2.0 trên Android mới của bạn sẽ xuất hiện trong danh sách mã cho dự án của bạn. Mã ứng dụng OAuth 2.0 là một chuỗi , có dạng như sau:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com