1. Install Windows Subsystem for Linux and Ubuntu
   1. Open Windows Control Panel (Windows Key and type 'Control Panel')
   2. Click on 'Programs'
   3. Click on 'Turn Windows features on or off'
   4. Scroll down and enable 'Windows Subsystem for Linux'
2. Goto the Windows Store and search 'Ubuntu 18.04 LTS'
3. Open Windows Subsystem for Linux (tested with Ubuntu 18.04)
4. Change directories to where you'd like to store the cpputest repo. Ideally keep this at the same level as the code to be tested.
5. Clone cppUtest (git clone https://github.com/cpputest/cpputest.git)
6. Update all packages 'sudo apt-get update'
7. Install gcc toolchain, autoconf and build tools sudo apt-get install build-essential autoconf automake libtool g++

You can make cpputest in many ways, here are two potential methods from within WSL (I've had the most success with Cmake).

1. Change directory to cpputest_build
2. Make with cmake cmake ..
3. Run make with make
4. Install with sudo make install

1. Change to the cpputest director cd /mnt/"directory to cppUtest"/cpputest/
2. Run autoreconf script './autoreconf.sh"
3. Change directory to cpputest_build
4. Configure the build ../configure
5. make check
6. make tdd
7. sudo make install

1. From within WSL, add CPPUTEST_HOME to profile, example:
   1. Use vim to edit vim ~/.profile
   2. Append line export CPPUTEST_HOME=/mnt/"directory to cppUtest"/cpputest
   3. Save file (Esc, x)
2. Copy the library folder from make install, to CPPUTEST_HOME: cp -a /usr/local/lib $CPPUTEST_HOME
3. From cmd or Powershell, set the WSL default user ubuntu config --default-user username (https://docs.microsoft.com/en-us/windows/wsl/user-support)

The Cpputest makefile resides in the local directory and is configured based on the project under test. As an example, use the makefile from James Grenning: https://github.com/jwgrenning/cpputest-starter-project.

1. Add source files and/or directories of test files (SRC_FILES += and/or SRC_DIRS +=).
2. Add test files and/or directories of test files (TEST_SRC_FILES += and/or TEST_SRC_DIRS +=).
3. Add directory of Mocks, stubs, and fakes (MOCS_SCR_DIRS +=)
4. Eable CppUMock: CPPUTEST_USE_EXTENSIONS = Y
5. Add source include directory (INCLUDE_DIRS +=)
6. Adjust the CppuTest objs directory as needed
7. Adjust the compiler flags
8. Add additional libraries as needed (LD_LIBRARIES += -lgcov for coverage report)
9. Enable coverage reporting: CPPUTEST_USE_GCOV = Y
10. Add project specific defines as needed (example: CPPUTEST_CFLAGS += -DSTEM32F429xx)

• From WSL: make clean, then make gcov
• Windows cmd/Powershell: bash --login -c "make clean", then bash --login -c "make gcov" ("--login" is needed to take advantage of the CPPUTEST_HOME path variable.)

Note: make gcov is used to make with coverage report, use make all if coverage report is not desired.

In essence, runs the same commands from the Windows cmd/Powershell manual steps. See cpputest_runner.bat

1. Forked from James Grenning: https://github.com/jwgrenning/cpputest-starter-project
   • A cpputest starter project
   • See the readme directory: cpputest-starter-kit-readme.pdf or cpputest-starter-kit-readme.rtf
2. https://github.com/miguelmoraperea/guide_setup_cpputest_eclipse_win_7