2018-03-18 16:01:56 -06:00
|
|
|
### Usage
|
|
|
|
|
|
|
|
To build dependencies for the current arch+OS:
|
|
|
|
|
2019-05-11 22:16:26 -06:00
|
|
|
```bash
|
|
|
|
make
|
|
|
|
```
|
2018-03-18 16:01:56 -06:00
|
|
|
|
|
|
|
To build for another arch/OS:
|
|
|
|
|
2019-05-11 22:16:26 -06:00
|
|
|
```bash
|
|
|
|
make HOST=host-platform-triplet
|
|
|
|
```
|
2018-03-18 16:01:56 -06:00
|
|
|
|
|
|
|
For example:
|
|
|
|
|
2019-05-11 22:16:26 -06:00
|
|
|
```bash
|
|
|
|
make HOST=x86_64-w64-mingw32 -j4
|
|
|
|
```
|
2018-03-18 16:01:56 -06:00
|
|
|
|
2018-11-24 07:20:44 -07:00
|
|
|
A toolchain will be generated that's suitable for plugging into Monero's
|
|
|
|
cmake. In the above example, a dir named x86_64-w64-mingw32 will be
|
|
|
|
created. To use it for Monero:
|
2018-03-18 16:01:56 -06:00
|
|
|
|
2019-05-11 22:16:26 -06:00
|
|
|
```bash
|
|
|
|
cmake -DCMAKE_TOOLCHAIN=`pwd`/contrib/depends/x86_64-w64-mingw32
|
|
|
|
```
|
2018-03-18 16:01:56 -06:00
|
|
|
|
|
|
|
Common `host-platform-triplets` for cross compilation are:
|
|
|
|
|
|
|
|
- `i686-w64-mingw32` for Win32
|
|
|
|
- `x86_64-w64-mingw32` for Win64
|
|
|
|
- `x86_64-apple-darwin11` for MacOSX
|
|
|
|
- `arm-linux-gnueabihf` for Linux ARM 32 bit
|
|
|
|
- `aarch64-linux-gnu` for Linux ARM 64 bit
|
2019-06-26 16:25:47 -06:00
|
|
|
- `riscv64-linux-gnu` for Linux RISCV 64 bit
|
2018-03-18 16:01:56 -06:00
|
|
|
|
|
|
|
No other options are needed, the paths are automatically configured.
|
|
|
|
|
|
|
|
Dependency Options:
|
|
|
|
The following can be set when running make: make FOO=bar
|
|
|
|
|
2019-05-11 22:16:26 -06:00
|
|
|
```
|
|
|
|
SOURCES_PATH: downloaded sources will be placed here
|
|
|
|
BASE_CACHE: built packages will be placed here
|
|
|
|
SDK_PATH: Path where sdk's can be found (used by OSX)
|
|
|
|
FALLBACK_DOWNLOAD_PATH: If a source file can't be fetched, try here before giving up
|
|
|
|
DEBUG: disable some optimizations and enable more runtime checking
|
|
|
|
HOST_ID_SALT: Optional salt to use when generating host package ids
|
|
|
|
BUILD_ID_SALT: Optional salt to use when generating build package ids
|
|
|
|
```
|
2018-03-18 16:01:56 -06:00
|
|
|
|
|
|
|
Additional targets:
|
|
|
|
|
2019-05-11 22:16:26 -06:00
|
|
|
```
|
|
|
|
download: run 'make download' to fetch all sources without building them
|
|
|
|
download-osx: run 'make download-osx' to fetch all sources needed for osx builds
|
|
|
|
download-win: run 'make download-win' to fetch all sources needed for win builds
|
|
|
|
download-linux: run 'make download-linux' to fetch all sources needed for linux builds
|
|
|
|
```
|
2018-03-18 16:01:56 -06:00
|
|
|
|
2018-03-18 08:50:41 -06:00
|
|
|
#Darwin (macos) builds:
|
|
|
|
|
2022-05-03 08:51:34 -06:00
|
|
|
To build with the x86_64-apple-darwin11 you require the mac os developer tools in MacOSX11.1.sdk.
|
2018-03-18 08:50:41 -06:00
|
|
|
Download it from apple, or search for it on github. Create a new directoty called SDKs in this
|
2022-05-03 08:51:34 -06:00
|
|
|
directory and place the entire MacOSX11.1.sdk folder in it. The depends build will then pick it up automatically
|
2018-03-18 08:50:41 -06:00
|
|
|
(without requiring SDK_PATH).
|
|
|
|
|
2018-12-04 14:01:03 -07:00
|
|
|
|
|
|
|
#Mingw builds
|
|
|
|
|
|
|
|
Building for 32/64bit mingw requires switching alternatives to a posix mode
|
|
|
|
|
|
|
|
```bash
|
|
|
|
update-alternatives --set x86_64-w64-mingw32-g++ x86_64-w64-mingw32-g++-posix
|
|
|
|
update-alternatives --set x86_64-w64-mingw32-gcc x86_64-w64-mingw32-gcc-posix
|
|
|
|
```
|
|
|
|
|
2018-03-18 16:01:56 -06:00
|
|
|
### Other documentation
|
|
|
|
|
|
|
|
- [description.md](description.md): General description of the depends system
|
|
|
|
- [packages.md](packages.md): Steps for adding packages
|
|
|
|
|