Debian中Flutter应用的打包方法

Debian上Flutter应用的打包方法

一 准备环境

• 安装 Flutter SDK 并加入 PATH（如将 ~/flutter/bin 加入环境变量），执行 flutter doctor 检查环境；按需安装 Android SDK/Android Studio 并完成许可协议接受（运行一次 flutter doctor --android-licenses）。
• 安装 Linux 桌面运行依赖（示例）：sudo apt install -y curl git cmake unzip wget zsh libgtk-3-dev。
• 准备 Flutter 项目：flutter create my_app && cd my_app && flutter pub get。
• 启用 Linux 桌面支持：flutter config --enable-linux-desktop；如需图标可添加插件 flutter_launcher_icons 并执行生成命令。

二 打包为 Linux 可执行文件与 Debian 包

• 构建 Linux 可执行文件：flutter build linux，产物位于 build/linux/（包含可执行文件与资源）。
• 制作 Debian 安装包（.deb）的两种方式：
  1. 使用社区插件 flutter_build_debian
     • 在项目根目录创建 debian.yaml，示例：flutter_app:command: my_apparch: x64parent: /usr/local/libnonInteractive: false
     • 运行构建：flutter pub run flutter_build_debian，生成的 .deb 位于 build/debian/。
  2. 手动制作简易 .deb（示例）
     • 目录结构：myapp-1.0.0/DEBIAN/control 与 myapp-1.0.0/usr/bin/my_app
     • control 示例：Package: myappVersion: 1.0.0Architecture: amd64Maintainer: Your Name [email protected]: A Flutter Linux app
     • 构建与安装：dpkg-deb --build myapp-1.0.0sudo dpkg -i myapp-1.0.0.deb
• 分发与安装：将 .deb 提供给用户，使用 sudo dpkg -i xxx.deb 安装。

三 打包为 Android APK 并签名

• 生成签名密钥：keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-key-alias
• 配置签名（推荐方式）：在项目 android/app 下创建 key.properties，内容：storePassword=密码keyPassword=密码keyAlias=my-key-aliasstoreFile=…/keystore/my-release-key.jks在 android/app/build.gradle 中读取该文件并配置 signingConfigs.release，然后在 buildTypes.release 中引用。
• 构建发布 APK：flutter build apk，产物位于 build/app/outputs/flutter-apk/（常见为 app-release.apk）。
• 安装测试：flutter install（连接设备时）。

四 打包为 iOS 的说明

• 在 Debian 上无法直接完成 iOS 打包与签名，需使用 macOS + Xcode 执行 flutter build ios 并在 Xcode 中归档与导出 IPA。也可考虑使用云端构建服务或 Mac 虚拟机方案。

五 常见问题与建议

• 运行 flutter doctor 报错：优先解决 Android 许可与 SDK 组件缺失问题（运行 flutter doctor --android-licenses）。
• 构建 Linux 失败：确认已启用 Linux 桌面支持并安装 GTK 3 等依赖。
• 生成的 .deb 安装依赖不满足：在 control 的 Depends 字段中显式声明所需依赖，或先用 apt 安装依赖后再安装 .deb。
• Android 发布包无法安装或闪退：确保使用正确的发布签名配置，并核对 abiFilters 与目标设备架构匹配。