https://github.com/wang-bin/cmake-tools
Cmake utilities for C++11 projects targeting Windows(host/cross build), Raspberry Pi (host/cross build), macOS, iOS, Android
https://github.com/wang-bin/cmake-tools
android clang clang-cl cmake ios lld maccatalyst macos raspberry-pi rpi windows winrt
Last synced: 4 months ago
JSON representation
Cmake utilities for C++11 projects targeting Windows(host/cross build), Raspberry Pi (host/cross build), macOS, iOS, Android
- Host: GitHub
- URL: https://github.com/wang-bin/cmake-tools
- Owner: wang-bin
- License: mit
- Created: 2017-03-05T06:55:57.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-23T15:50:53.000Z (5 months ago)
- Last Synced: 2024-12-23T16:38:53.082Z (5 months ago)
- Topics: android, clang, clang-cl, cmake, ios, lld, maccatalyst, macos, raspberry-pi, rpi, windows, winrt
- Language: CMake
- Homepage:
- Size: 402 KB
- Stars: 37
- Watchers: 6
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Windows Cross Build via Clang-CL + LLD
toolchain file: windows.clang.cmake
MSVC ABI compatible. Supports x86, x64, arm64(clang-8+).
#### Requirements
- Copy of Windows SDK, only Include and Lib are used
- Copy of msvc sdk, only include and lib are used
#### Options
- WINSDK_DIR (or environment var WindowsSdkDir): win10 sdk dir containing Include and Lib
- WINSDK_VER (or environment var WindowsSDKVersion): win10 sdk version
- MSVC_DIR (or environment var VCDIR): msvc dir containing include and lib
- UWP: build for uwp
- PHONE: build for windows phone
- ONECORE: use onecore
- USE_LIBCXX: use libc++ instead of msvcp
#### Defined CMake Vars
- WINRT: true if UWP or PHONE is set
- WINSTORE: same as WINRT
- WINDOWS_DESKTOP: not WINRT
- WINDOWS_XP: if CMAKE_SYSTEM_VERSION < 6.0
#### Defined C/C++ Macros
- _WIN32_WINNT
## Generic Linux Clang+LLD Toolchain
toolchain file: linux.clang.cmake
Clang(set by CMAKE_C_COMPILER or auto detect) and LLVM tools are auto detected and highest version is selected.
#### Options
Also applies for raspberry pi, sunxi etc.
- USE_LIBCXX: use libc++ instead of libstdc++
- USE_CXXABI: can be c++abi, stdc++ and supc++. Only required if libc++ is built with none abi
- USE_COMPILER_RT: use compiler-rt instead of libgcc as compiler runtime library
- USE_STDCXX: libstdc++ version to use, MUST be >= 4.8. default is 0, selected by compiler
- LINUX_SYSROOT: sysroot dir
## Legacy Raspberry Pi Host/Cross Build via Clang + LLD
toolchain file: rpi.clang.cmake
NOTE: using linux.clang.cmake and a generic linux sysroot is enough for a modern arm64 rpi OS. Legacy rpi(1~3) includes brcm libraries.
#### Requirements
- [Sysroot](https://sourceforge.net/projects/avbuild/files/raspberry-pi/rpi-sysroot.tar.xz/download)
#### Options
- USE_LIBCXX (optional, default off): use libc++ instead of libstdc++
#### Defined CMake Vars
- CMAKE_SYSTEM_PROCESSOR: armv6
- RPI: 1
- OS: rpi
- CMAKE_CROSSCOMPILING: auto detected
#### Defined C/C++ Macros
- OS_RPI
## iOS
toolchain file: ios.cmake (https://github.com/wang-bin/ios.cmake)
#### Options
- IOS_ARCH: can be armv7, arm64, i386, x86_64 and any combination of above, e.g. "arm64;x86_64" to build universal 64bit binaries
- IOS_BITCODE (optional, default off)
- IOS_EMBEDDED_FRAMEWORK (optional, default off)
- IOS_DEPLOYMENT_TARGET (optional)
## Additional Tools
`include(tools.cmake)` after `project(...)`
#### Features
- Dead code elimination
- ELF hardened (through option `ELF_HARDENED`, default is on)
- ELF separated debug symbol
- Windows XP support for VC (through option `WINDOWS_XP`, default is on)
- Android system stdc++ dependency removal
- LTO: USE_LTO=thin/0/1/N/AUTO, default is off
- C++11 support for macOS 10.7
- asan, ubsan
- uninstall template
#### Defined CMake Vars
- ARCH: x86, x64, ${ANDROID_ABI}, empty for apple multi-arch build
- WINRT, WINSTORE
- OS=rpi, iOS, macOS, WinRT, android
#### Functions
- enable_ldflags_if
- mkdsym: create elf debug symbol file
- mkres: convert any binary to C/C++ byte array
- set_relocatable_flags: enable relocatable object target
- exclude_libs_all: forbid exporting symbols from static dependencies
- set_rpath: rpath/runpath flags for ELF and Mach-O
- target_sources: compatible implementation for cmake < 3.1
#### Defined C Macros
- OS_RPI: if build for raspberry pi