Flutter集成Firebase Auth/Firestore构建失败：Dex超限及API弃用问题

Hey there, let's work through your Firebase integration issues step by step—starting with the build-breaking Dex method count error, then addressing the deprecation and unsafe operation warnings.

1. 解决Dex文件方法引用数超过64K的核心问题 #

This is the main blocker stopping your build from succeeding. Android's default Dex format can only handle up to 64K method references, and Firebase + Flutter plugins easily push past that limit. Here's how to fix it:

步骤1：开启Multidex支持 #

Open your android/app/build.gradle file and make these edits:

• Add multiDexEnabled true to the defaultConfig block:

defaultConfig {
    // ... existing configuration
    multiDexEnabled true
}

• Add the Multidex dependency to the dependencies block (use the AndroidX version if you've migrated to AndroidX):

// For AndroidX projects
implementation 'androidx.multidex:multidex:2.0.1'
// For non-AndroidX (legacy support library) projects
// implementation 'com.android.support:multidex:1.0.3'

步骤2：配置Application类 #

Choose one of these two options:

• Create a custom Application class that extends MultiDexApplication:

import androidx.multidex.MultiDexApplication

class MyApp : MultiDexApplication() {
    // ... your app initialization code (if any)
}

Then update your AndroidManifest.xml to use this class:

<application
    android:name=".MyApp"
    // ... other existing attributes
>

• Or, if you don't have a custom Application class, directly use MultiDexApplication in the manifest:

<application
    android:name="androidx.multidex.MultiDexApplication"
    // ... other existing attributes
>

2. 处理Firebase插件的API弃用与不安全操作提示 #

Your current Firebase plugin versions (firebase_auth: ^0.15.3, cloud_firestore: ^0.13.0+1) are quite outdated, which is why you're seeing deprecation warnings. Let's update them while keeping compatibility with your Flutter v1.12.13+hotfix.5 setup:

步骤1：升级Firebase插件 #

Update your pubspec.yaml with compatible stable versions:

dependencies:
  flutter:
    sdk: flutter
  firebase_auth: ^0.18.4+1
  cloud_firestore: ^0.14.4+2

Run flutter pub get to install the updated plugins.

步骤2：更新Gradle配置 #

Your current com.google.gms:google-services:4.3.0 is also outdated. Update it in your android/build.gradle file:

buildscript {
    dependencies {
        // ... existing dependencies
        classpath 'com.google.gms:google-services:4.3.10'
        // You can also update the Android Gradle plugin to 3.6.4 (fully compatible with Flutter 1.12)
        classpath 'com.android.tools.build:gradle:3.6.4'
    }
}

步骤3：修复不安全操作提示 #

The "unchecked/unsafe operation" warnings typically come from two places:

• Missing await on Firebase async methods (e.g., FirebaseAuth.instance.signInWithEmailAndPassword() returns a Future—always use await to handle it properly)
• Unsafe type casts (replace direct as casts with type checks using is before accessing properties)

For example, instead of:

var user = FirebaseAuth.instance.currentUser as User;

Use:

var user = FirebaseAuth.instance.currentUser;
if (user is User) {
    // Safe operations with the user object here
}

3. 额外验证步骤 #

• Run flutter clean to clear cached build files, then rebuild your project to ensure all changes take effect
• Double-check that your Firebase console has the correct SHA-1/SHA-256 fingerprints added for your Android app (missing fingerprints can cause hidden authentication issues even if the build succeeds)

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