Getting Started

Installing

To install the latest release version of the rcodesign executable using Cargo (Rust’s package manager):

cargo install apple-codesign

To enable smart card integration:

cargo install --features smartcard apple-codesign

To compile and run from a Git checkout of its canonical repository (developer mode):

cargo run --bin rcodesign -- --help

To install from a Git checkout of its canonical repository:

cargo install --bin rcodesign

To install from the latest commit in the canonical Git repository:

cargo install --git https://github.com/indygreg/PyOxidizer --branch main rcodesign

Obtaining a Code Signing Certificate

Follow the instructions at Managing Code Signing Certificates to obtain a code signing certificate.

Installing Apple Transporter for Notarization

Notarization requires using Apple Transporter for uploading artifacts to Apple for notarization. This (Java) tool is distributed for macOS, Windows, and Linux.

You can install it by following Apple’s instructions.

If you do not want to perform notarization, you do not need to install Apple Transporter.

Obtaining an Apple Connect API Key

To notarize and staple, you’ll need an Apple Connect API Key to authenticate connections to Apple’s servers.

You can generate one at https://appstoreconnect.apple.com/access/api.

This requires an Apple Developer account, which requires paying money. You may need to click around in the App Store Connect website to enable the API keys feature.

Apple Transporter looks in various locations for the API Key. Run iTMSTransporter -help upload and read the docs for the -apiKey argument.

We recommend putting the keys in ~/.appstoreconnect/private_keys/ because that is a descriptive directory name.