《铜豌豆 Linux》本身是开源项目,欢迎大家参与开发。这个页面主要介绍了提交源代码、参与打包和相关开发的一些信息。

了解使用技巧和常见问题

在参与开发之前,可能你关心的事项已经解决或者正在解决。例如,你可以在使用技巧栏目和常见问题栏目了解相关的情况,或者跟铜豌豆社群联系

基本介绍

项目开发在码云进行,项目开发首页地址为: https://gitee.com/atzlinux/

2020-12-28,项目创建的第一个仓库在码云获赞超过 100 星,目前获星数量为: star
欢迎大家继续前往 点赞加星!

本项目所有内容,全部开放源代码。

开发动态

git 仓库权限

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

报告 bug 反馈问题

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

我们关心你的需求

欢迎向我们反馈你的需求。各个软件包本身的需求、网站的需求,请到各子仓库的 Issues 新建 Issue。友善、文明地描述你的需求或相关情况即可。
系统整体性的需求,请这里 反馈需求。 欢迎大家积极评估、实现用户的需求。
更复杂的情况,例如公益团体、校园团体、深入修改配适、商业服务合作定制等等,也可以向我们的开发者咨询

铜豌豆邮件列表

欢迎加入铜豌豆邮件列表沟通,加入方法请查看:

开发和发布的准备

请先在码云注册账号。关注你希望参与开发的 git 仓库。 安装 iso 版本的《铜豌豆 Linux》操作系统,并安装各类开发工具:
apt-get -y install --no-install-recommends -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 debconf-utils debsums build-essential:native dh-python libdistro-info-perl strace vim-scripts blhc reprotest appstream-util apt-file libncurses-dev bison flex libssl-dev pkg-kde-tools reportbug licensecheck
在 Debian 11 下,请使用如下命令安装:
apt-get -y install --no-install-recommends -t bullseye-backports git git-buildpackage dpkg-dev debhelper dh-make dh-runit devscripts dh-autoreconf quilt lintian dh-exec dgit dupload debmake pristine-tar debconf-utils debsums build-essential:native dh-python libdistro-info-perl strace vim-scripts ubuntu-dev-tools blhc reprotest appstream-util apt-file libncurses-dev bison flex libssl-dev pkg-kde-tools reportbug cmake licensecheck libgit-wrapper-perl libstring-shellquote-perl atzlinux-deb-template tools-atzlinux-dev libclass-inspector-perl wlc
在 Debian 12 下,请使用如下命令安装:
apt-get -y install --no-install-recommends git git-buildpackage dpkg-dev debhelper dh-make dh-runit devscripts dh-autoreconf quilt lintian dh-exec dgit dupload debmake pristine-tar debconf-utils debsums build-essential:native dh-python libdistro-info-perl strace vim-scripts ubuntu-dev-tools blhc reprotest appstream-util apt-file libncurses-dev bison flex libssl-dev pkg-kde-tools reportbug cmake licensecheck libgit-wrapper-perl libstring-shellquote-perl atzlinux-deb-template tools-atzlinux-dev tools-atzlinux tools-atzlinux-dev-conf libclass-inspector-perl wlc libsoap-lite-perl routine-update

提交到铜豌豆 Linux 生态的源代码

fork 您希望参与开发的 git 仓库,提交合并请求,由相应仓库维护者评估、合并。
合并后你贡献的代码就是铜豌豆 Linux 生态的源代码的一部分啦!

集成你关心的软件包

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

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

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

    gbp 命令文档,已经随 git-buildpackage 软件包安装,路径为:
    file:///usr/share/doc/git-buildpackage/manual-html/index.html

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

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

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

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

    相关开发命令及工具

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

    软件包命名的主要规则

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

    软件包名

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

    版本号

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

    铜豌豆软件包名、版本号

    按软件包来源,分类说明如下:

    git 仓库权限

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

    源代码获取 #deb-src

    铜豌豆自己打包的软件,其代码均按 Debian 规范公开放置,可以用 Debian 通用源代码获取工具下载。
    在 /etc/apt/sources.list 添加铜豌豆软件包源代码下载源:

    deb-src https://apt.atzlinux.com/atzlinux bullseye main contrib non-free

    然后运行 apt update 更新源代码索引。 Debian 官方软件包源代码可以通过以上类似方式获取,其源代码下载源建议使用 sid 代号:

    deb-src https://mirrors.bfsu.edu.cn/debian sid main contrib non-free

    参考信息


    《铜豌豆 Linux》官网二维码
    《铜豌豆 Linux》官网二维码
    版权所有 © 《铜豌豆 Linux》 项目网站版权协议为(CC BY-NC-ND 4.0)