【亲测免费】 Google Sign-In for iOS 开源项目指南

1. 项目目录结构及介绍

Google Sign-In for iOS 的仓库结构清晰地组织了代码和资源，以支持在iOS和macOS应用中集成Google登录功能。以下是核心的目录结构及关键组件简介：

• Sources: 包含主要的实现代码，如GoogleSignIn.swift，处理Google登录的核心逻辑。
• Samples: 提供示例应用程序，包括Objective-C版本（SignInSample）和SwiftUI版本（如DaysUntilBirthday），展示如何集成Google Sign-In。
• GoogleSignIn: 这是主库，包含了用于实现Google登录的所有必要类和接口。
  • GIDSignIn: 核心类，负责登录流程管理。
  • GIDSignInButton: 实现“Sign in with Google”按钮的UI组件。
• GoogleSignInSwift: 若你的应用使用SwiftUI，则此部分提供了额外的支持，尤其是GoogleSignInButtonViewModel，帮助自定义Google Sign-In按钮。
• Documentation: 可能包含API参考或其它文档资料，尽管具体路径未在引用中明确指出。
• Resources: 通常包含图标、配置文件等静态资源，但在此引用中未详细列出。

2. 项目的启动文件介绍

在实际应用中，Google Sign-In的启动涉及到初始化过程，通常在iOS应用中，这会在AppDelegate.swift或相应的入口点进行。主要步骤包括设置GIDSignIn的共享实例，并处理URL回调以便完成身份验证流程。例如，在Swift中，你会添加类似以下代码到AppDelegate来处理身份验证的URL重定向：

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    var handled = GIDSignIn.sharedInstance.handle(url)
    if !handled {
        // 其他URL处理逻辑
    }
    return handled
}

对于macOS，此操作通常在AppDelegate的applicationDidFinishLaunching方法中通过监听kAEGetURL事件来完成。

3. 项目的配置文件介绍

Google Sign-In的正确配置依赖于几个关键文件和参数：

a. Podfile（如果是使用CocoaPods）

在项目根目录下的Podfile中加入pod 'GoogleSignIn'和（如果适用）pod 'GoogleSignInSwiftSupport'以引入必要的依赖项。

b. Info.plist

重要配置位于你的App的Info.plist文件内：

• GIDClientID: 添加你的OAuth客户端ID，确保它对应于你在Google Cloud Console创建的应用。
• CFBundleURLTypes下配置自定义URL Scheme，基于反向的客户端ID，例如com.googleusercontent.apps.1234567890-abcdefg。

如果有后台认证需求，还需增加GIDServerClientID。

c. Google云控制台配置

虽然不是直接在项目内的文件，但是你必须在Google Cloud Console配置OAuth客户端ID和服务器端客户端ID，这些信息随后需体现在项目的配置中。此外，可能还需要下载配置文件，其中包含了客户端ID和其他配置详情，用于指引本地配置更新。

通过以上步骤，你可以确保Google Sign-In正确集成至你的iOS或macOS应用中，提供用户便捷且安全的登录体验。记住，为了确保应用能在设备上存储凭证，应用需要经过Apple的签名。