-
Notifications
You must be signed in to change notification settings - Fork 41
Quick Start
Aether edited this page Sep 8, 2025
·
1 revision
Note: The release script now auto-increments version numbers. Just run ./create-release.sh without arguments for patch releases.
brew install --cask sparkle
./setup-sparkle-tools.sh
./setup-sparkle.sh# Auto-increment version (recommended)
./create-release.sh
# Or specify version manually
./create-release.sh 0.0.1# Create gh-pages branch
git checkout -b gh-pages
git rm -rf .
cp ../appcast.xml .
git add appcast.xml
git commit -m "Add appcast for updates"
git push origin gh-pages
# Enable in GitHub: Settings → Pages → Source: gh-pages- Upload
Ora-Browser.dmgto GitHub Releases - Upload
appcast.xmlto any web host
Edit project.yml:
settings:
base:
SUFeedURL: https://the-ora.github.io/browser/appcast.xml
SUPublicEDKey: YOUR_PUBLIC_KEY_HERExcodegen
# Build and run app
# Go to Settings → General → Check for Updates| File | Location | Purpose |
|---|---|---|
build/appcast.xml |
Public web server | Update feed for Sparkle |
build/Ora-Browser.dmg |
GitHub Releases | App installer download |
build/dsa_pub.pem |
App bundle | Public key for verification |
-
Appcast:
https://the-ora.github.io/browser/appcast.xml -
DMG:
https://github.com/the-ora/browser/releases/download/v{VERSION}/Ora-Browser.dmg -
Public Key: Copy from
dsa_pub.pem
- DSA keys generated (
dsa_priv.pem,dsa_pub.pem) - Release built and signed (
Ora-Browser.dmg) - Appcast updated with real signature
- Appcast hosted at public URL
- DMG uploaded to GitHub Releases
-
SUFeedURLupdated in app -
SUPublicEDKeyadded to app - Xcode project regenerated
-
Keys not working: Run
./setup-sparkle.shagain -
Signature invalid: Use
sign_updatecommand output exactly -
Update not found: Check
SUFeedURLin Info.plist - DMG won't download: Verify GitHub release is public
See docs/HOSTING_SETUP.md for detailed instructions.
</xai:function_call: write>
/Users/keni/code/ora/browser/docs/QUICK_START.md