無限極項目共享10客戶化開發(fā)windows

1、Windows操作系統(tǒng)Phabricator命令行工具Arcanist基本用法Author: Creation Date: Last Updated:Ref:劉光輝Ver:1.0文檔控制更改日期章節(jié)作者版本更改參考內(nèi)容目錄文檔控制21.Arcanist簡介4英文UserGuide4其他幫助4安裝Arcanist5環(huán)境準備5. ...4.2.5.安裝. 5安裝Arcanist7為Arcanist配置文本編輯器8Arcanist的基本用法9為新項目加入Arcanist支持9項目代碼管理與Review.2.1.Arcanist簡介Arca

2、nist, 是Phabricator的一款命令行工具(d-lineerface)。提供給用戶許多Phabricator工具其他特性。令行方式(比如說Differential, Files, 和Paste)。還包含了許多1.1.英文UserGuide1.1.1.文檔地址/book/phabricator/article/arcanist/1.2.其他幫助1.2.1.Mac操作系統(tǒng)下Arcanist的基本用法參看文檔：ht/thread-39791-1-1.html2.安裝Arcanist本章節(jié)主要描述如何在Windows操作系統(tǒng)下安裝Arcanist2.1.環(huán)境準備2.1.1.安裝測試環(huán)境操作系

3、統(tǒng)：Win7 64位 旗艦版2.1.2.概述Arcanist是由編寫，所以需要安裝CLI，版本必須是5.2或者更新。另外，Phabricator支持Git，本文檔也將以Git為例，講解如何使用Arcanist做最基本的代碼管理。2.1.3.安裝步驟1.2.3.；安裝；安裝Arcanist。.1.5.2及以上版本的地址：請2.3.安裝2.3.1.安裝1.解壓Zip到合適位置，如：D:tools2.拷貝文件夾下的.ini-development到相同的目錄，重命名為.ini。3.目錄和文件夾下的ext目錄添加到path中。添加內(nèi)配置環(huán)境變量。將：D:tools-7.0.1-Win32

4、-VC14-x64;D:tools-7.0.1-Win32-VC14-x64ext;4.ini，查找到行;exten=_curl.dll，去掉注釋本句用的;。然打開文件后查找到行; exten_dir = ext，同樣去掉;激活擴展功能。至此，配置完成。2.4.安裝Arcanist2.4.1.安裝Git略。本步安裝Arcanist將通過git clone將文件從遠處拷貝到本地，所以需要Git支持。為了確保Git已經(jīng)就緒，請運行命令git config -list確保你Git的用戶名和郵箱必須不能有中文！否則后面會報錯。附：修改Git用戶名和郵箱的方法：git config

5、git config user.2.4.2.安裝Arcanist命令行下選擇合適目錄，使用git clone命令將安裝文件從上拉下來。1.首先克隆Arcanist的依賴包，git clone然后克隆Arcanist包，git clone/phacility/libphutil.git2./phacility/arcanist.git3.為Arcanist配置環(huán)境變量，將Arcanist安裝目錄下的bin加入到path環(huán)境變量里。如：D:Arcanistarcanistbin;驗證Arcanist是否安裝完成，打開命令行，輸入命令：arc，顯示如下信息說明安裝完成。4.2.5.為Arcanist

6、配置文本編輯器本步可以由用戶個性化定制，選擇自己喜歡的文本編輯器，使用較為輕量級的2.5.1.的編輯器選擇1.2.3.Notepad+Vim (Git Bash自帶) GitPad2.5.2.配置編輯器1.在任意位置打開命令行，運行命令：arc set-config editor C:pathtosomeeditor.exe命令中的地址是指向你編輯器的exe文件的完整目錄2.還可以添加參數(shù)進一步定制，請參看文檔。3.Arcanist的基本用法本章介紹如何為新項目加入Arcanist支持，并講解基于Git的代碼管理的基本用法3.1.為新項目加入Arcanist支持3.1.1.基本步驟1.引入基礎(chǔ)

7、配置文件.arcconfig。在新項目目錄下，新建一個文件名字為.arcconfig。編輯內(nèi)phabricator.uri : 其中的地址為新項目的下：/倉庫目錄，也就是你代碼改變要提交給的目錄。該文件就是一個JSON文件，參數(shù)參看文檔。2.安裝Arcanist Credentials。在同樣在項目目錄下打開命令行，執(zhí)行命令：arc install-，彈出提示如下，提示中的并，得到如下圖的API Token，粘貼回車如上圖，提示安裝成功。至此，Arcanist支持配置完畢。3.2.項目代碼管理與Review3.2.1.基本用法本節(jié)講解Arcanist如何結(jié)合基于Git的代碼管理進行代碼Revi

8、ew.將采用實際項目中開發(fā)接到開發(fā)任務后的場景的講解方式.步驟如下:1.接到開發(fā)任務后,首先確定當前所在分支為master,并在master分支上執(zhí)行g(shù)itpull origaster拉取到代碼2.按照開發(fā)任務的提示，新建一個臨時開發(fā)分支，如：T1。在T1分支上開發(fā)完后首先提交任務代碼。開發(fā)完成后提交任務代碼Review分為以下幾步：a)執(zhí)行arc diff create,選擇使用當前分支(HEAD)，會彈出之前配置的文本編輯器讓你添加本次提交的基本信息，保存關(guān)閉編輯器，又會再次彈出編輯器，這次你需要填寫Summary、Test Plan、Reviewers和Subscribers四個信息，保

9、存關(guān)閉編輯器，如下圖，成功提交代碼Reviewb)執(zhí)行arc list，查看提交的代碼Review是否通過，下圖為通過前后兩次arc list的執(zhí)行結(jié)果：c)如果Review通過向下繼續(xù)第三步，如果沒有通過，請先修改代碼后，執(zhí)行arc diff update D17，填寫Test Plan等信息，然后等待 list查看代碼Review通過。直到arc3.代碼審核。技術(shù) 令arc list查看到。負責代碼審核工作，審核通過后開發(fā)將可以執(zhí)行命4.提交最終代碼到服務器的orig T1分支合并到master并推送。aster。執(zhí)行arc land T1。這句的意思是將5.如果arc land master不能正常提交，分為以下幾步解決：a)拉取代碼服務器上代碼，合并到開發(fā)分支。首先切換到master分支，執(zhí)行g(shù)it checkout master