conda-ecopkgs贡献指南：如何为openEuler添加新的conda软件包

conda-ecopkgs贡献指南：如何为openEuler添加新的conda软件包

【免费下载链接】conda-ecopkgsThis repo aims to manage the conda packages which support openEuler.项目地址: https://gitcode.com/openeuler/conda-ecopkgs

前往项目官网免费下载：https://ar.openeuler.org/ar/

openEuler / conda-ecopkgs项目旨在管理支持openEuler系统的conda软件包，为开发者和用户提供丰富的软件选择。本文将详细介绍如何为该项目贡献新的conda软件包，帮助你快速上手贡献流程。

一、准备工作：环境与仓库

1.1 安装必要工具 🛠️

在开始贡献前，请确保你的系统中安装了以下工具：

• Git：用于版本控制
• Conda：用于构建和管理软件包
• Docker：用于验证软件包在openEuler环境中的兼容性
• Python：用于运行项目中的脚本，如scripts/update.py

1.2 克隆项目仓库

首先，将conda-ecopkgs仓库克隆到本地：

git clone https://gitcode.com/openeuler/conda-ecopkgs cd conda-ecopkgs

二、添加新软件包的步骤

2.1 创建软件包目录

在packages目录下为新软件包创建一个文件夹，命名格式为软件包名称，例如packages/my-new-package。

2.2 编写package.yml文件 📝

在新创建的目录中，创建package.yml文件，该文件用于描述软件包的基本信息、源地址、构建依赖等。以下是一个基本示例：

name: my-new-package version: 1.0.0 source: url: https://example.com/my-new-package-1.0.0.tar.gz sha256: abc123def456... build: number: 0 script: | ./configure --prefix=$PREFIX make make install requirements: build: - gcc - make run: - libxyz

你可以参考现有软件包的package.yml文件，了解更多配置选项。

2.3 编写supported-versions.yml文件

创建supported-versions.yml文件，指定软件包支持的openEuler版本和架构：

22.03-lts: 1.0.0: - x86_64 - aarch64 23.09: 1.0.0: - x86_64

该文件定义了软件包在不同openEuler版本和架构上的可用性。

三、验证软件包

3.1 使用verify.sh脚本进行本地验证

项目提供了scripts/verify.sh脚本，用于验证软件包的构建和安装是否正常。运行以下命令进行验证：

bash scripts/verify.sh -p my-new-package -v 1.0.0

3.2 理解自动验证流程

当你提交Pull Request后，项目的CI系统会自动运行scripts/update.py脚本，该脚本会：

1. 检查修改的文件
2. 克隆源代码和原始代码
3. 对新添加的软件包版本和架构进行验证
4. 使用Docker运行验证脚本，确保软件包在openEuler环境中正常工作

四、提交贡献

4.1 提交代码并创建Pull Request

将你的修改提交到本地仓库，并推送到远程分支，然后在GitCode上创建Pull Request。确保你的提交信息清晰明了，例如："Add my-new-package 1.0.0 for openEuler 22.03-lts and 23.09"。

4.2 处理审核反馈

项目维护者会对你的Pull Request进行审核，可能会提出修改意见。请根据反馈及时调整你的代码和配置文件，确保软件包符合项目规范。

五、贡献注意事项

• 遵循现有格式：保持package.yml和supported-versions.yml文件的格式与其他软件包一致。
• 测试兼容性：确保软件包在指定的openEuler版本和架构上能够正常构建和运行。
• 更新文档：如果需要，更新项目的README文件，添加新软件包的相关信息。

通过以上步骤，你就可以成功为openEuler / conda-ecopkgs项目贡献新的conda软件包了。感谢你的参与，让openEuler生态更加丰富！ 🚀

【免费下载链接】conda-ecopkgsThis repo aims to manage the conda packages which support openEuler.项目地址: https://gitcode.com/openeuler/conda-ecopkgs