使用Fastlane发布至Firebase App Distribution时提示ProviderScope未找到

1. 核对Fastlane构建命令与参数 #

Fastlane构建时的参数可能和手动构建不一致，导致代码优化或裁剪异常：

• 确保Fastlane中执行的flutter build命令和手动构建完全匹配，比如手动用flutter build apk --release，则Fastlane lane配置应为：

lane :build_release do
  sh "flutter build apk --release"
end

• 避免添加可能误删Riverpod代码的参数，比如--split-debug-info若配置不当，或未处理注解保留规则。

2. 配置Android混淆规则（针对Android平台） #

如果是Android应用，Fastlane构建可能启用了更严格的R8/ProGuard混淆，导致Riverpod的ProviderScope被误裁剪：

• 在android/app/proguard-rules.pro中添加Riverpod专属混淆规则：

# 保留Riverpod相关类与注解
-keep class dev.riverpod.** { *; }
-keep @dev.riverpod.annotation.* class *
-keepclassmembers class * {
  @dev.riverpod.annotation.* <methods>;
}

• 确保android/app/build.gradle中release构建的混淆配置和手动构建一致，比如：

buildTypes {
    release {
        signingConfig signingConfigs.release
        minifyEnabled true
        shrinkResources true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

3. 统一Flutter SDK环境 #

Fastlane可能使用了与本地手动构建不同的Flutter版本，导致构建产物差异：

• 在Fastlane lane中添加版本检查，确保环境一致：

lane :verify_flutter_env do
  sh "flutter --version"
  # 若需指定SDK路径，可设置环境变量
  # ENV['FLUTTER_ROOT'] = '/your/flutter/sdk/path'
end

4. 确认Firebase上传的构建产物正确性 #

检查Fastlane是否上传了错误的构建包（比如debug包而非release包）：

• 在firebase_app_distribution lane中明确指定正确的产物路径：

lane :upload_to_firebase do
  firebase_app_distribution(
    app: "your-firebase-app-id",
    apk_path: "build/app/outputs/flutter-apk/app-release.apk",
    testers: "your-testers@example.com"
  )
end

5. 二次验证ProviderScope初始化逻辑 #

虽然手动构建正常，但仍需确认main.dart中全局包裹了ProviderScope，且无环境分支逻辑：

void main() {
  runApp(
    ProviderScope(
      child: MyApp(),
    ),
  );
}

• 避免出现仅在debug模式下初始化ProviderScope的代码。

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