mirror of
https://github.com/signalwire/freeswitch.git
synced 2025-03-21 15:07:33 +00:00
[DOCS] Add guides for building FreeSWITCH build-dependencies
* [DOCS] Add guides for building FreeSWITCH build-dependencies * Add `build-dependencies.sh` script
This commit is contained in:
s3rj1k
GitHub
parent
675bd8f27d
commit
e622a02b33
@ -1,6 +1,29 @@
|
||||
# Building FreeSWITCH packages using `FSDEB`
|
||||
## Install build dependencies first
|
||||
In order to build FreeSWITCH packages first you need to install build dependencies. There are two ways:
|
||||
* [From our FreeSWITCH Debian repository](#install-build-dependencies-from-repo) (using [FSGET](/scripts/packaging) for example) - the simplest way
|
||||
* [Manually compile the build dependencies](#manually-compile-build-dependencies)
|
||||
|
||||
<a name="install-build-dependencies-from-repo"></a>
|
||||
### Configuring FreeSWITCH Debian repo (for dependencies)
|
||||
Since we are building a FreeSWITCH release let's configure FreeSWITCH Community Release Debian repo.
|
||||
We recommend using [FSGET](/scripts/packaging).
|
||||
|
||||
Replace `<PAT or API token>` with your `SignalWire Personal Access Token (PAT)`
|
||||
[HOWTO Create a SignalWire Personal Access Token](https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/how-to-create-a-personal-access-token/how-to-create-a-personal-access-token)
|
||||
```bash
|
||||
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token>
|
||||
```
|
||||
Configuring the repo is enough. Dependencies will be installed during the FreeSWITCH building process.
|
||||
|
||||
<a name="manually-compile-build-dependencies"></a>
|
||||
### Manually compile the build dependencies
|
||||
Just follow this [Dependency Building Guide](dependencies/README.md) without the need to set up the FreeSWITCH Debian repo.</br>
|
||||
Although we recommend using the FreeSWITCH Debian repo as all the dependencies are already prebuilt for you.
|
||||
|
||||
---
|
||||
## Prerequisites
|
||||
FreeSWITCH packages can be built when FreeSWITCH is cloned using `git` only.
|
||||
FreeSWITCH packages can be built when FreeSWITCH is cloned using `git` only.
|
||||
(Methods described here won't work if you download a source tarball and extract it)
|
||||
|
||||
Please make sure you have `git` and `curl` installed:
|
||||
@ -17,16 +40,7 @@ cd /usr/src
|
||||
git clone https://github.com/signalwire/freeswitch -b v1.10
|
||||
```
|
||||
|
||||
## Configuring FreeSWITCH Debian repo (for dependencies)
|
||||
Since we are building a FreeSWITCH release let's configure FreeSWITCH Community Release Debian repo.
|
||||
We recommend using [FSGET](/scripts/packaging).
|
||||
|
||||
Replace `<PAT or API token>` with your `SignalWire Personal Access Token (PAT)`
|
||||
[HOWTO Create a SignalWire Personal Access Token](https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Installation/how-to-create-a-personal-access-token/how-to-create-a-personal-access-token)
|
||||
```bash
|
||||
curl -sSL https://freeswitch.org/fsget | bash -s <PAT or API token>
|
||||
```
|
||||
|
||||
---
|
||||
## Building packages with `FSDEB`
|
||||
```bash
|
||||
curl -sSL https://freeswitch.org/fsdeb | bash -s -- -b 999 -o /usr/src/fsdebs/ -w /usr/src/freeswitch
|
||||
|
||||
61
scripts/packaging/build/dependencies/README.md
Normal file
61
scripts/packaging/build/dependencies/README.md
Normal file
@ -0,0 +1,61 @@
|
||||
# FreeSWITCH Build Dependencies
|
||||
|
||||
This directory is organized into subfolders, where each subfolder contains build instructions for a single Debian package. These packages are dependencies required to build FreeSWITCH's Debian packages.
|
||||
|
||||
## Recommended order of building:
|
||||
|
||||
- [libbroadvoice](libbroadvoice/README.md)
|
||||
- [libilbc](libilbc/README.md)
|
||||
- [libsilk](libsilk/README.md)
|
||||
- [spandsp](spandsp/README.md)
|
||||
- [sofia-sip](sofia-sip/README.md)
|
||||
- [libks](libks/README.md)
|
||||
- [signalwire-c](signalwire-c/README.md)
|
||||
- [libv8](libv8/README.md) (only for `AMD64`)
|
||||
|
||||
## Build Dependencies Script
|
||||
|
||||
A convenient script `build-dependencies.sh` is provided to automate the building of dependencies. This script offers several options to customize the build process.
|
||||
|
||||
### Usage
|
||||
|
||||
```bash
|
||||
./build-dependencies.sh [options] [library_names...]
|
||||
```
|
||||
|
||||
### Options
|
||||
|
||||
- `-h, --help`: Show the help message
|
||||
- `-b, --build-number N`: Set build number (default: 42 or env value)
|
||||
- `-a, --all`: Build all libraries
|
||||
- `-s, --setup`: Set up build environment before building
|
||||
- `-o, --output DIR`: Set output directory (default: /var/local/deb)
|
||||
- `-p, --prefix DIR`: Set source path prefix (default: /usr/src)
|
||||
- `-r, --repo`: Set up local repository after building
|
||||
- `-c, --clone`: Clone required repositories before building
|
||||
- `-g, --git-https`: Use HTTPS instead of SSH for git cloning
|
||||
|
||||
### Examples
|
||||
|
||||
Set up environment, clone repositories, and build all dependencies:
|
||||
```bash
|
||||
./build-dependencies.sh --build-number 123 --setup --all --repo --clone
|
||||
```
|
||||
|
||||
Complete build with all options (setup environment, build all libraries, create local repo, clone repos with HTTPS):
|
||||
```bash
|
||||
./build-dependencies.sh --build-number 123 --setup --all --repo --clone --git-https
|
||||
```
|
||||
|
||||
Build specific libraries with full automation:
|
||||
```bash
|
||||
./build-dependencies.sh --build-number 123 --setup --repo --clone --git-https libks signalwire-c
|
||||
```
|
||||
|
||||
### Running in Docker
|
||||
|
||||
You can run the build script inside a Docker container for a clean, isolated build environment:
|
||||
|
||||
```bash
|
||||
docker run -it -v $(pwd):/root/scripts debian:bookworm bash -c "cd /root/scripts && bash"
|
||||
```
|
||||
465
scripts/packaging/build/dependencies/build-dependencies.sh
Executable file
465
scripts/packaging/build/dependencies/build-dependencies.sh
Executable file
@ -0,0 +1,465 @@
|
||||
#!/bin/bash
|
||||
|
||||
## shfmt -w -s -bn -ci -sr -fn scripts/packaging/build/dependencies/build-dependencies.sh
|
||||
|
||||
set -e # Exit immediately if a command exits with a non-zero status
|
||||
set -u # Treat unset variables as an error
|
||||
set -o pipefail # Return value of a pipeline is the value of the last (rightmost) command to exit with a non-zero status
|
||||
set -x # Print commands and their arguments as they are executed
|
||||
|
||||
# Default values
|
||||
BUILD_NUMBER=${BUILD_NUMBER:-42}
|
||||
LIBRARIES=()
|
||||
BUILD_ALL=false
|
||||
SETUP_ENV=false
|
||||
OUTPUT_DIR="/var/local/deb"
|
||||
SOURCE_PREFIX="/usr/src"
|
||||
SETUP_LOCAL_REPO=false
|
||||
CLONE_REPOS=false
|
||||
GIT_PROTOCOL="ssh"
|
||||
|
||||
###################
|
||||
# Helper Functions
|
||||
###################
|
||||
|
||||
# Display script usage information and available options
|
||||
function show_usage()
|
||||
{
|
||||
echo "Usage: $0 [options] [library_names...]"
|
||||
echo "Options:"
|
||||
echo " -h, --help Show this help message"
|
||||
echo " -b, --build-number N Set build number (default: 42 or env value)"
|
||||
echo " -a, --all Build all libraries"
|
||||
echo " -s, --setup Set up build environment before building"
|
||||
echo " -o, --output DIR Set output directory (default: /var/local/deb)"
|
||||
echo " -p, --prefix DIR Set source path prefix (default: /usr/src)"
|
||||
echo " -r, --repo Set up local repository after building"
|
||||
echo " -c, --clone Clone required repositories before building"
|
||||
echo " -g, --git-https Use HTTPS instead of SSH for git cloning"
|
||||
echo ""
|
||||
echo "Available libraries:"
|
||||
echo " libbroadvoice"
|
||||
echo " libilbc"
|
||||
echo " libsilk"
|
||||
echo " spandsp"
|
||||
echo " sofia-sip"
|
||||
echo " libks"
|
||||
echo " signalwire-c"
|
||||
echo " libv8-packaging (or libv8)"
|
||||
echo ""
|
||||
}
|
||||
|
||||
# Normalize library names, replacing aliases with their canonical names
|
||||
function normalize_library_name()
|
||||
{
|
||||
local lib_name=$1
|
||||
|
||||
case $lib_name in
|
||||
libv8)
|
||||
echo "libv8-packaging"
|
||||
;;
|
||||
*)
|
||||
echo "$lib_name"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# Parse command line arguments and set corresponding variables
|
||||
function parse_arguments()
|
||||
{
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case $1 in
|
||||
-h | --help)
|
||||
show_usage
|
||||
exit 0
|
||||
;;
|
||||
-b | --build-number)
|
||||
BUILD_NUMBER="$2"
|
||||
shift 2
|
||||
;;
|
||||
-a | --all)
|
||||
BUILD_ALL=true
|
||||
shift
|
||||
;;
|
||||
-s | --setup)
|
||||
SETUP_ENV=true
|
||||
shift
|
||||
;;
|
||||
-o | --output)
|
||||
OUTPUT_DIR="$2"
|
||||
shift 2
|
||||
;;
|
||||
-p | --prefix)
|
||||
SOURCE_PREFIX="$2"
|
||||
shift 2
|
||||
;;
|
||||
-r | --repo)
|
||||
SETUP_LOCAL_REPO=true
|
||||
shift
|
||||
;;
|
||||
-c | --clone)
|
||||
CLONE_REPOS=true
|
||||
shift
|
||||
;;
|
||||
-g | --git-https)
|
||||
GIT_PROTOCOL="https"
|
||||
shift
|
||||
;;
|
||||
*)
|
||||
local normalized_name=$(normalize_library_name "$1")
|
||||
LIBRARIES+=("$normalized_name")
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
if [ "$(id -u)" != "0" ]; then
|
||||
echo "Non-root user detected. Execution may fail."
|
||||
fi
|
||||
}
|
||||
|
||||
# Validate the provided arguments and set defaults if needed
|
||||
function validate_arguments()
|
||||
{
|
||||
if [ ${#LIBRARIES[@]} -eq 0 ] && [ "$BUILD_ALL" == "false" ]; then
|
||||
echo "Error: No libraries specified"
|
||||
show_usage
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ "$BUILD_ALL" == "true" ]; then
|
||||
LIBRARIES=("libbroadvoice" "libilbc" "libsilk" "spandsp" "sofia-sip" "libks" "signalwire-c" "libv8-packaging")
|
||||
fi
|
||||
}
|
||||
|
||||
# Set up the build environment variables and create output directory
|
||||
function setup_environment()
|
||||
{
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
export BUILD_NUMBER=$BUILD_NUMBER
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
|
||||
mkdir -p "$OUTPUT_DIR"
|
||||
}
|
||||
|
||||
# Install required build tools and dependencies
|
||||
function setup_build_environment()
|
||||
{
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
|
||||
local tmp_dir="${TMPDIR:-/tmp}"
|
||||
|
||||
echo "Setting up build environment..."
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config \
|
||||
git
|
||||
|
||||
if ! git config --global --get-all safe.directory | grep -q '\*'; then
|
||||
echo "Setting git safe.directory configuration..."
|
||||
git config --global --add safe.directory '*'
|
||||
fi
|
||||
|
||||
if [[ " ${LIBRARIES[@]} " =~ " libv8-packaging " ]] || [ "$BUILD_ALL" == "true" ]; then
|
||||
echo "libv8 is in the build list, checking for dependencies..."
|
||||
|
||||
if [ ! -d "$SOURCE_PREFIX/libv8-packaging" ] && [ "$CLONE_REPOS" == "true" ]; then
|
||||
echo "Cloning libv8-packaging repository..."
|
||||
clone_repositories "libv8-packaging"
|
||||
fi
|
||||
|
||||
if [ -d "$SOURCE_PREFIX/libv8-packaging" ] && [ -f "$SOURCE_PREFIX/libv8-packaging/build.sh" ]; then
|
||||
echo "Installing dependencies for libv8..."
|
||||
(cd "$SOURCE_PREFIX/libv8-packaging" && ./build.sh --install-deps)
|
||||
|
||||
echo "Setting up Python environment for libv8..."
|
||||
(cd "$SOURCE_PREFIX/libv8-packaging" && ./build.sh --setup-pyenv)
|
||||
touch "${tmp_dir}/libv8_pyenv_setup_complete"
|
||||
else
|
||||
echo "Warning: libv8-packaging directory not found. Clone the repository first to install its dependencies."
|
||||
echo "You can use the --clone flag or run the script with -c libv8-packaging first."
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
# Clone a specific library repository using the configured protocol
|
||||
clone_repositories()
|
||||
{
|
||||
local lib_name=$1
|
||||
local original_dir=$(pwd)
|
||||
local repo_dir="$SOURCE_PREFIX/$lib_name"
|
||||
|
||||
echo "=== Cloning $lib_name ==="
|
||||
|
||||
if [ -d "$repo_dir" ]; then
|
||||
echo "Directory $repo_dir already exists, skipping clone..."
|
||||
return 0
|
||||
fi
|
||||
|
||||
mkdir -p "$SOURCE_PREFIX"
|
||||
cd "$SOURCE_PREFIX"
|
||||
|
||||
if [ "$GIT_PROTOCOL" == "ssh" ]; then
|
||||
FREESWITCH_BASE="git@github.com:freeswitch"
|
||||
SIGNALWIRE_BASE="git@github.com:signalwire"
|
||||
else
|
||||
FREESWITCH_BASE="https://github.com/freeswitch"
|
||||
SIGNALWIRE_BASE="https://github.com/signalwire"
|
||||
fi
|
||||
|
||||
case $lib_name in
|
||||
libbroadvoice)
|
||||
git clone $FREESWITCH_BASE/libbroadvoice.git
|
||||
;;
|
||||
libilbc)
|
||||
git clone $FREESWITCH_BASE/libilbc.git
|
||||
;;
|
||||
libsilk)
|
||||
git clone $FREESWITCH_BASE/libsilk.git
|
||||
;;
|
||||
spandsp)
|
||||
git clone --branch packages $FREESWITCH_BASE/spandsp.git
|
||||
;;
|
||||
sofia-sip)
|
||||
git clone $FREESWITCH_BASE/sofia-sip.git
|
||||
;;
|
||||
libks)
|
||||
git clone $SIGNALWIRE_BASE/libks.git
|
||||
;;
|
||||
signalwire-c)
|
||||
git clone $SIGNALWIRE_BASE/signalwire-c.git
|
||||
;;
|
||||
libv8-packaging)
|
||||
git clone $FREESWITCH_BASE/libv8-packaging.git
|
||||
;;
|
||||
*)
|
||||
echo "Error: Unknown library for cloning '$lib_name'"
|
||||
return 1
|
||||
;;
|
||||
esac
|
||||
|
||||
cd "$original_dir"
|
||||
|
||||
echo "=== Completed cloning $lib_name ==="
|
||||
}
|
||||
|
||||
# Set up a local Debian repository for built packages
|
||||
setup_local_repository()
|
||||
{
|
||||
local original_dir=$(pwd)
|
||||
local abs_output_dir=$(readlink -f "$OUTPUT_DIR")
|
||||
|
||||
echo "Setting up local Debian repository in $abs_output_dir..."
|
||||
cd "$abs_output_dir"
|
||||
|
||||
dpkg-scanpackages -m . | tee Packages \
|
||||
&& gzip -f -k Packages \
|
||||
&& printf "deb [trusted=yes] file:$abs_output_dir /\n" | tee /etc/apt/sources.list.d/local.list \
|
||||
&& apt-get update
|
||||
|
||||
cd "$original_dir"
|
||||
|
||||
echo "Local repository setup complete."
|
||||
}
|
||||
|
||||
# Build a library using the Debian package build system
|
||||
build_deb_library()
|
||||
{
|
||||
local lib_name=$1
|
||||
local original_dir=$(pwd)
|
||||
|
||||
echo "=== Building $lib_name ==="
|
||||
|
||||
cd "$SOURCE_PREFIX/$lib_name/"
|
||||
|
||||
export VERSION=$(dpkg-parsechangelog --show-field Version | cut -f1 -d'-')
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
|
||||
echo "Version: $VERSION"
|
||||
echo "Git SHA: $GIT_SHA"
|
||||
echo "Build Number: $BUILD_NUMBER"
|
||||
|
||||
apt-get update \
|
||||
&& mk-build-deps \
|
||||
--install \
|
||||
--remove debian/control \
|
||||
--tool "apt-get -y --no-install-recommends" \
|
||||
&& apt-get -y -f install
|
||||
|
||||
dch \
|
||||
--controlmaint \
|
||||
--distribution "${CODENAME}" \
|
||||
--force-bad-version \
|
||||
--force-distribution \
|
||||
--newversion "${VERSION}-${BUILD_NUMBER}-${GIT_SHA}~${CODENAME}" \
|
||||
"Nightly build, ${GIT_SHA}" \
|
||||
&& debuild \
|
||||
--no-tgz-check \
|
||||
--build=binary \
|
||||
--unsigned-source \
|
||||
--unsigned-changes \
|
||||
&& mv -v ../*.{deb,changes} "$OUTPUT_DIR"/.
|
||||
|
||||
cd "$original_dir"
|
||||
|
||||
echo "=== Completed building $lib_name ==="
|
||||
}
|
||||
|
||||
# Build a library using the CMake build system
|
||||
build_cmake_library()
|
||||
{
|
||||
local lib_name=$1
|
||||
local deps=$2
|
||||
local original_dir=$(pwd)
|
||||
|
||||
echo "=== Building $lib_name ==="
|
||||
|
||||
cd "$SOURCE_PREFIX/$lib_name/"
|
||||
|
||||
if [ -n "$deps" ]; then
|
||||
echo "Installing dependencies for $lib_name..."
|
||||
apt-get update && apt-get -y install $deps
|
||||
fi
|
||||
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
|
||||
echo "Git SHA: $GIT_SHA"
|
||||
echo "Build Number: $BUILD_NUMBER"
|
||||
|
||||
PACKAGE_RELEASE="${BUILD_NUMBER}.${GIT_SHA}" cmake . \
|
||||
-DCMAKE_BUILD_TYPE=Debug \
|
||||
-DCMAKE_INSTALL_PREFIX="/usr" \
|
||||
&& make package \
|
||||
&& mv -v *.deb "$OUTPUT_DIR"/.
|
||||
|
||||
cd "$original_dir"
|
||||
|
||||
echo "=== Completed building $lib_name ==="
|
||||
}
|
||||
|
||||
# Build libv8 using its own build script
|
||||
build_libv8()
|
||||
{
|
||||
local original_dir=$(pwd)
|
||||
local tmp_dir="${TMPDIR:-/tmp}"
|
||||
local pyenv_marker_file="${tmp_dir}/libv8_pyenv_setup_complete"
|
||||
|
||||
echo "=== Building libv8 ==="
|
||||
|
||||
cd "$SOURCE_PREFIX/libv8-packaging/"
|
||||
|
||||
echo "Building libv8 with build number $BUILD_NUMBER, output to $OUTPUT_DIR..."
|
||||
./build.sh --build-number "$BUILD_NUMBER" --output-dir "$OUTPUT_DIR"
|
||||
|
||||
cd "$original_dir"
|
||||
|
||||
echo "=== Completed building libv8-packaging ==="
|
||||
}
|
||||
|
||||
# Process dependencies and ensure they're built in the correct order
|
||||
function process_dependencies()
|
||||
{
|
||||
local NEEDS_LOCAL_REPO=false
|
||||
|
||||
if [[ " ${LIBRARIES[@]} " =~ " signalwire-c " ]]; then
|
||||
NEEDS_LOCAL_REPO=true
|
||||
|
||||
if ! [[ " ${LIBRARIES[@]} " =~ " libks " ]]; then
|
||||
echo "Adding libks as a dependency for signalwire-c"
|
||||
LIBRARIES=("libks" "${LIBRARIES[@]}")
|
||||
fi
|
||||
fi
|
||||
|
||||
echo $NEEDS_LOCAL_REPO
|
||||
}
|
||||
|
||||
# Clone all the repositories for the specified libraries
|
||||
function clone_all_repos()
|
||||
{
|
||||
echo "Cloning repositories using ${GIT_PROTOCOL} protocol..."
|
||||
for lib in "${LIBRARIES[@]}"; do
|
||||
clone_repositories "$lib"
|
||||
done
|
||||
}
|
||||
|
||||
# Build all the specified libraries in the correct order
|
||||
function build_all_libraries()
|
||||
{
|
||||
local NEEDS_LOCAL_REPO=$(process_dependencies)
|
||||
|
||||
for lib in "${LIBRARIES[@]}"; do
|
||||
case $lib in
|
||||
libbroadvoice | libilbc | libsilk | spandsp | sofia-sip)
|
||||
build_deb_library "$lib"
|
||||
;;
|
||||
libks)
|
||||
build_cmake_library "$lib" "libssl-dev uuid-dev"
|
||||
;;
|
||||
signalwire-c)
|
||||
setup_local_repository
|
||||
build_cmake_library "$lib" "libks2"
|
||||
;;
|
||||
libv8-packaging)
|
||||
build_libv8
|
||||
;;
|
||||
*)
|
||||
echo "Error: Unknown library '$lib'"
|
||||
show_usage
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
if [ "$SETUP_LOCAL_REPO" == "true" ] && [ "$NEEDS_LOCAL_REPO" == "false" ]; then
|
||||
setup_local_repository
|
||||
echo "Local Debian repository has been set up at $OUTPUT_DIR."
|
||||
fi
|
||||
}
|
||||
|
||||
# Print a summary of the build process
|
||||
function print_summary()
|
||||
{
|
||||
echo "All selected libraries have been built successfully."
|
||||
echo "Output packages are in $OUTPUT_DIR/"
|
||||
}
|
||||
|
||||
#####################
|
||||
# Main Script Logic
|
||||
#####################
|
||||
|
||||
# Parse command line arguments
|
||||
parse_arguments "$@"
|
||||
|
||||
# Validate input arguments
|
||||
validate_arguments
|
||||
|
||||
# Setup the build environment if flag is set
|
||||
if [ "$SETUP_ENV" == "true" ]; then
|
||||
setup_build_environment
|
||||
else
|
||||
echo "Skipping build environment setup (use -s or --setup to enable)"
|
||||
fi
|
||||
|
||||
# Set up environment variables
|
||||
setup_environment
|
||||
|
||||
echo "Using source path prefix: $SOURCE_PREFIX"
|
||||
|
||||
# Clone repositories if flag is set
|
||||
if [ "$CLONE_REPOS" == "true" ]; then
|
||||
clone_all_repos
|
||||
else
|
||||
echo "Skipping repository cloning (use -c or --clone to enable)"
|
||||
fi
|
||||
|
||||
# Build all libraries
|
||||
build_all_libraries
|
||||
|
||||
# Print summary
|
||||
print_summary
|
||||
117
scripts/packaging/build/dependencies/libbroadvoice/README.md
Normal file
117
scripts/packaging/build/dependencies/libbroadvoice/README.md
Normal file
@ -0,0 +1,117 @@
|
||||
# Building `libbroadvoice` Debian Package
|
||||
|
||||
This guide explains how to build the `libbroadvoice` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone git@github.com:freeswitch/libbroadvoice.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd libbroadvoice/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/libbroadvoice/
|
||||
```
|
||||
|
||||
### Extract Debian package version:
|
||||
```bash
|
||||
export VERSION=$(dpkg-parsechangelog --show-field Version | cut -f1 -d'-')
|
||||
```
|
||||
|
||||
### Extract git hash:
|
||||
```bash
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& mk-build-deps \
|
||||
--install \
|
||||
--remove debian/control \
|
||||
--tool "apt-get -y --no-install-recommends" \
|
||||
&& apt-get -y -f install
|
||||
```
|
||||
|
||||
### Update changelog:
|
||||
```bash
|
||||
dch \
|
||||
--controlmaint \
|
||||
--distribution "${CODENAME}" \
|
||||
--force-bad-version \
|
||||
--force-distribution \
|
||||
--newversion "${VERSION}-${BUILD_NUMBER}-${GIT_SHA}~${CODENAME}" \
|
||||
"Nightly build, ${GIT_SHA}"
|
||||
```
|
||||
|
||||
### Build binary package:
|
||||
```bash
|
||||
debuild \
|
||||
--no-tgz-check \
|
||||
--build=binary \
|
||||
--unsigned-source \
|
||||
--unsigned-changes
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v ../*.{deb,changes} OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v ../*.{deb,changes} /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
117
scripts/packaging/build/dependencies/libilbc/README.md
Normal file
117
scripts/packaging/build/dependencies/libilbc/README.md
Normal file
@ -0,0 +1,117 @@
|
||||
# Building `libilbc` Debian Package
|
||||
|
||||
This guide explains how to build the `libilbc` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone git@github.com:freeswitch/libilbc.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd libilbc/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/libilbc/
|
||||
```
|
||||
|
||||
### Extract Debian package version:
|
||||
```bash
|
||||
export VERSION=$(dpkg-parsechangelog --show-field Version | cut -f1 -d'-')
|
||||
```
|
||||
|
||||
### Extract git hash:
|
||||
```bash
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& mk-build-deps \
|
||||
--install \
|
||||
--remove debian/control \
|
||||
--tool "apt-get -y --no-install-recommends" \
|
||||
&& apt-get -y -f install
|
||||
```
|
||||
|
||||
### Update changelog:
|
||||
```bash
|
||||
dch \
|
||||
--controlmaint \
|
||||
--distribution "${CODENAME}" \
|
||||
--force-bad-version \
|
||||
--force-distribution \
|
||||
--newversion "${VERSION}-${BUILD_NUMBER}-${GIT_SHA}~${CODENAME}" \
|
||||
"Nightly build, ${GIT_SHA}"
|
||||
```
|
||||
|
||||
### Build binary package:
|
||||
```bash
|
||||
debuild \
|
||||
--no-tgz-check \
|
||||
--build=binary \
|
||||
--unsigned-source \
|
||||
--unsigned-changes
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v ../*.{deb,changes} OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v ../*.{deb,changes} /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
98
scripts/packaging/build/dependencies/libks/README.md
Normal file
98
scripts/packaging/build/dependencies/libks/README.md
Normal file
@ -0,0 +1,98 @@
|
||||
# Building `libks` Debian Package
|
||||
|
||||
This guide explains how to build the `libks` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone git@github.com:signalwire/libks.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd libks/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/libks/
|
||||
```
|
||||
|
||||
### Extract git hash:
|
||||
```bash
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y install \
|
||||
libssl-dev \
|
||||
uuid-dev
|
||||
```
|
||||
|
||||
### Build binary package:
|
||||
```bash
|
||||
PACKAGE_RELEASE="${BUILD_NUMBER}.${GIT_SHA}" cmake . \
|
||||
-DCMAKE_BUILD_TYPE=Debug \
|
||||
-DCMAKE_INSTALL_PREFIX="/usr" \
|
||||
&& make package
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v *.deb OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v *.deb /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
117
scripts/packaging/build/dependencies/libsilk/README.md
Normal file
117
scripts/packaging/build/dependencies/libsilk/README.md
Normal file
@ -0,0 +1,117 @@
|
||||
# Building `libsilk` Debian Package
|
||||
|
||||
This guide explains how to build the `libsilk` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone git@github.com:freeswitch/libsilk.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd libsilk/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/libsilk/
|
||||
```
|
||||
|
||||
### Extract Debian package version:
|
||||
```bash
|
||||
export VERSION=$(dpkg-parsechangelog --show-field Version | cut -f1 -d'-')
|
||||
```
|
||||
|
||||
### Extract git hash:
|
||||
```bash
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& mk-build-deps \
|
||||
--install \
|
||||
--remove debian/control \
|
||||
--tool "apt-get -y --no-install-recommends" \
|
||||
&& apt-get -y -f install
|
||||
```
|
||||
|
||||
### Update changelog:
|
||||
```bash
|
||||
dch \
|
||||
--controlmaint \
|
||||
--distribution "${CODENAME}" \
|
||||
--force-bad-version \
|
||||
--force-distribution \
|
||||
--newversion "${VERSION}-${BUILD_NUMBER}-${GIT_SHA}~${CODENAME}" \
|
||||
"Nightly build, ${GIT_SHA}"
|
||||
```
|
||||
|
||||
### Build binary package:
|
||||
```bash
|
||||
debuild \
|
||||
--no-tgz-check \
|
||||
--build=binary \
|
||||
--unsigned-source \
|
||||
--unsigned-changes
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v ../*.{deb,changes} OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v ../*.{deb,changes} /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
151
scripts/packaging/build/dependencies/libv8/README.md
Normal file
151
scripts/packaging/build/dependencies/libv8/README.md
Normal file
@ -0,0 +1,151 @@
|
||||
# Building `libv8` Debian Package
|
||||
|
||||
This guide explains how to build the `libv8` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
- Only supported platform is AMD64
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone git@github.com:freeswitch/libv8-packaging.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd libv8-packaging/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/libv8-packaging/
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update -y \
|
||||
&& apt-get install -y \
|
||||
libbz2-dev \
|
||||
libffi-dev \
|
||||
libglib2.0-dev \
|
||||
liblzma-dev \
|
||||
libncurses5-dev \
|
||||
libncursesw5-dev \
|
||||
libreadline-dev \
|
||||
libsqlite3-dev \
|
||||
libssl-dev \
|
||||
libtinfo5 \
|
||||
llvm \
|
||||
ninja-build \
|
||||
tk-dev \
|
||||
zlib1g-dev
|
||||
```
|
||||
|
||||
### Configure build parameters:
|
||||
```bash
|
||||
export PYENV_VERSION_TAG=v2.4.0
|
||||
export PYTHON_VERSION=2.7.18
|
||||
export V8_GIT_VERSION=6.1.298
|
||||
export PYENV_ROOT="/opt/pyenv"
|
||||
export PATH="$PYENV_ROOT/shims:$PYENV_ROOT/bin:$BUILD_DIR/depot_tools:$PATH"
|
||||
export BUILD_DIR=$(realpath $(pwd))/BUILD
|
||||
```
|
||||
|
||||
### Clone, build and configure `pyenv`:
|
||||
```bash
|
||||
git clone --branch $PYENV_VERSION_TAG https://github.com/pyenv/pyenv.git $PYENV_ROOT \
|
||||
&& sed -i 's|PATH="/|PATH="$PYENV_ROOT/bin/:/|g' /etc/profile \
|
||||
&& $PYENV_ROOT/bin/pyenv init - | tee -a /etc/profile \
|
||||
&& echo "export PATH=\"$BUILD_DIR/depot_tools:${PATH}\"" | tee -a /etc/profile
|
||||
```
|
||||
|
||||
### Install `pyenv`:
|
||||
```bash
|
||||
pyenv install $PYTHON_VERSION \
|
||||
&& pyenv global $PYTHON_VERSION
|
||||
```
|
||||
|
||||
### Configure build:
|
||||
```bash
|
||||
mkdir -p $BUILD_DIR \
|
||||
&& cp ./stub-gclient-spec $BUILD_DIR/.gclient \
|
||||
&& cp -av ./debian/ $BUILD_DIR/ \
|
||||
&& cd $BUILD_DIR
|
||||
```
|
||||
|
||||
### Build binaries:
|
||||
```bash
|
||||
git clone --depth=1 https://chromium.googlesource.com/chromium/tools/depot_tools.git \
|
||||
&& gclient sync --verbose -r $V8_GIT_VERSION \
|
||||
&& cd v8 \
|
||||
&& gn gen out.gn --args="is_debug=true symbol_level=2 blink_symbol_level=1 v8_symbol_level=1 v8_static_library=true is_component_build=false v8_enable_i18n_support=false v8_use_external_startup_data=false" \
|
||||
&& gn args out.gn --list | tee out.gn/gn_args.txt \
|
||||
&& ninja -v d8 -C out.gn \
|
||||
&& cd $BUILD_DIR
|
||||
```
|
||||
|
||||
### Build Debian package:
|
||||
```bash
|
||||
sed -i -e "s/GIT_VERSION/$V8_GIT_VERSION/g" debian/v8-6.1_static.pc \
|
||||
&& sed -i -e "s/GIT_VERSION/$V8_GIT_VERSION/g" debian/changelog \
|
||||
&& sed -i -e "s/DATE/$(env LC_ALL=en_US.utf8 date '+%a, %d %b %Y %H:%M:%S %z')/g" debian/changelog \
|
||||
&& sed -i -e "s/DISTRO/$(lsb_release -sc | tr -d '\n')/g" debian/changelog \
|
||||
&& sed -i -e "s/BUILD_NUMBER/$BUILD_NUMBER/g" debian/changelog \
|
||||
&& debuild -b -us -uc
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v ../*.{deb,changes} OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v ../*.{deb,changes} /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
113
scripts/packaging/build/dependencies/signalwire-c/README.md
Normal file
113
scripts/packaging/build/dependencies/signalwire-c/README.md
Normal file
@ -0,0 +1,113 @@
|
||||
# Building `signalwire-c` Debian Package
|
||||
|
||||
This guide explains how to build the `signalwire-c` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
- LibKS
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone git@github.com:signalwire/signalwire-c.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd signalwire-c/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/signalwire-c/
|
||||
```
|
||||
|
||||
### Extract git hash:
|
||||
```bash
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
```
|
||||
|
||||
### (Optionally) Use local file-based Debian repository to install `libks` dependency:
|
||||
```bash
|
||||
cd OUT/ \
|
||||
&& dpkg-scanpackages . | tee OUT/Packages \
|
||||
&& gzip -f OUT/Packages \
|
||||
&& printf "deb [trusted=yes] file:$(realpath $(pwd)) ./\n" | tee /etc/apt/sources.list.d/local.list
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/OUT/ \
|
||||
&& dpkg-scanpackages . | tee /usr/src/OUT/Packages \
|
||||
&& gzip -f /usr/src/OUT/Packages \
|
||||
&& printf "deb [trusted=yes] file:/usr/src/OUT ./\n" | tee /etc/apt/sources.list.d/local.list
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y install \
|
||||
libks2
|
||||
```
|
||||
|
||||
### Build binary package:
|
||||
```bash
|
||||
PACKAGE_RELEASE="${BUILD_NUMBER}.${GIT_SHA}" cmake . \
|
||||
-DCMAKE_BUILD_TYPE=Debug \
|
||||
-DCMAKE_INSTALL_PREFIX="/usr" \
|
||||
&& make package
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v *.deb OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v *.deb /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
117
scripts/packaging/build/dependencies/sofia-sip/README.md
Normal file
117
scripts/packaging/build/dependencies/sofia-sip/README.md
Normal file
@ -0,0 +1,117 @@
|
||||
# Building `sofia-sip` Debian Package
|
||||
|
||||
This guide explains how to build the `sofia-sip` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone git@github.com:freeswitch/sofia-sip.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd sofia-sip/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/sofia-sip/
|
||||
```
|
||||
|
||||
### Extract Debian package version:
|
||||
```bash
|
||||
export VERSION=$(dpkg-parsechangelog --show-field Version | cut -f1 -d'-')
|
||||
```
|
||||
|
||||
### Extract git hash:
|
||||
```bash
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& mk-build-deps \
|
||||
--install \
|
||||
--remove debian/control \
|
||||
--tool "apt-get -y --no-install-recommends" \
|
||||
&& apt-get -y -f install
|
||||
```
|
||||
|
||||
### Update changelog:
|
||||
```bash
|
||||
dch \
|
||||
--controlmaint \
|
||||
--distribution "${CODENAME}" \
|
||||
--force-bad-version \
|
||||
--force-distribution \
|
||||
--newversion "${VERSION}-${BUILD_NUMBER}-${GIT_SHA}~${CODENAME}" \
|
||||
"Nightly build, ${GIT_SHA}"
|
||||
```
|
||||
|
||||
### Build binary package:
|
||||
```bash
|
||||
debuild \
|
||||
--no-tgz-check \
|
||||
--build=binary \
|
||||
--unsigned-source \
|
||||
--unsigned-changes
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v ../*.{deb,changes} OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v ../*.{deb,changes} /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
117
scripts/packaging/build/dependencies/spandsp/README.md
Normal file
117
scripts/packaging/build/dependencies/spandsp/README.md
Normal file
@ -0,0 +1,117 @@
|
||||
# Building `spandsp` Debian Package
|
||||
|
||||
This guide explains how to build the `spandsp` Debian package.
|
||||
|
||||
## Prerequisites:
|
||||
- Git
|
||||
- Debian-based system (native or Docker)
|
||||
|
||||
## Build Steps
|
||||
|
||||
### Clone the repository:
|
||||
```bash
|
||||
git clone --branch packages git@github.com:freeswitch/spandsp.git
|
||||
```
|
||||
|
||||
### (Optionally) Use Docker to build packages for Debian `Bookworm`:
|
||||
```bash
|
||||
docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
|
||||
```
|
||||
|
||||
### Set non-interactive frontend for APT:
|
||||
```bash
|
||||
export DEBIAN_FRONTEND=noninteractive
|
||||
```
|
||||
|
||||
### Install required build tools:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& apt-get -y upgrade \
|
||||
&& apt-get -y install \
|
||||
build-essential \
|
||||
cmake \
|
||||
devscripts \
|
||||
lsb-release \
|
||||
docbook-xsl \
|
||||
pkg-config
|
||||
```
|
||||
|
||||
### Set build number (modify as needed):
|
||||
```bash
|
||||
export BUILD_NUMBER=42
|
||||
```
|
||||
> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
|
||||
|
||||
### Set Debian codename:
|
||||
```bash
|
||||
export CODENAME=$(lsb_release -sc)
|
||||
```
|
||||
|
||||
### Configure git safety setting:
|
||||
```bash
|
||||
git config --global --add safe.directory '*'
|
||||
```
|
||||
|
||||
### Navigate to the source directory:
|
||||
```bash
|
||||
cd spandsp/
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
cd /usr/src/spandsp/
|
||||
```
|
||||
|
||||
### Extract Debian package version:
|
||||
```bash
|
||||
export VERSION=$(dpkg-parsechangelog --show-field Version | cut -f1 -d'-')
|
||||
```
|
||||
|
||||
### Extract git hash:
|
||||
```bash
|
||||
export GIT_SHA=$(git rev-parse --short HEAD)
|
||||
```
|
||||
|
||||
### Install build dependencies:
|
||||
```bash
|
||||
apt-get update \
|
||||
&& mk-build-deps \
|
||||
--install \
|
||||
--remove debian/control \
|
||||
--tool "apt-get -y --no-install-recommends" \
|
||||
&& apt-get -y -f install
|
||||
```
|
||||
|
||||
### Update changelog:
|
||||
```bash
|
||||
dch \
|
||||
--controlmaint \
|
||||
--distribution "${CODENAME}" \
|
||||
--force-bad-version \
|
||||
--force-distribution \
|
||||
--newversion "${VERSION}-${BUILD_NUMBER}-${GIT_SHA}~${CODENAME}" \
|
||||
"Nightly build, ${GIT_SHA}"
|
||||
```
|
||||
|
||||
### Build binary package:
|
||||
```bash
|
||||
debuild \
|
||||
--no-tgz-check \
|
||||
--build=binary \
|
||||
--unsigned-source \
|
||||
--unsigned-changes
|
||||
```
|
||||
|
||||
### Move built packages to the output directory:
|
||||
```bash
|
||||
mkdir -p OUT \
|
||||
&& mv -v ../*.{deb,changes} OUT/.
|
||||
```
|
||||
-- or --
|
||||
```bash
|
||||
mkdir -p /usr/src/OUT \
|
||||
&& mv -v ../*.{deb,changes} /usr/src/OUT/.
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
After a successful build, the Debian packages will be available in the `OUT` directory.
|
||||
Loading…
x
Reference in New Issue
Block a user