Tổng quan
Để sử dụng Google Fit cho Android, bạn cần có mã ứng dụng khách OAuth 2.0 cho các ứng dụng Android.
Tất cả ứng dụng Android đều được ký bằng một chứng chỉ kỹ thuật số mà bạn giữ khoá riêng tư. Hãy tham khảo hướng dẫn về Android để ký ứng dụng của bạn để biết thêm thông tin về chứng chỉ kỹ thuật số.
Mã ứng dụng OAuth 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 mã cho mỗi chứng chỉ, bất kể bạn có bao nhiêu người dùng cho ứng dụng.
Để lấy mã cho ứng dụng, bạn cần thực hiện một số bước. Các bước này được trình bày bên dưới.
- Tìm thông tin chứng chỉ của ứng dụng.
- Tạo hoặc sửa đổi dự án trong Google API Console.
- Yêu cầu mã ứng dụng khách OAuth 2.0.
Tìm thông tin chứng chỉ của ứng dụng
Khoá API dựa trên 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ị vân tay số SHA-1 cho chứng chỉ, 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ó 2 chứng chỉ:
- Chứng chỉ gỡ lỗi: Các công cụ SDK Android sẽ tự động tạo chứng chỉ này khi bạn tạo bản dựng gỡ lỗi. Chỉ sử dụng chứng chỉ này với những ứng dụng mà bạn đang kiểm thử. Đừng cố gắng phát hành ứng dụng được ký bằng chứng chỉ gỡ lỗi. Chứng chỉ gỡ lỗi được mô tả chi tiết hơn trong bài viết 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 sẽ tạo chứng chỉ này khi bạn tạo bản phát hành. Bạn cũng có thể tạo chứng chỉ này
bằng chương trình
keytool. Hãy 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 trên toàn thế giới.
Hãy làm theo các bước bên dưới để hiển thị vân tay số SHA-1 của chứng chỉ bằng
chương trình keytool với tham số -v. Để biết thêm
thông tin về Keytool, hãy xem
tài liệu của Oracle.
Hiển thị dấu vân tay chứng chỉ gỡ lỗi
Tìm tệp kho khoá gỡ lỗi. Tên tệp là
debug.keystorevà được tạo 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 các tệp Thiết bị ảo Android (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ở 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 thị dấu vân tay chứng chỉ phát hành
-
Tìm tệp kho khoá chứng chỉ phát hành. Không có vị trí hoặc tên mặc định cho kho khoá phát hành. Nếu bạn không chỉ định một vị trí hoặc tên khi tạo ứng dụng để phát hành, thì bản dựng sẽ không ký
.apkvà bạn sẽ phải ký trước khi có thể phát hành. Đối với chứng chỉ phát hành, bạn cũng cần bí danh của chứng chỉ và mật khẩu cho kho khoá và chứng chỉ. Bạn có thể liệt kê các 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_namebằng đường dẫn và tên đủ điều kiện của kho khoá, bao gồm cả đuôi.keystore. Bạn sẽ được nhắc nhập mật khẩu của kho khoá. Sau đó,keytoolsẽ hiển thị tất cả các bí danh trong kho khoá. -
Nhập nội dung sau vào một 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_namebằng đường dẫn và tên đủ điều kiện của kho khoá, bao gồm cả đuôi.keystore. Thay thếyour_alias_namebằng bí danh 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 vân tay số SHA-1
của chứng chỉ. Vân tay số là chuỗi gồm 20 số thập lục phân có 2 chữ 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 Thể dục 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 trong suốt quá trình này và tự động kích hoạt API Thể dục, hãy nhấp vào
Ngoài ra, hãy làm theo các bước sau để bật API Thể dục trong Google API Console và nhận mã ứng dụng khách OAuth 2.0.
- Chuyển đến Google API Console.
- Chọn một dự án hoặc tạo một dự án mới. Sử dụng cùng một dự án cho các phiên bản Android và REST của ứng dụng.
- Nhấp vào Tiếp tục để bật API Thể dục.
- Nhấp vào Chuyển đến 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 khách OAuth.
- Trong phần Loại ứng dụng , hãy chọn Android.
Trong hộp thoại kết quả, hãy nhập vân tay số SHA-1 và tên gói 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:75com.example.android.fit-exampleNhấp vào Tạo. Mã ứng dụng khách và khoá bí mật OAuth 2.0 Android mới sẽ xuất hiện trong danh sách mã cho dự án của bạn. Mã ứng dụng khách OAuth 2.0 là một chuỗi ký tự, chẳng hạn như sau:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com