[Bug #2480] applications介绍文档
Signed-off-by: Zhu Yingchun <yczhu@linx-info.com>
This commit is contained in:
Zhu Yingchun
136
intro-applications-repository.md
Normal file
136
intro-applications-repository.md
Normal file
@@ -0,0 +1,136 @@
|
||||
# applications介绍
|
||||
|
||||
本文档主要用来介绍applications目录的结构，各个子目录，以及其中包含的各种文件的用途。预期达到的效果是，让首次将applications.git库克隆到本地的用户能够通过阅读此文档，对applications目录的内容有个总体的了解。
|
||||
|
||||
咱们知道，applications.git是gitlab上的一个git库，具体存放位置[点击这里查看](git@gitlab.rd.in.linx:linx6.0.42/applications.git)。当咱们通过git clone这条命令，将这个版本库克隆到本地机器上的时候，同时会创建出此git库的工作区，在本地机器上的表现形式就是创建了一个applications目录，本文档的介绍也就是从这里开始的。
|
||||
|
||||
:zap:注意：在这篇文档中，我在刻意强调git工作区（git workspace)和git库（git repository)的区别，就我目前的理解，我认为在哪个目录下初始化了git（git init），哪里就是git工作区；而git库是在工作区中的隐藏目录.git。
|
||||
|
||||
## 1.applications的用途
|
||||
|
||||
GNU/Linux操作系统（GNU/Linux OS）本身是由linux内核和特定GNU应用软件组成的，所以，一个特定版本的OS对应着很多软件包，我们可以称之为软件仓库。怎么样才能有效地管理这个软件仓库，对GNU/Linux OS的维护者而言是非常值得研究的问题。很明显，这会在很大程度上降低管理大量软件包的繁琐程度，给OS维护人员带来方便，提高维护人员的工作效率。
|
||||
因为在管理rocky6.0.42.41这个OS的软件包时选择了git这个工具，远程git库的管理用的是gitlab，所以才有了克隆applications.git库，然后在本地自动创建了applications工作区的过程。
|
||||
所以说，本地的applications目录，就是维护rocky6.0.42.41的工作区。在它的子目录packages下存放的是rocky6.0.42.41用到的所有软件包，因此维护rocky6.0.42.41的工作基本上都是在这个里进行的，升级或者更换了packages目录下的软件包，就等于是升级或者更换了rocky6.0.42.41的软件包，至于为什么会这样，可以阅读另一篇文档[点击这里查看](http://gitlab.rd.in.linx/linx6.0.42/documents/blob/master/workflow.md)，或许有一定的帮助。
|
||||
|
||||
在applications目录下还有另外一个子目录build，这个是在rocky6.0.42.41以前的OS生成镜像文件时用到的目录，现在已经不再使用了，所以可以不用管它。下面将会对applications的packages子目录进行介绍。
|
||||
|
||||
## 2.applications的组织结构
|
||||
|
||||
将git库克隆到本地机器后，会创建出维护rocky6.0.42.41的工作区，即applications目录，所以这里就以介绍这个目录里的内容为中心展开，包括各个目录，子目录，目录中的文件，以及它们的作用，但是由于目前已经不再使用build子目录中的内容，所以不再介绍这个目录。
|
||||
|
||||
### 2.1 applications的目录树结构
|
||||
|
||||
下面是通过“tree applications”命令显示出来的applications目录的结构，其中省略了大量的子目录。当你用ls查看一下你本地的工作区applications，你会发现工作区的目录层级结构是非常简单的，很容易看清楚。所以，省略的这些子目录对于本文档的预期目标是无关紧要的。尽管如此，下面还是列出了一些子目录，这样做的目的仅仅是为了说明这些子目录下的内容。这几个目录具有一定的代表性，包含了所有子目录中将会出现的大多数文件。
|
||||
|
||||
```
|
||||
applications/
|
||||
├── build
|
||||
└── packages
|
||||
├── a
|
||||
│ ├── acct
|
||||
│ ├── acct-6.3.5.tar.gz
|
||||
│ ├── acct-cap.conf
|
||||
│ ├── Pkgfile
|
||||
│ ├── post_add.sh
|
||||
│ └── post_mk.sh
|
||||
│
|
||||
├── b
|
||||
│
|
||||
├── c
|
||||
│ ├── cairo
|
||||
│ ├── cairo-1.10.2.tar.gz
|
||||
│ ├── cairo-1.2.6.tar.gz
|
||||
│ └── Pkgfile
|
||||
│
|
||||
├── d
|
||||
│ ├── db
|
||||
│ ├── db-4.3.27.tar.gz
|
||||
│ ├── db-4.5.20.tar.gz
|
||||
│ ├── patch.4.5.20.1
|
||||
│ ├── patch.4.5.20.2
|
||||
│ └── Pkgfile
|
||||
├── e
|
||||
│
|
||||
├── f
|
||||
│ ├── firefox
|
||||
│ ├── firefox.1
|
||||
│ ├── firefox-2.0.0.11-l10n.tar.bz2
|
||||
│ ├── firefox-2.0.0.11-source.tar.bz2
|
||||
│ ├── firefox-2.0.0.1-l10n.tar.bz2
|
||||
│ ├── firefox-2.0.0.1-source.tar.bz2
|
||||
│ ├── firefox-2.0.0.3-l10n.tar.bz2
|
||||
│ ├── firefox-2.0.0.3-source.tar.bz2
|
||||
│ ├── firefox-2.0.0.8-l10n.tar.bz2
|
||||
│ ├── firefox-2.0.0.8-source.tar.bz2
|
||||
│ ├── firefox-2.0.0.9-l10n.tar.bz2
|
||||
│ ├── firefox-2.0.0.9-source.tar.bz2
|
||||
│ ├── firefox-3.0.3-l10n.tar.bz2
|
||||
│ ├── firefox-3.0.3-source.tar.bz2
|
||||
│ ├── firefox.desktop
|
||||
│ ├── firefox.png
|
||||
│ ├── mozconfig
|
||||
│ ├── Pkgfile
|
||||
│ └── prefix
|
||||
├── g
|
||||
├── h
|
||||
├── j
|
||||
├── k
|
||||
├── l
|
||||
├── m
|
||||
├── n
|
||||
├── o
|
||||
├── p
|
||||
├── q
|
||||
├── r
|
||||
├── s
|
||||
├── t
|
||||
├── u
|
||||
├── v
|
||||
├── w
|
||||
├── x
|
||||
├── y
|
||||
└── z
|
||||
```
|
||||
当你浏览了你本地机器上的applications工作区之后，你会发现，所有子目录下的文件无外乎就这么几种：源码包、Pkgfile文件，这是每一个软件包目录下必有的；post_mk.sh文件、post_add.sh文件、补丁文件，这几个文件，你会发现，有些软件包目录下有，有些软件包目录下没有。下面分别进行介绍。
|
||||
|
||||
### 2.2 分述各个目录和文件的作用
|
||||
|
||||
浏览applications工作区，首先看到两个目录：build和packages。
|
||||
* build是rocky6.0.42.41以前的版本在生成镜像文件时用到的目录，现在已经不再使用，所以不用管这个目录。
|
||||
* packages目录下存放着构建rocky6.0.42.41用到的所有源码包。
|
||||
|
||||
浏览packages目录，可以看到它有`以26个英文字母命名的子目录`。再浏览这些子目录（任意选中一个进行浏览），发现这个目录下依然是一些目录，不过`这里的目录名全是以一些软件包的名字命名的，并且这些软件包名的首字母就是它所在的目录`。继续往下，才发现了源码包和Pkgfile文件，或许还有其他的一些文件。
|
||||
|
||||
看到这里，想必你已经理解了，这里也是运用了计算机技术中大量使用的“分层技术”，通过不断划分层次来对源代码包和与其相关的文件进行归类。不管你认不认同这种处理方法，它已经这样做了。不过，在我看来划分层次在这里还是起到了非常好的效果，至少找一个软件包非常容易了。
|
||||
|
||||
再看软件包名目录下的内容，因为每个软件包名目录下的内容都大同小异，所以这里咱们只会整体上介绍文件包名目录下的文件种类，不会也不可能介绍每一个软件包名目录。
|
||||
|
||||
* 源码包：从网络上下载的源代码包；
|
||||
* Pkgfile：编译rocky6.0.42.41上的二进制包时用到的文件，关于Pkgfile文件的介绍[点击这里查看](http://gitlab.rd.in.linx/linx6.0.42/documents/blob/master/Pkgfile-yczhu.md)。
|
||||
* post_mk.sh、post_add.sh：这是两个shell脚本，在执行pkgmk命令时加上-pm、-pa参数，将会在编译二进制包时执行这两个文件，详细介绍见《pkg 命令说明文档V0.2.odt》。
|
||||
* \*.patch文件、\*.conf文件：软件包的补丁文件和编译软件包的相关配置文件，根据不同的需求会在编译软件包时加入这两个文件。
|
||||
|
||||
### 2.3 关于隐藏文件和隐藏目录
|
||||
|
||||
在applications工作区下，有隐藏目录.git和隐藏文件.gitignore：
|
||||
* .git：初始化git时创建的隐藏目录，这里就是git版本库（git是一个版本控制工具）。
|
||||
* .gitignore：是git的一个配置文件，所有在这里列出了名字的文件将会被git忽略掉，不跟踪这些文件。例如，在applications工作区下，有这么一些文件将不被git跟踪：
|
||||
|
||||
```
|
||||
cat applications/.gitignore
|
||||
|
||||
.footprint.diff
|
||||
.footprint.orig
|
||||
.md5sum.diff
|
||||
.md5sum.orig
|
||||
*.pyc
|
||||
*.o
|
||||
*.so.*
|
||||
```
|
||||
所有这里列出的文件名将不被跟踪。
|
||||
|
||||
在软件包名目录下会出现一些隐藏文件，譬如.footprint*，.md5sum：
|
||||
* .footprint\*：如果以ls -a浏览软件包名目录里的内容，会发现这一系列的文件有.footprint、.footprint_base、.footprint_ia64_sec、.footprint_ppc64_base、.footprint_x86_64_base、.footprint_x86_64_sec。打开其中任意一个查看其内容，发现这个文件的每一行包含三个字段，结尾处是一个目录名或者文件名。第一个字段描述这一行结尾处文件或目录的属性，第二个字段是这个目录或文件的属主、属组，第三个字段是这个文件或目录的存放路径。这些目录和文件正是在编译二进制包时，会在pkg目录下创建的目录和文件。这个文件也有记录编包过程的作用，如果改动了Pkgfile，导致重新编出的包与上一次编出的包目录或文件有变化，那么pkgmk将会报错。这时候，如果想要更新此.footprint文件，可以用命令pkgmk加上-uf参数来实现。文件名中的ia64、x86_64等表示不同的计算机体系结构，base表示基本包，sec表示的是安全包。
|
||||
* .md5sum：很明显，这就是md5校验和文件。查看这个文件的内容，会发现这个文件的每一行分为两个字段，第一个字段是一个校验和，第二个字段是这个校验和对应的文件名。实际上，每一个在Pkgfile的source=()中列出的文件，都会有一个校验和存放到这个文件中，当这些文件被改动后，如果不更新被改动文件的校验和，pkgmk命令将会报错，这时可以用pkgmk命令加上-um参数来更新文件的校验和。
|
||||
|
||||
最后，还有一点跟软件包名目录下的内容相关的问题。由于历史的原因:smile:，有些目录下会有各种不同的源码包，以及这些源码包需要的补丁文件等，例如上面的示例中列出的firefox目录就是；后来有了新的规则，不再将多余的内容放在软件包名目录下，只放本次编译二进制包用到的文件，这让软件包名目录下的内容显得精炼了不少，例如上面示例中的acct目录就是。
|
||||
Reference in New Issue
Block a user