Trước khi có thể bắt đầu tích hợp ứng dụng iOS hoặc macOS với các thành phần Đăng nhập bằng Google, bạn phải tải các phần phụ thuộc xuống và định cấu hình dự án Xcode của mình. Các bước trên trang này chỉ thực hiện điều đó. Sau đó, các bước tiếp theo sẽ mô tả cách tích hợp Đăng nhập bằng Google vào ứng dụng của bạn.
Trước khi bắt đầu
Cài đặt phiên bản Xcode hiện tại.
Cài đặt phần phụ thuộc Đăng nhập bằng Google trong dự án của bạn
CocoaPods
Nếu bạn chưa cài đặt CocoaPods, hãy làm theo các bước trong CocoaPods Bắt đầu của chúng tôi.
Mở cửa sổ dòng lệnh rồi chuyển đến vị trí Xcode của ứng dụng dự án.
Nếu bạn chưa tạo Podfile cho ứng dụng của mình, hãy tạo một tệp bây giờ:
pod init
Mở Podfile đã tạo cho ứng dụng của bạn và thêm nội dung sau đây:
pod 'GoogleSignIn'
Nếu bạn đang sử dụng SwiftUI, hãy thêm cả tiện ích nhóm cho tiêu đề "Đăng nhập bằng Google" nút:
pod 'GoogleSignInSwiftSupport'
Lưu tệp và chạy:
pod install
Mở tệp
.xcworkspace
không gian làm việc đã tạo cho ứng dụng của bạn trong Xcode. Hãy sử dụng tệp này cho tất cả các hoạt động phát triển ứng dụng trong tương lai. (Lưu ý tệp này khác với tệp.xcodeproj
dự án đi kèm, sẽ dẫn đến lỗi bản dựng khi mở).Bạn có thể tham khảo ứng dụng mẫu object-C Tệp nhóm để xem ví dụ.
Trình quản lý gói Swift
Mở dự án của bạn trong Xcode.
Thêm các phần phụ thuộc Đăng nhập bằng Google vào ứng dụng của bạn (Tài liệu về mã SKU):
Kho lưu trữ https://github.com/google/GoogleSignIn-iOS
Phiên bản 7.0.0 Đóng gói sản phẩm GoogleSignIn Nếu bạn đang sử dụng SwiftUI, hãy thêm cả sản phẩm gói tiện ích sau cho nút "Đăng nhập bằng Google" nút:
Đóng gói sản phẩm GoogleSignInSwift
Lấy mã ứng dụng OAuth
Ứng dụng của bạn cần có mã ứng dụng khách OAuth để tự nhận dạng theo quy trình xác thực của Google phần phụ trợ. Đối với các ứng dụng iOS và macOS, loại ứng dụng có mã ứng dụng khách OAuth phải được định cấu hình là iOS.
Nếu bạn chưa tạo mã ứng dụng OAuth, hãy nhấp vào nút này bên dưới để làm điều đó.
Sau khi bạn tạo mã ứng dụng khách OAuth, hãy ghi lại chuỗi mã ứng dụng khách bạn sẽ cần định cấu hình tính năng Đăng nhập bằng Google trong ứng dụng của mình. Bạn có thể tuỳ ý tải xuống tệp cấu hình, chứa ID ứng dụng khách của bạn và các để tham khảo trong tương lai.
Nếu đã tạo mã ứng dụng OAuth, bạn có thể tìm thấy OAuth hiện tại của mình bằng cách nhấp vào nút bên dưới.
Nhận mã ứng dụng khách của máy chủ OAuth
Hầu hết ứng dụng sẽ cần truyền danh tính của người dùng đã đăng nhập sang một dịch vụ phụ trợ thuộc loại nào đó. Để chuyển danh tính của người dùng đã đăng nhập bằng Google một cách an toàn vào phần phụ trợ, bạn sẽ sử dụng mã thông báo mã nhận dạng, như thảo luận trong bài viết Xác thực bằng máy chủ phụ trợ. Việc truy xuất mã nhận dạng của người dùng yêu cầu mã ứng dụng khách thứ hai – máy chủ của bạn mã ứng dụng khách – đại diện cho phần phụ trợ của bạn.
Cách tạo mã ứng dụng khách của máy chủ:
Mở dự án của bạn trong Bảng điều khiển Cloud.
Tạo một mã ứng dụng khách OAuth mới thuộc loại ứng dụng web. Ghi lại chuỗi mã ứng dụng khách mà bạn sẽ cần để định cấu hình tính năng Đăng nhập bằng Google trong .
Định cấu hình dự án ứng dụng
Tính năng Đăng nhập bằng Google yêu cầu bạn định cấu hình dự án bằng mã ứng dụng OAuth và một lược đồ URL tuỳ chỉnh. Nếu muốn, bạn cũng có thể thêm mã ứng dụng khách của máy chủ cho xác thực phần phụ trợ hoặc tối ưu hoá ứng dụng cho Workspace.
Thêm mã ứng dụng khách OAuth và lược đồ URL tuỳ chỉnh
Cập nhật tệp Info.plist
của ứng dụng để thêm OAuth
mã ứng dụng khách và lược đồ URL tuỳ chỉnh dựa trên mã ứng dụng khách đảo ngược.
Mã ứng dụng khách bị đảo ngược là mã ứng dụng khách của bạn, có thứ tự là các dấu chấm được phân tách bằng dấu chấm
đã đảo ngược các trường. Thông tin này cũng xuất hiện trong "Lược đồ URL dành cho iOS" khi chọn một
ứng dụng OAuth hiện có của iOS trên Đám mây
bảng điều khiển dành cho nhà phát triển. Ví dụ: com.googleusercontent.apps.1234567890-abcdefg
<key>GIDClientID</key> <string>YOUR_IOS_CLIENT_ID</string> <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string> </array> </dict> </array>
Không bắt buộc: Định cấu hình phương thức xác thực phần phụ trợ
Nếu bạn cần thu hút người dùng Mã thông báo mã nhận dạng cho hoạt động xác thực phần phụ trợ,
đặt khoá GIDServerClientID
trong tệp Info.plist
của ứng dụng.
<key>GIDServerClientID</key> <string>YOUR_SERVER_CLIENT_ID</string>
Không bắt buộc: Tối ưu hoá cho miền Google Workspace hoặc vùng OpenID
Sử dụng thông số GIDHostedDomain
nếu bạn muốn tối ưu hoá quy trình đăng nhập cho
một miền Google Workspace.
<key>GIDHostedDomain</key> <string>YOUR_HOSTED_DOMAIN</string>
Sử dụng tham số GIDOpenIDRealm
nếu bạn muốn chỉ định vùng OpenID.
<key>GIDOpenIDRealm</key> <string>YOUR_OPENID_REALM</string>
Ký đơn đăng ký
Ứng dụng của bạn phải được ký bằng một chứng chỉ do Apple cấp để chạy có sẵn trên thiết bị macOS và iOS để lưu trữ thông tin đăng nhập qua chuỗi khoá.
Các bước tiếp theo
Bây giờ, bạn đã tải các phần phụ thuộc của dự án xuống và định cấu hình bản Xcode của mình bạn có thể thêm tính năng Đăng nhập bằng Google vào ứng dụng iOS của mình.