流程图.png

上一篇讲解了如何部署、配置、运行phabricator，链接如下：

gitee+微信云托管+phabricator搭建程序员团队协同开发，实现项目从0到上线的工作平台

这一篇讲解程序员团队如何利用gitee+微信云托管+phabricator协同开发，实现项目从0到上线

在Windows上安装开发所需的环境：php环境，所需的软件：git、arcanist、finalShell

1、下载安装php环境

php安装包下载地址：https://windows.php.net/download/

• 下载zip包-解压-改解压后的文件夹名称为php

• 右击“此电脑”-属性-高级系统设置-环境变量-系统变量-找到“Path”双击-新建-变量名输入php-变量值选浏览找到刚刚的php文件夹双击确定-完成-确认关闭窗口

• 去php文件夹下，找到php.ini-devepment或者php.ini-production并且重命名为php.ini。

• 在php.ini找到;extension_dir = xxxxx,把xxx改为c:/xin/php/ext (存放的文件位置)，同时去掉前面的;符号，保存关闭窗口即可

• 按win+R输入cmd，输入php -v显示php版本就是安装php成功

2、下载安装git

git下载链接：

https://git-scm.com/downloads

下载安装即可

3、下载安装finalShell

finalShell用于ssh连接服务器。

下载地址：

http://www.hostbuf.com/t/988.html

4、下载安装notepad++

notepad++主要是用于辅助arcanist写代码提交信息等等，记好notepad++的本地安装地址，备用。配置arcanist会用到。

5、下载安装和配置arcanist

Arcanist是Phabricator提交代码评审的客户端工具，即这是Phabricator配套的Code Review工具。

在D盘或者E盘创建一个xin空文件夹，进入空文件夹，右击空白处，点击open git bash here，输入以下命令下载arcanist。

git clone https://github.com/phacility/arcanist.git

下载好arcanist后，开始配置arcanist的环境变量：

• 右击此电脑，点击“属性”，再点击“高级系统设置”，
• 点击“环境变量”，在“系统变量”里找到“Path”变量，双击“Path”变量
• 点击“新建”，输入：E:\xin\arcanist\bin（你安装arcanist的路径）
• 按“win+R”，输入cmd打开命令窗口，输入“arc help”，如果不报错，则代表安装配置成功
• 在命令窗口输入以下命令来配置arc的编辑器：

  arc set-config editor "E:\notepad++\notepad++.exe\"
  
//如果不想用notepad++，也可以用vim编辑器
arc set-config editor "vim"

• arcanist的安装和配置到此完成

下面是arcanist使用过程中碰到的问题和解决方案

问题：在命令窗口使用arc help命令测试正常，在vscode终端窗口使用arc help命令会报错arc : 无法将“arc”项识别为 cmdlet、函数、脚本文件或可运行程序的名称.........

解决办法：

• 1、在左下角电脑开始搜索框搜索Windows Powershell
• 2. 输入 set-ExecutionPolicy RemoteSigned 回车
• 3. 输入 A 回车
• 4.再输入get-ExecutionPolicy,回车 出现RemoteSigned 即为成功
• 5、重启电脑
• 6、重新打开电脑即可

6、拉取代码项目和基本项目配置

1、拉取phabricator仓库的代码到本地

在D盘或者E盘创建一个空文件夹（例如code文件夹），点击进入文件夹，右击空白处，再点击“open git bash here”打开命令窗口（前提已安装git），输入命令git clone http://xxxxx.git（phabricator代码仓库上的链接），首次clone拉取代码需要输入账号密码，输入后自动拷贝代码下来

2、添加.arccondig文件到代码目录（首次需要这样操作）

然后用vscode打开code文件夹里面的那个代码文件夹，在代码根目录新建.arcconfig文件，内容如下：

{
   "phabricator.uri" : "https://phabricator.example.com/" （你的phabricator域名）
}

保存文件即可。

3、安装arcanist证书（首次需要这样操作）
接下来，点击vscode界面左上角的“终端”-“新建终端”，在终端界面输入arc install-certificate命令安装arcanist证书。输入后会提示如下内容：

CONNECT  Connecting to "http://dev.xxxxx.com/api/"...
LOG IN
Open this page in your browser and log in if necessary:

http://dev.xxxxx.com/conduit/login/ 

Then paste the API Token on that page below.


    Paste API Token from that page: xxxxx（此处输入token）

