mirror of
https://github.com/XRPLF/rippled.git
synced 2025-11-19 18:45:52 +00:00
67238b9fa6
On macOS, if you have not installed something that depends on `xz`, then your
system may lack `lzma`, resulting in a build error similar to:
```
Downloading libarchive-3.6.0.tar.xz completed [6250.61k]
libarchive/3.6.0:
ERROR: libarchive/3.6.0: Error in source() method, line 120
get(self, **self.conan_data["sources"][self.version], strip_root=True)
ReadError: file could not be opened successfully:
- method gz: ReadError('not a gzip file')
- method bz2: ReadError('not a bzip2 file')
- method xz: CompressionError('lzma module is not available')
- method tar: ReadError('invalid header')
```
The solution is to ensure that `lzma` is installed by installing `xz`.
85 lines
2.1 KiB
Markdown
85 lines
2.1 KiB
Markdown
Our [build instructions][BUILD.md] assume you have a C++ development
|
|
environment complete with Git, Python, Conan, CMake, and a C++ compiler.
|
|
This document exists to help readers set one up on any of the Big Three
|
|
platforms: Linux, macOS, or Windows.
|
|
|
|
[BUILD.md]: ../../BUILD.md
|
|
|
|
|
|
## Linux
|
|
|
|
Package ecosystems vary across Linux distributions,
|
|
so there is no one set of instructions that will work for every Linux user.
|
|
These instructions are written for Ubuntu 22.04.
|
|
They are largely copied from the [script][1] used to configure our Docker
|
|
container for continuous integration.
|
|
That script handles many more responsibilities.
|
|
These instructions are just the bare minimum to build one configuration of
|
|
rippled.
|
|
You can check that codebase for other Linux distributions and versions.
|
|
If you cannot find yours there,
|
|
then we hope that these instructions can at least guide you in the right
|
|
direction.
|
|
|
|
```
|
|
apt update
|
|
apt install --yes curl git libssl-dev python3.10-dev python3-pip make g++-11
|
|
|
|
curl --location --remote-name \
|
|
"https://github.com/Kitware/CMake/releases/download/v3.25.1/cmake-3.25.1.tar.gz"
|
|
tar -xzf cmake-3.25.1.tar.gz
|
|
rm cmake-3.25.1.tar.gz
|
|
cd cmake-3.25.1
|
|
./bootstrap --parallel=$(nproc)
|
|
make --jobs $(nproc)
|
|
make install
|
|
cd ..
|
|
|
|
pip3 install 'conan<2'
|
|
```
|
|
|
|
[1]: https://github.com/thejohnfreeman/rippled-docker/blob/master/ubuntu-22.04/install.sh
|
|
|
|
|
|
## macOS
|
|
|
|
Open a Terminal and enter the below command to bring up a dialog to install
|
|
the command line developer tools.
|
|
Once it is finished, this command should return a version greater than the
|
|
minimum required (see [BUILD.md][]).
|
|
|
|
```
|
|
clang --version
|
|
```
|
|
|
|
The command line developer tools should include Git too:
|
|
|
|
```
|
|
git --version
|
|
```
|
|
|
|
Install [Homebrew][],
|
|
use it to install [pyenv][],
|
|
use it to install Python,
|
|
and use it to install Conan:
|
|
|
|
[Homebrew]: https://brew.sh/
|
|
[pyenv]: https://github.com/pyenv/pyenv
|
|
|
|
```
|
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
|
brew update
|
|
brew install xz
|
|
brew install pyenv
|
|
pyenv install 3.10-dev
|
|
pyenv global 3.10-dev
|
|
eval "$(pyenv init -)"
|
|
pip install 'conan<2'
|
|
```
|
|
|
|
Install CMake with Homebrew too:
|
|
|
|
```
|
|
brew install cmake
|
|
```
|