windows下配置openGrok源代码阅读工具

虽然说windows下的源代码阅读工具sourceInsight很强大，但是在公司阅读android源代码一直使用的是openGrok，所以对sourceInsight的代码风格不太习惯，也不太会用。最终还是安装了openGrok。

openGrok的安装有点麻烦，所以在这里记录一下。

openGrok是一个网页形式的代码阅读工具，要想安装需要下载以下几个工具。

1.tomcat 服务器

2.下载openGrok binary，http://opengrok.github.io/OpenGrok/

3.下载安装ctags。http://download.csdn.net/detail/mickeyfirst/5535753（速度要快些）或者到官网下载

安装过程：

1.首先安装tomcat服务器，服务器的安装不在介绍，在浏览器输入localhost:8080查看是否安装成功。

2.首先把openGrok解压的某一个盘的根目录，我保存的目录为D:\opengrok-0.12.1

3.在openGrok的根目录下新建data和source两个文件夹。目录示意图为

---opengrok

------bin

------data

------doc

------lib

------man

------source

data文件夹用于保存项目的配置文件，source文件夹用于保存源代码工程。

4.把opengrok\lib\目录下的source.war文件复制到tomcat服务器的webapps目录下，在浏览器输入localhost:8080\source,webapps下的source.war会自动解压。

5.打开D:\apache-tomcat-7.0.57\webapps\source\WEB-INF\web.xml文件，修改CONFIGURATION的值，改为openGrok下的data文件夹下的configuration.xml。

注：configuration.xml目前还不存在，在后面建立索引的时候会自动生成

<param-name>CONFIGURATION</param-name>

<param-value>D:/opengrok-0.12.1/opengrok-0.12.1/data/configuration.xml</param-value>

<description>Full path to the configuration file where OpenGrok can read it's configuration</description>

</context-param>

6.安装ctags，把ctags的同样解压到D盘根目录，然后把ctags加到系统环境变量path中。

7.把项目源代码拷贝到openGrok中的source文件夹下。

8.打开windows的DOS窗口。

9.输入以下命令为项目建立索引和配置文件

注：上面的路径是我自己安装的路径，执行命令时把路径修改成自己对应的目录的路径。

10.等上面的命令执行完成后，就可以使用openGrok来阅读项目源代码了，如果项目比较大，像Android源代码，建立索引可能会用很长时间，耐心等待即可。
java -Xmx1024m -jar D:\opengrok-0.12.1\opengrok-0.12.1\lib\opengrok.jar -W "D:\\opengrok-0.12.1\\opengrok-0.12.1\\data\\configuration.xml" -P -S -v -s "D:\\opengrok-0.12.1\\opengrok-0.12.1\\source" -d "D:\\opengrok-0.12.1\\opengrok-0.12.1\\data"