2018-03-18 22:01:56 +00:00
|
|
|
### Usage
|
|
|
|
|
|
|
|
To build dependencies for the current arch+OS:
|
|
|
|
|
2019-05-12 04:16:26 +00:00
|
|
|
```bash
|
|
|
|
make
|
|
|
|
```
|
2018-03-18 22:01:56 +00:00
|
|
|
|
|
|
|
To build for another arch/OS:
|
|
|
|
|
2019-05-12 04:16:26 +00:00
|
|
|
```bash
|
|
|
|
make HOST=host-platform-triplet
|
|
|
|
```
|
2018-03-18 22:01:56 +00:00
|
|
|
|
|
|
|
For example:
|
|
|
|
|
2019-05-12 04:16:26 +00:00
|
|
|
```bash
|
|
|
|
make HOST=x86_64-w64-mingw32 -j4
|
|
|
|
```
|
2018-03-18 22:01:56 +00:00
|
|
|
|
2018-11-24 14:20:44 +00: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 22:01:56 +00:00
|
|
|
|
2019-05-12 04:16:26 +00:00
|
|
|
```bash
|
|
|
|
cmake -DCMAKE_TOOLCHAIN=`pwd`/contrib/depends/x86_64-w64-mingw32
|
|
|
|
```
|
2018-03-18 22:01:56 +00:00
|
|
|
|
|
|
|
Common `host-platform-triplets` for cross compilation are:
|
|
|
|
|
|
|
|
- `i686-w64-mingw32` for Win32
|
|
|
|
- `x86_64-w64-mingw32` for Win64
|
2022-05-05 15:29:11 +00:00
|
|
|
- `x86_64-apple-darwin11` for MacOSX x86_64
|
2018-03-18 22:01:56 +00:00
|
|
|
- `arm-linux-gnueabihf` for Linux ARM 32 bit
|
|
|
|
- `aarch64-linux-gnu` for Linux ARM 64 bit
|
2019-06-26 22:25:47 +00:00
|
|
|
- `riscv64-linux-gnu` for Linux RISCV 64 bit
|
2018-03-18 22:01:56 +00: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-12 04:16:26 +00:00
|
|
|
```
|
|
|
|
SOURCES_PATH: downloaded sources will be placed here
|
|
|
|
BASE_CACHE: built packages will be placed here
|
|
|
|
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 22:01:56 +00:00
|
|
|
|
|
|
|
Additional targets:
|
|
|
|
|
2019-05-12 04:16:26 +00: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 22:01:56 +00:00
|
|
|
|
2018-12-04 21:01:03 +00: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 22:01:56 +00:00
|
|
|
### Other documentation
|
|
|
|
|
|
|
|
- [description.md](description.md): General description of the depends system
|
|
|
|
- [packages.md](packages.md): Steps for adding packages
|
|
|
|
|