xmake-vscode

A XMake integration in Visual Studio Code

Introduction

A XMake integration in Visual Studio Code.

You need install xmake first and a project with xmake.lua.

Please see xmake-github and website if you want to known more about xmake.

Features

Quickstart
Colorization
Completion Lists
StatusBar
Commands
Configuration
Build
Run and Debug
Record and Playback
Problem

Quickstart

Colorization and Completion Lists

StatusBar

Commands

Configuration

Build

Run and Debug

Record and Playback

Problem

IntelliSense

Debugging

Debug via launch configurations (launch.json) is accessible only with Run->Start Debugging (not F5 keybinding) or via Launch Debug command.

attribute	type
name	string	Required. Launch configuration name, as you want it to appear in the Run and Debug panel.
type	string	Required. Set to `xmake`.
request	string	Required. Session initiation method:`launch` or `attach`.
target	string	Required. XMake target.
env	object	Additional environment variables. `{"PATH" : "some/path"}`
args	string ❘ [string]	Command line parameters. If not defined args are taken from `debuggingTargetsArguments` config.
cwd	string	If not defined xmake will use the target directory.
stopAtEntry	boolean	If set to true, the debugger should stop at the entry-point of the target (ignored on attach). Default value is false.
terminal	string	Destination of stdio streams: `console` for Debug Console `integrated` (default) for VSCode integrated terminal `external` for a new terminal window `newExternal` for a new terminal window but only with cli application (only cpptools / with lldb it will be converted to `external`)

Example:

{
    "configurations": [
    {
       "name": "XMake Debug",
        "type": "xmake",
        "request": "launch",
        "target": "example",
        "stopAtEntry": true
    }
  ]
}

Configurations related to debugging

Debugger extension

You can choose the debugger extension with xmake.debugConfigType, set it to:

default for cpptools debugger
codelldb for lldb debugger

Envs behaviour

You can choose the behaviour between xmake envs and envs that are defined in launch.json For an xmake envs that are like this {"PATH: "path/from/xmake"} and in launch.json {"PATH": "path/from/config"}.

Default is merge.

With xmake.envBehaviour set to merge, the result is: {"PATH": "path/from/xmake;path/from/config"}.
With xmake.envBehaviour set to erase, the result is: {"PATH": "path/from/xmake"}
And with xmake.envBehaviour set to override, the result is: {"PATH": "path/from/config"}.

XMake envs will only be replaced for the same key, if another xmake env key is present, it will be present in the final result.

Global Configuration

We can configure them in settings.json

{
    "configuration": {
        "type": "object",
        "title": "XMake configuration",
        "properties": {
            "xmake.executable": {
                "type": "string",
                "default": "xmake",
                "description": "The xmake executable name / path"
            },
            "xmake.logLevel": {
                "type": "string",
                "default": "normal",
                "description": "The Log Level: normal/verbose/minimal",
                "enum": [
                    "verbose",
                    "normal",
                    "minimal"
                ]
            },
            "xmake.buildLevel": {
                "type": "string",
                "default": "normal",
                "description": "The Build Output Level: normal/verbose/warning/debug",
                "enum": [
                    "verbose",
                    "normal",
                    "warning",
                    "debug"
                ]
            },
            "xmake.buildDirectory": {
                "type": "string",
                "default": "${workspaceRoot}/build",
                "description": "The Build Output Directory"
            },
            "xmake.installDirectory": {
                "type": "string",
                "default": "",
                "description": "The Install Output Directory"
            },
            "xmake.packageDirectory": {
                "type": "string",
                "default": "",
                "description": "The Package Output Directory"
            },
            "xmake.workingDirectory": {
                "type": "string",
                "default": "${workspaceRoot}",
                "description": "The Project Working Directory with the root xmake.lua"
            },
            "xmake.androidNDKDirectory": {
                "type": "string",
                "default": "",
                "description": "The Android NDK Directory"
            }
        }
    }
}

Symbitic/xmake-vscode