433 lines
7.3 KiB
Markdown
433 lines
7.3 KiB
Markdown
# Mobile EDA 打包指南
|
|
|
|
**版本**: v1.1.0
|
|
**最后更新**: 2026-03-07
|
|
|
|
---
|
|
|
|
## 📋 环境要求
|
|
|
|
### 通用要求
|
|
- Flutter SDK >= 3.19.0
|
|
- Dart SDK >= 3.0.0
|
|
- Git
|
|
|
|
### Android 打包
|
|
- Android SDK 30+
|
|
- JDK 11+
|
|
- Android Studio (推荐)
|
|
|
|
### Windows 打包
|
|
- Windows 10/11
|
|
- Visual Studio 2019+ (带 C++ 桌面开发)
|
|
- Windows 10 SDK
|
|
|
|
### Linux 打包
|
|
- Ubuntu 20.04+ / Debian 11+ / Fedora 35+
|
|
- Clang/CMake/Ninja
|
|
- pkg-config
|
|
- GTK+3
|
|
|
|
---
|
|
|
|
## 🚀 快速开始
|
|
|
|
### 1. 获取依赖
|
|
|
|
```bash
|
|
cd mobile-eda
|
|
flutter pub get
|
|
```
|
|
|
|
### 2. 运行测试
|
|
|
|
```bash
|
|
flutter test
|
|
```
|
|
|
|
### 3. 构建
|
|
|
|
#### 方式 A: 全平台构建 (推荐)
|
|
|
|
```bash
|
|
# Linux/macOS
|
|
./scripts/build-all.sh
|
|
|
|
# Windows (PowerShell)
|
|
.\scripts\build-windows.ps1
|
|
```
|
|
|
|
#### 方式 B: 单独平台构建
|
|
|
|
```bash
|
|
# Android APK
|
|
flutter build apk --release
|
|
|
|
# Windows EXE
|
|
flutter build windows --release
|
|
|
|
# Linux
|
|
flutter build linux --release
|
|
|
|
# Web
|
|
flutter build web --release
|
|
```
|
|
|
|
---
|
|
|
|
## 📦 输出文件
|
|
|
|
### Android
|
|
|
|
| 文件 | 说明 | 大小 |
|
|
|------|------|------|
|
|
| `mobile-eda-v1.1.0-debug.apk` | Debug 版本 | ~50MB |
|
|
| `mobile-eda-v1.1.0-release.apk` | Release 版本 | ~25MB |
|
|
| `mobile-eda-v1.1.0.aab` | Google Play Bundle | ~20MB |
|
|
|
|
### Windows
|
|
|
|
| 文件 | 说明 | 大小 |
|
|
|------|------|------|
|
|
| `mobile-eda.exe` | 主程序 | ~15MB |
|
|
| `flutter_windows.dll` | Flutter 运行时 | ~10MB |
|
|
| `*.dll` | 依赖库 | ~20MB |
|
|
| **总计** | 完整包 | ~50MB |
|
|
|
|
### Linux
|
|
|
|
| 文件 | 说明 |
|
|
|------|------|
|
|
| `mobile_eda` | 主程序 |
|
|
| `lib/` | 依赖库 |
|
|
| `data/` | 资源文件 |
|
|
|
|
### Web
|
|
|
|
| 文件 | 说明 |
|
|
|------|------|
|
|
| `index.html` | 入口页面 |
|
|
| `main.dart.js` | 编译后的 JS |
|
|
| `assets/` | 静态资源 |
|
|
|
|
---
|
|
|
|
## 🔧 详细步骤
|
|
|
|
### Android 打包
|
|
|
|
#### 1. 配置签名
|
|
|
|
创建 `android/key.properties`:
|
|
|
|
```properties
|
|
storePassword=你的密钥库密码
|
|
keyPassword=你的密钥密码
|
|
keyAlias=上传
|
|
storeFile=../upload-keystore.jks
|
|
```
|
|
|
|
#### 2. 修改 `android/app/build.gradle`
|
|
|
|
```gradle
|
|
android {
|
|
...
|
|
signingConfigs {
|
|
release {
|
|
keyAlias keystoreProperties['keyAlias']
|
|
keyPassword keystoreProperties['keyPassword']
|
|
storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
|
|
storePassword keystoreProperties['storePassword']
|
|
}
|
|
}
|
|
buildTypes {
|
|
release {
|
|
signingConfig signingConfigs.release
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
#### 3. 构建
|
|
|
|
```bash
|
|
# 生成密钥库 (首次)
|
|
keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
|
|
|
|
# 构建 Release APK
|
|
flutter build apk --release
|
|
|
|
# 构建 App Bundle (Google Play)
|
|
flutter build appbundle --release
|
|
```
|
|
|
|
#### 4. 安装测试
|
|
|
|
```bash
|
|
# 查看设备
|
|
adb devices
|
|
|
|
# 安装 APK
|
|
adb install build/app/outputs/flutter-apk/app-release.apk
|
|
```
|
|
|
|
---
|
|
|
|
### Windows 打包
|
|
|
|
#### 1. 安装 Visual Studio
|
|
|
|
- 下载 [Visual Studio Community](https://visualstudio.microsoft.com/)
|
|
- 安装时选择 "使用 C++ 的桌面开发"
|
|
- 安装 Windows 10 SDK
|
|
|
|
#### 2. 构建
|
|
|
|
```bash
|
|
# PowerShell
|
|
flutter build windows --release
|
|
|
|
# 或使用脚本
|
|
.\scripts\build-windows.ps1
|
|
```
|
|
|
|
#### 3. 创建安装包
|
|
|
|
```bash
|
|
# 进入构建目录
|
|
cd build\windows\runner\Release
|
|
|
|
# 复制所有文件到发布目录
|
|
mkdir mobile-eda-v1.1.0
|
|
copy * mobile-eda-v1.1.0\
|
|
|
|
# 压缩
|
|
Compress-Archive -Path mobile-eda-v1.1.0\* -DestinationPath mobile-eda-v1.1.0-windows-x64.zip
|
|
```
|
|
|
|
#### 4. 创建快捷方式 (可选)
|
|
|
|
使用 [Inno Setup](https://jrsoftware.org/isinfo.php) 创建安装程序：
|
|
|
|
```iss
|
|
[Setup]
|
|
AppName=Mobile EDA
|
|
AppVersion=1.1.0
|
|
DefaultDirName={pf}\MobileEDA
|
|
DefaultGroupName=Mobile EDA
|
|
OutputDir=installer
|
|
|
|
[Files]
|
|
Source: "build\windows\runner\Release\*"; DestDir: "{app}"
|
|
|
|
[Icons]
|
|
Name: "{group}\Mobile EDA"; Filename: "{app}\mobile_eda.exe"
|
|
```
|
|
|
|
---
|
|
|
|
### Linux 打包
|
|
|
|
#### 1. 安装依赖
|
|
|
|
```bash
|
|
# Ubuntu/Debian
|
|
sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev
|
|
|
|
# Fedora
|
|
sudo dnf install clang cmake ninja-build pkg-config gtk3-devel
|
|
```
|
|
|
|
#### 2. 构建
|
|
|
|
```bash
|
|
flutter build linux --release
|
|
```
|
|
|
|
#### 3. 创建 AppImage (可选)
|
|
|
|
```bash
|
|
# 安装 linuxdeploy
|
|
wget https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage
|
|
chmod +x linuxdeploy-x86_64.AppImage
|
|
|
|
# 创建 AppImage
|
|
./linuxdeploy-x86_64.AppImage --appdir AppDir -e build/linux/x64/release/bundle/mobile_eda -d mobile-eda.desktop -i icons/mobile_eda.png --output appimage
|
|
```
|
|
|
|
#### 4. 创建 DEB 包 (可选)
|
|
|
|
```bash
|
|
# 使用 flutter_debianizer
|
|
flutter pub add dev:flutter_debianizer
|
|
flutter debianize
|
|
cd debian
|
|
dpkg-buildpackage -us -uc -b
|
|
```
|
|
|
|
---
|
|
|
|
### Web 打包
|
|
|
|
#### 1. 构建
|
|
|
|
```bash
|
|
flutter build web --release
|
|
```
|
|
|
|
#### 2. 部署
|
|
|
|
**GitHub Pages**:
|
|
```bash
|
|
# 安装 deploy_to_github
|
|
flutter pub add deploy_to_github
|
|
|
|
# 部署
|
|
flutter pub run deploy_to_github
|
|
```
|
|
|
|
**Netlify**:
|
|
```bash
|
|
# 安装 Netlify CLI
|
|
npm install -g netlify-cli
|
|
|
|
# 部署
|
|
netlify deploy --prod --dir=build/web
|
|
```
|
|
|
|
**Vercel**:
|
|
```bash
|
|
# 安装 Vercel CLI
|
|
npm install -g vercel
|
|
|
|
# 部署
|
|
vercel --prod
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 文件大小优化
|
|
|
|
### 减少 APK 大小
|
|
|
|
```bash
|
|
# 启用代码压缩
|
|
# android/app/build.gradle
|
|
buildTypes {
|
|
release {
|
|
minifyEnabled true
|
|
shrinkResources true
|
|
}
|
|
}
|
|
|
|
# 只保留需要的语言
|
|
# android/app/build.gradle
|
|
android {
|
|
defaultConfig {
|
|
resConfigs "en", "zh"
|
|
}
|
|
}
|
|
```
|
|
|
|
### 减少 Windows 大小
|
|
|
|
```bash
|
|
# 使用 flutter build windows --split-debug-info
|
|
flutter build windows --release --split-debug-info=symbols
|
|
|
|
# 压缩 DLL
|
|
upx --best *.dll
|
|
```
|
|
|
|
---
|
|
|
|
## 🔍 常见问题
|
|
|
|
### Q: Android 构建失败 "SDK not found"
|
|
|
|
**A**: 确保 ANDROID_HOME 环境变量已设置
|
|
|
|
```bash
|
|
export ANDROID_HOME=$HOME/Android/Sdk
|
|
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
|
|
```
|
|
|
|
### Q: Windows 构建失败 "Visual Studio not found"
|
|
|
|
**A**: 安装 Visual Studio 2019+ 并选择 "使用 C++ 的桌面开发"
|
|
|
|
### Q: Linux 构建失败 "GTK not found"
|
|
|
|
**A**: 安装 GTK+3 开发库
|
|
|
|
```bash
|
|
sudo apt-get install libgtk-3-dev
|
|
```
|
|
|
|
### Q: Web 构建后白屏
|
|
|
|
**A**: 检查 `baseHref` 配置
|
|
|
|
```bash
|
|
flutter build web --base-href /your-repo-name/
|
|
```
|
|
|
|
---
|
|
|
|
## 📈 性能基准
|
|
|
|
| 平台 | 启动时间 | 内存占用 | 包大小 |
|
|
|------|----------|----------|--------|
|
|
| Android | <2s | ~150MB | 25MB |
|
|
| Windows | <3s | ~200MB | 50MB |
|
|
| Linux | <2s | ~180MB | 45MB |
|
|
| Web | <5s | ~100MB | 5MB (gzip) |
|
|
|
|
---
|
|
|
|
## 📝 发布清单
|
|
|
|
### Android (Google Play)
|
|
|
|
- [ ] 签名配置
|
|
- [ ] App Bundle 构建
|
|
- [ ] 隐私政策
|
|
- [ ] 应用截图
|
|
- [ ] 描述文案
|
|
- [ ] 提交审核
|
|
|
|
### Windows (官网下载)
|
|
|
|
- [ ] 代码签名证书 (可选)
|
|
- [ ] 安装包制作
|
|
- [ ] 官网下载页
|
|
- [ ] 更新机制
|
|
|
|
### Linux (Snap/Flatpak)
|
|
|
|
- [ ] Snapcraft 配置
|
|
- [ ] Flatpak 清单
|
|
- [ ] 提交到商店
|
|
|
|
### Web (在线使用)
|
|
|
|
- [ ] 域名配置
|
|
- [ ] HTTPS 证书
|
|
- [ ] CDN 加速
|
|
- [ ] SEO 优化
|
|
|
|
---
|
|
|
|
## 🔗 相关链接
|
|
|
|
- [Flutter 官方打包文档](https://docs.flutter.dev/deployment)
|
|
- [Android 签名配置](https://docs.flutter.dev/deployment/android)
|
|
- [Windows 打包指南](https://docs.flutter.dev/deployment/windows)
|
|
- [Linux 打包指南](https://docs.flutter.dev/deployment/linux)
|
|
- [Web 部署指南](https://docs.flutter.dev/deployment/web)
|
|
|
|
---
|
|
|
|
**文档版本**: v1.0
|
|
**最后更新**: 2026-03-07
|