google-signin-unity 的安装和配置教程

1. 项目基础介绍和主要编程语言

google-signin-unity 是一个开源项目，它为 Unity 游戏引擎提供 Google Sign-In API 插件。这个插件支持 Android 和 iOS 平台，可以让 Unity 项目实现 Google 登录功能，获取 OAuth ID 令牌或服务器授权码。主要编程语言是 C#，用于 Unity 的脚本和与原生代码的交互。

2. 项目使用的关键技术和框架

该项目使用的关键技术是 Google Sign-In API，这是 Google 提供的一个认证服务，允许用户使用他们的 Google 帐户进行登录。此外，它还涉及到原生代码的集成，因为需要在 Android 和 iOS 设备上调用特定的 API。在 Unity 中，项目使用了 C# 编写的脚本与这些原生代码进行交互。

3. 项目安装和配置的准备工作

在开始安装和配置之前，请确保你已经完成了以下准备工作：

• 安装了 Unity 编辑器，版本至少为 2021.3.21 或更高。
• 拥有一个有效的 Google Cloud 项目，并已经开启了 Google Sign-In API。
• 获取了项目的 Web 客户端 ID 和 Android 客户端 ID。
• 对于 iOS 项目，还需要获取相应的 iOS 客户端 ID。

安装步骤

以下是详细的安装步骤：

步骤 1：导入 Unity 插件

1. 打开 Unity 编辑器。
2. 在菜单栏选择 Assets > Import Package > Custom Package...。
3. 选择下载的 GoogleSignIn-unitypackage 文件，点击 Open 导入插件。

步骤 2：配置项目设置

Android 配置：

1. 在 Unity 编辑器中，选择 File > Build Settings，选择 Android 平台，然后关闭窗口。
2. 转到 PlayerSettings（在菜单栏 Edit > Project Settings 中）。
3. 在 Package Name 字段中，输入你在 Google Cloud Console 中创建的 Android 应用的包名。
4. 设置应用的图标和其他相关信息。

iOS 配置：

1. 在 Unity 编辑器中，选择 File > Build Settings，选择 iOS 平台，然后关闭窗口。
2. 使用 Xcode 打开项目，设置应用的图标、.bundle identifier 等信息。
3. 根据 README 中的说明，配置 Info.plist 文件，添加 CLIENT_ID、WEB_CLIENT_ID 等必要的字段。

步骤 3：配置 Web 客户端 ID

1. 在 Unity 编辑器中，打开或创建一个场景。
2. 在 Hierarchy 视图中，选择 Canvas 对象（如果没有，需要先创建一个）。
3. 添加 SignInSampleScript 组件到 Canvas 对象。
4. 在 SignInSampleScript 组件的检查器（Inspector）窗口中，输入你的 Web 客户端 ID。

步骤 4：构建和运行

• 对于 Android，确保已经设置了正确的 keystore 和签名信息，然后构建并运行到 Android 设备或模拟器上。
• 对于 iOS，构建并运行到 iOS 设备或模拟器上，确保已经在 Xcode 中正确设置了所有必要的信息。

完成以上步骤后，你的 Unity 项目应该就能够使用 Google Sign-In 功能了。在集成过程中遇到任何问题，可以参考项目的 README 文件和官方文档。