Linux 制作 snap 包

Snap 是 Canonical（科能公司）开发的通用 Linux 软件包格式，可以在任何支持 snap 的 Linux 发行版上运行。Snap 包是自包含的，包含了应用程序及其所有依赖项，提供了更好的安全性和隔离性。

什么是 snap 包

Snap 是开发者打包应用的新途径，它相对于传统包格式（如 .deb、.rpm）带来了许多优点。Snap 的主要特点包括：

安全性：使用沙盒隔离，应用彼此隔离
跨发行版：一个 snap 包可以在所有支持 snap 的 Linux 发行版上运行
自包含：包含所有依赖，无需担心依赖冲突
自动更新：支持自动更新机制
回滚支持：可以回滚到之前的版本
事务性：安装和更新是原子操作

适用场景：

跨发行版软件分发
需要沙盒隔离的应用
需要自动更新的应用
包含复杂依赖的应用

必备知识

在开始制作 snap 包之前，你需要了解：

Linux 基础知识：熟悉命令行操作
YAML 语法：snapcraft.yaml 使用 YAML 格式
应用程序结构：了解你的应用程序的文件结构
Snap 概念：了解 snap、snapd、snapcraft 的概念

准备工作

安装 snapd

snapd 是运行 snap 包的后台服务，默认内置于 Ubuntu 16.04 及更高版本。

# Ubuntu（通常已预装）
# 检查是否已安装
snap --version

# 如果未安装
sudo apt update
sudo apt install -y snapd

# CentOS/RHEL 7
sudo yum install -y epel-release
sudo yum install -y snapd
sudo systemctl enable --now snapd.socket

# CentOS/RHEL 8+ / Fedora
sudo dnf install -y snapd
sudo systemctl enable --now snapd.socket

# 创建符号链接（某些系统需要）
sudo ln -s /var/lib/snapd/snap /snap

安装 snapcraft

snapcraft 是创建 snap 包的工具：

# Ubuntu
sudo apt install -y snapcraft

# 或使用 snap 安装
sudo snap install snapcraft --classic

# 验证安装
snapcraft --version

snap 包结构

snap 包的基本结构：

snap/
├── snapcraft.yaml    # Snap 包定义文件（必需）
└── ...

构建后的 snap 包是一个 .snap 文件，实际上是一个压缩的 squashfs 文件系统。

制作 snap 包

创建项目目录

# 创建项目目录
mkdir myapp-snap
cd myapp-snap

# 创建 snap 目录
mkdir snap

创建 snapcraft.yaml

snapcraft.yaml 是 snap 包的核心配置文件：

snapcraft.yaml
name: myapp
version: '1.0.0'
summary: A simple application
description: |
  This is a simple application used to demonstrate
  snap package creation.

grade: stable
confinement: strict

apps:
  myapp:
    command: myapp
    plugs: []

parts:
  myapp:
    plugin: dump
    source: .
    organize:
      myapp: bin/myapp

基本配置说明

name：snap 包名（必须唯一，只能包含小写字母、数字和连字符）
version：版本号
summary：简短描述（最多 79 个字符）
description：详细描述
grade：质量等级（stable 或 devel）
confinement：安全模式（strict、devmode 或 classic）
apps：定义应用程序入口点
parts：定义构建部分

构建 snap 包

# 在项目根目录执行
snapcraft

# 构建完成后会生成
ls -lh myapp_1.0.0_amd64.snap

安装和测试

# 安装 snap 包
sudo snap install myapp_1.0.0_amd64.snap --dangerous

# 运行应用
myapp

# 查看已安装的 snap
snap list

# 卸载
sudo snap remove myapp

实际示例

示例 1：打包一个 Shell 脚本

1. 准备应用程序

mkdir myapp-snap
cd myapp-snap

# 创建简单的脚本
cat > myapp << 'EOF'
#!/bin/bash
echo "Hello from myapp!"
echo "Version: 1.0.0"
EOF

chmod +x myapp

2. 创建 snapcraft.yaml

snapcraft.yaml
name: myapp
version: '1.0.0'
summary: A simple shell script application
description: |
  This is a simple shell script application used to
  demonstrate snap package creation.

grade: stable
confinement: strict

apps:
  myapp:
    command: myapp
    plugs: []

parts:
  myapp:
    plugin: dump
    source: .
    organize:
      myapp: bin/myapp

3. 构建和安装

