50 lines
2 KiB
Text
50 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.
|