From 0618da89db99084d18431c5caa8b8a4c0b45d398 Mon Sep 17 00:00:00 2001 From: arcHarico Date: Mon, 3 Mar 2025 17:14:12 +0800 Subject: [PATCH] draft v3 in zh --- content/developer/packaging/basics.zh.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/content/developer/packaging/basics.zh.md b/content/developer/packaging/basics.zh.md index 3868c8b..367a4ad 100644 --- a/content/developer/packaging/basics.zh.md +++ b/content/developer/packaging/basics.zh.md @@ -34,7 +34,8 @@ AOSC OS 是滚动发行版，这意味着 AOSC OS 整体发行时不使用版本 Ciel 的主要功能为管理独立的 AOSC OS 构建环境（通称 BuildKit），因此 Ciel 不一定需要在 AOSC OS 上运行。如果您使用的是 Arch Linux，可以通过 AUR 安装 Ciel。 -接下来，我们可以开始配置 Ciel 工作区了。**注意：Ciel 需要使用 `root` 身份运行（您可以使用 `sudo -i` 命令以提权（此时会进入root shell，`~`会指向`/root`），也可在每条命令前添加`sudo `（此时`~`的对应目录不会改变））；在创建工作区的过程中，需要从 GitHub 下载内容，请确保您的网络环境能够顺畅地访问 GitHub。** +接下来，我们可以开始配置 Ciel 工作区了。**注意：Ciel 需要使用 `root` 身份运行。**可以使用 `sudo -i` 命令以提权（此时会进入root shell，`~`会指向`/root`），也可在每条命令前添加`sudo `（此时`~`的对应目录不会改变）。 +**在创建工作区的过程中，需要从 GitHub 下载内容，请确保您的网络环境能够顺畅访问 GitHub。** 请先在合适的地方新建一个文件夹（文件夹所在的分区建议留出 10 GB 或以上的可用空间）并切换到这个文件夹，然后运行以下命令，开始配置 Ciel 工作区。在向导询问目标架构时（Target Architecture），一般是选择当前这台设备的处理器架构；询问维护者信息时（Maintainer Information）时，请参照示例填写自己的信息；其余选项使用默认值即可；询问是否需要创建新实例时（Do you want to add a new instance now?），请选择是，并创建一个名为 `main` 的实例。 @@ -124,7 +125,7 @@ CHKSUMS="SKIP sha256::some_checksum sha256::sume_checksum" - `PKGNAME` : 软件包名。 - `PKGDES` : 软件包简介。 - - `PKGSEC` : 软件包所在板块（类别）。注意，板块（类别）名并不一定与软件包在软件包树的子目录名称的一部分相同，例如 `i3` 处于软件包树的 `desktop-wm` 子目录，但它的所在板块是 `x11`。AOSC OS所接受的软件包所在板块（类别）可查阅 [Autobuild4 的相关文件](https://github.com/AOSC-Dev/autobuild4/blob/master/sets/section)。 + - `PKGSEC` : 软件包所在板块（类别）。需要注意的是，板块（类别）名并不一定与软件包在软件包树的子目录名称的一部分相同，例如 `i3` 处于软件包树的 `desktop-wm` 子目录，但它的所在板块是 `x11`。AOSC OS 所接受的软件包所在板块（类别）可查阅 [Autobuild4 的相关文件](https://github.com/AOSC-Dev/autobuild4/blob/master/sets/section)。 - `PKGDEP` : 软件包依赖。 - `PKGCONFL` : 软件包冲突信息。 - `BUILDDEP` : 构建依赖（仅在构建时需要的软件包）。 @@ -166,12 +167,12 @@ ABTYPE=meson 接下来，我们来实战软件包配置编写。在该章节，我们来尝试打包 [hello](https://www.gnu.org/software/hello/) ，这是一个由 GNU 编写的简易问候程序，可在屏幕上打印一句“Hello, world!”。本软件没有依赖项，故而非常适合入门。 -首先切换到 `TREE` 目录，并确定我们目前处于 `stable` 这个 Git 分支，然后给软件包创建一个新的 Git 分支，并切换到这个分支上。由于要引入新软件包，根据 [AOSC OS 主题制维护指南 (AOSC OS Topic-Based Maintenance Guidelines)](@/developer/packaging/topic-based-maintenance-guideline.md)，分支名称应为 `$PKGNAME-$PKGVER-new`，即 `hello-2.12.1-new`。 +先切换到 `TREE` 目录并确定目前处于 `stable` 分支，然后执行 `git pull` 确保与上游同步，然后给软件包创建一个新的 Git 分支，分支名称应按 [AOSC OS 主题制维护指南 (AOSC OS Topic-Based Maintenance Guidelines)](@/developer/packaging/topic-based-maintenance-guideline.md) 编写。我们现在是要引入新软件包，所以分支名称格式应为 `$PKGNAME-$PKGVER-new`，即 `hello-2.12.1-new`。 -因为 `hello` 属于实用工具，我们要在 `app-utils` 下创建 `hello` 目录。 +创建分支后，就可以切换到这个分支上。因为 `hello` 属于实用工具，我们要在 `app-utils` 下创建 `hello` 目录。 ``` bash -cd TREE/app-utils +cd app-utils mkdir hello cd hello ``` @@ -204,7 +205,7 @@ ciel build -i main hello 很简单，对吧？这是因为 Autobuild4 的自动探测功能判断出这个包需要使用 `autotools`（即 `./configure && make && make install`）流程进行构建。 -然后，在 Ciel 的工作区目录下，你就能在相关的 OUTPUT 文件夹内看到构建出来的 `.deb` 软件包。此时，你可以在 AOSC OS 双击安装 / 使用 oma 安装 / 使用 dpkg 安装 之后测试这个软件包是否可以正常工作。例如，要测试 `hello` 是否正常，我们应在终端运行 `hello`，在 `LANG` 设置为 `zh_CN-UTF8` 时会输出“世界你好！”。 +然后，在 Ciel 的工作区目录下，你就能在相关的 OUTPUT 文件夹内看到构建出来的 `.deb` 软件包。此时，你可以在 AOSC OS 双击安装 / 使用 oma 安装 / 使用 dpkg 安装 之后测试这个软件包是否可以正常工作。例如，要测试 `hello` 是否正常，我们应在终端运行 `hello`，在 `LANG` 设置为 `zh_CN.UTF-8` 时会输出“世界你好！”。 ## Git 提交 @@ -241,7 +242,7 @@ bash: update to 5.2 接下来，请静候 PR 审核。社区的贡献者会审阅并提出修改意见（如有），在修改和测试通过后，社区的贡献者会通过您的 PR 并合入 stable 分支。最后，您就可以使用自动化设施构建软件包，将新的软件包或软件包更新推送给所有用户。目前，软件包的上传与推送工作由自动化设施完成，相关内容请见[使用自动化设施构建软件包](@/developer/packaging/buildit-bot.zh.md)。 -对 AOSC OS 主树等 AOSC OS 项目贡献一次提交后，即可成为贡献者。在成为贡献者后，您可以将本地 Git 分支直接推送到主树，之后使用自动化设施创建 PR、测试构建软件包，自行安装并测试、生成审计报告（/dickens），等待其他贡献者审阅与通过 PR后，将软件包合入 stable 分支并**再次**构建软件包。 +对 AOSC OS 主树等 AOSC OS 项目贡献一次提交后，即可成为贡献者。在成为贡献者后，您可以将本地 Git 分支直接推送到主树，之后使用自动化设施创建 PR 、测试构建软件包，自行安装并测试、生成审计报告（/dickens），等待其他贡献者审阅与通过 PR 后，将软件包合入 stable 分支并**再次**构建软件包。 # 结语