如何制作Debian的deb安装包及编译

Posted on Posted in 程序方程式

文章参考来源:https://wiki.debian.org/Packaging/Intro?action=show&redirect=IntroDebianPackaging

中文参考资料:https://www.debian.org/doc/manuals/maint-guide/build.zh-cn.html

  • 配置预制环境

  1. 使用apt-get install automake 将安装 autoconf{a} automake autotools-dev{a} 三个包。
  2. 使用apt-get install dh-make 将安装 debhelper dh-make html2text三个包。
  3. 使用apt-get install devscripts ,这个是使用debuild所需要的。
  • 制作Deb包

  • 创建helloworld.c

在当前目录下创建一个名为hello的子目录。进入文件夹并新建一个标准的Hello World的C代码hello.c
#include <stdio.h>
int main(int argc, char ** argv){
printf(“hello,world\n”);
return 0;
}

此时,文件夹下只有一个hello.c文件。

  • 创建一个 Makefile.am 文件

automake根据configure.in中的宏并在perl的帮助下把Makefile.am转成Makefile.in文件。Makefile.am 文件定义所要产生的目标。我们要填写的 Makefile.am 内容为以下两句:
bin_PROGRAMS=beep // bin_PROGRAMS:定义要产生的可执行程序的文件名。
beep_SOURCES=hello.c // beep_SOURCES:定义“beep”这个可执行程序所需要的原始文件。如果“beep”这个程序是由多个原始文件产生的,必须把它所用到的所有原始文件都列出来,并以空白符隔开。假设“beep”还需要“hello.c”、“main.c”、“hello.h”3个文件,则定义beep_SOURCES= hello.c main.c hello.h。如果定义多个可执行文件,则对每个可执行程序都要定义相应的filename_SOURCES,其中filename为要生成的可执行程序的文件名。

所以,beep 可以替换为你想要生成的二进制可执行文件名(后面生成deb文件也是一样的名称),如果我最终我们生成的应用名为long.deb,上面两句就写成:
bin_PROGRAMS=long
long_SOURCES=hello.c
当前我们目录下只有:hello.c Makefile.am 两个文件
$: vim Makefile.am
$: ls
hello.c Makefile.am

执行autoscan

执行autoscan命令,会生成一个configure.scan文件,将configure.scan改名为configure.in
$ autoscan
$ ls
autoscan.log configure.scan hello.c Makefile.am
$ mv configure.scan configure.in
$ ls
autoscan.log configure.in hello.c Makefile.am

configure.in 文件的内容是一系列GNU m4 的宏,这些宏经autoconf处理后会变成检查系统特性的Shell脚本。configure.in文件中宏的顺序并没有特别的规定,但是每一个configure.in 文件必须以宏AC_INIT开头,以宏AC_OUTPUT结束。

修改configure.in文件

打开configure.in文件我们会看到自动生成的configure.in(scan)包括以下内容:
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.69]) // 此行是描述需要的工具兼容性,如我们使用的是autotools工具版本是2.69,这个自动生成不要修改!
AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS]) // 此行是描述我们要生成的应用的信息,包括:应用名,版本号以及维护人邮箱(直译为反馈bug地址)。比如我们需要将此行修改成 AC_INIT([beep], [0.1], [reaper888@yeah.net])
//下面两行形容的是软件包的地址和名称,以便autotools开始工作
AC_CONFIG_SRCDIR([hello.c])
AC_CONFIG_HEADERS([config.h])

// 在这我们需要加入一行“ AM_INIT_AUTOMAKE ”,如果没有此行,在部分系统生成Makefile时会报错而且生成不了Makefile文件。
# Checks for programs.
AC_PROG_CC//这句高速autotools使用默认的编译器和binutils,当然你也可以传入类似于“ AC_PROG_CC([gcc gcc-4.7]) ”的参数,我们不传参,使用默认即可

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.
// 下面不变
AC_CONFIG_FILES([Makefile])// 设置configure命令所要产生的文件。我们最终期望产生Makefile
AC_OUTPUT

所以,经过修改后,我们的configure.in文件是:
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.69])
AC_INIT([beep], [0.1], [reaper888@yeah.net])
AC_CONFIG_SRCDIR([hello.c])
AC_CONFIG_HEADERS([config.h])
AM_INIT_AUTOMAKE
# Checks for programs.
AC_PROG_CC

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_CONFIG_FILES([Makefile])
AC_OUTPUT

