wxWidgets/build/cmake
Tobias Taschner 183ba1cb4c Set NSPrincipalClass to wxNSApplcation for CMake builds too
This setting is important for some functionality provided by
wxNSApplcation and most importantly without the setting all samples
where only shown scaled on high DPI displays.

Notice that it was already present in src/osx/carbon/Info.plist.in which
is used for the samples in autoconf build.

Closes https://github.com/wxWidgets/wxWidgets/pull/743
2018-05-02 15:53:09 +02:00
..
demos CMake: Set Visual Studio working directory 2018-01-11 22:09:43 +01:00
lib Fix cross-compiling with CMake due to wrong ws2_32 case 2018-04-04 16:53:15 +02:00
modules CMake: Update cotire to 1.7.10 2018-01-11 22:09:52 +01:00
samples CMake: Disable dialup sample in macOS 2018-03-23 22:00:29 +01:00
tests CMake: Only link executables to enabled libraries 2018-01-24 00:47:58 +01:00
utils CMake: Only link executables to enabled libraries 2018-01-24 00:47:58 +01:00
config.cmake
files.cmake Add wxLZMAInputStream for decompressing data in XZ format 2018-04-06 15:39:55 +02:00
functions.cmake Set NSPrincipalClass to wxNSApplcation for CMake builds too 2018-05-02 15:53:09 +02:00
init.cmake CMake: Enable multi-processor compilation for MSVC 2018-02-08 21:13:44 +01:00
install.cmake
main.cmake CMake: fix and add more options 2018-01-28 23:52:11 +01:00
options.cmake Merge branch 'lzma' 2018-04-06 15:41:36 +02:00
policies.cmake Use C++11 for tests during CMake configuration if necessary 2018-01-24 16:25:28 +01:00
README.md CMake: Update cmake/README.md 2018-02-06 11:54:50 +01:00
setup.cmake CMake: Additional fixes/tweaks for C++11 on macOS 2018-02-08 11:01:05 +01:00
setup.h.in Check for liblzma headers in configure too and add wxUSE_LIBLZMA 2018-04-06 15:39:39 +02:00
source_groups.cmake
toolkit.cmake Move GTK+/Win32 libraries list to toolkit.cmake file 2018-03-01 01:16:06 +02:00
uninstall.cmake.in

This directory contains CMake files needed to build native build files for wxWidgets.

For building wxWidgets or using wxWidgets in your CMake project please see the CMake overview in the wxWidgets documentation.

CMake files organization

All CMake files are located in $(wx)/build/cmake additionally there is a CMakeLists.txt in the root directory.

Files

  • $(wx)/CMakeLists.txt
    • This should only contain commands and definitions which need to be contained in the top level and includes main.cmake
  • config.cmake
    • Generates config files used to find wxWidgets by other build systems
    • Creates wx-config
  • files.cmake
    • List of source files generated by $(wx)build/upmake from $(wx)build/files
    • This file should usually never be edited manually
    • However if a new group of files is added it needs to be edited manually
  • functions.cmake
    • contains various wxWidgets specific functions and macros used throughout the CMake files
    • Every function should contain a short description of it's parameters as a comment before the function/macro
  • install.cmake
    • Handles defintions for the install and uninstall target
  • init.cmake
    • Intializes various variables used during the build process and for generation of setup.h and configuration files
  • main.cmake
    • Includes all other cmake files
  • options.cmake
    • All user selectable build options should be defined in this file via calls to wx_option()
  • policies.cmake
  • setup.cmake
    • Handles all tests required to create the setup.h header based platform and user settings
  • setup.h.in
    • Template for setup.h updated automatically by $(wx)/build/update-setup-h
  • source_groups.cmake
    • Define source groups used in supported IDEs
  • toolkit.cmake
    • Define toolkit specific options and detection to this file
  • uninstall.cmake.in
    • Used by install.cmake when creating the uninstall target

Sub directories

Each sub directory contains a CMakeLists.txt and might contain various other .cmake files.

  • demos
    • Defines build targets for demos via wx_add_demo()
  • lib
    • Defines build targets for all libraries and bundle third party libraries
    • Each library is contained in a seperate directory and uses wx_add_library() to define the library target
    • Bundled third party library without upstream CMake support are defined in a .cmake file using wx_add_builtin_library() to define static library targets
  • modules
    • Includes CMake modules used to find third party packages via find_package()
    • Includes the cotire module used to for precompiled header generation
  • samples
    • Defines build targets for all samples via wx_add_sample()
    • Defintions for trivial samples are included in CMakeLists.txt more complex samples might have a seperate .cmake file
  • tests
    • Defines build targets for all tests
  • utils
    • Defines build targets for all utilities