The Visual Studio sln file, xAFVirtualAmp.sln, is generated and built by Python using cmake. Be sure you install Python
2.7 and add the installed location to the “Paths” environment variable under System Properties.
To generate and build a solution:
1. By default, the solution virtual device wrapper is configured to work with one instance. If you would like to run multiple
instances, you will need to modify the xAFVirtualAmpEffect.cpp and xAFVirtualAmpEffect.h files.
2. Configure the build by enabling or disabling the audio objects in extendable-audio-framework\build\
externalObjConfig.cmake.
You can toggle the fields on and off by setting the macros above to one or zero.
3. Once the above configuration is completed, open the command window and navigate to the xAF repository
base directory.
4. To generate and build the Visual Studio project for the Win32 platform:
a. Release mode –type build.py –platform=WinPc –target=Win32 –profile=Release
b. Debug mode – type build.py –platform=WinPc –target=Win32 –profile=Debug
xAF libraries and VirtualAmp dll will be generated in the \public\lib\win32\Release folder for the Release mode
and in the \public\lib\win32\Debug folder for the Debug mode.
Page 7 of 17
xAF_Startup_Guide.docx Confidential / © by HARMAN CoC Lifestyle Audio
If you want to open the Visual Studio solution files, go to the output build_dir_Win32 folder and open
xAFVirtualAmp.sln with administrator privileges.
5. To generate and build a Visual Studio project for the Win64 platform:
a. Release mode – type build.py –platform=WinPc –target=Win64 –profile=Release
b. Debug mode – type build.py –platform=WinPc –target=Win64 –profile=Debug
xAF libraries and virtualamp dll will be generated in the \public\lib\win64\Release folder for the Release mode
and in the \public\lib\win64\Debug folder for the Debug mode.
If you want to open the Visual Studio solution files, go to the output build_dir_Win64 folder and open
xAFVirtualAmp.sln with administrator privileges.
6. To run the xAF unit test:
a. Release mode – type build.py –platform=WinPc –target=Win32 –profile=Release –program=unitTest
b. Debug mode – type build.py –platform=WinPc –target=Win32 –profile=Debug –program=unitTest
Unit tests are not currently supported on the Win64 platform.
7. To clean the build artifacts – type build.py –platform=WinPc –clean
8. The xAF has tested the solution file using Microsoft Visual Studio 2015 Professional. Older versions may not
work.