RubyMetric / chsrc

chsrc 全平台通用换源工具与框架. Change Source everywhere for every software
https://chsrc.run/
GNU General Public License v3.0
4.15k stars 167 forks source link

如果换源方法有问题,或者还未支持该软件换源,我该如何贡献? #29

Open ccmywish opened 5 months ago

ccmywish commented 5 months ago

多提 issue

每个组织、个人的技术栈都很不同,所以chsrc很难涵盖所有能换源的东西。

但是尽可能换所有源,这是chsrc想要达到的目标,所以如果有任何换源需求,请你大胆提出。

  1. issues on Gitee
  2. issues on GitHub


多测试,多反馈

基于上述目标,我们的开发环境很难完全测试。所以当你发现有问题的时候,请直接提issue,并附上输出信息。


不需要C语言也可贡献

chsrc 不仅是一个命令行工具,同时也是一个换源框架,它甚至使你能够在不了解C语言的情况下编写出新的换源方法(recipe)。

请参考文档:doc/Write-A-Recipe-Even-If-You-Dont-Know-C.md

chsrc为了达到全平台的支持,使用了C语言。这一点提高了贡献者的门槛。但是这并非说你无法贡献。如果发现chsrc现有实现的换源方法有问题,或还未实现该换源:

  1. 而你非常清楚该如何换源时(甚至你已经自己编写、或找到其他人写的换源脚本):

    你可以直接告知我们具体的命令,或用shell脚本的方式告诉我们如何换源,我们将转换为等效的C语言进入程序。可以使用 sed, awk 等外部命令,但是请确保平台上一定存在。

  2. 当你自己也不清楚该如何换源时:

    请尽量寻找好他人撰写的换源的细致教程,当我们实现后,请第一时间测试并反馈。

ccbikai commented 5 months ago

能否通过配置文件,达成自定义源的目标

ccmywish commented 5 months ago

@ccbikai

感谢你的多次反馈和建议!自定义源的功能会近两三天内实现。形式类似 chsrc set dockerhub https://abc.com

ccmywish commented 5 months ago

@ccbikai

已经可以支持自定义源,如:chsrc set ruby https://gems.ruby-china.com/

但是有些换源的URL和换源方法有关联,不能确保所有源都成功。若测试有问题,可以重新开一个issue.