PhalApi官方发布流程

前言
为了让更多的同学了解PhalApi的发布流程,以及方便发布同学参考执行,这里将PhalApi的发布流程共享如下。

一张图告诉你PhalApi的版本关系
20170303200254.png


可以看到,其中:
  • master:当前的开发分支,如果有代码更新,可创建merge request提交到此master分支
  • release/release-en:最新发布分支,分别对应中文版发布分支、英文版发布分支,区别主要在于代码注释上的差异
  • archive-x.x.x:历史归档版本,只读分支。


具体的发布流程

1、准备发布公告
根据更新日记,把最新的更新内容整理成发布公告,以便投放到社区、开源中国、群里。
可参考公告:https://www.oschina.net/search ... Dnews

2、更新版本号
按版本命名的规范,通常情况下递增版本号,修改代码仓库下的README.md、PhalApi.php两处的版本号,如下所示,保存并提交。

修改版本号(1):
20170303201205.png


修改版本号(2):
20170303201322.png


3、合并代码到发布分支
进行代码合并时,需要进行中文版和英文版的合并。首先,将代码从master合并到release,再把代码从master分支合并到release-en分支,并且进行相应的修改,把中文翻译成英文。

注意,这里的代码合并路径应该是:master -> release -> release-en。参考操作命令:
git checkout release
git pull
git merge master
git push
git push origin2 release

git checkout release-en
git pull
git merge release
git push
git push origin2 release-en

最后,进行代码提交,除了push到GIT@OSC外,还要同步到github上的https://github.com/phalapi/phalapi" rel="nofollow" target="_blank">PhalApi,可以使用命令:git push origin2 release (需要配置好本地账号)。

4、打Tag和发布release
可以在Tags新建Tag,Tag的命名可使用:archive-x.x.x(注:以前使用新建分支,现改用tag)。同时,在Releases 创建Release。
在github上进行同样的操作。

5、更新框架代码到Demo站点
将最新版本的框架代码,更新到Demo站点(对应目录:~/projects/demo.phalapi.net),这里只需要更新PhalApi核心框架目录即可,并根据需要更新其他目录文件,如Public目录。

6、更新文档docs
同步更新phpdoc.xml的标题版本,然后使用脚本build_docs.sh 、 build_docs_en.sh(需先切到release-en分支) 分别生成中文版、英文版的在线类手册,随后提交更新到PhalApi-Net 仓库。官网会在1分钟内自动更新到在线类参考手册、Classes docs。
20170303202010.png


7、更新WIKI文档
可通过执行build_wikis.shbuild_wikis_en.sh脚本重新生成最新中文版和英文版的WIKI文档,然后提交到Git仓库。服务器会在1分钟内自动更新到官网的文档

8、更新其他格式的WIKI
其他格式的WIKI有,:PDF版本、CHM版本。其中:

PDF版本:
可以在Chrome浏览器打开汇总后的PhalApi-Wikis.html文件(本地位置:~\PhalApi-Net\wikis\PhalApi-Wikis.html),然后:打印 -> 更改 -> 另存为PDF,然后上传到CDN。

CHM版本:
可以使用htm2chm(本地位置:~\chm\htm2chm\htm2chm.exe)重新生成CHM文件,并且上传到CDN。

PDF和CHM上传到CDN后,更改下载链接到:下载页面

9、更新最新版本号,以便提示开发人员进行免费升级
待改动的接口:
https://www.phalapi.net/check_lastest_version.php

最终提示效果:

20170617104140.jpg




 

0 个评论

要回复文章请先登录注册