Facebook开源代码审阅工具与Git的集成的安装

安装Arcanist客户端
Arcanist是代码审阅的客户端。虽然支持从网页发起的代码审阅，但是通常最简便的方式是使用arcanist客户端提交和更新代码审阅。因此需要先安装arcanist的客户端。

安装前置条件

• 已经安装了GIT版本控制工具。如果还没有安装，请参见Git version control system的Wiki页。

安装流程

• 安装PHP
• 安装Arcanist

安装PHP

• 如果已经安装了PHP，请删除原有的实例。
• 从\\192.168.2.210\Tools\版本控制\arcanist目录拷贝PHP的zip文件php-5.6.31-Win32-VC11-x86.zip到本地目录，比如d:\tools\php。
• 解压缩zip文件到本地目录。
• 打开php.ini文件，找到extension_dir= 这一行(on windows的下一行)，改为extension_dir = "d:\tools\php\ext"，其中d:\tools\php是安装路径。
• 添加phd的安装目录到系统的PATH环境变量中去。右键点击我的电脑->属性->高级系统设置->环境变量，找到PATH变量，把该路径添加到最后（和前一个路径用分号隔开）。
• 验证：新建一个命令行窗口，输入php -v，应该能够看到类似这样的信息。

C:\>php -v
PHP 5.6.31 (cli) (built: Jul  5 2017 22:25:43)
Copyright (c) 1997-2016 The PHP Group
Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies

• 如果你遇到MSVCR110.dll找不到的错误，请下载安装Visual C++ Redistributable for Visual Studio 2012 Update 4，在\\192.168.2.210\Tools\版本控制\arcanist的vcredist_x64（64位）或者vcredist_x86（32位）。

• TIPS:如果通过安装，依旧无法安装，可以通过360安全卫士中的人工修复，选择游戏环境->缺少**.dll文件-> 选择，确认MSVCRD 开头的文件，进行修复。

安装Arcanist

• 首先创建安装目录，比如d:\tools\arcanist；然后从github上克隆arcanist和libphutil。开启一个命令窗口（Win+R，cmd），然后输入以下命令：

$ mkdir somewhere/
$ cd somewhere/
somewhere/ $ git clone https://github.com/phacility/libphutil.git
somewhere/ $ git clone https://github.com/phacility/arcanist.git

如果GIT下载较慢，从210上\\192.168.2.210\Tools\版本控制\arcanist\ 目录下下载arcanist.zip，然后解压缩。

• TIPS:这里主要是进入到相应的文件夹中，进行安装，例如如果已经在安装路径下打开了相应的路径，只需要输入git clonehttps://github.com/phacility/libphutil.git 既可以进行安装例如：G:\arcanist\arcanist>git clone https://github.com/phacility/arcanist.git

• 将arcanist的bin文件路径（比如d:\arcanist\arcanist\bin）添加到系统的PATH环境变量中去。右键点击我的电脑->属性->高级系统设置->环境变量，找到PATH变量，把该路径添加到最后（和前一个路径用分号隔开）。

• 验证：新建一个命令行窗口，输入arc，应该能够看到类似这样的回复，说明安装成功。

C:\>arc
Usage Exception: No command provided. Try `arc help`.

初始配置

• 配置文本编辑器，推荐使用Notepad++，在cmd中执行：

(32位系统或者64位系统64位Notepad++）

arc set-config editor "\"C:\Program Files\Notepad++\notepad++.exe\" -multiInst -nosession"

或者（64位系统，32位Notepad++）

arc set-config editor "\"C:\Program Files (x86)\Notepad++\notepad++.exe\" -multiInst -nosession"

返回如下，显示正确

• 添加根证书到arcanist的信任列表

因为服务器用的SSL证书是由内部的根证书发布的，为了让arcanist能够接受HTTPS的连接，需要把根证书拷贝到信任目录中去。
下载custom.pem文件(\\192.168.2.210\Tools\版本控制\custom.pem)，然后拷贝到arcanist安装目录下\libphutil\resources\ssl。拷贝好之后，目录应该看起来是这样：

• 建立项目的arcanist配置文件

在项目根目录下，寻找文件: .arcconfig。通常项目已经添加了该配置，并且提交到代码库。如果没有的话，新建文件。
在文件中输入：

{
  "phabricator.uri" : "https://dev.corp.xxxx.com/"
}

保存文件。

• 创建arcanist的用户登录信息

在配置了.arcconfig文件的项目根目录下，打开一个cmd命令行窗口，然后输入

>arc install-certificate

• TIPS:可通过以下方式在目录下直接进入CMD命令行方法1：在当前目录下，按下shift + 鼠标右键，会出现“在此处打开命令窗口”的字样，然后点击即可。方法2：在该文件夹上，按下shift + 鼠标右键，会出现“在此处打开命令窗口”的字样，然后点击即可。

根据提示，在浏览器中打开https://dev.corp.xxxxx.com/conduit/login/ （如果没有登录，需要先登录）。

CONNECT  Connecting to "https://dev.corp.xxxxx.com/api/"...
LOGIN TO PHABRICATOR
Open this page in your browser and login to Phabricator if necessary:

https://dev.corp.xxxxx.com/conduit/login/

Then paste the API Token on that page below.

    Paste API Token from that page:

将其中的API Key拷贝到命令行中，点击回车。保存成功之后，会显示：

    Paste API Token from that page: your-api-key-here
Writing ~/.arcrc...
 SUCCESS!  API Token installed.

配置成功之后，就可以用arc diff来提交代码审阅了。