Build Instructions¶

Shaka Packager supports building on Windows, Mac and Linux host systems.

Linux build dependencies¶

Most development is done on Ubuntu (currently 22.04 LTS, Jammy Jellyfish). The dependencies mentioned here are only for Ubuntu. There are some instructions for other distros below.

sudo apt-get update
sudo apt-get install -y \
        curl \
        build-essential cmake git ninja-build python3

Note that git must be v1.7.6 or above to support relative paths in submodules.

Note also that cmake must be v3.24 or above to support a linker setting needed for absl::log_flags.

Mac system requirements¶

Xcode 7.3+.

The OS X 10.10 SDK or later. Run

ls `xcode-select -p`/Platforms/MacOSX.platform/Developer/SDKs

to check whether you have it.

Install Ninja (recommended) using Homebrew¶

brew install ninja

Windows system requirements¶

Visual Studio 2017 or newer.
Windows 10 or newer.

Recommended version of Visual Studio is 2022, the Community edition should work for open source development of tools like Shaka Packager but please check the Community license terms for your specific situation.

Install the “Desktop development with C++” workload which will install CMake and other needed tools.

If you use chocolatey, you can install these dependencies with:

choco install -y `
  git cmake ninja python `
  visualstudio2022community visualstudio2022-workload-nativedesktop `
  visualstudio2022buildtools windows-sdk-10.0

# Find python install
$pythonpath = Get-Item c:\Python* | sort CreationDate | Select-Object -First 1

# Symlink python3 to python
New-Item -ItemType SymbolicLink `
  -Path "$pythonpath/python3.exe" -Target "$pythonpath/python.exe"

# Update global PATH
$env:PATH += ";C:\Program Files\Git\bin;c:\Program Files\CMake\bin;$pythonpath"
setx PATH "$env:PATH"

Get the code¶

Dependencies are now managed via git submodules. To get a complete checkout you can run:

git clone --recurse-submodules https://github.com/shaka-project/shaka-packager.git

Build Shaka Packager¶

Linux and Mac¶

Shaka Packager uses CMake as the main build tool, with Ninja as the recommended generator (outside of Windows).

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release

If you want to build debug code, replace Release above with Debug.

You can change other build settings with -D flags to CMake, for example you can build a shared libpackager instead of static by adding

-DBUILD_SHARED_LIBS="ON"

After configuring CMake you can run the build with

cmake --build build --parallel

To build portable, fully-static executables on Linux, you will need either musl as your system libc, or a musl toolchain. (See musl.cc. To create a portable, fully-static build for Linux, configure CMake with:

  -DCMAKE_BUILD_TYPE=Release \
  -DBUILD_SHARED_LIBS="OFF" \
  -DFULLY_STATIC="ON" \
  -DCMAKE_C_COMPILER=/path/to/x86_64-linux-musl-gcc \
  -DCMAKE_CXX_COMPILER=/path/to/x86_64-linux-musl-g++

Windows¶

Windows build instructions are similar. Using Tools > Command Line > Developer Command Prompt should open a terminal with cmake and ctest in the PATH. Omit the -G Ninja to use the default backend, and pass --config during build to select the desired configuration from Visual Studio.

cmake -B build
cmake --build build --parallel --config Release

Build artifacts¶

After a successful build, you can find build artifacts including the main packager binary in build output directory (build/packager/ for a Ninja build, build/packager/Release/ for a Visual Studio release build, or build/packager/Debug/ for a Visual Studio debug build).

See Shaka Packager Documentation on how to use Shaka Packager.

Installation¶

To install Shaka Packager, run:

cmake --install build/ --strip --config Release

You can customize the output location with --prefix (default /usr/local on Linux and macOS) and the DESTDIR environment variable. These are provided by CMake and follow standard conventions for installation. For example, to build a package by installing to foo instead of the system root, and to use /usr instead of /usr/local, you could run:

DESTDIR=foo cmake --install build/ --strip --config Release --prefix=/usr

Update your checkout¶

To update an existing checkout, you can run

git pull origin main --rebase
git submodule update --init --recursive

The first command updates the primary Packager source repository and rebases on top of tip-of-tree (aka the Git branch origin/main). You can also use other common Git commands to update the repo.

The second updates submodules for third-party dependencies.

Notes for other linux distros¶

The docker files at packager/testing/dockers have the most up to date commands for installing dependencies. For example:

Alpine Linux¶

Use apk command to install dependencies:

apk add --no-cache \
        bash curl \
        bsd-compat-headers linux-headers \
        build-base cmake git ninja python3

Arch Linux¶

Instead of running sudo apt-get install to install build dependencies, run:

pacman -Suy --needed --noconfirm \
        core/which \
        cmake gcc git ninja python3

Debian¶

Same as Ubuntu.

apt-get install -y \
        curl \
        build-essential cmake git ninja-build python3

Fedora¶

Instead of running sudo apt-get install to install build dependencies, run:

yum install -y \
        which \
        libatomic \
        cmake gcc-c++ git ninja-build python3

CentOS¶

For CentOS, Ninja is only available from the CRB (Code Ready Builder) repo

dnf update -y
dnf install -y yum-utils
dnf config-manager --set-enabled crb

then same as Fedora

yum install -y \
        which \
        libatomic \
        cmake gcc-c++ git ninja-build python3

OpenSUSE¶

Use zypper command to install dependencies:

zypper in -y \
        curl which \
        cmake gcc9-c++ git ninja python3

OpenSuse 15 doesn’t have the required gcc 9+ by default, but we can install it as gcc9 and symlink it.

ln -s g++-9 /usr/bin/g++
ln -s gcc-9 /usr/bin/gcc

Tips, tricks, and troubleshooting¶

Xcode license agreement¶

If you are getting the error

Agreeing to the Xcode/iOS license requires admin privileges, please re-run as root via sudo.

the Xcode license has not been accepted yet which (contrary to the message) any user can do by running:

xcodebuild -license

Only accepting for all users of the machine requires root:

sudo xcodebuild -license

Using an IDE¶

No specific instructions are available. However most IDEs with CMake support should work out of the box

Contributing¶

If you have improvements or fixes, we would love to have your contributions. See https://github.com/shaka-project/shaka-packager/blob/main/CONTRIBUTING.md for details.

We have continue integration tests setup on pull requests. You can also verify locally by running the tests manually.

ctest -C Debug -V --test-dir build

You can find out more about GoogleTest at its GitHub page.

You should install clang-format (using apt install or brew install depending on platform) to ensure that all code changes are properly formatted.

You should commit or stage (with git add) any code changes first. Then run

git clang-format --style Chromium origin/main

This will run formatting over just the files you modified (any changes since origin/main).