GettingStarted.txt 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. Place the library's root folder inside of a new folder.
  2. This allow keeping your own projects and the "temporary" folder that's
  3. used for compiling quickly outside of the library's version history.
  4. If using Linux, you might need to install the X11 headers.
  5. If it doesn't work, your Linux distro might not have an X11 server.
  6. On debian based distributions:
  7. sudo apt-get install libx11-dev
  8. If using a Raspberry Pi, you can use Raspbian (Buster or newer for X11 support) or Ubuntu Mate.
  9. Build and run an example program on Linux:
  10. * Select an SDK example and open its folder in a terminal.
  11. * Give permission to execute the build script.
  12. chmod +x build.sh
  13. * Run the build script.
  14. ./build.sh
  15. Run regression tests on Linux:
  16. * Open the source folder in a terminal and run the test script:
  17. chmod +x test.sh
  18. ./test.sh
  19. Create your own Linux project
  20. * Copy one of the SDK examples.
  21. * Change ROOT_PATH and TEMP_DIR in your build script
  22. to refer to the same locations from a new source path.
  23. * Add your own external dependencies to LINKER_FLAGS within a quote
  24. with -l in front of each library name.
  25. Creating a terminal application
  26. If your application doesn't create any window, you can make it more portable
  27. by replacing "WINDOW_MANAGER=X11" with "WINDOW_MANAGER=NONE".
  28. This will compile with NoWindow.cpp instead of X11Window.cpp in windowManagers.
  29. Create your own cross-platform CodeBlocks project:
  30. * Select C++ 14 with G++ from the GCC toolchain.
  31. * Link with "-lm -pthread" to get standard C++ math and threading.
  32. * Include all source files in the DFPSR folder or just the ones you need.
  33. * Include the window wrapper and its dependencies for each target build.
  34. Most platforms will be targeted using NoWindow.cpp for text only.
  35. This should work with most other IDEs that support the GCC toolchain.