From 00a0eb24fc7c65d27df572b78904c38ebe5da37f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Kornel=20Lesin=CC=81ski?= Date: Sat, 21 Jan 2017 13:06:15 +0000 Subject: [PATCH] 1.16 installer defaults --- documentation/package-updates/index.md | 10 +++++++++- documentation/upgrading/index.md | 6 ++++-- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/documentation/package-updates/index.md b/documentation/package-updates/index.md index 44b2c1a..61366c8 100644 --- a/documentation/package-updates/index.md +++ b/documentation/package-updates/index.md @@ -9,8 +9,16 @@ Guided Package Installation allows Sparkle to download and install a package, `p ### Deploying a Package -A guided installation occurs when Sparkle finds a `*.sparkle_guided.pkg` or `*.sparkle_guided.mpkg` in the root of the download. +#### Automatic installation + +A guided installation occurs when Sparkle finds a `*.pkg` or `*.mpkg` file in the root of the download archive ([older versions](/documentation/upgrading/) of Sparkle required the filename to be `*.sparkle_guided.pkg`). The installer package is installed using macOS's built-in command line installer, `/usr/sbin/installer`. No installation interface is shown to the user. A guided installation can be started by applications other than the application being replaced. This is particularly useful where helper applications or agents are used. + +#### Interactive GUI Installer + +An interactive installation occurs when Sparkle finds a `*.sparkle_interactive.pkg` or `*.sparkle_interactive.mpkg` file in the root of the download archive. + +The package will be installed using macOS's built-in GUI installer. The installation will require user to manually click through the steps, so we don't recommend this type of installation. diff --git a/documentation/upgrading/index.md b/documentation/upgrading/index.md index 517c5f4..f663c61 100644 --- a/documentation/upgrading/index.md +++ b/documentation/upgrading/index.md @@ -4,9 +4,11 @@ id: documentation title: Upgrading from previous versions of Sparkle --- -We strongly recommend using Sparkle 1.13.1 or later, as there have been important fixes in reliability and [security](/documentation/security) of updates. Very old versions of Sparkle also suffer some incompatibilities with the latest macOS versions. +We strongly recommend upgrading Sparkle to the [latest version](//github.com/{{ site.github_username }}/Sparkle/releases), as there have been important fixes in reliability and [security](/documentation/security) of updates. Very old versions of Sparkle also suffer some incompatibilities with the latest macOS versions. -If you're upgrading from a very old version of Sparkle we recommend using [Sparkle 1.14 or later](//github.com/{{ site.github_username }}/Sparkle/releases). The API is backwards-compatible. +## Upgrading from Sparkle 1.15 and older + +For updates that [use the `.pkg` format](https://sparkle-project.org/documentation/package-updates/), Sparkle no longer shows the full Installer GUI by default. Rename your `.pkg` file to `.sparkle_interactive.pkg` to keep the old behavior. ## Upgrading to SDK 10.11 (affects all versions of Sparkle)