cargo-ferrokit-0.5.0 is not a library.
cargo-ferrokit
Make, run, check, bundle and notarize native Mac apps built with
ferrokit.
&&
| Command | What it does |
|---|---|
new <path> [--document] |
A new app: a to-do list, or a text document app, with self-checks and an AGENTS.md for AI coding assistants. |
run [--release] |
Builds, bundles and runs the app (its name, icon and identity), output in the terminal. |
check |
Clippy (warnings are errors), tests, a bundle, the app's self-checks (CHECK=all), the signature. |
bundle [--universal] [--zip] |
A signed .app with the hardened runtime (ad hoc, or your Developer ID). |
notarize [--dry-run] |
Developer ID signing, Apple's notary service, stapling, a zip to share. |
appcast [--key-file <file>] |
Updates through Sparkle: zips the bundled app into updates/ and writes the feed (Sparkle's generate_appcast), ready to upload. |
bundle --app-store [--build <n>] [--dry-run] |
For the Mac App Store: universal, sandboxed, the provisioning profile embedded, Apple Distribution signing, a signed .pkg for Transporter. |
Settings live in the app's Cargo.toml:
[]
= "My App"
= "com.example.myapp"
= "icon.png" # square PNG (1024 px) or .icns
= "15.0"
= "public.app-category.productivity"
= ["de", "fr"] # its translations, besides English
= "Developer ID Application: Your Name (TEAMID)"
= "my-profile" # xcrun notarytool store-credentials my-profile …
= true # sign for the App Sandbox (files the user chooses, bookmarks)
= true # with the sandbox: outgoing connections
= "Apple Distribution: Your Name (TEAMID)" # bundle --app-store
= "3rd Party Mac Developer Installer: Your Name (TEAMID)"
= "MyApp.provisionprofile" # a Mac App Store profile
[[]]
= "Text"
= ["txt", "md"]
[] # updates through Sparkle 2
= "https://example.com/myapp/appcast.xml"
= "…" # what Sparkle's bin/generate_keys prints
= "~/Developer/Sparkle-2.10.1" # Sparkle's release, unpacked (or FERROKIT_SPARKLE)
With updates set, bundle embeds and signs Sparkle.framework and the
app gets Check for Updates… (see the guide's Testing and shipping
chapter).
macOS only. It runs Apple's tools (codesign, plutil, sips,
iconutil, lipo, ditto, xcrun notarytool, stapler, spctl), which
come with the Command Line Tools; appcast runs Sparkle's generate_appcast.
License: MIT OR Apache-2.0.