Flutter Android应用打包指南

发布时间: 2025-03-22 22:39

↑

# Flutter Android应用打包指南

## 打包前的准备工作

### 1. 应用签名配置

在发布Android应用之前，需要创建签名密钥：

1. 使用Android Studio生成密钥：
   - 选择 Build > Generate Signed Bundle/APK
   - 选择 Android App Bundle 或 APK
   - 点击 Create new 创建新的密钥库

2. 使用命令行生成密钥：
```bash
keytool -genkey -v -keystore ~/key.jks \
        -keyalg RSA -keysize 2048 -validity 10000 \
        -alias key
```

### 2. 配置签名信息

在`android/app/build.gradle`文件中配置签名信息：

```gradle
android {
    signingConfigs {
        release {
            storeFile file("path/to/key.jks")
            storePassword "store_password"
            keyAlias "key"
            keyPassword "key_password"
        }
    }

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

### 3. 保护签名信息

为了保护签名信息，建议将敏感信息存储在单独的配置文件中：

1. 创建`key.properties`文件（不要提交到版本控制）：
```properties
storePassword=<password>
keyPassword=<password>
keyAlias=key
storeFile=<path-to-keystore>
```

2. 修改`build.gradle`文件：
```gradle
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile file(keystoreProperties['storeFile'])
            storePassword keystoreProperties['storePassword']
        }
    }
}
```

## 应用配置

### 1. 应用图标

1. 准备不同分辨率的图标：
   - mipmap-mdpi (48x48)
   - mipmap-hdpi (72x72)
   - mipmap-xhdpi (96x96)
   - mipmap-xxhdpi (144x144)
   - mipmap-xxxhdpi (192x192)

2. 替换`android/app/src/main/res/`目录下对应的图标文件

### 2. 应用名称

修改`android/app/src/main/AndroidManifest.xml`：

```xml
<application
    android:label="应用名称"
    android:icon="@mipmap/ic_launcher">
```

### 3. 版本号配置

在`pubspec.yaml`中设置版本号：

```yaml
version: 1.0.0+1  # 格式：version_name+version_code
```

## 打包应用

### 1. 检查配置

在打包之前，运行检查命令：

```bash
flutter doctor
flutter pub get
flutter clean
```

### 2. 生成APK

```bash
# 生成release版本APK
flutter build apk --release

# 生成特定架构的APK
flutter build apk --release --target-platform android-arm64
```

生成的APK文件位于：
`build/app/outputs/flutter-apk/app-release.apk`

### 3. 生成App Bundle

```bash
flutter build appbundle --release
```

生成的AAB文件位于：
`build/app/outputs/bundle/release/app-release.aab`

## 优化与测试

### 1. 代码混淆

在`android/app/build.gradle`中启用混淆：

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

创建`android/app/proguard-rules.pro`文件：

```proguard
# Flutter混淆规则
-keep class io.flutter.app.** { *; }
-keep class io.flutter.plugin.** { *; }
-keep class io.flutter.util.** { *; }
-keep class io.flutter.view.** { *; }
-keep class io.flutter.** { *; }
-keep class io.flutter.plugins.** { *; }

# 保留Parcelable序列化的类
-keep class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}

# 保留@Keep注解的类和成员
-keep class androidx.annotation.Keep
-keep @androidx.annotation.Keep class * {*;}
-keepclasseswithmembers class * {
    @androidx.annotation.Keep <methods>;
}
-keepclasseswithmembers class * {
    @androidx.annotation.Keep <fields>;
}
-keepclasseswithmembers class * {
    @androidx.annotation.Keep <init>(...);
}
```

### 2. 性能优化

1. 启用R8编译器：
在`android/gradle.properties`中添加：
```properties
android.enableR8=true
```

2. 优化图片资源：
   - 使用适当的图片格式（WebP优于PNG）
   - 压缩图片资源
   - 使用矢量图标（SVG）

3. 减小APK大小：
   - 移除未使用的资源
   - 使用App Bundle发布
   - 启用资源压缩

### 3. 测试检查

1. 功能测试：
```bash
flutter test
```

2. 集成测试：
```bash
flutter drive --target=test_driver/app.dart
```

3. 性能测试：
   - 使用Flutter DevTools分析性能
   - 检查内存使用情况
   - 测试启动时间

## 常见问题

### 1. 签名问题

如果遇到签名相关错误：

1. 检查密钥库路径是否正确
2. 验证密钥库密码和别名
3. 确保`key.properties`文件格式正确

### 2. 构建错误

常见构建错误解决方案：

1. Gradle同步失败：
   - 检查网络连接
   - 更新Gradle版本
   - 清理项目：`flutter clean`

2. 资源文件错误：
   - 检查资源文件名是否合法
   - 确保资源文件存在
   - 验证XML文件格式

### 3. 兼容性问题

1. 设置目标SDK版本：
在`android/app/build.gradle`中：
```gradle
android {
    compileSdkVersion 33
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 33
    }
}
```

2. 权限处理：
在`AndroidManifest.xml`中正确声明权限：
```xml
<manifest ...>
    
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    ...
</manifest>
```

## 发布检查清单

在发布应用之前，请检查以下内容：

1. 应用配置
   - [ ] 应用ID配置正确
   - [ ] 版本号设置适当
   - [ ] 应用名称和图标已更新

2. 签名配置
   - [ ] 使用发布密钥签名
   - [ ] 密钥库安全保存
   - [ ] 签名配置正确

3. 代码和资源
   - [ ] 移除调试代码和日志
   - [ ] 资源文件优化
   - [ ] 第三方库版本检查

4. 性能和安全
   - [ ] 启用代码混淆
   - [ ] 检查应用性能
   - [ ] 安全漏洞检查

5. 测试验证
   - [ ] 功能测试完成
   - [ ] 兼容性测试完成
   - [ ] 用户体验测试

## 总结

本文详细介绍了Flutter Android应用打包的完整流程，包括：

1. 签名配置
2. 应用设置
3. 打包命令
4. 优化建议
5. 问题解决

建议：

- 妥善保管签名密钥
- 定期更新依赖
- 重视性能优化
- 做好版本管理
- 保持良好的测试习惯

元素码农