AZSLc Development Guide

CMake minimum version 3.20 is required.

On Windows

> cd D:\GIT\o3de-azslc

There's a convenient prepare_solution_win.bat file that will help with CMake configuration and VS2019 solution generation.

> .\prepare_solution_win.bat
...
...
-- Output libraries to D:/GIT/o3de-azslc/src/dist
-- Configuring done
-- Generating done
-- Build files have been written to: D:/GIT/o3de-azslc/build/win_x64
Press any key to continue . . .

In VS2019 open the solution located in build\win_x64\Azslc.sln.
From here you can work with VS2019, make changes to the code, etc.

Common Things To Know For All Platforms (Windows, MacOS & Linux)

The src/CMakeLists.txt is setup so all the *.cpp & *.h files under the src/ directory will be added to the solution. If you need to add new files, simply add them inside the src/ directory and reconfigure by running the respective prepare_solution_<platform>.sh/.bat.

Running unit tests.

Unit testing is orchestrated with the python script tests/testapp.py. For convenience, on Windows, the batch file tests\launch_tests.bat is provided to run the full test suite for the Release build. When validating the Debug build, you should use test\launch_tests_debug.bat.

Intellisense Support

Jeremy Ong shared an Intellisense configuration file for Visual Studio Code:
https://www.jeremyong.com/graphics/parsers/hlsl/azsl/2022/01/02/azsl-intellisense-prototype/