🚀 壹信 IM · Android 环境配置与打包指南

💡 核心信息
适用版本: Flutter 3.x+ | Android SDK 30+ (Android 11)
最后更新: 2026-03-06
架构目标: arm64-v8a (仅 64 位，极致精简)
适用系统: macOS / Linux / Windows (Git Bash)

📑 目录导航

🛠️ 环境准备

📦 项目初始化

🛠️ 一、环境准备

在开始之前，请确保您的开发机器已安装以下核心组件。

1.1 必装软件清单

组件	推荐版本	说明
Flutter SDK	`3.24.0` + (稳定版)	官方下载链接
Android Studio	`Ladybug (2024.2)` +	包含 SDK Manager 和模拟器
JDK	`17` 或 `21`	Flutter 3.x 强依赖 JDK 17+
Git	Latest	代码版本管理

1.2 Android SDK 组件要求

打开 Android Studio → Settings → Languages & Frameworks → Android SDK，确保勾选以下组件：

SDK Platforms:

✅ Android 11 ("R") (API Level 30) — 本项目最低强制要求

✅ Android 14/15 (API Level 34/35) — 推荐安装以适配新设备

SDK Tools:

✅ Android SDK Build-Tools (34.0.0 +)

✅ Android SDK Command-line Tools (必须，用于接受 License)

⬜ Android Emulator (可选，如需模拟器测试)

1.3 环境变量与协议许可

安装完成后，打开终端执行以下命令进行验证和配置：

🔍 1. 查看 Flutter 环境健康状态

✍️ 2. 接受 Android SDK 许可证

⚠️ 注意: 如遇提示，请连续输入 y 并回车，直到全部接受。

✅ 3. 再次检查

确保 Android 部分显示为绿色对勾 ✅

💡 提示: 如果 flutter doctor 提示找不到 Android SDK，请手动指定路径：

📦 二、项目初始化

2.1 获取源代码

2.2 安装依赖

在项目根目录执行，下载所有 Dart 包：

2.3 清理与预热 (推荐)

如果是首次构建，建议执行清理以避免缓存干扰：

⚙️ 三、关键配置核查

壹信 IM 有特定的架构和版本限制，请在打包前务必核对以下文件。

3.1 检查 `minSdkVersion`

打开 android/app/build.gradle，确认 defaultConfig 配置如下：

3.2 检查后端 API 地址

打开 lib/core/services/api/api_client.dart，根据当前环境修改 ApiConfig：

3.3 签名配置 (Release 打包必需)

正式发布的 APK 必须经过签名。

1. 生成密钥库 (如果没有)

2. 创建配置文件

在 android/ 目录下创建 key.properties (请务必将其加入 .gitignore)：

3. 配置 Gradle

在 android/app/build.gradle 中引用签名：

▶️ 四、调试运行 (Debug)

连接一台 Android 11+ 的真机或启动模拟器。

1. 查看已连接设备

2. 运行项目 (默认连接第一个设备)

3. 指定设备运行 (可选)

⚠️ 重要提醒: 由于 minSdkVersion 设为 30，Android 10 及以下版本的设备将无法安装此应用。

🎁 五、正式打包 (Release)

方式 A：使用自动化脚本 (推荐 macOS/Linux)

项目根目录已内置优化脚本 build_apk.sh，它会自动处理混淆、符号分离和文件重命名。

赋予执行权限 (仅需一次):

执行打包:

✅ 脚本执行后效果：

生成仅包含 arm64 的 APK。

开启代码混淆 (--obfuscate)。

符号表分离至 build/app/outputs/symbols。

自动将 APK 重命名为 壹信IM.apk 并复制到桌面。

方式 B：手动命令行打包 (通用/Windows)

如果您在 Windows 环境或需要自定义参数：

📦 产物位置: build/app/outputs/flutter-apk/app-release.apk

💡 进阶：构建 App Bundle (Google Play 上架)
如果需要上传 Google Play，请使用 .aab 格式：
产物位置: build/app/outputs/bundle/release/app-release.aab

❓ 六、常见问题 (FAQ)

🎉 恭喜！您已成功完成壹信 IM 的 Android 环境配置与打包。

如有其他问题，请参考项目根目录 README.md 或联系技术团队。

Android安卓打包教程

🚀 壹信 IM · Android 环境配置与打包指南#

📑 目录导航#

🛠️ 一、环境准备#

1.1 必装软件清单#

1.2 Android SDK 组件要求#

1.3 环境变量与协议许可#

🔍 1. 查看 Flutter 环境健康状态#

✍️ 2. 接受 Android SDK 许可证#

✅ 3. 再次检查#

📦 二、项目初始化#

2.1 获取源代码#

2.2 安装依赖#

2.3 清理与预热 (推荐)#

⚙️ 三、关键配置核查#

3.1 检查 minSdkVersion#

3.2 检查后端 API 地址#

3.3 签名配置 (Release 打包必需)#

1. 生成密钥库 (如果没有)#

2. 创建配置文件#

3. 配置 Gradle#

▶️ 四、调试运行 (Debug)#

1. 查看已连接设备#

2. 运行项目 (默认连接第一个设备)#

3. 指定设备运行 (可选)#

🎁 五、正式打包 (Release)#

方式 A：使用自动化脚本 (推荐 macOS/Linux)#

方式 B：手动命令行打包 (通用/Windows)#

❓ 六、常见问题 (FAQ)#

🎉 恭喜！您已成功完成壹信 IM 的 Android 环境配置与打包。#