document/TranslateProject
2
0
Fork 0
mirror of https://github.com/LCTT/TranslateProject.git synced 2024-12-26 21:30:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #9612 from wxy/20180708-Getting-Started-with-Debian-Packaging

Browse Source 
PRF&PUB:20180708 Getting Started with Debian Packaging
This commit is contained in:
Xingyu.Wang 2018-07-29 11:11:55 +08:00 committed by GitHub
commit c3ebd5db22
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 47 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

112
translated/tech/20180708 Getting Started with Debian Packaging.md → published/20180708 Getting Started with Debian Packaging.md
View File

@ -1,36 +1,37 @@
从 Debian 打包 Package 开始
Debian 打包入门
======
> 创建 CardBook 软件包、本地 Debian 仓库，并修复错误。
![](http://minkush.me/img/posts/12.jpg)
我在 GSoC (译注：Google Summer Of Code，一项针对学生进行的开源项目训练营，一般在夏季进行。)的任务中有一项是为用户构建 Thunderbird 拓展。一些非常流行的拓展，比如 [‘Lightning’][1] （日记组织工具）已经拥有了 deb 包。
我在 GSoC（LCTT 译注：Google Summer Of Code，一项针对学生进行的开源项目训练营，一般在夏季进行。)的任务中有一项是为用户构建 Thunderbird <ruby>扩展<rt>add-ons</rt></ruby>。一些非常流行的扩展，比如 [Lightning][1] （日历行事历）已经拥有了 deb 包。
另外一个重要的用于管理基于 CardDav 和 vCard 标准的联系人的拓展 ‘[Cardbook][2]’ ，还没有一个 deb 包。
另外一个重要的用于管理基于 CardDav 和 vCard 标准的联系人的扩展 [Cardbook][2] ，还没有一个 deb 包。
我的导师， [Daniel][3]鼓励我去为它制作一个包，并上传到[mentors.debian.net][4]。因为这样就可以使用 `apt-get` 来安装，简化了安装流程。这篇博客描述了我如何从头开始学习和为 CardBook 创建一个 Debian 包的。
我的导师， [Daniel][3] 鼓励我去为它制作一个包，并上传到 [mentors.debian.net][4]。因为这样就可以使用 `apt-get` 来安装，简化了安装流程。这篇博客描述了我是如何从头开始学习为 CardBook 创建一个 Debian 包的。
首先，我是第一次接触打包，我在从源码构建包的基础上进行了拓展研究，并检查它的协议是是否与 [DFSG][5] 兼容。
首先，我是第一次接触打包，我在从源码构建包的基础上进行了大量研究，并检查它的协议是是否与 [DFSG][5] 兼容。
我从多个 Debian Wiki 中的指南中进行学习，比如 ‘[打包介绍][6]’, ‘[构建一个包][7]’，以及一些博客。
我从多个 Debian Wiki 中的指南中进行学习，比如 [打包介绍][6]、 [构建一个包][7]，以及一些博客。
我还学习包含在[Lightning 拓展包][8]的 amd64 文件。
我还研究了包含在 [Lightning 扩展包][8]的 amd64 文件。
我创建的包可以在[这里][9]找到。
![Debian Package!][10]
Debian 包
*Debian 包*
### 创建一个空的包
我开始于使用 `dh_make` 来创建一个 `debian` 目录。
我从使用 `dh_make` 来创建一个 `debian` 目录开始。
```
# Empty project folder
$ mkdir -p Debian/cardbook
```
```
# create files
$ dh_make\
@ -38,12 +39,12 @@ $ dh_make\
> --single \
> --packagename cardbook_1.0.0 \
> --email minkush@example.com
```
一些重要的文件，比如控制、规则、变更日志、版权文件等被初始化其中。
一些重要的文件，比如 `control`、`rules`、`changelog`、`copyright` 等文件被初始化其中。
所创建的文件的完整列表如下：
```
$ find /debian
debian/
@ -73,28 +74,19 @@ debian/menu.ex
debian/postinst.ex
debian/cardbook.substvars
debian/files
```
I gained an understanding of [Dpkg][11] package management program in Debian and its use to install, remove and manage packages.
我了解关于Debian 系统中 [Dpkg][11] 包管理器及如何用它安装、删除和管理包。
我了解了 Debian 系统中 [Dpkg][11] 包管理器及如何用它安装、删除和管理包。
我使用 `dpkg` 命令创建了一个空的包。这个命令创建一个空的包文件以及四个名为 `.changes`、`.deb`、 `.dsc`、 `.tar.gz` 的文件。
`.dsc` 文件包含所发生的修改和签名
- `.dsc` 文件包含了所发生的修改和签名
- `.deb` 文件是用于安装的主要包文件。
- `.tar.gz` （tarball）包含了源代码
`.deb` 文件是主要用于安装的包。
这个过程也在 `/usr/share` 目录下创建了 `README` 和 `changelog` 文件。它们包含了关于这个包的基本信息比如描述、作者、版本。
`.tar.gz` (tarball) 包含了源代码
这个进程也创建了`/usr/share`目录下的 README 和 变更日志文件。他们包含了关于这个包的基本信息比如描述、作者、版本。
I installed the package and checked the installed package contents. My new package mentions the version, architecture and description!
我安装这个包，并检查这个包安装的内容。我的包中包含了版本、架构和描述。
我安装这个包，并检查这个包安装的内容。我的新包中包含了版本、架构和描述。
```
$ dpkg -L cardbook
@ -105,29 +97,26 @@ $ dpkg -L cardbook
/usr/share/doc/cardbook/README.Debian
/usr/share/doc/cardbook/changelog.gz
/usr/share/doc/cardbook/copyright
```
### 包含 CardBook 源代码
在成功的创建了一个空包以后，我在包中添加了真正的 CardBook 拓展文件。 CardBook 的源代码托管在 [Gitlab][12] 上。我将所有的源码文件包含在另外一个目录，并告诉打包命令哪些文件需要包含在这个包中。
在成功的创建了一个空包以后，我在包中添加了实际的 CardBook 扩展文件。 CardBook 的源代码托管在 [Gitlab][12] 上。我将所有的源码文件包含在另外一个目录，并告诉打包命令哪些文件需要包含在这个包中。
我使用 vi 编辑器创建一个 `debian/install` 文件并列举了需要被安装额文件。在这个过程中。我花时间去学习基于 Linux 终端的文本编辑器，比如 vi 。这让我熟悉如何在 vi 中编辑、创建文件和快捷方式。
我使用 `vi` 编辑器创建一个 `debian/install` 文件并列举了需要被安装的文件。在这个过程中，我花费了一些时间去学习基于 Linux 终端的文本编辑器，比如 `vi` 。这让我熟悉如何在 `vi` 中编辑、创建文件和快捷方式。
当这些完成后，我在变更日志中更新了包的版本并记录了我所做的改变。
```
$ dpkg -l | grep cardbook
ii cardbook 1.1.0 amd64 Thunderbird add-on for address book
```
![Changelog][13]
更新完包的变更日志
*更新完包的变更日志*
在重建完成后，重要的依赖和描述可以被加入到包中。 Debian 控制文件可以用来添加额外的必须项目和依赖。
在重新构建完成后，重要的依赖和描述信息可以被加入到包中。 Debian 的 `control` 文件可以用来添加额外的必须项目和依赖。
### 本地 Debian 仓库
@ -135,68 +124,60 @@ ii cardbook 1.1.0 amd64 Thunderbird add-on for address book
```
$ sudo dpkg -i cardbook_1.1.0.deb
```
为了实际测试包的安装，我决定构建一个本地 Debian 存储库。没有它，“apt-get” 命令将无法定位包，因为它没有在 Debian 的包软件列表中。
为了实际测试包的安装，我决定构建一个本地 Debian 存储库。没有它，`apt-get` 命令将无法定位包，因为它没有在 Debian 的包软件列表中。
为了配置本地 Debian 存储库，我复制我的包 (.deb) 到放在 `/tmp` 目录中的 `Packages.gz` 文件。
为了配置本地 Debian 存储库，我复制我的包 （.deb）为放在 `/tmp` 目录中的 `Packages.gz` 文件。
![Packages-gz][14]
本地 Debian 仓库
*本地 Debian 仓库*
为了使它工作，我了解了 apt 的配置和它查找文件的路径。
为了使它工作，我了解了 `apt` 的配置和它查找文件的路径。
我研究了一种在 apt-config 中添加文件位置的方法。最后，我通过在 APT 中添加 `*.list` 文件来添加包的路径和使用 `apt-cache` 更新APT缓存来完成我的任务。
Hence, the latest CardBook version could be successfully installed by `apt-get install cardbook`
我研究了一种在 `apt-config` 中添加文件位置的方法。最后，我通过在 APT 中添加 `*.list` 文件来添加包的路径，并使用 `apt-cache` 更新APT缓存来完成我的任务。
因此，最新的 CardBook 版本可以成功的通过 `apt-get install cardbook` 来安装了。
![Package installation!][15]
使用 apt-get 安装 CardBook
*使用 apt-get 安装 CardBook*
### 修复打包错误和 Bugs
我的导师 Daniel 在这个过程中帮了我很多忙，并指导我如何进一步进行打包。他告诉我使用 [Lintian][16] 来修复打包过程中出现的常见错误和最终使用 [dput][17] 来上传 CardBook 包。
> Lintian 是一个用于发现策略问题和 Bug 的包检查器。它是 Debian 维护者们在上传包之前广泛使用的自动化检查 Debian 策略的工具。
> Lintian 是一个用于发现策略问题和 Bugs 的包检查器。它是 Debian 维护者们在上传包之前广泛使用的自动化检查 Debian 策略的工具。
我上传了该软件包的第二个更新版本到 Debian 目录中的 [Salsa 仓库][18] 的一个独立分支中。
我上传了第二个版本的到Debian 目录中的 [Salsa 仓库][18] 的一个分离分支中。
我从 Debian backports 上安装 Lintian 并学习在一个包上用它来修复错误。我研究了它在缩写上的使用错误和如何查看 Lintian 命令返回详细的内容。
我从 Debian backports 上安装 Lintian 并学习在一个包上用它来修复错误。我研究了它用在其错误信息中的缩写，和如何查看 Lintian 命令返回的详细内容。
```
$ lintian -i -I --show-overrides cardbook_1.2.0.changes
```
最初，在 `.changes` 文件上运行命令时，我惊讶地看到大量错误、警告和注释被显示出来！
最初，在 `.changes` 文件上运行命令时，我惊讶地看到显示出来了大量错误、警告和注释！
![Package Error Brief!][19]
在包上运行 Lintian 时看到的大量报错
*在包上运行 Lintian 时看到的大量报错*
![Lintian error1!][20]
详细的 Lintian 报错
*详细的 Lintian 报错*
详细的 Lintian 报错 (2) 以及更多
![Lintian error2!][23]
我花了几天时间修复于 Debian 包策略相关的一些错误。我为了消除一个简单的错误，必须仔细研究每一项策略和 Debian 的规则。为此，我参考了 [Debian 策略手册][21] 以及 [Debian 开发者参考][22]。
*详细的 Lintian 报错 (2) 以及更多*
我花了几天时间修复与 Debian 包策略违例相关的一些错误。为了消除一个简单的错误，我必须仔细研究每一项策略和 Debian 的规则。为此，我参考了 [Debian 策略手册][21] 以及 [Debian 开发者参考][22]。
我仍然在努力使它变得完美无暇，并希望很快可以将它上传到 mentors.debian.net！
如果 Debian 社区中使用 Thunderbird 的人可以帮助修复这些报错就太感谢了。
--------------------------------------------------------------------------------
via: http://minkush.me/cardbook-debian-package/
@ -204,7 +185,7 @@ via: http://minkush.me/cardbook-debian-package/
作者：[Minkush Jain][a]
选题：[lujun9972](https://github.com/lujun9972)
译者：[Bestony](https://github.com/bestony)
校对：[校对者ID](https://github.com/校对者ID)
校对：[wxy](https://github.com/wxy)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
@ -218,16 +199,17 @@ via: http://minkush.me/cardbook-debian-package/
[7]:https://wiki.debian.org/BuildingAPackage
[8]:https://packages.debian.org/stretch/amd64/lightning/filelist
[9]:https://salsa.debian.org/minkush-guest/CardBook/tree/debian-package/Debian
[10]:/img/posts/13.png
[10]:http://minkush.me/img/posts/13.png
[11]:https://packages.debian.org/stretch/dpkg
[12]:https://gitlab.com/CardBook/CardBook
[13]:/img/posts/15.png
[14]:/img/posts/14.png
[15]:/img/posts/11.png
[13]:http://minkush.me/img/posts/15.png
[14]:http://minkush.me/img/posts/14.png
[15]:http://minkush.me/img/posts/11.png
[16]:https://packages.debian.org/stretch/lintian
[17]:https://packages.debian.org/stretch/dput
[18]:https://salsa.debian.org/minkush-guest/CardBook/tree/debian-package
[19]:/img/posts/16.png (Running Lintian on package)
[20]:/img/posts/10.png
[19]:http://minkush.me/img/posts/16.png (Running Lintian on package)
[20]:http://minkush.me/img/posts/10.png
[21]:https://www.debian.org/doc/debian-policy/
[22]:https://www.debian.org/doc/manuals/developers-reference/
[23]:http://minkush.me/img/posts/17.png