[Windows][VC2022][CMake] Compiling Canary Sources

1 - Downloads Required:

2 - Visual Studio 2022:

  • On the Visual Studio home screen, in the Visual Studio Community 2022 product click the Install button.

  • On the next screen under Workloads select Desktop Development with C++:

  • Then in Language Packs, select English:

  • Then click the Install button.

3 - Install the necessary software:

  • Install Git.

4 - VCPKG:

If you don't have vcpkg installed

Use Powershell in directory C:

  • cd C:\

• To complete vcpkg installation, run the commands below in Powershell:

  • git clone https://github.com/microsoft/vcpkg

  • cd vcpkg

  • .\bootstrap-vcpkg.bat

  • .\vcpkg integrate install

If you already have vcpkg installed

Use Powershell in directory C:

  • cd C:\vcpkg

• To update vcpkg installation, run the commands below in Powershell:

  • git pull

  • .\vcpkg upgrade

  • .\vcpkg upgrade --no-dry-run

  • .\bootstrap-vcpkg.bat

5 - Integration of vcpkg into Visual Studio:

  • Execute the following command in Powershell with Administrator permission to set vcpkg environment variable:

[System.Environment]::SetEnvironmentVariable('VCPKG_ROOT','C:\vcpkg', [System.EnvironmentVariableTarget]::Machine)

6 - Canary Sources:

  • Download Canary sources with the command below in Powershell:

cd C:\

git clone --recursive https://github.com/opentibiabr/canary.git

7 - Compiling Canary Sources:

  • Open Visual Studio 2022, in the "Get Started" window, select "Open the local folder" and open the server main folder.

  • Wait for the Visual Studio to load. It will automatically install the libraries and generate the cmake cache. (Be patient, the first cache may take a few minutes).

  • After the cmake cache is successfully generated, you can compile the server by going to the Build > Build All menu.

  • Note: Check if the build is Windows-Release before compile the server. If not, you can choose the option in the configuration drop down menu, generate the cmake cache by going to Project > Configure Cache menu then compile the server by going to the Build > Build All menu.

8 - Credits:

Majesty (Canary compilation tutorial on VS2022)

Microsoft - VCPKG: https://github.com/Microsoft/vcpkg

Last updated