# 得包

**Repository Path**: deepin20/DebPacker

## Basic Information

- **Project Name**: 得包
- **Description**: 得包 - 图形化Debian打包工具
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-20
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DebPacker（得包）

![GitHub release (latest by date)](https://img.shields.io/badge/version-0.2.7-blue)
![License](https://img.shields.io/badge/license-MIT-green)
![Python](https://img.shields.io/badge/python-3.8+-blue)

> 图形化 Debian 软件包打包工具 —— 让打包变得像填表一样简单。

DebPacker 是一个基于 PySide6 的图形界面工具，封装了 `fpm` 和 `dpkg-deb` 的复杂命令，让你能够通过拖拽、点选等方式轻松生成 `.deb` 安装包。无论你是开发者还是 Linux 新手，都能快速上手。

![主界面预览](docs/screenshot.png)

---

## ✨ 主要特性

- **可视化文件映射**：拖拽文件或文件夹，直接指定安装到系统的目标路径。
- **依赖管理**：图形化添加软件依赖，自动写入 `control` 文件。
- **生命周期脚本**：支持 `preinst`、`postinst`、`prerm`、`postrm`，内置 Bash 语法高亮和常用模板。
- **一键打包**：自动调用 `fpm`（若已安装）或降级使用 `dpkg-deb`，无需手动编写控制文件。
- **项目保存与复用**：配置可保存为 `.fpmproj` 文件，下次一键加载。
- **导出标准 `debian/` 目录**：兼容传统 `dpkg-buildpackage` 工作流。
- **智能错误提示**：图形化告知缺失依赖，引导用户操作。

---

## 📦 安装

### 方式一：下载 .deb 包（推荐）

从 [Releases](https://gitee.com/deepin20/DebPacker/releases) 页面下载最新 `debpacker_*.deb` 文件，然后执行：

```bash
sudo dpkg -i debpacker_*.deb
```

如果提示缺少依赖，运行 `sudo apt install -f` 修复。

### 方式二：从源码运行

```bash
git clone https://gitee.com/deepin20/DebPacker.git
cd DebPacker
python3 -m venv venv
source venv/bin/activate
pip install PySide6
python run.py
```

---

## 🚀 快速使用

1. 启动 DebPacker（从开始菜单或终端执行 `debpacker`）。
2. 填写软件包信息（包名、版本、架构等）。
3. 在中央表格中添加文件映射：
   - 右键“添加行”手动输入，或
   - 直接从文件管理器拖拽文件/文件夹。
4. 在右侧“依赖”标签添加依赖（如 `python3`）。
5. 可选：在“脚本”标签编写 `postinst` 等脚本。
6. 点击工具栏 **“打包”**，稍等片刻，`.deb` 文件即生成。

详细教程请参考 [用户指南](docs/user_guide.md)。

---

## 🔧 依赖说明

- **Python 3.8+**（系统自带）
- **PySide6**：用于图形界面。若未安装，启动时会弹出提示，请根据提示选择一种方式安装：
  - **系统安装**：`sudo apt install python3-pyside6`（Deepin/UOS 可能没有该包，请改用 pip）
  - **pip 安装**：`pip install --break-system-packages PySide6`
  - **虚拟环境**：`python3 -m venv ~/debpacker-venv && ~/debpacker-venv/bin/pip install PySide6`，然后参考 [常见问题](#常见问题) 修改启动脚本。
- **fpm**（可选）：用于更高级的打包，若未安装则自动降级使用 `dpkg-deb`。安装方式：`sudo gem install fpm`（需 Ruby）。

---

## ❓ 常见问题

### 1. 安装后点击开始菜单无反应，终端运行提示 `PySide6 未安装`

请参照上方“依赖说明”安装 PySide6。若已安装在虚拟环境中，请修改 `/usr/bin/debpacker` 将 `python3` 替换为虚拟环境的完整路径，或使用用户级启动脚本。

### 2. 打包时提示 `fpm: command not found`

无需担心，DebPacker 会自动使用系统自带的 `dpkg-deb` 完成打包。

### 3. 如何卸载 DebPacker？

```bash
sudo dpkg -r debpacker
```

### 4. 项目文件 `.fpmproj` 是什么格式？

JSON 格式，方便版本管理和人工阅读。

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

开发指南请参考 [development.md](docs/development.md)。

---

## 📄 许可证

MIT License © 2026 温暖断章

---

## 🙏 致谢

- [fpm](https://github.com/jordansissel/fpm) —— 强大的打包工具
- [PySide6](https://wiki.qt.io/Qt_for_Python) —— Qt 的 Python 绑定

---

**觉得好用？点个 ⭐ Star 支持我们！**