Developing for Windows

Step 1: Install tools and dependencies

Install Visual Studio 2022 (MSVC 14.44.35211)

• Install workload: "Desktop development with C++"
• Check:
  • MSVC 14.44.35211
  • Windows 10/11 SDK
• Open VS Installer, select Desktop development with C++
• Check MSVC, Windows 10/11 SDK
• After installation, launch VS once to initialize components

Install xmake

Recommended to install using scoop or choco. Choose either:

• scoop:

  scoop install xmake

• chocolatey:

  choco  install xmake

• Verify:

  xmake --version

Step 2: Get source code and compile run

Choose your own working directory, for example E:\TestFile:

cd E:\TestFile
git clone git@gitee.com:XmacsLabs/mogan.git
cd mogan

Use xmake to configure and build

xmake project configuration

xmake config --yes -vD -m releasedbg --plat=windows --vs_runtime=MT

If previous build failed, clear old cache first

xmake f -c
xmake c -a

Build project

xmake build stem

Install target

xmake install stem

Run program

xmake run stem

Optional: Vscode support

Developers using Vscode can use xmake to generate compile_command.json, which can be recognized by C/C++ plugin to provide semantics highlight and so on.

xmake project --kind=compile_commands ./.vscode

then modify .vscode/c_cpp_properties.json to tell C++ lsp configs of this project:

{
    {
    "configurations": [
        {
            // other configs
            "compilerPath": "<your configuration>",
            "cppStandard": "gnu++17",
            "intelliSenseMode": "windows-gcc-x64",
            "compileCommands": ".vscode/compile_commands.json"
        }
    ],
}
}