打开浏览器访问提示链接http://dev.xxxxx.com/conduit/login/，没有登录的会提示登录，登录后看到token并复制到vscode终端，按enter键开始安装arcanist证书，一般都会成功。

7、开始开发（开发流程）

在vscode终端输入命令：

• 1、先查看当前本地分支，查看是否是master本地分支

git branch 

• 2、拉取远程仓库的master远程分支回来，即要先拉取最新的代码回来，因为怕之前clone回来后又刚好有同事push提交了新代码，为了保证本地master分支是最新的，所以再一次git pull origin master拉取远程仓库的master远程分支回来，保证代码是最新的。

git pull origin master 

• 3、基于本地master分支去创建A本地分支并切换到A本地分支。（开发建分支原则：一个需求最好建一个分支，比如添加评论需求，就创建AddComment分支）

git checkout -b A 

• 4、推送并创建远程仓库的A远程分支

git push origin A 

• 5、查看并确认当前本地开发分支是否是A本地分支

git branch

• 6、查看是否有代码修改，即查看代码修改情况，保证初始状态是暂无任何文件修改

git status 

• 7、暂无修改后，开始写修改代码

写代码.........（几个小时）

• 8、代码写好后，ctrl+s保存修改。

• 9、查看改动了哪些文件

git status

特殊情况的命令补充：
如果不小心改动了不应该改的文件，可以使用git checkout -- xxx（xxx代表文件名）命令让xxx文件恢复到没有被修改的状态。

• 10、将当前的所有修改添加到暂存区

git add .  

• 11、添加改动说明并将暂存区中的改动提交到本地仓库

git commit -m "修改添加了评论功能"

• 12、将代码push提交到phabricator对应代码仓库的开发分支A

git push origin A 

• 13、切换为本地master分支

git checkout master 

• 14、拉取远端master分支的最新代码，保证本地master分支的代码是新的（因为有可能其他同事提交了新代码）

git pull origin master 

• 15、把A本地分支合并到master本地分支

git merge A 

输入上述命令后会弹出默认合并信息的界面，然后按:q退出即可

• 16、创建代码审核版本，供同事查阅审核修改的代码

arc diff 

输入上述命令后会弹出notepad++，要求填写reviewers、subscribers、test plan、summary等等4个信息，其中reviewers、subscribers填写phabricator上存在的用户名，另外。reviewers不能填自己的用户名。

情况说明：如果同事觉得代码不合格或者写得不好，需要修改。即审核未通过，则需要重新切换到A本地分支并且修改代码后更新代码审核链接，让同事继续查阅审核。命令如下：

1、git checkout A //切换到A本地分支继续修改
2、git status //查看修改了哪些文件
3、git add .
4、git commit -m "修改了xxx"
5、arc diff　--update D# //更新代码审核的链接，继续查阅审核。其中#是代码审核链接的序号

关于arc命令的使用拓展：

如果arc diff产生代码审核，但是邮箱发送不了代码审核的提醒，则需要到var/www/pha/phabricator目录下执行

./bin/phd restart //重启phabricator的后台进程

• 17、等同事审核通过后，输入此命令把master本地分支push推送到phabricator对应代码仓库的master分支

git push origin master

• 18、到此完成例如“添加评论功能”的开发任务

• 19、用finalShell登录服务器，把代码更新到gitee平台的代码仓库上，输入以下命令：

1、//打开根目录
cd ../
2、//打开指定的文件目录
cd var/www/pha/phabricator
3、//执行命令，把代码更新到gitee平台的代码仓库上
//下面命令执行后需要输入gitee远程仓库的账号密码，这个会推送代码到gitee平台的代码仓库里，只有这样，gitee的远程仓库才会及时更新
./bin/repository update --trace R29  （其中R29是仓库名称）

补充说明：如果有需要测试，开发流程到第13后，可以先切换到test分支，把A分支合并到test分支，先把测试分支发布到测试环境，测试人员测试没有bug后再合并到master

8、利用微信云托管发布项目上线

操作如下图：

微信云托管发布上线.png

微信云托管满足了中小型企业的项目发布上线需求，有日志、有灰色发布、全量发布等等各种功能。

这就是利用gitee+微信云托管+phabricator搭建程序员团队协同开发工作平台，实现项目从0到上线的整个过程。给大家提供一个可行性参考。