bob-project
Name
bob-project - Create IDE project files
Synopsis
bob project [-h] [--list] [-D DEFINES] [-c CONFIGFILE] [-e NAME] [-E]
[--download MODE] [--resume] [-n] [-b] [-j [JOBS]]
[--sandbox | --no-sandbox]
[projectGenerator] [package] ...
Description
Generate Project Files.
Options
-c CONFIGFILE
Use config File
--download MODE
Download from binary archive (yes, no, deps, packages)
See bob-dev(1) for details.
-D DEFINES
Override default environment variable
-e NAME
Preserve environment variable
-E
Preserve whole environment
-j, --jobs
Specifies the number of jobs to run simultaneously.
--list
List available Generators
-n
Do not build (bob dev) before generate project Files. RunTargets may not work
--no-sandbox
Disable sandboxing
-b
Do build only (bob dev -b) before generate project Files. No checkout
--resume
Resume build where it was previously interrupted
--sandbox
Enable sandboxing
Eclipse CDT project generator
bob project eclipseCdt <package> [-h] [-u] [--buildCfg BUILDCFG] [--overwrite]
[--destination DEST] [--name NAME]
[--exclude EXCLUDES] [-I ADDITIONAL_INCLUDES]
The Eclipse CDT generator has the following specific options. They have to be passed on the command line after the package name.
--buildCfg BUILDCFG
Adds a new buildconfiguration. Format: <Name>::<flags>. Flags are passed to bob dev. See bob dev for a list of availabe flags.
--destination DEST
Destination of project files.
--exclude EXCLUDES
Packages will be marked as ‘exclude from build’ in eclipse. Usefull if indexer runs OOM.
-I ADDITIONAL_INCLUDES
Additional include directories.
--name NAME
Name of project. Default is complete_path_to_package
--overwrite
Remove destination folder before generating.
-u, --update
Update project files (.project).
QtCreator project generator
bob project qt-project <package> [-h] [-u] [--buildCfg BUILDCFG] [--overwrite]
[--destination DEST] [--name NAME]
[-I ADDITIONAL_INCLUDES] [-f Filter]
[--exclude Excludes] [--include Includes] [--kit KIT]
[-S START_INCLUDES] [-C CONFIG_DEF]
This generator also supports generation of project files for native Windows QtCreator by using MSYS2. The prerequisite is, that MSYS2 must be started by msys2_shell.cmd script.
The QtCreator project generator has the following specific options. They have to be passed on the command line after the package name.
--buildCfg BUILDCFG
Adds a new buildconfiguration. Format: <Name>::<flags>
--destination DEST
Destination of project files
-f Filter, --filter Filter
File filter. A regex for matching additional files.
--exclude Excludes
Package filter. A regex for excluding packages in QTCreator.
--include Includes
Include package filter. A regex for including only the specified packages in QTCreator. Use single quotes to specify your regex. For exmaple: –include ‘foobar-.*’ You can also mix the Includes with the Excludes. In this case always use the Includes option beforehand. For example: –include ‘foobar-.*’ –exclude ‘foobar-baz’ This will ensure you only include packages wtih foobar-* but excludes the foobar-baz package.
-I ADDITIONAL_INCLUDES
Additional include directories.
--kit KIT
Name of the kit to use for this project.
Qt Creator usually auto-detects your installed compilers on the system and creates one or more “kits” based on the detected settings. Bob will use the “Desktop” kit by default. The generator cannot create a project if QtCreator is not installed. If the “Desktop” kit is missing you have to create one or specify an existing one with the
--kit
option.See the online documentation 1 for more information.
--name NAME
Name of project. Default is complete_path_to_package
--overwrite
Remove destination folder before generating.
-u, --update
Update project files (.files, .includes, .config)
-S START_INCLUDES
Additional include directories, will be placed at the beginning of the include list.
-C CONFIG_DEF
Add line to .config file. Can be used to specify preprocessor defines used by the QTCreator.
Visual Studio Code project generator
bob project vscode <package> [-h] [--name NAME] [--destination DEST]
[--exclude EXCLUDES]
[--include INCLUDE] [-I ADDITIONAL_INCLUDES]
[-S START_INCLUDES] [--sort]
The Visual Studio Code generator will generate a single .code-workspace file which could be opened in the Visual Studio Code.
The Visual Studio Code generator has the following specific options. They have to be passed on the command line after the package name.
--name NAME
Name of project. Default is package_name
--destination DEST
Destination of project files.
--exclude EXCLUDES
Package filter. A regex for excluding packages in VSCode.
--include INCLUDE
Include package filter. A regex for including only the specified packages in VSCode. Use single quotes to specify your regex. For exmaple: –include ‘foobar-.*’ You can also mix the Includes with the Excludes. In this case always use the Includes option beforehand. For example: –include ‘foobar-.*’ –exclude ‘foobar-baz’ This will ensure you only include packages wtih foobar-* but excludes the foobar-baz package.
-I ADDITIONAL_INCLUDES
Additional include directories.
-S START_INCLUDES
Additional include directories, will be placed at the beginning of the include list.
--sort
Sort the dependend packages by name (default: unsorted)