macOS & iOS Requirements

Unless the "fips" feature is enabled, building aws-lc-rs v1.7.0 (or later) for macOS targets should only require a C/C++ compiler. Builds for iOS will also require CMake.

Platformdefaultfipsbindgen required?
aarch64-apple-darwinC/C++ CompilerC/C++ Compiler, CMake & GoNo
x86_64-apple-darwinC/C++ CompilerC/C++ Compiler, CMake & GoNo
aarch64-apple-iosC/C++ Compiler & CMakeNot SupportedYes
x86_64-apple-iosC/C++ Compiler & CMakeNot SupportedYes

C/C++ Compiler

Install Command Line Tools for Xcode which a provides a C/C++ compiler environment (LLVM).

CMake

MacPorts

sudo port install cmake

Homebrew

brew install cmake

Bindgen

On most platforms, bindgen requires libclang or llvm package to be installed. See the requirements page in The bindgen User Guide for instructions.

MacPorts

sudo port install clang

Homebrew

brew install llvm

bindgen-cli

cargo install --force --locked bindgen-cli

FIPS build

Building with the "fips" feature on this platform will result in the creation of shared libraries (named like libaws_lc_fips_0_xx_yy_crypto.dylib and libaws_lc_fips_0_xx_yy_rust_wrapper.dylib). These shared libraries will likely need to be distributed alongside any executable that depends on aws-lc-rs.

Troubleshooting

See our troubleshooting section.