执行autoheader和aclocal命令

$ automake
configure.in:8: required file `./install-sh’ not found
configure.in:8: `automake –add-missing’ can install `install-sh’
configure.in:8: required file `./missing’ not found
configure.in:8: `automake –add-missing’ can install `missing’
Makefile.am: required file `./INSTALL’ not found
Makefile.am: `automake –add-missing’ can install `INSTALL’
Makefile.am: required file `./NEWS’ not found
Makefile.am: required file `./README’ not found
Makefile.am: required file `./AUTHORS’ not found
Makefile.am: required file `./ChangeLog’ not found
Makefile.am: required file `./COPYING’ not found
Makefile.am: `automake –add-missing’ can install `COPYING’
所以,根据提示,我们缺少 NEWS、README、AUTHORS、ChangeLog和COPYING,而使用automake –add-missing会生成COPYING,所以在此之前我们需要手动添加这几个文件:
$ touch NEWS README AUTHORS ChangeLog
$ ls
aclocal.m4 autom4te.cache ChangeLog configure.in Makefile.am README
AUTHORS autoscan.log config.h.in hello.c NEWS
注:这是我在演示如何使用autotools,如果是你真得要发布软件,请仔细填写这几个文件,而不是使用touch生成一个空文件。

现在我们可以使用automake –add-missing:
$ automake –add-missing
configure.in:8: installing `./install-sh’
configure.in:8: installing `./missing’
Makefile.am: installing `./INSTALL’
Makefile.am: installing `./COPYING’ using GNU General Public License v3 file
Makefile.am: Consider adding the COPYING file to the version control system
Makefile.am: for your code, to avoid questions about which license your project uses.
$ ls
aclocal.m4 autom4te.cache ChangeLog configure.in hello.c install-sh Makefile.in NEWS
AUTHORS autoscan.log config.h.in COPYING INSTALL Makefile.am missing README
会发现,现在使用automake很顺利,而且生成了INSTALL、COPYING等文件。

使用autoconf

$ ls
aclocal.m4  autom4te.cache  ChangeLog    configure.in  hello.c  install-sh   Makefile.in  NEWS
AUTHORS     autoscan.log    config.h.in  COPYING       INSTALL  Makefile.am  missing      README
$ autoconf 
$ ls
aclocal.m4  autom4te.cache  ChangeLog    configure     COPYING  INSTALL     Makefile.am  missing  README
AUTHORS     autoscan.log    config.h.in  configure.in  hello.c  install-sh  Makefile.in  NEWS
所以,我们可以看到,使用autoconf命令生成了configure。

执行./configure和make

$:./configure

…(略)

$:make

..(略)

此时,在当前目录下有Makefile文件,我们可以做的工作有:
* make all:产生设定的目标,即生成所有的可执行文件。使用make也可以达到此目的。
* make clean:删除之前编译时生成的可执行文件及目标文件(形如*.o的中间文件)。
* make distclean:除了删除可执行文件和目标文件以外,把configure所产生的 Makefile文件也清除掉。通常在发布软件前执行该命令。
* make install:将使用make all或make命令产生的可执行文件以软件的形式安装到系统中。若使用bin_PROGRAMS宏,程序将会被安装到 /usr/local/bin下,否则安装到预定义的目录下。
* make dist:将程序和相关的文档包装为一个压缩文档以供发布。执行完该命令,在当前目录下会产生一个名为PACKAGE-VERSION.tar.gz的文件。PACKAGE 和 VERSION 这两个参数是来自configure.in文件中的AM_INIT_AUTOMAKE(PACKAGE,
VERSION)。如在上个例子中执行make dist命令,会产生名为“hello-1.0.tar.gz”的文件。
* make distcheck:与make dist类似,但是加入了检查包装以后的压缩文件是否正常。

make dist提取源程序包

