samiandClaude Sonnet 5
fd70c3b595
Installs the full apt dependency set for a clean Ubuntu 26.04 machine (build toolchain, Qt 6, libcurl/sqlite/openssl/secret, ffmpeg, node, lint tools), then verifies versions: cmake >= 3.28, g++ with working -std=c++23 <expected>, node >= 20, and every -dev package via pkg-config. --with-clang adds LLVM for the M7 fuzz targets; --packaging adds .deb tooling; --check verifies without installing. Flags the CMake 4.x pre-3.5 cmake_minimum_required hazard from the brief. Co-Authored-By: Claude Sonnet 5 <[email protected]> Claude-Session: https://claude.ai/code/session_01HPPSGhiArbvQgwC2DNiURS
209 lines
6.8 KiB
Bash
Executable File
209 lines
6.8 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
#
|
|
# tools/bootstrap.sh — install every build/test dependency for Velox Download Manager.
|
|
#
|
|
# Target: a clean Ubuntu 26.04 LTS machine. Safe to re-run (apt is idempotent).
|
|
# Owned by lane PKG/QA. Keep this in sync with the table in README.md "Toolchain bootstrap".
|
|
#
|
|
# ./tools/bootstrap.sh # everything needed to build + test
|
|
# ./tools/bootstrap.sh --with-clang # also install clang/LLVM for the libFuzzer targets
|
|
# ./tools/bootstrap.sh --packaging # also install .deb tooling (lane PKG, M6)
|
|
# ./tools/bootstrap.sh --check # verify versions only, install nothing
|
|
|
|
set -euo pipefail
|
|
|
|
WITH_CLANG=0
|
|
WITH_PACKAGING=0
|
|
CHECK_ONLY=0
|
|
for arg in "$@"; do
|
|
case "$arg" in
|
|
--with-clang) WITH_CLANG=1 ;;
|
|
--packaging) WITH_PACKAGING=1 ;;
|
|
--check) CHECK_ONLY=1 ;;
|
|
-h|--help)
|
|
sed -n '3,12p' "$0" | sed 's/^# \{0,1\}//'
|
|
exit 0 ;;
|
|
*) echo "bootstrap: unknown option '$arg'" >&2; exit 2 ;;
|
|
esac
|
|
done
|
|
|
|
log() { printf '\033[1;34m==>\033[0m %s\n' "$*"; }
|
|
warn() { printf '\033[1;33mwarning:\033[0m %s\n' "$*" >&2; }
|
|
die() { printf '\033[1;31merror:\033[0m %s\n' "$*" >&2; exit 1; }
|
|
|
|
# --- sanity --------------------------------------------------------------------
|
|
|
|
[[ "$(uname -s)" == "Linux" ]] || die "this project targets Linux (Ubuntu 26.04)."
|
|
|
|
if [[ -r /etc/os-release ]]; then
|
|
. /etc/os-release
|
|
if [[ "${ID:-}" != "ubuntu" ]]; then
|
|
warn "distro is '${ID:-unknown}', not ubuntu — package names may differ."
|
|
elif [[ "${VERSION_ID:-}" != "26.04" ]]; then
|
|
warn "Ubuntu ${VERSION_ID:-?} detected; the project is developed against 26.04."
|
|
fi
|
|
fi
|
|
|
|
command -v apt-get >/dev/null 2>&1 || die "apt-get not found; install deps manually (see README)."
|
|
|
|
SUDO=""
|
|
if [[ $EUID -ne 0 ]]; then
|
|
command -v sudo >/dev/null 2>&1 || die "not root and no sudo; re-run as root."
|
|
SUDO="sudo"
|
|
fi
|
|
|
|
# --- package sets -----------------------------------------------------------------
|
|
# Full list, so a clean machine gets everything even though the dev box already has most.
|
|
|
|
APT_CORE=(
|
|
build-essential # g++, make
|
|
g++ # C++23 front end (need >= 13; 26.04 ships 15)
|
|
gdb
|
|
cmake # >= 3.28 (26.04 ships 4.2)
|
|
ninja-build
|
|
pkg-config
|
|
git
|
|
python3 # testserver, conformance helpers, codegen
|
|
ca-certificates
|
|
curl
|
|
)
|
|
|
|
APT_LIBS=(
|
|
libcurl4-openssl-dev # CORE: HTTP stack
|
|
libsqlite3-dev # DAEMON: task store
|
|
nlohmann-json3-dev # DAEMON/PROTO: JSON-RPC (never in core/)
|
|
libssl-dev # CORE: SHA-256 / TLS bits
|
|
libsecret-1-dev # DAEMON: Secret Service for credentials
|
|
libavformat-dev # MEDIA (M4): HLS/DASH mux
|
|
libavcodec-dev
|
|
libavutil-dev
|
|
ffmpeg # MEDIA (M4): runtime muxer
|
|
)
|
|
|
|
APT_GUI=(
|
|
qt6-base-dev
|
|
qt6-tools-dev
|
|
qt6-tools-dev-tools # lrelease/lupdate for i18n
|
|
libqt6svg6-dev # GUI: SVG icon rendering
|
|
)
|
|
|
|
APT_LINT=(
|
|
clang-format
|
|
clang-tidy
|
|
)
|
|
|
|
APT_NODE=(
|
|
nodejs # EXT + tools/mockd + conformance runner
|
|
npm
|
|
)
|
|
|
|
APT_CLANG=(
|
|
clang # optional: libFuzzer targets (M7)
|
|
llvm
|
|
)
|
|
|
|
APT_PACKAGING=(
|
|
debhelper
|
|
dpkg-dev
|
|
lintian
|
|
devscripts
|
|
fakeroot
|
|
)
|
|
|
|
# --- install --------------------------------------------------------------------
|
|
|
|
PKGS=("${APT_CORE[@]}" "${APT_LIBS[@]}" "${APT_GUI[@]}" "${APT_LINT[@]}" "${APT_NODE[@]}")
|
|
[[ $WITH_CLANG -eq 1 ]] && PKGS+=("${APT_CLANG[@]}")
|
|
[[ $WITH_PACKAGING -eq 1 ]] && PKGS+=("${APT_PACKAGING[@]}")
|
|
|
|
if [[ $CHECK_ONLY -eq 0 ]]; then
|
|
log "apt-get update"
|
|
$SUDO apt-get update -qq
|
|
log "installing ${#PKGS[@]} packages (idempotent; already-present ones are skipped)"
|
|
DEBIAN_FRONTEND=noninteractive $SUDO apt-get install -y --no-install-recommends "${PKGS[@]}"
|
|
else
|
|
log "--check: skipping installation"
|
|
fi
|
|
|
|
# --- verify --------------------------------------------------------------------
|
|
|
|
log "verifying toolchain"
|
|
|
|
fail=0
|
|
need_cmd() {
|
|
if command -v "$1" >/dev/null 2>&1; then
|
|
printf ' \033[32m✓\033[0m %-16s %s\n' "$1" "$("${@:2}" 2>&1 | head -1)"
|
|
else
|
|
printf ' \033[31m✗\033[0m %-16s MISSING\n' "$1"
|
|
fail=1
|
|
fi
|
|
}
|
|
|
|
need_cmd git git --version
|
|
need_cmd cmake cmake --version
|
|
need_cmd ninja ninja --version
|
|
need_cmd g++ g++ --version
|
|
need_cmd pkg-config pkg-config --version
|
|
need_cmd python3 python3 --version
|
|
need_cmd clang-format clang-format --version
|
|
need_cmd clang-tidy clang-tidy --version
|
|
need_cmd node node --version
|
|
need_cmd npm npm --version
|
|
[[ $WITH_CLANG -eq 1 ]] && need_cmd clang clang --version
|
|
|
|
# Version floors that actually matter.
|
|
if command -v cmake >/dev/null 2>&1; then
|
|
cmake_ver="$(cmake --version | sed -n '1s/.* //p')"
|
|
# `sort -V -C` exits 0 iff the input is already in ascending order, i.e. floor <= ver.
|
|
if ! printf '3.28.0\n%s\n' "$cmake_ver" | sort -V -C; then
|
|
warn "cmake $cmake_ver is below the 3.28 floor in CMakeLists.txt."
|
|
fi
|
|
# CMake >= 4 hard-errors on cmake_minimum_required() < 3.5 in any dependency.
|
|
if printf '4.0.0\n%s\n' "$cmake_ver" | sort -V -C; then
|
|
log "cmake $cmake_ver is 4.x — dependencies with a pre-3.5 CMake floor will fail to configure."
|
|
fi
|
|
fi
|
|
|
|
if command -v g++ >/dev/null 2>&1; then
|
|
gxx_major="$(g++ -dumpversion | cut -d. -f1)"
|
|
if (( gxx_major < 13 )); then
|
|
warn "g++ $gxx_major lacks the C++23 support this project needs (>= 13)."
|
|
fi
|
|
echo '#include <expected>
|
|
#include <version>
|
|
#if __cpp_lib_expected < 202202L
|
|
#error no std::expected
|
|
#endif
|
|
int main(){}' > /tmp/vdm_bootstrap_cxx23.$$.cpp
|
|
if g++ -std=c++23 -fsyntax-only /tmp/vdm_bootstrap_cxx23.$$.cpp 2>/dev/null; then
|
|
printf ' \033[32m✓\033[0m %-16s std::expected / -std=c++23 OK\n' "c++23"
|
|
else
|
|
printf ' \033[31m✗\033[0m %-16s -std=c++23 with <expected> failed\n' "c++23"
|
|
fail=1
|
|
fi
|
|
rm -f /tmp/vdm_bootstrap_cxx23.$$.cpp
|
|
fi
|
|
|
|
if command -v node >/dev/null 2>&1; then
|
|
node_major="$(node --version | sed 's/^v//; s/\..*//')"
|
|
if (( node_major < 20 )); then
|
|
warn "node $node_major may be too old for the extension toolchain; consider nvm (>= 20)."
|
|
fi
|
|
fi
|
|
|
|
# Qt / library dev packages: check via pkg-config where possible.
|
|
for mod in Qt6Core Qt6Widgets Qt6Svg libcurl sqlite3 libssl libsecret-1 libavformat; do
|
|
if pkg-config --exists "$mod" 2>/dev/null; then
|
|
printf ' \033[32m✓\033[0m %-16s %s\n' "$mod" "$(pkg-config --modversion "$mod")"
|
|
else
|
|
printf ' \033[31m✗\033[0m %-16s pkg-config can'\''t find it\n' "$mod"
|
|
fail=1
|
|
fi
|
|
done
|
|
|
|
echo
|
|
if [[ $fail -ne 0 ]]; then
|
|
die "toolchain incomplete — see the ✗ lines above."
|
|
fi
|
|
log "toolchain OK. Next: cmake --preset dev && cmake --build --preset dev"
|