最近公司說要開始使用Phabricator系統進行Code Review,聽后一臉茫然,不知道是個什么東西,趕緊Google一番。
Phabricator是何物?
Phabricator是一套基于Web的軟件開發協作工具,它的主要功能有操作數據(任務查看操作);開發輔助(工作流,查看提交的 diff,代碼檢查,執行單元測試);輔助(文件文檔管理)。它最初是Facebook的一個內部工具,后來發展開源,這是項目地址。
Phabricator是一個LAMP (Linux, Apache, MySQL, PHP) 程序,所以Windows下是不能安裝的,我也沒有配置過,這里給出官方安裝教程,有興趣的可以學習下,本篇主要講的是Arcanist的安裝。
那Arcanist又是何物?
Arcanist是Phabricator提供的一個客戶端命令行工具,旨在幫助我們快速的操作和使用(不使用Arcanist的話,在web界面也是可以進行diff等操作的)。
開始配置安裝
- 安裝PHP環境
到PHP官方網站下載最新版本:傳送門,這里要注意下載與操作系統一致的包,否則后續步驟會出現錯誤,32位系統下載x86的包,64位系統下載x64的包,線程安全和非安全都可以。安裝步驟:
- 解壓到一個指定的目錄(如D:\PHP);
- 將PHP安裝目錄(如D:\PHP)加入到PATH環境變量中;
- 復制php.ini-development文件為php.ini,并且把“extension_dir="ext"”、“extension=php_curl.dll”、“extension=php_mbstring.dll”這幾行行首的分號去掉;
- 安裝Git或者SVN
忽略。 - 安裝Arcanist及libphutil
libphutil是php的工具集,Arcanist運行需要依賴它。
下載地址:
https://github.com/facebook/arcanist/archive/master.zip
https://github.com/facebook/libphutil/archive/master.zip
下載后解壓到指定的Phabricator目錄(如D:\phabricator),并把目錄名分別修改為arcanist、libphutil,并把arc.bat所在目錄(例如D:\phabricator\arcanist\bin)配置到PATH環境變量中。
測試:打開cmd,運行php -i
命令。
如果提示了錯誤:無法啟動此程序,因為計算機中丟失 VCRUNTIME140.dll,是因為在Windows下運行php7需要Visual C++Redistributable 2015,去微軟官網下載安裝程序,安裝一遍即可。有64位版和32位版,根據計算機配置進行下載,下面是下載鏈接:
64位版下載地址:
http://download.microsoft.com/download/9/E/1/9E1FA77A-9E95-4F3D-8BE1-4D2D0C947BA2/enu_INREL/vcredistd14x64/vc_redist.x64.exe
32位版下載地址:
http://download.microsoft.com/download/9/E/1/9E1FA77A-9E95-4F3D-8BE1-4D2D0C947BA2/enu_INREL/vcredistd14x86/vc_redist.x86.exe
下載后根據提示安裝即可。 - 配置arc編輯器
使用Arcanist時需要使用文本編輯器編輯大塊的文本,不能使用微軟自帶的NotePad,有以下Windows平臺的編輯器可供選擇:
Notepad++
$ arc set-config editor
""C:\Program Files (x86)\Notepad++\notepad++.exe" -multiInst -nosession"
vim
$ arc set-config editor ""C:\Program Files (x86)\Git\share\vim\vim73\vim.exe""
GitPad
$ arc set-config editor ""C:\Users\yourusername\AppData\Roaming\GitPad\GitPad.exe""
Sublime Text
$ arc set-config editor
""C:\Program Files\Sublime Text 2\sublime_text.exe" -w -n"
以上編輯器的具體路徑可改為自己的編輯器安裝地址。
- 配置Arcanist
- 配置PhabricatorURI:運行命令
arc set-config default $pha-server
,例如arc set-config default http://pha.apk.cn/
- 安裝證書:運行命令
arc install-certificate
,依照提示訪問http://$pha-server/conduit/token/, 復制內容粘貼token即可。
- 至此,Arcanist的安裝與配置就結束了,我們就可以盡情的使用啦。你可以運行命令
$ arc help
來進行arc的使用學習。