Sally installieren und aktualisieren

Sally benötigt kein Installationsprogramm. Eine Version ist eine .zip-Datei für Ihre Plattform (x64, x86 oder ARM64). Entpacken Sie sie in einen beschreibbaren Ordner, z. B. C:\Tools\Sally, und starten Sie sally.exe. Die Ordner plugins, toolbars und utils müssen neben sally.exe bleiben. Ihre Einstellungen werden pro Benutzer außerhalb dieses Ordners gespeichert und von Aktualisierungen nicht berührt.

Das Aktualisierungsprogramm utils\salupdate.exe von Sally findet und installiert neue Versionen auf GitHub. Sally selbst verbindet sich dafür nie mit dem Internet, sondern startet das Aktualisierungsprogramm.

Seit Sally 1.0.38 verwendet das Aktualisierungsprogramm die in Sally gewählte Sprache, einschließlich Englisch, wenn Windows eine andere Sprache verwendet. Ist keine gültige Sally-Sprache konfiguriert, wählt es eine verfügbare Windows-Sprache und verwendet ersatzweise Englisch. Seine Fenster und Bestätigungen verwenden die Dialogschrift und das Anwendungssymbol von Sally. Seit 1.0.40 verwendet es eine konfigurierte eigene Dateifensterschrift, andernfalls die Windows-Dialogschrift, und übernimmt die gespeicherte Symbolfarbe.

So aktualisieren Sie aus Sally:

Wählen Sie Hilfe/Auf neue Versionen prüfen. Das Aktualisierungsfenster fragt GitHub nach der neuesten Version und zeigt die installierte und aktuelle Version mit Versionshinweisen an.
Wenn eine neuere Version angezeigt wird, klicken Sie auf Installieren und neu starten.
Das Aktualisierungsprogramm lädt die Version herunter, prüft die veröffentlichte SHA-256-Prüfsumme, entpackt sie und bittet um Bestätigung.
Alle aus demselben Ordner gestarteten Sally-Fenster werden geschlossen, die Dateien ersetzt und Sally erneut gestartet. Anschließend zeigt das Aktualisierungsfenster das Ergebnis.

Versionsseite öffnen zeigt die Version auf GitHub. Erst ein Klick auf Installieren und neu starten installiert sie.

Versionshinweise und freiwillige Unterstützung

Seit Sally 1.0.39 trennt das Aktualisierungsfenster Was ist neu? von Vom Entwickler. Signierte Inhalte können Hinweise in Ihrer Sprache bereitstellen. Wenn optionale Inhalte nicht geladen werden können, bleiben englische Versionshinweise verfügbar. Nachrichten des Betreuers sind für alle sichtbar. Fehlende Inhalte verhindern keine kostenlose Aktualisierung.

Hilfe/Was ist neu? öffnet die mitgelieferten Hinweise zur installierten Version vollständig offline. Dabei werden weder neue Versionen gesucht noch installiert. Mit Auf Aktualisierungen prüfen starten Sie dort ausdrücklich eine Onlineprüfung.

Sally unterstützen öffnet die Seite zur finanziellen Unterstützung. In 1.0.40 erscheinen optionale Unterstützungsaktionen bei Aktualisierungsprüfungen und in der kompakten Erfolgsbestätigung. Ein freiwilliger Unterstützerschlüssel aktiviert Ihr Unterstützerabzeichen: Ihren gewählten Namen unter Über Sally und optional im Titel von Sally. Während eines aktiven oder zukünftig beginnenden Unterstützungszeitraums blendet das Aktualisierungsprogramm die Schaltflächen für Unterstützung und Schlüsseleingabe aus. Name, Zeitraum und Schlüsselverwaltung bleiben unter Über Sally verfügbar, ebenso Nachrichten des Betreuers. Alle Funktionen und Aktualisierungen bleiben kostenlos. Schließen schließt nur das Aktualisierungsfenster, ohne Unterstützereinstellungen zu ändern.

Über Unterstützerschlüssel eingeben fügen Sie einen Schlüssel ein oder importieren seine Datei. Die Prüfung erfolgt automatisch offline. Prüfen Sie Name und Zeitraum und wählen Sie Schlüssel speichern. Unter Über Sally zeigt Unterstützerdetails den gespeicherten Namen und Unterstützungszeitraum. Die Option für den Namen im Fenstertitel wird sofort gespeichert. Der kleine Pfeil neben Schließen bietet Ersetzen, Exportieren und bestätigtes lokales Entfernen. Ihr Name wird lokal auf Ihrem Computer angezeigt.

Nach einem Beitrag über PayPal oder Buy Me a Coffee nutzen Sie den Anforderungslink auf der Unterstützungsseite, um badges [at] get-sally [dot] app Ihren gewünschten Abzeichennamen, die Zustelladresse, den Zahlungsanbieter und den Zahlungsnamen oder die Transaktionsreferenz per E-Mail zu senden. Schlüssel werden manuell ausgestellt, normalerweise innerhalb einer Woche. Alle Funktionen und Aktualisierungen bleiben kostenlos.

Links in beiden Lesebereichen lassen sich per Maus oder Kontextmenü öffnen: Fokussieren Sie den Bereich und drücken Sie Shift+F10 oder die Kontextmenütaste.

Zeitplan für automatische Aktualisierungsprüfungen

Sally sucht auch automatisch nach neueren Versionen, standardmäßig wöchentlich. Unter Nach Updates suchen in Konfiguration/Allgemein wählen Sie Intervalle von täglich bis halbjährlich oder nie. Nur bei einer neueren Version öffnet sich das Aktualisierungsfenster, ohne den Tastaturfokus zu übernehmen; seine Taskleistenschaltfläche blinkt. Ist GitHub nicht erreichbar, versucht Sally es am nächsten Tag erneut.

