CX::PM for Visual Studio Code
Build, test, pack and install cxpm projects without leaving the editor.
Open a folder with a package.cpp and CX::PM finds your projects, targets and toolchains, runs every step of
the lifecycle in one click, and takes you from an error straight to the line that caused it.
What you get
- Every project at a glance. The Project Outline lists your projects, their targets, sources, dependencies,
options and tasks, as cxpm configured them.
- One click for every step. Configure, Build, Test, Pack, Install and Run Task from the palette, the status bar
or the outline. Each step runs in the terminal, can be cancelled, and reports its errors in the Problems panel.
- Run and debug without setup. Pick an executable target and press Debug: it is built first and started under
the debugger you already have, with no hand-written launch configuration.
- Code completion that matches the build. IntelliSense follows the exact settings each file is built with.
- Manifests that write themselves. Completion, hover help and snippets in
package.cpp; Create a Project,
Generate a Manifest, Add and Remove Dependency.
- Tests in the Test Explorer. Run or debug a whole tests project or a single case, and see each result inline.
- Your own tasks. Add
cxpm tasks to your workspace tasks for any step, each with its own folder, toolchain
and options.
Getting started
- Download cxpm and put it on your
PATH, or set cxpm.path.
- Open a folder with a
package.cpp, or run CX::PM: Create a Project.
- Run CX::PM: Configure, then CX::PM: Build.
The guides live at soft-forge.dev/cxpm.
Settings
| Setting |
What it does |
cxpm.path |
Where cxpm is; empty looks on PATH, ~/.local/bin and build/bin |
cxpm.jobs |
How many files build at once; 0 uses every core |
cxpm.toolchain |
The toolchain to build with; set it with Select Toolchain |
cxpm.sysroot |
The sysroot to build against |
cxpm.extraArgs |
Further arguments for every step |
cxpm.environment |
Environment variables for cxpm |
cxpm.saveBeforeBuild |
Save open files before a step |
Every setting is listed under CX::PM in the Settings editor, with its default.
License
MIT.
| |
