调用signIn()时games_services始终返回null问题求助

已完成GameKit与Google Play服务的集成步骤，AndroidManifest中配置了如下meta-data：

<meta-data
    android:name="com.google.android.gms.games.APP_ID"
    android:value="MY_ID" />
<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

Google Play Console各项配置看似正常，但SDK未标记完成，调用以下signIn方法时返回结果始终为null：

Future<void> signIn() async {
    final result = await GameAuth.signIn();
    print(result);
}

排查步骤 #

• 确认APP_ID准确性
  检查MY_ID是否与Google Play Console游戏服务页面「设置」→「应用详情」中的应用ID完全一致，不要混淆包名、项目ID与APP_ID，避免多余空格或字符。

• 完成Google Play Console的SDK验证
  SDK未标记完成是核心嫌疑点，需：

  1. 上传签名后的APK/AAB到Google Play Console的测试或生产渠道，确保包名、签名证书与游戏服务配置完全匹配；
  2. 在设备上运行应用时，先通过GoogleApiAvailability.getInstance().isGooglePlayServicesAvailable(context)检查服务状态，修复Google Play服务未安装/过期等问题。

• 核对签名证书配置
  在Google Play Console游戏服务的「凭据」页面，添加应用的发布签名SHA-1（使用App Bundle时需额外添加上传密钥SHA-1）；调试阶段可补充调试签名SHA-1，避免调试时验证失败。

• 捕获signIn异常信息
  修改代码捕获错误，获取具体失败原因：

  Future<void> signIn() async {
    try {
      final result = await GameAuth.signIn();
      print(result);
    } catch (e) {
      print('SignIn失败: $e');
    }
  }
  

  常见异常包括API未启用、APP_ID不匹配、签名证书错误、网络权限缺失等。

• 验证Google Play服务依赖
  检查Android模块级build.gradle是否正确引入游戏服务依赖，示例：

  implementation 'com.google.android.gms:play-services-games:23.1.0'
  

  确保依赖版本与@integer/google_play_services_version匹配。

• 检查设备环境

  1. 测试设备需安装最新版Google Play服务，且登录的Google账号已添加到Google Play Console的测试账号列表（开启封闭/开放测试时）；
  2. 优先使用真实设备测试，部分模拟器存在Google Play服务功能不全的问题。

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