Bis Sally 1.0.36 übernahm dies das Plugin Check Version. Sally 1.0.37 übernimmt dessen Zeitplan und entfernt das Plugin.

So aktualisieren Sie mit einer heruntergeladenen Version (auch offline):

Laden Sie die .zip-Datei für Ihre Plattform und möglichst auch Sally-v<version>-SHA256SUMS.txt in denselben Ordner herunter.
Ziehen Sie die .zip-Datei auf utils\salupdate.exe in Ihrem Sally-Ordner oder führen Sie utils\salupdate.exe <path to the .zip> aus.
Das Aktualisierungsprogramm zeigt die installierte und neue Version, fragt vor einer älteren Version nach, zeigt an, ob Sally läuft, und bittet einmal um Bestätigung. Sally wird geschlossen, die Dateien ersetzt und Sally erneut gestartet.

Befehlszeile des Aktualisierungsprogramms

<file>.zip	Installiert eine heruntergeladene Version (siehe oben).
--yes	Beantwortet alle Fragen mit Ja und läuft ohne Meldungen; Fehler werden weiterhin angezeigt. Das Ergebnis wird ins Protokoll geschrieben (siehe unten).
--install <folder>	Aktualisiert Sally im angegebenen Ordner statt im Ordner des Aktualisierungsprogramms.
--check	Öffnet das Aktualisierungsfenster wie Hilfe/Auf neue Versionen prüfen.
--whats-new	Zeigt die mitgelieferten Versionshinweise offline wie Hilfe/Was ist neu?. Kann mit --install zur Auswahl eines Sally-Ordners kombiniert werden. Schalter für Onlineprüfungen und Installationsaktionen sind in diesem Modus nicht zulässig.
--auto	Mit --check: Zeigt wie die automatische Prüfung von Sally nur bei einer neueren Version ein Fenster. Der Exitcode ist 0, wenn Sally aktuell ist, 1, wenn das Fenster angezeigt wurde, und 2, wenn GitHub nicht erreichbar war.
--feed <address>	Mit --check: Fragt eine andere HTTPS-Adresse ab, die wie der Versionsfeed von GitHub antwortet (ein Spiegelserver).
--report --result <file>	Zeigt das Ergebnis der Aktualisierung an, die die Ergebnisdatei hinterlassen hat. Sally startet diesen Modus nach einer Aktualisierung.

Starten Sie salupdate.exe ohne Datei, um eine unterbrochene Aktualisierung, etwa nach einem Stromausfall, rückgängig zu machen. Zum Installieren startet Sally das Aktualisierungsprogramm mit weiteren eigenen Schaltern (--prepare, --apply und ihren Argumenten); diese sind nicht zur manuellen Eingabe bestimmt.

Was eine Aktualisierung ändert

Nur die Dateien der Version werden ersetzt. Andere Dateien, etwa exportierte Konfigurationen oder eigene Dateien, bleiben unverändert.
Dateien früherer Versionen, die in der neuen Version nicht mehr enthalten sind, werden entfernt, z. B. das in 1.0.37 eingestellte Plugin Check Version. Die Version führt solche Dateien in sally-update.obsolete im Sally-Ordner auf.
Bis alle neuen Dateien bereitstehen, wird nichts geändert. Kann eine Datei nicht ersetzt werden, werden alle Dateien exakt auf ihren vorherigen Zustand zurückgesetzt.
Der Windows-Explorer hält die Shell-Erweiterung von Sally geladen (utils\salextx64.dll, salextx86.dll oder salextARM64.dll). Das Aktualisierungsprogramm benennt die geladene Datei z. B. in salextx64.dll.sally-old um und legt die neue an ihrer Stelle ab. Sally löscht die alte Kopie bei einem späteren Start, sobald Explorer sie nicht mehr verwendet. Ein Neustart von Windows ist nicht erforderlich.
Bei einem Sally-Ordner unter Program Files wird einmal um Administratorrechte gebeten, nur zum Ersetzen der Dateien.

Vor der Installation prüft das Aktualisierungsprogramm, ob das Paket eine Sally-Version für Ihren Prozessor ist. Es lehnt Pakete ab, die außerhalb des Sally-Ordners schreiben würden oder deren veröffentlichte SHA-256-Prüfsumme nicht stimmt. Ohne Vergleichsprüfsumme wird nur nach Ihrer Bestätigung installiert.

Hilfe bei Problemen

Protokoll und letztes Ergebnis des Aktualisierungsprogramms: %LOCALAPPDATA%\Sally\Update\salupdate.log und result.txt. Downloads bleiben bis zum Abschluss im selben Ordner.
Sie können jederzeit manuell aktualisieren: Schließen Sie Sally und entpacken Sie die neue Version über den Sally-Ordner. Meldet Windows, dass salextx64.dll verwendet wird, benennen Sie diese Datei um und kopieren Sie erneut.
Sally 1.0.35 und älter haben kein Aktualisierungsprogramm; aktualisieren Sie diese einmal manuell.

Siehe auch

Konfiguration/Allgemein
Neuerungen dieser Version
Sally mit Parametern starten

Ersetzen Sie zum Schreiben einer E-Mail [at] durch @ und [dot] durch einen Punkt. Nennen Sie Ihren gewünschten Abzeichennamen, Zustell-E-Mail-Adresse, Zahlungsanbieter und Zahlungsnamen oder Transaktionsreferenz.

der Kontaktadresse für Abzeichen: badges [at] get-sally [dot] app