如何在Flutter中实现Google Fit Kit？授权后应用崩溃问题排查

我来帮你一步步梳理Flutter集成Google Fit Kit的流程，都是实际项目中验证过的可靠步骤：

1. 添加必要依赖 #

首先在你的pubspec.yaml里添上官方维护的相关插件：

dependencies:
  flutter:
    sdk: flutter
  google_sign_in: ^6.2.1 # 建议用最新稳定版
  google_fitness: ^0.5.0

执行flutter pub get拉取依赖包。

2. 配置Google Cloud Console #

这是集成的核心环节，别马虎：

• 登录Google Cloud Console，选择或新建你的项目。
• 在API库中搜索Google Fit API，点击启用该服务。
• 创建OAuth 2.0客户端ID：选择Android应用类型，填写应用包名（比如com.yourname.fitdemo），并添加SHA-1签名——debug环境可通过命令生成：keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android。
• 下载生成的google-services.json文件，直接放到Flutter项目的android/app目录下。

3. 配置Android项目 #

• 打开android/build.gradle，在dependencies块中添加Google服务依赖：

  dependencies {
      classpath 'com.google.gms:google-services:4.4.0' // 尽量使用最新版本
  }
  

• 在android/app/build.gradle的最底部添加以下代码，让Google服务生效：

  apply plugin: 'com.google.gms.google-services'
  

• 前往android/app/src/main/AndroidManifest.xml添加对应权限，根据你需要访问的数据类型调整：

  <uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
  <uses-permission android:name="android.permission.INTERNET" />
  <!-- 读写活动数据的权限 -->
  <uses-permission android:name="com.google.android.gms.permission.FITNESS_ACTIVITY_READ" />
  <uses-permission android:name="com.google.android.gms.permission.FITNESS_ACTIVITY_WRITE" />
  

4. 实现登录与权限请求 #

以下是基础的功能实现代码，你可以直接复制到项目中测试：

import 'package:google_sign_in/google_sign_in.dart';
import 'package:google_fitness/google_fitness.dart';

final GoogleSignIn _googleSignIn = GoogleSignIn(
  scopes: [
    'https://www.googleapis.com/auth/fitness.activity.read',
    'https://www.googleapis.com/auth/fitness.activity.write',
    // 如需其他数据权限，比如心率，添加对应scope即可
  ],
);

Future<void> setupGoogleFit() async {
  try {
    // 先完成Google账号登录
    await _googleSignIn.signIn();
    // 初始化Google Fit客户端
    await GoogleFitness.initialize();
    // 检查是否已获取权限
    bool hasPermissions = await GoogleFitness.hasPermissions();
    if (!hasPermissions) {
      bool granted = await GoogleFitness.requestPermissions();
      if (granted) {
        print("权限已授予！可以开始使用Google Fit功能");
        // 这里可调用接口获取步数、活动数据等
      } else {
        print("用户拒绝了权限请求，请引导用户开启权限");
      }
    }
  } catch (e) {
    print("初始化过程出错：$e");
  }
}

碰到这种授权崩溃的情况，我之前帮不少开发者排查过，大概率是配置细节出了问题，咱们一步步来排查：

1. 检查google-services.json的正确性 #

• 确认文件是从Google Cloud Console最新下载的，且文件内的package_name与你当前应用的包名完全一致（大小写都不能出错）。
• 确保文件确实放在android/app目录下，不要误放到android根目录或其他位置。

2. 验证SHA-1签名是否匹配 #

这是最常见的崩溃原因：

• 如果你用debug模式运行应用，Cloud Console中配置的必须是debug keystore的SHA-1；如果是release版本，则需要使用release keystore的SHA-1。
• 若不确定，重新生成SHA-1并更新到Cloud Console的客户端ID配置中，再重新下载google-services.json替换旧文件。

3. 权限配置位置错误修正 #

你提到把权限配置在app->build里？这是不对的，权限必须添加到AndroidManifest.xml中（参考上面集成步骤里的权限配置位置），build.gradle并不是存放权限的地方，放错会导致权限不生效甚至崩溃。

4. 检查版本兼容性 #

• 确认google_sign_in和google_fitness插件是最新稳定版，旧版本可能存在已知的崩溃bug。
• 检查android/build.gradle中的com.google.gms:google-services版本，不要使用过于老旧的版本，尽量与插件依赖的版本匹配。

5. 通过崩溃日志定位根源 #

打开Android Studio的Logcat，连接你的设备，过滤Error或Crash关键词，查看具体的崩溃堆栈信息：

• 如果是SecurityException，基本可以确定是权限或签名配置问题；
• 如果是NullPointerException，可能是初始化步骤错误，比如未完成Google登录就请求权限。

6. 最小化项目测试 #

若以上排查都无法解决问题，建议新建一个空的Flutter项目，只添加Google Fit相关依赖和最基础的代码，测试是否能正常授权。如果新项目正常运行，说明原项目存在代码或依赖冲突。

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