snapcraft
sudo snap install myapp_1.0.0_amd64.snap --dangerous
myapp

示例 2：打包一个 Python 应用

1. 准备应用程序

mkdir myapp-snap
cd myapp-snap

# 创建 Python 应用
cat > myapp.py << 'EOF'
#!/usr/bin/env python3
import sys
print("Hello from myapp!")
print("Version: 1.0.0")
EOF

chmod +x myapp.py

2. 创建 snapcraft.yaml

snapcraft.yaml
name: myapp
version: '1.0.0'
summary: A simple Python application
description: |
  This is a simple Python application used to
  demonstrate snap package creation.

grade: stable
confinement: strict

apps:
  myapp:
    command: myapp
    plugs: []

parts:
  myapp:
    plugin: python
    source: .
    python-version: python3
    organize:
      myapp.py: bin/myapp

3. 构建和安装

snapcraft
sudo snap install myapp_1.0.0_amd64.snap --dangerous
myapp

示例 3：打包一个 C 程序

1. 准备应用程序

mkdir myapp-snap
cd myapp-snap

# 创建 C 程序
cat > myapp.c << 'EOF'
#include <stdio.h>
int main() {
    printf("Hello from myapp!\n");
    printf("Version: 1.0.0\n");
    return 0;
}
EOF

# 创建 Makefile
cat > Makefile << 'EOF'
CC=gcc
CFLAGS=-Wall
TARGET=myapp

$(TARGET): myapp.c
	$(CC) $(CFLAGS) -o $(TARGET) myapp.c

clean:
	rm -f $(TARGET)
EOF

2. 创建 snapcraft.yaml

snapcraft.yaml
name: myapp
version: '1.0.0'
summary: A simple C application
description: |
  This is a simple C application used to
  demonstrate snap package creation.

grade: stable
confinement: strict

apps:
  myapp:
    command: myapp
    plugs: []

parts:
  myapp:
    plugin: make
    source: .
    build-packages:
      - gcc
    organize:
      myapp: bin/myapp

3. 构建和安装

snapcraft
sudo snap install myapp_1.0.0_amd64.snap --dangerous
myapp

snapcraft.yaml 详解

插件类型

Snapcraft 支持多种插件来构建不同类型的应用：

dump：直接复制文件，不做任何处理
python：Python 应用
nodejs：Node.js 应用
make：使用 Makefile 构建
cmake：使用 CMake 构建
autotools：使用 autotools 构建
go：Go 应用
rust：Rust 应用

权限和接口（Plugs）

Snap 使用接口（interfaces）来控制应用的权限：

apps:
  myapp:
    command: myapp
    plugs:
      - network
      - home
      - desktop

常用接口：

network：网络访问
home：访问用户主目录
desktop：桌面集成
audio-playback：音频播放
camera：摄像头访问
pulseaudio：PulseAudio 访问

构建包和依赖

parts:
  myapp:
    plugin: make
    build-packages:      # 构建时需要的包
      - gcc
      - make
    stage-packages:      # 运行时需要的包
      - libssl1.1

环境变量

apps:
  myapp:
    command: myapp
    environment:
      MYAPP_CONFIG: $SNAP_USER_DATA/config
      PATH: $SNAP/usr/bin:$PATH

服务应用

如果应用需要作为服务运行：

apps:
  myapp:
    command: myapp
    daemon: simple
    restart-condition: on-failure

高级配置

多部分构建

parts:
  myapp-core:
    plugin: make
    source: src/
  
  myapp-ui:
    plugin: dump
    source: ui/
    after: [myapp-core]

使用外部源码

parts:
  myapp:
    plugin: make
    source: https://github.com/user/repo.git
    source-tag: v1.0.0

使用本地源码

parts:
  myapp:
    plugin: make
    source: ../myapp-source

测试 snap 包

本地测试

直接在本地安装、测试：

# 安装并测试
sudo snap install myapp_1.0.0_amd64.snap --dangerous
myapp

# 查看 snap 信息
snap info myapp

# 查看 snap 文件
snap list myapp

使用 snap try

如果还在开发过程中，可以使用 snap try 快速测试：

# 创建可安装的目录结构
mkdir -p snap-try/bin
cp myapp snap-try/bin/

# 尝试安装
sudo snap try snap-try/

# 运行
myapp

# 卸载
sudo snap remove myapp

发布 snap 包

