oxmox
17f68cf8fe
git-subtree-dir: external/nng git-subtree-split: 169221da8d53b2ca4fda76f894bee8505887a7c6
49 lines
2 KiB
Text
49 lines
2 KiB
Text
ifdef::env-github[]
|
|
:note-caption: :information_source:
|
|
endif::[]
|
|
|
|
= Building for Cross Compilation
|
|
|
|
TIP: Cross-compiling is used when the operating system or process architecure
|
|
the software is being built for is different than the system where the software
|
|
is being compiled. If you don't know what this means, this does not apply to
|
|
and you should ignore this file.
|
|
|
|
When building for cross-compilation, you can use CMake's native support
|
|
`CMAKE_TOOLCHAIN_FILE` to configure the location of the toolchain.
|
|
|
|
You'll need that toolchain to have your compiler, linker, header files,
|
|
and possibly any other libraries that need to be linked at build time.
|
|
|
|
This is all relatively standard stuff for CMake.
|
|
|
|
A lot more detail is located here: https://gitlab.kitware.com/cmake/community/wikis/doc/cmake/CrossCompiling
|
|
|
|
NOTE: When _NNG_ detects that it is being built in a Cross-Compile
|
|
situation (i.e. when `CMAKE_CROSSCOMPILING` is true), it will default
|
|
to disabling the building of the test suite and tools.
|
|
This is normally preferable, since many embedded environments cannot host
|
|
command line applications or shell environments. +
|
|
+
|
|
To enable tools or tests to build anyway, the values of either
|
|
`NNG_TOOLS` or `NNG_TESTS` (or both) may be set to `ON`.
|
|
|
|
== Cross-compiling for Android
|
|
|
|
More details for Android are located in the <<BUILD_ANDROID.adoc>> file.
|
|
|
|
== Cross-compiling for iOS
|
|
|
|
More details for iOS (and tvOS, etc.) are located in the <<BUILD_IOS.adoc>> file.
|
|
|
|
== Cross-compiling for Windows or Linux or MACOS - Using vcpkg
|
|
|
|
You can download and install nng using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager:
|
|
|
|
git clone https://github.com/Microsoft/vcpkg.git
|
|
cd vcpkg
|
|
./bootstrap-vcpkg.sh
|
|
./vcpkg integrate install
|
|
./vcpkg install nng
|
|
|
|
The nng port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
|