3.9 KiB
Build Instructions
Instructions for building this repository on Linux.
Table of Contents
Contributing to the Repository
If you intend to contribute, the preferred workflow is for you to develop your contribution in a fork of this repository in your GitHub account and then submit a pull request.
Repository Content
This repository contains the source code necessary to build warp-packer for different platforms and architectures.
Building on Linux
Linux Development Environment Requirements
This repository has been built and tested on Debian 12.5 (Bookworm) on an AMD64 architecture.
Required Package List
apt install curl maven clang cmake libssl-dev zlib1g-dev liblzma-dev libbz2-dev gcc-aarch64-linux-gnu gcc-mingw-w64-x86-64-win32 git
Install and Prepare Required Rust Version
This repository has been built and tested with Rust version 1.78.
To install the newest version, run the following command:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
If a newer version doesn't work, a specific version can be installed with the following command:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-toolchain=1.78.0
For more information see this GitHub Issue and the official installation instructions.
After installing, run the following commands to get the necessary targets:
rustup target add x86_64-apple-darwin
rustup target add aarch64-unknown-linux-gnu
rustup target add x86_64-pc-windows-gnu
Required macOS SDK
To build warp-packer for the target x86_64-apple-darwin, a macOS SDK is needed. The repository has been built and tested with MacOSX10.12 SDK. There are several GitHub repositories available that contain different SDK versions, but they all seem to miss the header files. So it is recommended to download it from Apple's website. The macOS SDK is integrated into Xcode, and this repository has been built and tested with Xcode version 8.3.3.
Build and Use macOS SDK from Xcode
To build and use the macOS SDK from Xcode, osxcross will be used.
Download osxcross:
git clone https://github.com/tpoechtrager/osxcross.git
Extract macOS SDK from Xcode (see here):
<path/to>/osxcross/tools/gen_sdk_package_pbzx.sh <path/to>/Xcode_8.3.3.xip
Hint: This method may require up to 45 GB of free disk space. An SSD is recommended for this method.
Copy or move the SDK into the <path/to>/osxcross/tarballs/ directory.
Run:
UNATTENDED=yes OSX_VERSION_MIN=10.12 <path/to>/osxcross/build.sh
to create the macOS cross toolchain.
Add the target/bin folder to your PATH environment variable:
PATH="<path/to>/osxcross/target/bin:$PATH"
Build the Project
Clone the project and within the project directory, run:
make
to start the build.
The compiled warp-packer files are in the folder:
<path/to>/warp/target/<target>/release/warp-packer
e.g.
warp/target/aarch64-unknown-linux-gnu/release/warp-packer