注册 Snap Store 账户

# 登录 Snap Store
snapcraft login

# 注册 snap 名称
snapcraft register myapp

上传到 Snap Store

# 构建
snapcraft

# 上传（需要先登录）
snapcraft upload myapp_1.0.0_amd64.snap

# 发布到稳定通道
snapcraft release myapp 1 stable

本地安装（不发布）

如果只是本地使用，可以使用 --dangerous 标志：

sudo snap install myapp_1.0.0_amd64.snap --dangerous

常见问题排查

1. 构建失败

# 查看详细构建日志
snapcraft --debug

# 清理构建环境
snapcraft clean

# 重新构建
snapcraft

2. 权限问题

如果应用需要访问系统资源，需要在 plugs 中添加相应接口：

apps:
  myapp:
    command: myapp
    plugs:
      - network
      - home

3. 依赖问题

确保在 build-packages 和 stage-packages 中列出所有依赖：

parts:
  myapp:
    build-packages:
      - gcc
      - libssl-dev
    stage-packages:
      - libssl1.1

4. 应用无法运行

检查命令路径是否正确：

apps:
  myapp:
    command: bin/myapp  # 相对于 snap 根目录的路径

最佳实践

使用合适的插件：根据应用类型选择合适的插件
最小权限原则：只请求必要的接口权限
版本管理：使用语义化版本规范
测试充分：在多个发行版上测试
文档完整：提供清晰的描述和使用说明

总结

Snap 是一个强大的打包格式，特别适合跨发行版软件分发。制作 snap 包的基本步骤如下：1. 安装工具：安装 snapd 和 snapcraft 2. 创建项目：创建项目目录和 snapcraft.yaml 文件 3. 配置 snapcraft.yaml：定义应用信息和构建规则 4. 构建 snap 包：使用 snapcraft 构建 5. 测试安装：本地安装和测试 6. 发布（可选）：上传到 Snap Store通过正确配置 snapcraft.yaml，可以创建一个可以在所有支持 snap 的 Linux 发行版上运行的软件包。## 参考- Snapcraft 官方文档

什么是 snap 包​

必备知识​

准备工作​

安装 snapd​

安装 snapcraft​

snap 包结构​

制作 snap 包​

创建项目目录​

创建 snapcraft.yaml​

基本配置说明​

构建 snap 包​

安装和测试​

实际示例​

示例 1：打包一个 Shell 脚本​

1. 准备应用程序​

2. 创建 snapcraft.yaml​

3. 构建和安装​

示例 2：打包一个 Python 应用​

1. 准备应用程序​

2. 创建 snapcraft.yaml​

3. 构建和安装​

示例 3：打包一个 C 程序​

1. 准备应用程序​

2. 创建 snapcraft.yaml​

3. 构建和安装​

snapcraft.yaml 详解​

插件类型​

权限和接口（Plugs）​

构建包和依赖​

环境变量​

服务应用​

高级配置​

多部分构建​

使用外部源码​

使用本地源码​

测试 snap 包​

本地测试​

使用 snap try​

发布 snap 包​

注册 Snap Store 账户​

上传到 Snap Store​

本地安装（不发布）​

常见问题排查​

1. 构建失败​

2. 权限问题​

3. 依赖问题​

4. 应用无法运行​

最佳实践​

总结​

什么是 snap 包

必备知识

准备工作

安装 snapd

安装 snapcraft

snap 包结构

制作 snap 包

创建项目目录

创建 snapcraft.yaml

基本配置说明

构建 snap 包

安装和测试

实际示例

示例 1：打包一个 Shell 脚本

1. 准备应用程序

2. 创建 snapcraft.yaml

3. 构建和安装

示例 2：打包一个 Python 应用

1. 准备应用程序

2. 创建 snapcraft.yaml

3. 构建和安装

示例 3：打包一个 C 程序

1. 准备应用程序

2. 创建 snapcraft.yaml

3. 构建和安装

snapcraft.yaml 详解

插件类型

权限和接口（Plugs）

构建包和依赖

环境变量

服务应用

高级配置

多部分构建

使用外部源码

使用本地源码

测试 snap 包

本地测试

使用 snap try

发布 snap 包

注册 Snap Store 账户

上传到 Snap Store

本地安装（不发布）

常见问题排查

1. 构建失败

2. 权限问题

3. 依赖问题

4. 应用无法运行

最佳实践

总结