OSCHINA 软件库集中展示开源项目资料,适合提交尚未收录的框架、工具与应用,中文开发者可从最新、热门和更新榜继续查看源码、文档与版本消息。
OSCHINA 是面向中文开发者的开源与技术社区,软件库(在新标签页打开) 是其中专门收录开源软件资料的区域。访客可以搜索项目,浏览最新软件、热门软件和软件更新榜。进入项目页后,还能查看许可证、开发语言、官网、文档、下载、资讯、评论和收藏。
这套发现方式适合已经公开源码、写明许可证,而且尚未被软件库收录的框架、组件、开发工具和应用。闭源 SaaS、普通闭源 App、没有明确授权的公开仓库,以及已有条目的重复投递,都不符合当前软件投递页写明的条件。
提交前先判断当前任务。软件库尚无项目条目时,使用 投递软件 建立资料。已有条目发布新版本时,改走 软件更新资讯。名称、官网、仓库或许可证需要修正时,则在原条目使用 纠错。三种动作不能互相替代。
搜索软件名,也检查旧名称和官网域名
打开软件库,分别搜索当前名称、曾用名、仓库名和官网域名。找到已有条目时,记录它的公开地址,后续走更新或纠错流程。没有结果,再准备新软件投递。
当前投递页的友情提示写明:投递的软件必须开源,并且尚未被 OSCHINA 收录。编辑审核通过后,软件才会进入软件库。
许可证比宣传文案更早准备
代码能公开访问,不等于其他人已经获得使用、修改和分发它的许可。仓库中应当有明确的许可证文件,官网或 README 还要说明安装方法、运行环境、当前版本和最小示例。许可证仍在讨论时,应先解决授权问题。
软件官网、源码仓库和使用文档各自回答不同问题:官网解释用途和支持范围,仓库证明代码与授权,文档帮助读者完成安装或调用。详细介绍应让人看懂软件解决什么问题、怎样开始,以及有哪些运行条件。不要只复制品牌口号、功能名或技术关键词。
登录后从个人发布页进入“投递软件”
OSCHINA 当前的发布地址包含登录用户自己的 ID,形式为 https://my.oschina.net/u/真实用户ID/admin/publish,因此没有一个适合所有人的固定投递网址。登录后从个人菜单进入发布页,在顶部从 投递新闻 切换到 投递软件。
截至本次核验,软件表单包含:
软件名称:必填;软件网址:必填;源码地址:页面没有显示必填标记;文档地址:页面没有显示必填标记;详细介绍:必填;请选择开源许可证:下拉选项包括 GPL、LGPL、AGPL、Apache、MIT、BSD、EPL、MPL、Mulan 和其他。
网址字段接受 HTTP、HTTPS 或 FTP 地址。虽然界面没有把源码地址标为必填,官方资格仍要求软件开源。本站建议让审核者和读者能从所填页面直接找到真实源码与许可证。
许可证选择器当前默认显示 GPL。这个默认值只是表单初始状态,不能替项目决定授权。提交前要把它改成仓库实际使用的许可证。列表中没有对应选项时,选择 其他,并在项目公开资料中写清完整名称。
点击 投递软件 后,接口成功时页面会提示 发布软件成功,随后打开账户的项目列表。这个提示证明表单已经提交,尚未证明编辑已经收录。软件出现在公开软件库,并能由未登录访客打开,才算完成发布。
已收录项目用“软件更新资讯”报告版本变化
项目已有软件库条目时,不要为新版本重新创建软件。回到同一个个人发布页,保留在 投递新闻 标签,把 新闻分类 设为 软件更新资讯,再用 关联软件 搜索并选中原条目。
标题写明版本号和最重要的变化。正文交代发布日期、下载或升级地址、兼容性、破坏性变更和迁移办法。提交后仍需等待编辑审核。新闻通过审核并出现在资讯页或原软件的公开信息中,才是读者可见的版本更新。
本站建议只为影响安装、兼容、功能或安全的变化发布软件更新资讯。小幅文案、截图或链接变化应在原条目使用 纠错,不要发布软件更新资讯或重复建立条目。
提交前检查链接与许可证
软件库条目会展示官网、文档和下载地址,读者可以从这些链接继续了解或试用项目。本站建议在提交前用未登录窗口逐个打开这些链接,并实际走一遍安装或 Demo。项目名称、版本和许可证也要在官网、仓库、文档与投递内容中保持一致。
介绍里可以写真实的性能数据、兼容范围或迁移成本,但要同时给出版本、环境和测试方法。不要虚构下载量、用户评价或编辑推荐,也不要因为表单默认选中 GPL 就提交错误许可证。重复条目、闭源产品和无法访问的源码地址也不符合当前投递条件。
收录后用“纠错”维护条目
公开项目页的操作栏当前有 纠错,页面还会展示官网、文档、下载、许可证、开发语言、资讯、评论和收藏。官网迁移、仓库改名、文档失效或许可证变化时,先更新项目自己的页面,再打开软件库条目使用 纠错 提交对应修改。
版本发布后查看关联新闻和评论。有人报告安装失败或兼容问题时,确认环境和版本,在文档中补上解决办法,并回到原讨论说明结果。长期无人维护的失效链接会让软件库条目失去作用。
新建软件条目时,依次处理查重、授权、投递、审核和后续维护:
- 搜索软件库,核对当前名称、曾用名、仓库名和官网域名。
- 确认项目公开源码并写明许可证,整理官网、源码、文档、安装步骤和限制。
- 登录个人发布页,切换到
投递软件,按真实许可证修改默认选项并提交。 - 看到
发布软件成功后继续等待审核,以公开软件库条目作为最终成功状态。 - 新版本改走
投递新闻的软件更新资讯,资料变化则在原条目使用纠错。