《铜豌豆 Linux》本身是开源项目,欢迎大家参与开发。

基本介绍

项目开发在码云进行,项目开发首页地址为: https://gitee.com/atzlinux/
本项目所有内容,全部开放源代码: 本项目所有源代码地址

git 仓库介绍

以上 git 仓库,对积极的开发者,都可以授予读写权限。

报告 bug 反馈问题

各个软件包本身的问题、bug,网站的问题,请到各子仓库的 Issues 新建 Issue。
系统整体性的问题,请这里 反馈问题。 欢迎大家积极解决定位目前的已知问题。

反馈需求

各个软件包本身的需求、网站的需求,请到各子仓库的 Issues 新建 Issue。
系统整体性的需求,请这里 反馈需求。 欢迎大家积极评估、实现用户的需求。

开发准备

请先在码云注册账号。关注你希望参与开发的 git 仓库。 安装 iso 版本的《铜豌豆 Linux》操作系统,并安装各类开发工具:
apt -y install -t buster-backports git git-buildpackage dpkg-dev debhelper dh-make dh-runit devscripts dh-autoreconf quilt lintian lintian-brush dh-exec dgit dupload debmake dh-make-perl pristine-tar

代码提交

fork 您希望参与开发的 git 仓库,提交合并请求,由相应仓库维护者评估,合并代码。

新增软件包

新增加的软件包需求,可以是第三方已经制作好的 deb 包,在《铜豌豆 Linux》上,经过测试,能够稳定运行的; 也可以是之前没有合适的 deb 包,需要自行打包制作的。
  • 第三方软件包
  • 请到 https://gitee.com/atzlinux/debian-cn/issues/I13NQT 按模板提需求。
  • 自制软件包
  • 软件包制作,请参考 《Debian 新维护者手册》《Debian 维护者指南》《Debian Policy Manual》《Debian Developer's Reference》

    以上 4 个文档,均可以在本地安装相应软件包阅读。安装命令如下:

    apt -y install -t buster-backports maint-guide-zh-cn debmake-doc debian-policy developers-reference
    

    和我线下联系,邮件或者微信均可。在码云新建软件仓库,授予该仓库权限。从其它 软件包仓库拷贝 debian 目录,参照修改。 软件包在本地制作成功后,麻烦用 lintian 命令检查 deb 包是否有各类问题。 lintian 检查通过后,请通知我进行进一步的测试验证,如果没有问题,就会上传到 apt 软件源。

    注:lintian 命令通过如下命令安装

    	apt -y install lintian/buster-backports
    
    安装 buster-backports 版本的 lintian 软件包,其版本比较新,有利于发现更多打包错误。

  • 开源项目制作 deb 包
  • 如果现有的中文桌面应用的开源项目,目前还没有 deb 包,也欢迎联系制作打包。 在现有项目下增加一个 debian 目录,即可实现打包。 也可以把现有项目作为仓库上游,在铜豌豆码云仓库 Fork 一份,铜豌豆的仓库增加 debian 目录,专门处理打包相关代码,上游有新版本 merge 移植过来即可。

    开发命令及工具

    下列所提到的命令,均在 git 仓库检出的目录下运行。

    软件包命名规则

    一个规范的 deb 包,其文件名,由软件包名、版本号、架构、类型组成。 如:v2ray_4.22.1-2020.02.07atzlinux_amd64.deb 。 铜豌豆相关命名,也尽量遵循 Debian 的规则,分别说明如下:

    软件包名

    由 debian/control 文件的 Package: 字段确定。

    版本号

    Debian 官方软件包版本号的规则,请查看:man deb-version。 推荐阅读台湾 DD SZ Lin (林上智) 个人主页 撰写文章: 淺談 Debian package 版本意義以及使用時機
    软件包的版本号,在 debian/changelog 第一行的括号内确定。如:
    gmchess (0.29.6-2.2~20200206atzlinux)

    铜豌豆软件包名、版本号

    按软件包来源,分类说明如下: 在打包制作过程中的问题,可以在铜豌豆开发者群里面讨论。

    git 仓库权限

    码云 git 仓库权限,分为 管理员、开发者 等多种权限角色。“开发者”具备有本仓库的读写权限,“管理员”有仓库管理权限,可以决定哪些人做为本 git 仓库的开发者。

    相关文档