root
3.1 KiB
Interactive Build Menu
contrib/agrarian-build-menu.sh provides an interactive Ubuntu build workflow
for common Agrarian targets:
- Linux daemon and CLI tools
- Linux Qt GUI wallet
- Windows daemon and CLI tools
- Windows Qt GUI wallet
The script clones the Agrarian repository if the selected checkout directory does not exist. If the checkout already exists, it fetches, checks out the configured branch, and performs a fast-forward pull.
Only bootstrap packages needed to update the checkout are installed before the pull. Target-specific packages are installed after the checkout is current, so fresh dependency fixes on the selected branch are applied before the build.
Quick Start
From an existing checkout:
./contrib/agrarian-build-menu.sh
Do not run the script with sudo. It runs checkout, compilation, daemon config,
and the user systemd service as the current local user. It asks for sudo only
when it needs to install Ubuntu packages or set MinGW compiler alternatives.
From a fresh Ubuntu host:
sudo apt-get update
sudo apt-get install -y git ca-certificates
git clone --branch 2.0 https://github.com/pacificao/agrarian.git agrarian
cd agrarian
./contrib/agrarian-build-menu.sh
On minimal VPS images, apt sources may be incomplete. The script checks for
missing Ubuntu -updates and -security suites before installing build
packages. If they are missing, it asks before adding a standard
/etc/apt/sources.list.d/agrarian-ubuntu.sources file for the host
architecture.
The Linux daemon option uses the deterministic native depends/ build with Qt
disabled, so Berkeley DB and other core libraries are built inside the checkout
instead of being required as Ubuntu system development packages.
The Linux Qt wallet option also installs Ubuntu desktop development headers
needed by Qt's xcb platform plugin, including fontconfig, freetype, xcb, and
xkbcommon packages. The wallet helper uses the matching protoc built by
depends/, so a system protobuf compiler is not required.
Defaults
The script can be configured with environment variables:
REPO_URL=https://github.com/pacificao/agrarian.git
BRANCH=<current checkout branch, or main when run standalone>
WORKDIR=$HOME/agrarian
JOBS=<detected CPU count>
Example:
JOBS=8 WORKDIR=$HOME/src/agrarian ./contrib/agrarian-build-menu.sh
To test the 2.0 branch from a standalone downloaded copy of the script:
BRANCH=2.0 ./agrarian-build-menu.sh
Linux Daemon Autostart
After a Linux daemon-capable build, the script asks whether to install and start
agrariand for the current user. If accepted, it creates:
$HOME/.local/bin/agrariand$HOME/.local/bin/agrarian-cli$HOME/.agrarian/agrarian.conf$HOME/.config/systemd/user/agrariand.service
It then enables and starts the user service with:
systemctl --user enable --now agrariand.service
Windows Build Output
For Windows targets, the script prints the .exe artifact paths when the build
finishes. Copy the generated files from src/ and src/qt/ to the Windows
machine and run either agrariand.exe or agrarian-qt.exe.