下面,我们做的可是高端大气上档次的工作 — 生成可发布的Debian应用包 — deb文件。(Debian系Linux专属哦)
首先,我们使用“ make dist ”命令,make dist将程序和相关的文档包装为一个压缩文档以供发布。从此,你将再也不想手动写Makefile!!
$ make dist
if test -d “beep-0.1”; then find “beep-0.1” -type d ! -perm -200 -exec chmod u+w {} ‘;’ && rm -rf “beep-0.1” || { sleep 5 && rm -rf “beep-0.1”; }; else :; fi
test -d “beep-0.1” || mkdir “beep-0.1”
test -n “” \
|| find “beep-0.1” -type d ! -perm -755 \
-exec chmod u+rwx,go+rx {} \; -o \
! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
! -type d ! -perm -400 -exec chmod a+r {} \; -o \
! -type d ! -perm -444 -exec /bin/bash /tmp/hello/install-sh -c -m a+r {} {} \; \
|| chmod -R a+r “beep-0.1”
tardir=beep-0.1 && ${TAR-tar} chof – “$tardir” | GZIP=–best gzip -c >beep-0.1.tar.gz
if test -d “beep-0.1”; then find “beep-0.1” -type d ! -perm -200 -exec chmod u+w {} ‘;’ && rm -rf “beep-0.1” || { sleep 5 && rm -rf “beep-0.1”; }; else :; fi
$ ls
aclocal.m4 autoscan.log config.h config.status COPYING install-sh Makefile.in README
AUTHORS beep-0.1.tar.gz config.h.in configure hello.c Makefile missing stamp-h1
autom4te.cache ChangeLog config.log configure.in INSTALL Makefile.am NEWS
我们可以看到,目录里多了个beep-0.1.tar.gz文件。这就是我们后续工作的核心

切换新的工作目录:

$ mkdir ../hello_deb
$ cd ../hello_deb/
$ cp ../hello/beep-0.1.tar.gz ./
$ ls
beep-0.1.tar.gz
$ tar -xzf beep-0.1.tar.gz 
$ ls
beep-0.1  beep-0.1.tar.gz
$ cd beep-0.1/
$ ls
aclocal.m4  ChangeLog    configure     COPYING  install-sh   Makefile.in  NEWS
AUTHORS     config.h.in  configure.in  INSTALL  Makefile.am  missing      README

使用dh_make创建debian文件目录:

为了创建一个Debian包,我们首先要创建一个Debian控制文件,所以我们需要先配置dh_make,最基本的我们需要先配置如下两个选项(当然,还有其他更多的选项,现在我们就配置最简单的):
export DEBFULLNAME=”your name”
export DEBEMAIL=”a@b.com”
在此我们需要配置Debian包的维护人名称和邮箱,比如我就可以写:
export DEBFULLNAME=”example”
export DEBEMAIL=”example@example.com”

做好上述步骤后,我们可以使用”dh_make –single –copyright=gpl3 -f ../beep-0.1.tar.gz”,会提示一些确认信息,其中需要选择”single” (s)型包。
$ export DEBFULLNAME=”example”
$ export DEBEMAIL=”example”
$ dh_make –single –copyright=gpl3 -f ../beep-0.1.tar.gz

编辑debian/control文件

现在我们ls下当前目录,会发现当前目录下多了一个debian目录,我们cd进debian目录,打开control文件:
$ cd debian/
$ vim control
—– 下面是control内容
Source: beep // 程序包名
Section: unknown // 使用 unknown 或者misc 都可以,建议使用 misc
Priority: extra
Maintainer: Zhouyl <reaper888@yeah.net>
Build-Depends: debhelper (>= 8.0.0), autotools-dev
Standards-Version: 3.9.4
Homepage: <insert the upstream URL, if relevant> // 如果你的程序有官方网站,在此编辑上网站地址
#Vcs-Git: git://git.debian.org/collab-maint/beep.git
#Vcs-Browser: http://git.debian.org/?p=collab-maint/beep.git;a=summaryPackage: beep
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: <insert up to 60 chars description>
<insert long description, indented with spaces>

使用debuild生成deb应用包

cd ..进入beep-0.1目录,使用debuild命令
$ cd ..
$ debuild

…(略)

$ ls
beep-0.1 beep_0.1-1.dsc beep_0.1-1_i386.changes beep_0.1.orig.tar.gz
beep_0.1-1.debian.tar.gz beep_0.1-1_i386.build beep_0.1-1_i386.deb beep-0.1.tar.gz

 

发表评论