YCM-Generator, 为YouCompleteMe生成配置文件

分享于 

4分钟阅读

GitHub

  繁體
Generates config files for YouCompleteMe (https://github.com/Valloric/YouCompleteMe)
  • 源代码名称:YCM-Generator
  • 源代码网址:http://www.github.com/rdnetto/YCM-Generator
  • YCM-Generator源代码文档
  • YCM-Generator源代码下载
  • Git URL:
    git://www.github.com/rdnetto/YCM-Generator.git
    Git Clone代码到本地:
    git clone http://www.github.com/rdnetto/YCM-Generator
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/rdnetto/YCM-Generator
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    YCM-Generator

    这是一个脚本,从任意构建系统的项目中生成编译器标志列表,它可用于:

    • 生成.ycm_extra_conf.py文件供使用
    • 生成.color_coded文件以供使用

    它的工作方式是使用一个伪工具链来构建项目,这个工具链只是过滤将编译器标志存储在生成的文件中。

    它相当快,只需要~10秒就可为Linux内核生成一个配置文件。

    安装

    NeoBundle'rdnetto/YCM-Generator'添加到你的vimrc (或者你的插件管理器)。

    对于vim插件用户,添加Plug 'rdnetto/YCM-Generator', { 'branch': 'stable'} 到你的vimrc。

    或者,Arch Linux用户可以使用AUR软件包安装YCM-Generator 。

    用法

    运行./config_gen.py PROJECT_DIRECTORY,其中PROJECT_DIRECTORY是项目的构建系统的root目录(例如,包含根Makefile等的文件)

    你还可以使用:YcmGenerateConfig:CCGenerateConfig命令在Vim内调用它,来为当前目录生成配置文件,这些命令接受与./config_gen.py相同的参数,但不需要指定项目目录(它默认为当前工作目录)。

    要求和限制

    要求:

    • python 2
    • Clang

    支持的构建系统:

    • cmake
    • qmake
    • autotools

    生成系统应支持通过CC /CXX环境变量指定编译器,或者不使用编译器的绝对路径。

    结果配置文件中的某些标志可能相互排斥-建议在使用之前读取生成的文件。

    脚本假定clangclang++名为的可执行文件存在于PATH中,这在Ubuntu下导致问题,其中C++编译器可以称为clang++-3.6 (请参见#50). )。

    文档&支持

    • 运行./config_gen.py --help查看支持选项的完整列表
    • 如果收到错误消息ERROR: No commands were logged to the build logs 尝试使用--verbose标志查看错误消息
    • 某些构建系统需要设置某些环境变量,注意,除非使用YCM-Generator,否则--preserve-environment默认不使用
    • 如果打开有关这个错误消息的问题,请在使用--verbose运行时包含输出,并链接到项目repo (如果可能)

    开发

    欢迎使用补丁请提交对develop分支的请求。


    相关文章