来源:https://flarum.org/docs/extend/distribution.html#setting-up-git (官方文档)
发布
您已经编写了一个很好的扩展-现在您希望整个世界都能使用它。本文档将引导您完成分发过程,从为您的扩展程序建立Git存储库,到在Packagist上发布它。
# 设置Git
您需要做的第一件事是设置版本控制系统(VCS)。最受欢迎的VCS是Git。在本指南中,我们将使用Git,因此在继续之前请确保已安装它。如果您没有太多的Git知识,则可能需要查看这些学习资源。
安装Git之后,您需要初始化存储库。您可以git init根据需要在命令行上使用,也可以使用SourceTree或GitKraken之类的GUI工具。(推荐直接使用 vscode,自带git管理工具)
然后,您将需要一个在Git托管服务器中的帐户,其中最受欢迎的是GitHub和GitLab。这些将指导您如何将本地存储库与在线“远程”存储库连接。
# 标记发布
当您要发布此扩展程序时,您将需要确保信息是最新的。请花一分钟时间重新访问composer.json,并确保软件包名称,描述和Flarum扩展名信息正确无误。建议README.md在您的存储库中有一个文件来解释扩展名是什么,因此如果尚未创建该文件,请创建一个。
准备发布时,将扩展程序的文件提交到存储库并标记您的第一个版本:
git tag v0.1.0
git push && git push --tags
# 在Packagist上发布
Composer软件包将发布到Composer信息库,通常是Packagist。您将需要一个帐户才能继续。
如果这是您发布的扩展程序的第一个版本,则需要使用其公共存储库URL 提交软件包。如果您的扩展程序位于GitHub上,则该URL类似于https://github.com/AUTHOR/NAME.git。
# 未来版本
您可以将Packagist设置为自动更新软件包。然后,对于将来的发行版,您需要使用Git进行的所有操作就是提交,标记和将其推送到远程服务器。
# 推广您的扩展
您很可能希望在Extensions标记中的Flarum社区上进行讨论。其他人可以使用以下命令安装扩展程序:
composer require vendor/package
============
相关阅读:
Flarum入门及基础概念
Flarum前端开发
Flarum中的路由与上下文
Flarum数据处理与API接口调用
Flarum编写并发布扩展