Get Started with Amore

There are 3 steps to get started with Amore.

  1. Register your app with Amore.
  2. Add Sparkle to your project.
  3. Publish your app.

Register your app with Amore

The easiest way to get started with Amore is to drag your app binary (.app) into Amore. You will then get prompted to register the app with Amore which you can do by hitting the Create App button.

Create App

Add Sparkle to your project

After you created the app you will see metadata about your app. There are two entries which will show a warning.

  • Update Feed URL
  • Public Key

These two entries in your Info.plist are required by Sparkle to fetch and install new updates.

Create App

If you click on the warnings (the red x), you will be presented with a popover that explains which keys to add/change and provides you with a copyable value that you can paste into your Info.plist file.

SUPublicEDKey requires you to have previously setup a Sparkle private key. If you haven't done that yet, create one.

After you add SUFeedURL and SUPublicEDKey into your Info.plist you need to add the Sparkle updater SPUStandardUpdaterController if you haven't already.

  1. In your Xcode project: File › Add Packages…
  2. Enter https://github.com/sparkle-project/Sparkle as the package repository URL

Initialize the SPUStandardUpdaterController in your app's @main entry point. Here is an example for SwiftUI. Alternatively add it to your app delegate's didFinishLaunchingWithOptions method.

import SwiftUI
import Sparkle

@main
struct AmoreApp: App {

  let updaterController = SPUStandardUpdaterController(
    startingUpdater: true,
    updaterDelegate: nil,
    userDriverDelegate: nil
  )
      
  var body: some Scene {
    WindowGroup {
      ContentView()
    }
  }
}

Publish your app

After you added Sparkle and set the correct values in your Info.plist, you are ready to distribute your app with Amore.

Drag and drop your app binary (.app) into Amore, optionally write release notes and hit publish.

Congrats. You just published your first app with Amore.

Succes