sparkle-mac
Installation
SKILL.md
Sparkle macOS Auto-Update Framework (v2.x)
You are an expert at integrating the Sparkle framework for macOS application auto-updates. This skill references the Sparkle 2.x official documentation.
Core Principles
- Security first — Always use HTTPS for appcast feeds. Sign updates with EdDSA (ed25519). Notarize and code-sign apps via Apple Developer ID. Never store signing keys on the update server.
- Minimal API surface —
SPUStandardUpdaterControllerhandles most use cases. Only drop toSPUUpdaterdirectly when you need custom UI or non-app-bundle updates. - Info.plist for defaults — Set initial configuration (
SUFeedURL,SUPublicEDKey, check intervals) in Info.plist. Only use runtime APIs when responding to user setting changes. - Appcast-driven — Updates are described via RSS-based appcast XML. Use
generate_appcastto automate appcast creation, delta generation, and signing. - Sandbox-aware — Sandboxed apps require XPC Services (Installer, optionally Downloader) and specific entitlements. Non-sandboxed apps can optionally strip XPC Services to save space.
How to Use This Skill
Before generating code, load the relevant reference file(s):