如何在Cocos2d-x中通过Firebase C++ SDK实现谷歌账号认证？

刚好我之前在Cocos2d-x项目里踩过这个坑，给你梳理下完整流程和关键注意点：

首先明确核心事实：Firebase C++ SDK本身没有自带谷歌认证的GUI组件。因为谷歌的登录UI是依赖平台原生系统的（比如Android的Google Sign-In弹窗、iOS的系统级登录界面），Cocos2d-x作为跨平台引擎没法直接提供统一的登录UI。所以整体流程是：先通过平台原生代码（Android Java/iOS OC/Swift）触发谷歌登录、获取身份凭证，再把凭证传给Cocos2d-x的C++代码，最终调用Firebase Auth完成认证。

1. 前期准备 #

• 确保你的Cocos2d-x项目已经集成了Firebase C++ SDK，并且在Firebase控制台完成了项目配置：开启Google认证方式，添加对应平台的包名、SHA-1（Android）、Team ID（iOS）等信息。
• 分别在Android和iOS端集成谷歌官方的Sign-In SDK（这一步是必须的，因为要获取合法的身份凭证）。

2. 平台原生侧：获取谷歌身份凭证 #

2.1 Android端步骤 #

1. 先在Android项目的build.gradle里添加Google Sign-In依赖：

dependencies {
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
}

2. 在你的主Activity里实现谷歌登录逻辑：
   • 初始化GoogleSignInClient，注意要传入Firebase控制台生成的default_web_client_id（在google-services.json里可以找到）。
   • 添加登录按钮或者通过JNI触发登录Intent，启动谷歌官方的登录界面。
   • 在onActivityResult里处理登录结果，提取idToken（这是Firebase需要的凭证）。
   • 通过JNI把idToken传给Cocos2d-x的C++代码。

示例Java代码片段：

private static final int RC_SIGN_IN = 1001;
private GoogleSignInClient mGoogleSignInClient;

// 在onCreate里初始化
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
            .requestIdToken(getString(R.string.default_web_client_id))
            .requestEmail()
            .build();
    mGoogleSignInClient = GoogleSignIn.getClient(this, gso);
}

// 触发登录（可以通过JNI从C++调用这个方法）
public void startGoogleSignIn() {
    Intent signInIntent = mGoogleSignInClient.getSignInIntent();
    startActivityForResult(signInIntent, RC_SIGN_IN);
}

// 处理登录结果
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == RC_SIGN_IN) {
        Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
        try {
            GoogleSignInAccount account = task.getResult(ApiException.class);
            String idToken = account.getIdToken();
            // 通过JNI回调C++的认证方法
            CocosHelper.callCppGoogleAuth(idToken);
        } catch (ApiException e) {
            Log.e("GoogleAuth", "登录失败: " + e.getStatusCode());
        }
    }
}

2.2 iOS端步骤 #

1. 通过CocoaPods集成Google Sign-In SDK：

pod 'GoogleSignIn', '~> 7.0'

2. 在Info.plist里配置URL Scheme（从Firebase控制台的iOS项目配置里获取，格式是com.googleusercontent.apps.xxxxxx）。
3. 在你的ViewController里实现登录逻辑：
   • 初始化GIDSignInConfiguration，传入Firebase的Client ID。
   • 点击按钮或者通过桥接触发登录，获取GIDGoogleUser的idToken。
   • 通过桥接文件把idToken传给Cocos2d-x的C++代码。

示例Objective-C代码片段：

// 初始化（在viewDidLoad里）
GIDSignInConfiguration *config = [[GIDSignInConfiguration alloc] initWithClientID:@"YOUR_FIREBASE_CLIENT_ID"];
[GIDSignIn sharedInstance].configuration = config;

// 触发登录（可通过桥接从C++调用）
- (void)startGoogleSignIn {
    [[GIDSignIn sharedInstance] signInWithPresentingViewController:self completion:^(GIDSignInResult * _Nullable result, NSError * _Nullable error) {
        if (error) {
            NSLog(@"Google登录失败: %@", error.localizedDescription);
            return;
        }
        GIDGoogleUser *user = result.user;
        NSString *idToken = user.idToken.tokenString;
        // 回调C++的认证方法
        [CocosBridge cppGoogleAuthWithToken:idToken];
    }];
}

3. Cocos2d-x C++侧：用凭证完成Firebase认证 #

拿到平台传过来的idToken后，就可以调用Firebase C++ SDK的SignInWithCredentialAsync方法完成认证：

首先确保Firebase Auth已经初始化（通常在AppDelegate::applicationDidFinishLaunching()里）：

#include "firebase/auth.h"

firebase::App* g_firebase_app = nullptr;
firebase::auth::Auth* g_firebase_auth = nullptr;

bool AppDelegate::applicationDidFinishLaunching() {
    // 初始化Firebase App
    firebase::AppOptions options;
    // 如果你是通过google-services.json/GoogleService-Info.plist配置的，这里可以不用手动设参数
    g_firebase_app = firebase::App::Create(options);
    if (g_firebase_app) {
        g_firebase_auth = firebase::auth::Auth::GetAuth(g_firebase_app);
    }
    return true;
}

然后处理平台传过来的idToken，创建谷歌凭证并发起登录：

// 这个方法是平台原生通过JNI/桥接调用的
void onGoogleAuthTokenReceived(const std::string& id_token) {
    if (!g_firebase_auth) {
        CCLOG("Firebase Auth未初始化");
        return;
    }

    // 从idToken创建谷歌认证凭证
    firebase::auth::GoogleAuthCredential credential = 
        firebase::auth::GoogleAuthCredential::FromIdToken(id_token.c_str());

    // 异步登录
    g_firebase_auth->SignInWithCredentialAsync(
        credential,
        [](const firebase::auth::SignInResult& result, void* user_data) {
            if (result.status().ok()) {
                // 登录成功，获取用户信息
                firebase::auth::User* user = result.user();
                CCLOG("谷歌登录成功！用户ID: %s", user->uid().c_str());
                CCLOG("用户邮箱: %s", user->email().c_str());
                // 这里可以跳转到游戏主界面
            } else {
                // 登录失败，处理错误
                CCLOG("谷歌登录失败: %s", result.status().error_message());
            }
        },
        nullptr // 自定义用户数据，可选
    );
}

关于自定义GUI的说明 #

如果你不想用谷歌官方的登录UI，完全可以自己做一个Cocos2d-x的Scene作为登录界面（比如放一个自定义的"谷歌登录"按钮），但核心的登录验证流程还是必须调用平台原生的谷歌Sign-In SDK——因为谷歌的OAuth2.0授权流程需要官方SDK来处理身份验证，自定义界面只能做交互入口，不能绕过原生SDK的验证步骤。

举个例子：你做一个Cocos2d-x的登录场景，按钮点击后通过JNI（Android）或者桥接（iOS）调用原生的startGoogleSignIn方法，触发官方登录界面，等原生返回idToken后再回调C++的认证方法。

常见坑点 #

• 一定要在Firebase控制台正确配置平台信息：Android的SHA-1必须和你打包用的签名文件一致，iOS的Team ID和Bundle ID要匹配。
• idToken有有效期，不要缓存复用，每次登录都要获取最新的。
• 要处理各种错误情况：用户取消登录、网络异常、凭证无效等，给用户友好的提示。

内容的提问来源于stack exchange，提问作者MBU