common-dependency-build-helpers-4-apple-hardware

Contains one macOS build script for each dependency and an Xcode project with convenience build aggragates (using the build scripts).

Prerequisites

Package managers

MacPorts for installing dependencies:

Install MacPorts for your version of OS X/macOS.

Dependencies of prerequisites

You need a working python3 environment and all dependencies:

sudo port install git

sudo port install asn1c

sudo port install python38
sudo port install py38-lxml
sudo port select --set python3 python38

sudo port install gmake
sudo port install autoconf
sudo port install libtool
sudo port install automake

sudo port install wget

sudo port install gsed

sudo port install capnproto

xcode-select --install

Install Rust

curl https://sh.rustup.rs -sSf | sh

add this to ~/.profile (create if it doesn't exist):

source $HOME/.cargo/env
export PATH="$HOME/.cargo/bin:$PATH"

Restart your Console!

sudo port install pkgconfig
rustup toolchain install nightly
rustup target add x86_64-apple-darwin
rustup target add aarch64-apple-darwin
rustup target add aarch64-apple-darwin --toolchain nightly
rustup update

Dependencies

git clone https://gitea.pep.foundation/buff/mac-os-build-scripts-common-dependencies.git

Build

We recomend to not use the shell scripts directly but to use Xcode (because its a working, tested onliner and using the scripts directly is undocumented and untested).

Using Xcode UI

open CommonPEPDependencies/CommonPEPDependencies.xcodeproj.

Build the scheme fitting your needs (e.g. "build-pEpMIME-dependencies_macOS" if you need the dependencies for building pEpMIME).

Using terminal

xcodebuild -project "CommonPEPDependencies/CommonPEPDependencies.xcodeproj" -scheme "$NAME_OF_SCHEME_FITING_YOUR_NEEDS" -configuration [RELEASE|DEBUG]

Output Dir

You can configure the PREFIX to save build arttefacts and headers in CommonPEPDependencies/config.plist, setting the value for key "CommonPEPDependencies_PREFIX". It is relative to CommonPEPDependencies/CommonPEPDependencies.xcodeproj.

The default output dir is CommonPEPDependencies/build.

See: #Configs section for details re configuring it

Configs

config.plist

There is a CommonPEPDependencies/config.plist config file which you can configure the following in:

CommonPEPDependencies_PREFIX

Defines the PREFIX directory to save build arttefacts and headers in. It is relative to CommonPEPDependencies/CommonPEPDependencies.xcodeproj.

pEp_versions.plist

There is a /_config/pEp_versions.plist where you can configure the version used for pEp dependencies.

For 3rd party dependencies, the version used is hardcoded in the corresponding .code file (e.g. buildcode/iconv.code) as it is assumed to use the same 3rd party lib version for all pEp projects (if that assumtion is wrong, please do not chagne the .codefile but ping the maintainer to the version to /_config/pEp_versions.plist ).

Known Issue

Building sequoia this error is logged:

/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/objdump:1:1: 'conftest.o': Invalid/Unsupported object file format

It i yet unknown why that is the case, it seems to not do any harm and it does not return an none zero exit code.