Flutter构建Debian包插件flutter_build_debian的使用

Flutter构建Debian包插件flutter_build_debian的使用

flutter_build_debian是一个简单的命令行工具，帮助你将你的Flutter应用程序打包成一个可以用于生产的Debian包。

Debian包构建概述 📦

这个插件基于debian.yaml文件中的指令构建Debian包。为了更好地理解和掌握核心概念，可以查看Debian文档。

flutter_build_debian YAML示例

将yaml文件放置在你的Flutter项目的根目录下，路径为<项目根目录>/debian/debian.yaml。例如：

flutter_app: 
  command: mega_cool_app
  arch: x64
  parent: /usr/local/lib
  nonInteractive: false

control:
  Package: mega-cool-app
  Version: 1.0.0
  Architecture: amd64
  Priority: optional
  Depends:
  Maintainer:
  Description: Mega Cool App that does everything!

以下部分解释了YAML文件中的各个部分。

Flutter应用配置

flutter_app: 
  command: mega_cool_app
  arch: x64
  parent: /usr/local/lib
  nonInteractive: false

命令

指向你的Linux发布包中的二进制文件，并在调用Debian包时运行。

架构

你的应用的构建架构。

执行字段代码

Exec键在桌面文件中的字段代码列表，以逗号分隔。

示例: execFieldCodes: f,u,i 支持的代码: f, F, u, U, i, c, k

更多信息请参见FreeDesktop规范。

父目录

应用程序将安装在这个目录下的子目录中（如mega_cool_app）。

非交互式

当设置为true时，在包安装过程中不会显示确认提示。

默认值: /opt

示例:

parent: /usr/local/lib

目标目录为/usr/local/lib/mega_cool_app

包维护脚本

如果存在debian/scripts目录，则该目录下的可执行文件（如preinst、postinst、prerm和postrm）将被复制到包中作为Debian包维护脚本。

注意：任何preinst脚本都会覆盖由此工具生成的默认脚本，从而禁用安装前的交互确认提示（就像设置了nonInteractive: true一样）。

额外文件

如果存在debian/skeleton目录，这些文件将被复制到包中。

这可用于默认配置文件。

示例:

debian/skeleton/etc/megacool/main.conf 将被安装为 /etc/megacool/main.conf

控制信息

这是向APT包管理器或其他软件描述你的应用的信息。

依赖项

列出你的项目所依赖的库，这些库将在你的应用安装到系统之前通过APT包管理器进行安装。

例如：

pub.dev上的flutter_secure_storage Linux版本依赖于libsecret-1-0和libjsoncpp1

注意：多个依赖项用逗号分隔。

桌面文件和图标 🖥️

桌面入口文件用于将应用添加到桌面菜单。这些文件指定了应用的名称和图标、所属类别、相关搜索关键词等。这些文件扩展名为.desktop，遵循XDG桌面入口规范。

Flutter mega-cool-app.desktop示例

将.desktop文件放置在你的Flutter项目的根目录下，路径为<项目根目录>/debian/gui/mega-cool-app.desktop。

注意: 图标和.desktop文件名必须与yaml文件中的应用名相同。

例如：

[Desktop Entry]
Version=1.0
Name=Mega Cool App
GenericName=Mega Cool App
Comment=A Mega Cool App that does everything
Terminal=false
Type=Application
Categories=Utility
Keywords=Flutter;share;files;

将带有.png扩展名的图标放置在你的Flutter项目的根目录下，路径为<项目根目录>/debian/gui/mega-cool-app.png。

构建Debian包 📦

一旦gui/文件夹和debian.yaml文件准备就绪，从项目的根目录运行flutter_build_debian。

首先构建你的项目：

$ flutter build linux

如果尚未安装flutter_build_debian，则先安装它：

$ dart pub global activate flutter_build_debian

然后运行flutter_build_debian：

$ flutter_build_debian

查找并安装你的.deb应用包 📦

从项目的根目录开始查找：

$ cd debian/packages && ls

安装：

$ sudo dpkg -i [package_name].deb

依赖项查找

flutter_build_debian命令可以用来查找一组库文件的依赖项。

运行flutter_build_debian help可以看到这个描述：

Usage: flutter_build_debian [<mode> [<options>] ]
<mode>:
  help
    Print this usage.
  create
    Creates a folder and template files for the Debian package.
  build
    Build a Debian package file *.deb. This is the default mode.
  dependencies [<opts>] [<file1> [ <file2>...]]
    Detects the dependencies of a amount of library files.
    <fileX> can be a file or a directory.
<opts>:
   --excluded-packages=<comma-separated-list-of-names>
     That packages will be excluded from detection
   --excluded-libraries=<pattern>
     Excludes that library files from detection. <pattern> is a regular expr.
Examples:
flutter_build_debian
  Creates the Debian package described in ./debian/debian.yaml
flutter_build_debian dependencies
  Detects the dependencies of the files in ./build/linux/x64/release/bundle/lib
  and uses the information of debian/debian.yaml
flutter_build_debian dependencies --excl-lib=-dev|^my_lib release/libs
  Detects the dependencies of the files in release/libs without the excluded
  specified by "-dev|^my_lib":
  The file release/libs/our_lib-dev.2.so and release/libs/my_lib-dev.2.so
  will be excluded from detection.
flutter_build_debian dependencies --excluded-packages=lintian,my-project prod/libs
  Detects the dependencies of the files in prod/libs
  The packages lintian and my-project will be excluded from processing.
Note: modes and options can be abbreviated: --ex-pack means --excluded-packages