在典型的开发周期中,你可以在命令行中使用 flutter run 或在 IDE 中使用运行调试选项来测试应用。默认情况下,Flutter 会构建你应用的调试版本。

当你准备好应用的发布版本时(例如要发布到 Snap Store其他通道),本页面可以为你提供帮助。

前提条件

#

要构建并发布到 Snap Store,你需要以下组件:

设置构建环境

#

使用以下说明设置你的构建环境。

安装 snapcraft

#

在命令行中,运行以下命令:

sudo snap install snapcraft --classic

安装 LXD

#

要安装 LXD,请使用以下命令:

sudo snap install lxd

在 snap 构建过程中需要 LXD。安装后,需要配置 LXD 才能使用。默认答案适用于大多数用例。

sudo lxd init
Would you like to use LXD clustering? (yes/no) [default=no]:
Do you want to configure a new storage pool? (yes/no) [default=yes]:
Name of the new storage pool [default=default]:
Name of the storage backend to use (btrfs, dir, lvm, zfs, ceph) [default=zfs]:
Create a new ZFS pool? (yes/no) [default=yes]:
Would you like to use an existing empty disk or partition? (yes/no) [default=no]:
Size in GB of the new loop device (1GB minimum) [default=5GB]:
Would you like to connect to a MAAS server? (yes/no) [default=no]:
Would you like to create a new local network bridge? (yes/no) [default=yes]:
What should the new bridge be called? [default=lxdbr0]:
What IPv4 address should be used? (CIDR subnet notation, "auto" or "none") [default=auto]:
What IPv6 address should be used? (CIDR subnet notation, "auto" or "none") [default=auto]:
Would you like LXD to be available over the network? (yes/no) [default=no]:
Would you like stale cached images to be updated automatically? (yes/no) [default=yes]
Would you like a YAML "lxd init" preseed to be printed? (yes/no) [default=no]:

首次运行时,LXD 可能无法连接到其套接字:

An error occurred when trying to communicate with the 'LXD'
provider: cannot connect to the LXD socket
('/var/snap/lxd/common/lxd/unix.socket').

这意味着你需要将你的用户名添加到 LXD (lxd) 组中,因此请退出会话,然后重新登录。

sudo usermod -a -G lxd <your username>

snapcraft 概述

#

snapcraft 工具根据 snapcraft.yaml 文件中列出的指令构建 snap。要基本了解 snapcraft 及其核心概念,请查阅 Snap 文档《snapcraft 简介》。更多链接和信息列在本页面底部。

Flutter snapcraft.yaml 示例

#

将 YAML 文件放置在 Flutter 项目的 <项目根目录>/snap/snapcraft.yaml 下。(请记住,YAML 文件对空格敏感!)例如:

yaml
name: super-cool-app
version: 0.1.0
summary: Super Cool App
description: Super Cool App that does everything!

confinement: strict
base: core22
grade: stable

slots:
  dbus-super-cool-app: # adjust accordingly to your app name
    interface: dbus
    bus: session
    name: org.bar.super_cool_app # adjust accordingly to your app name and
    
apps:
  super-cool-app:
    command: super_cool_app
    extensions: [gnome] # gnome includes the libraries required by flutter
    plugs:
    - network
    slots:
      - dbus-super-cool-app
parts:
  super-cool-app:
    source: .
    plugin: flutter
    flutter-target: lib/main.dart # The main entry-point file of the application

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

元数据

#

snapcraft.yaml 文件的此部分定义并描述了应用程序。snap 版本从构建部分派生(采用)。

yaml
name: super-cool-app
version: 0.1.0
summary: Super Cool App
description: Super Cool App that does everything!

等级、限制和基础

#

此部分定义了 snap 的构建方式。

yaml
confinement: strict
base: core22
grade: stable
等级
指定 snap 的质量;这与后续的发布步骤相关。
限制
指定 snap 安装到最终用户系统后对系统资源的访问级别。严格限制将应用程序访问限制在特定资源(由 app 部分中的插头定义)。
基础
Snap 被设计为自包含应用程序,因此它们需要自己的私有核心根文件系统,称为 basebase 关键字指定了用于提供最少通用库集的版本,并在运行时作为应用程序的根文件系统挂载。

应用

#

此部分定义了 snap 中存在的应用程序。每个 snap 可以有一个或多个应用程序。本示例有一个应用程序——super_cool_app。

yaml
apps:
  super-cool-app:
    command: super_cool_app
    extensions: [gnome]
命令

指向二进制文件(相对于 snap 的根目录),并在调用 snap 时运行。

扩展

一个或多个扩展的列表。Snapcraft 扩展是可重用组件,可以在构建和运行时向 snap 暴露库和工具集,而无需开发人员对所包含的框架有具体了解。gnome 扩展将 GTK 3 库暴露给 Flutter snap。这确保了更小的占用空间和与系统的更好集成。

插头

一个或多个系统接口插头的列表。当 snap 受到严格限制时,这些插头是提供必要功能的必需品。此 Flutter snap 需要访问网络。

