LXR 索引Android(安卓)源码
16lz
2022-05-02
最近在学习android 源码，为了便于查看和搜索代码，利用LXR 建立了android 源码索引环境，非常方便。
LXR 本身是建立对linux 源码进行索引的，本身对C 语言的代码索引有很好的支持，在LXR 最新版本（我用的是lxr-0.9.10）已经支持对java 代码进行索引，因此，可以很好的实现对android代码进行索引。
在Ubuntu 10.10 搭建LXR 环境步骤：
1.安装 apache2, MySQL and exuberant-ctags.
2.在安装mysql-server时，你需要为root 用户创建一个密码才可完成安装, 接着，安装a perl library, 确保你可以连接数据库。安装和perl 相关的库:
3.下载lxr
http://sourceforge.net/projects/lxr/
在lxr 官网下载lxr，我下载的是lxr-0.9.10.tgz,默认下载到本地DOwnloads 文件夹下.
4. 配置lxr
解压缩lxr-0.9.10.tgz 到 /usr/local/share . 改名为lxr，执行以下命令即可：
5.配置数据库
首先登录数据库，使用直接创建的root 用户和密码
初始化MySQL server, 运行如下命令建立索引数据系统:
注意：为了确保初始化过程正确，需要在你的lxr目录下，即/usr/local/share/lxr 运行以上命令. 否则，在初始化数据库的时候无法找到initdb-mysql脚本。
退出数据库
6.配置LXR.
此时，我们还在lxr 目录下. 首先，我们需要拷贝默认的 lxr.conf 文件到lxr 根目录.
接着，配置lxr，用编辑器打开lxr.conf
我使用的是开源搜索引擎swish-e取代glimpse，因为swish-e是完全开源的，而glimpse是商业的，下载安装swish-e：
在lxr.conf 配置文件中注释掉glimpse相关的行，如下所示:
现在给出swish-e 的执行路径,可以通过使用 “which swish-e” 命令找到。我系统的swish-e执行路径是:
, 'swishbin' => '/usr/bin/swish-e'
注意：要确保用户对该文件有执行权限，如果遇到问题，可以通过“chmod”使用户有执行权限，下一步配置lxr的 ctags and configuration:
现在定义 server’s URL.首先给出 base URL，如下:
接着你可以添加主机的IP addresses，这样通过网络也可以访问LXR， addresses to URL aliases like the following:
接着我们指出源码所在的文件夹(下载android 源码)，确保通过索引可以找到源码。android 源码可有多个版本，因此可将其放在一个主文件夹下，该文件夹可包含多个子目录，如android2.3.4，android 2.3.5 ，即每个版本要分别对应一个子目录。例如，我用一个文件夹lxr_source,作为源文件目录，如下所示：
在lxr_source文件夹下，我有两个子目录 v1 and v2.我的源码分别在这两个子目录下，我需要告诉LXR 这些源码并且对他们进行索引. 通过在lxr.conf 文件如下行进行配置 :
接着设置默认版本是 version 2:
接着配置数据库连接。删除 “#” 字符并且设置用户名和密码是你之前创建的用户和密码:
最后设置swish-e 索引目录，要和源码目录分开，例如:
通过以上操作，我们完成了lxr.conf 文件的配置. 接着，我们开始索引操作，进入/usr/local/share/lxr 目录执行以下命令:
这个命令将索引你源码目录下的所有版本，如果你想对某个版本进行索引，可以执行如下命令：
由于android 源码很大，索引操作大概持续了4个小时，一旦对整个源码进行索引，下次索引的时候，只对修改和添加的部分进行索引，这样时间就很快了。
7.配置apache2 server
首先，在任意目录下创建 lxrserver.conf 文件（名称任意）:
在文件中添加如下代码:
将该文件移动到 apache2的 conf.d 的目录下:
接着我们进入 /usr/local/share/lxr 目录，执行如下命令：
到此我们完成了apache2 的配置
8.启动apache2
9.查看代码索引
通过以上全部操作和配置，我们可以进行代码索引，打开浏览器，输入
http://localhost/lxr/source ，即可
我们可以对android中的java 代码，c 代码中变量，函数进行索引，可以对文件进行索引。
遇到的几个问题：
1. http://localhost/lxr/source 查看代码的时候，LXR 不正常工作？
解决方案，修改/usr/local/share/lxr 目录下 source, ident, diff and search 文件的第一行，将原先第一行：
修改为：
即可，通过“which perl” 命令可查看perl 文件的位置
2.LXR 工作后，发现android源码中对变量、函数无法进行索引，查明原因是在建立索引的过程中，对android 源码中prebuilt 目录进行索引产生了错误，导致不能实现变量，函数的索引，删掉该函数，重新索引一次，即可。
推荐参考文档：
http://egemengozoglu.com/blog/2011/07/lxr-installation-on-ubuntu-10-10/
lxr 下载：http://sourceforge.net/projects/lxr/
lxr 官网安装教程：http://lxr.sourceforge.net/InstallSteps/install1tools.shtml
非常好，对LXR 的搭建起了很大的帮助。
LXR 本身是建立对linux 源码进行索引的，本身对C 语言的代码索引有很好的支持，在LXR 最新版本（我用的是lxr-0.9.10）已经支持对java 代码进行索引，因此，可以很好的实现对android代码进行索引。
在Ubuntu 10.10 搭建LXR 环境步骤：
1.安装 apache2, MySQL and exuberant-ctags.
sudo apt-get install apache2 mysql-server exuberant-ctags
2.在安装mysql-server时，你需要为root 用户创建一个密码才可完成安装, 接着，安装a perl library, 确保你可以连接数据库。安装和perl 相关的库:
sudo apt-get install libdbi-perl libdbd-mysql-perl libfile-mmagic-perl libapache2-mod-perl2
3.下载lxr
http://sourceforge.net/projects/lxr/
在lxr 官网下载lxr，我下载的是lxr-0.9.10.tgz,默认下载到本地DOwnloads 文件夹下.
4. 配置lxr
解压缩lxr-0.9.10.tgz 到 /usr/local/share . 改名为lxr，执行以下命令即可：
cd /usr/local/sharesudo mv /home/beaver/Downloads/lxr-0.9.10.tgz .sudo tar -zxf lxr-0.9.10.tgzsudo mv lxr-0.9.10 lxrcd lxr
5.配置数据库
首先登录数据库，使用直接创建的root 用户和密码
mysql -u root -p #Enter the password when asked.
初始化MySQL server, 运行如下命令建立索引数据系统:
CREATE USER 'lxr'@'localhost' identified by 'foo'; #Creates the user "lxr" with the password "foo"\. initdb-mysql #Initializes the lxr database by creating the tables and give "lxr" user the needed permissions.
注意：为了确保初始化过程正确，需要在你的lxr目录下，即/usr/local/share/lxr 运行以上命令. 否则，在初始化数据库的时候无法找到initdb-mysql脚本。
退出数据库
exit
6.配置LXR.
此时，我们还在lxr 目录下. 首先，我们需要拷贝默认的 lxr.conf 文件到lxr 根目录.
sudo cp templates/lxr.conf .
接着，配置lxr，用编辑器打开lxr.conf
sudo vim lxr.conf
我使用的是开源搜索引擎swish-e取代glimpse，因为swish-e是完全开源的，而glimpse是商业的，下载安装swish-e：
sudo apt-get install swish-e
在lxr.conf 配置文件中注释掉glimpse相关的行，如下所示:
#, 'glimpsebin' =>'/usr/local/bin/glimpse'#, 'glimpseindex' => '/usr/local/bin/glimpseindex'
现在给出swish-e 的执行路径,可以通过使用 “which swish-e” 命令找到。我系统的swish-e执行路径是:
, 'swishbin' => '/usr/bin/swish-e'
注意：要确保用户对该文件有执行权限，如果遇到问题，可以通过“chmod”使用户有执行权限，下一步配置lxr的 ctags and configuration:
, 'ectagsconf' => '/usr/local/share/lxr/lib/LXR/Lang/ectags.conf', 'genericconf' => '/usr/local/share/lxr/lib/LXR/Lang/generic.conf'
现在定义 server’s URL.首先给出 base URL，如下:
,'baseurl' => 'http://localhost/lxr'
接着你可以添加主机的IP addresses，这样通过网络也可以访问LXR， addresses to URL aliases like the following:
, 'baseurl_aliases' => [ 'http://17.2.0.193/lxr']
接着我们指出源码所在的文件夹(下载android 源码)，确保通过索引可以找到源码。android 源码可有多个版本，因此可将其放在一个主文件夹下，该文件夹可包含多个子目录，如android2.3.4，android 2.3.5 ，即每个版本要分别对应一个子目录。例如，我用一个文件夹lxr_source,作为源文件目录，如下所示：
, 'sourceroot' => '/home/beaver/lxr_source'
在lxr_source文件夹下，我有两个子目录 v1 and v2.我的源码分别在这两个子目录下，我需要告诉LXR 这些源码并且对他们进行索引. 通过在lxr.conf 文件如下行进行配置 :
, 'range' => [qw(v1 v2)]
接着设置默认版本是 version 2:
, 'default' => 'v2'
接着配置数据库连接。删除 “#” 字符并且设置用户名和密码是你之前创建的用户和密码:
,'dbpass' =>'foo', 'dbuser' => 'lxr'
最后设置swish-e 索引目录，要和源码目录分开，例如:
, 'swishdir' => '/home/beaver/swish/'
通过以上操作，我们完成了lxr.conf 文件的配置. 接着，我们开始索引操作，进入/usr/local/share/lxr 目录执行以下命令:
./genxref --url=http://localhost/lxr --allversions
这个命令将索引你源码目录下的所有版本，如果你想对某个版本进行索引，可以执行如下命令：
./genxref --url=http://localhost/lxr --version=v1
由于android 源码很大，索引操作大概持续了4个小时，一旦对整个源码进行索引，下次索引的时候，只对修改和添加的部分进行索引，这样时间就很快了。
7.配置apache2 server
首先，在任意目录下创建 lxrserver.conf 文件（名称任意）:
sudo vim lxrserver.conf
在文件中添加如下代码:
Alias /lxr /usr/local/share/lxr<Directory /usr/local/share/lxr> Options All AllowOverride All</Directory>
将该文件移动到 apache2的 conf.d 的目录下:
sudo cp lxrserver.conf /etc/apache2/conf.d/
接着我们进入 /usr/local/share/lxr 目录，执行如下命令：
sudo cp .htaccess_cgi .htaccess
到此我们完成了apache2 的配置
8.启动apache2
sudo /etc/init.d/apache2 restart
9.查看代码索引
通过以上全部操作和配置，我们可以进行代码索引，打开浏览器，输入
http://localhost/lxr/source ，即可
我们可以对android中的java 代码，c 代码中变量，函数进行索引，可以对文件进行索引。
遇到的几个问题：
1. http://localhost/lxr/source 查看代码的时候，LXR 不正常工作？
解决方案，修改/usr/local/share/lxr 目录下 source, ident, diff and search 文件的第一行，将原先第一行：
#!perl -T
修改为：
#!/usr/bin/perl
即可，通过“which perl” 命令可查看perl 文件的位置
2.LXR 工作后，发现android源码中对变量、函数无法进行索引，查明原因是在建立索引的过程中，对android 源码中prebuilt 目录进行索引产生了错误，导致不能实现变量，函数的索引，删掉该函数，重新索引一次，即可。
推荐参考文档：
http://egemengozoglu.com/blog/2011/07/lxr-installation-on-ubuntu-10-10/
lxr 下载：http://sourceforge.net/projects/lxr/
lxr 官网安装教程：http://lxr.sourceforge.net/InstallSteps/install1tools.shtml
非常好，对LXR 的搭建起了很大的帮助。
更多相关文章
- android user版本进行编译出现proguard错误混淆
- Android应用Preference相关及源码浅析(SharePreferences篇)
- Android最新源码4.3下载-教程 2013-11
- 对Android的理解
- Android利用Binder进行通信
- 安卓系统结构
- Android(安卓)AlarmManager实现定时任务（也就是闹钟） 附Demo源码
- 最新res索引讲解（drawable、layout、values等目录的分辨率和layou
- android 视频播放器 android videoView 按不同比例缩放 .