更新Android Studio后Google Play Games初始化时platform_configuration.Valid()返回false

问题描述 #

本人使用Google Play Games Services（C版本）已有数年，近期更新了部分SDK后，未更新任何Google Play Games Services相关SDK及C SDK，但platform_configuration.Valid()突然开始返回false。初始化代码如下：

// Init code    
gpg::AndroidInitialization::android_main(app);
auto pc = std::make_unique<gpg::PlatformConfiguration>();
pc->SetActivity(app->activity->clazz);
const auto is_valid = pc->Valid();
// is_valid is suddenly false

可能的原因及排查方向 #

• Activity 实例有效性问题：更新其他SDK后，可能导致app->activity->clazz获取到的是无效/已销毁的Activity引用。可以在调用SetActivity前检查app->activity是否非空，以及通过JNI方法验证clazz是否为有效引用（比如env->IsSameObject(clazz, nullptr)）。
• JNI 环境异常：部分SDK更新可能修改了JNI环境状态，比如线程附着状态变化、全局引用被意外释放。确认当前线程是否已正确附着到JNI环境，或尝试重新获取有效的JNIEnv实例后再执行初始化。
• Manifest 配置被意外修改：更新其他SDK时，可能间接覆盖或丢失AndroidManifest.xml中GPGS所需的配置。检查Manifest中是否存在：
  • com.google.android.gms.games.APP_ID的meta-data标签
  • 必要权限（如INTERNET）
• 依赖冲突导致的隐性版本变更：虽然未手动更新GPGS SDK，但其他SDK可能依赖了不同版本的Google Play Services库，导致依赖树中GPGS相关库被自动升级/降级，引发兼容性问题。通过./gradlew app:dependencies查看依赖树，确认gpg相关库版本是否符合C++ SDK要求。
• 初始化时机错误：更新其他SDK后应用生命周期流程可能变化，导致初始化代码在Activity未完全就绪时被调用（比如onCreate之前）。尝试将GPGS初始化延迟到onStart或onResume阶段执行。

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