DBus 接口

DBus 接口提供了一种 snap 通过 DBus 进行通信的方式。提供 DBus 服务的 snap 声明一个带有知名 DBus 名称和其使用的总线的插槽(slot)。希望与提供 snap 服务的 snap 通信的 snap 声明一个针对提供 snap 的插头(plug)。请注意,你的 snap 需要一个 snap 声明才能通过 snap store 交付并声明此知名 DBus 名称(只需将 snap 上传到 store 并请求手动审核,审核人员就会进行查看)。

当安装了提供 snap 的服务时,snapd 将生成安全策略,允许它侦听指定总线上的知名 DBus 名称。如果指定了系统总线,snapd 还会生成 DBus 总线策略,允许“root”拥有该名称并允许任何用户与该服务进行通信。非 snap 进程可以按照传统权限检查与提供 snap 的服务进行通信。其他(消费)snap 可能只能通过连接 snap 的接口来与提供 snap 的服务进行通信。

dbus-super-cool-app: # adjust accordingly to your app name
  interface: dbus
  bus: session
  name: dev.site.super_cool_app

部分

#

此部分定义了组装 snap 所需的源。

部件可以使用插件自动下载和构建。与扩展类似,snapcraft 可以使用各种插件(如 Python、C、Java 和 Ruby)来协助构建过程。snapcraft 还有一些特殊插件。

nil 插件
不执行任何操作,实际构建过程通过手动覆盖来处理。
flutter 插件
提供必要的 Flutter SDK 工具,因此你可以直接使用,而无需手动下载和设置构建工具。
yaml
parts:
  super-cool-app:
    source: .
    plugin: flutter
    flutter-target: lib/main.dart # The main entry-point file of the application

桌面文件和图标

#

桌面入口文件用于将应用程序添加到桌面菜单。这些文件指定应用程序的名称和图标、所属类别、相关搜索关键字等。这些文件具有 .desktop 扩展名,并遵循 XDG 桌面入口规范 1.1 版。

Flutter super-cool-app.desktop 示例

#

将 .desktop 文件放置在 Flutter 项目的 <项目根目录>/snap/gui/super-cool-app.desktop 下。

注意:图标和 .desktop 文件名必须与 YAML 文件中的应用程序名称相同!

例如

yaml
[Desktop Entry]
Name=Super Cool App
Comment=Super Cool App that does everything
Exec=super-cool-app 
Icon=${SNAP}/meta/gui/super-cool-app.png # Replace name with your app name.
Terminal=false
Type=Application
Categories=Education; # Adjust accordingly your snap category.

将你的 .png 格式图标放置在 Flutter 项目的 <项目根目录>/snap/gui/super-cool-app.png 下。

构建 snap

#

snapcraft.yaml 文件完成后,在项目根目录中运行 snapcraft,如下所示:

要使用 Multipass VM 后端:

snapcraft

要使用 LXD 容器后端:

snapcraft --use-lxd

测试 snap

#

snap 构建完成后,你的项目根目录中将有一个 <名称>.snap 文件。

$ sudo snap install ./super-cool-app_0.1.0_amd64.snap --dangerous

发布

#

现在你可以发布 snap 了。过程包括以下步骤:

  1. 如果你还没有,请在 snapcraft.io 创建一个开发者帐户。
  2. 注册应用程序名称。注册可以通过 Snap Store Web UI 门户完成,也可以通过命令行完成,如下所示:
    snapcraft login
    snapcraft register
  3. 发布应用程序。阅读下一节了解如何选择 Snap Store 通道后,将 snap 推送到 store:
    snapcraft upload --release=<channel> <file>.snap

Snap Store 通道

#

Snap Store 使用通道来区分不同版本的 snap。

snapcraft upload 命令将 snap 文件上传到 store。但是,在运行此命令之前,你需要了解不同的发布通道。每个通道由三个组件组成:

轨道
所有 snap 都必须有一个名为 latest 的默认轨道。除非另有说明,否则这是隐含的轨道。
风险
定义应用程序的就绪程度。Snap Store 中使用的风险级别为:stable(稳定版)、candidate(候选版)、beta(测试版)和 edge(边缘版)。
分支
允许创建短期 snap 序列以测试错误修复。

Snap Store 自动审核

#

Snap Store 会对你的 snap 运行多项自动化检查。还可能进行手动审核,具体取决于 snap 的构建方式以及是否存在任何特定的安全问题。如果检查无误,该 snap 将在 store 中可用。

更多 snapcraft 资源

#

你可以从 snapcraft.io 网站的以下链接中了解更多信息:

更多部署资源

#

一款一体化的 Flutter 应用程序打包和分发工具,为你提供一站式解决方案,满足各种分发需求。

支持流行的打包格式,如 appimage、deb、pacman、rpm 等。

用于 Flutter 应用离线构建的 Flatpak 清单工具。

支持 Flatpak 准备,以便在 Flathub 上发布。