Installer et mettre à jour Sally

Sally ne nécessite aucun programme d’installation. Téléchargez le .zip de votre plateforme (x64, x86 ou ARM64), extrayez-le dans un dossier accessible en écriture, par exemple C:\Tools\Sally, et lancez sally.exe. Conservez les dossiers plugins, toolbars et utils à côté de sally.exe. Les paramètres sont propres à chaque utilisateur et stockés hors de ce dossier ; les mises à jour ne les touchent donc pas.

L’outil de mise à jour de Sally, utils\salupdate.exe, trouve et installe les versions publiées sur GitHub. Sally ne se connecte jamais lui-même pour les mises à jour : il lance cet outil.

Depuis Sally 1.0.38, l’outil suit la langue choisie dans Sally, y compris l’anglais lorsque Windows utilise une autre langue. Sans langue valide configurée dans Sally, il choisit une langue disponible de Windows, sinon l’anglais. Ses fenêtres et confirmations utilisent la police de dialogue et l’icône de Sally. Depuis 1.0.40, il utilise votre police de panneau personnalisée si elle est définie, sinon la police de dialogue de Windows, et respecte la couleur d’icône enregistrée.

Pour mettre à jour depuis Sally :

Choisissez Aide/Vérifier les mises à jour.... La fenêtre interroge GitHub et affiche les versions installée et disponible avec les notes de version.
Si une version plus récente est proposée, cliquez sur Installer et redémarrer.
L’outil télécharge la version, vérifie sa somme SHA-256 publiée, l’extrait et demande confirmation.
Toutes les fenêtres de Sally lancées depuis ce dossier se ferment, les fichiers sont remplacés et Sally redémarre. La fenêtre indique ensuite le résultat.

Ouvrir la page de la version affiche celle-ci sur GitHub. L’installation ne commence qu’en cliquant sur Installer et redémarrer.

Notes de version et soutien volontaire

Depuis Sally 1.0.39, la fenêtre distingue Nouveautés et Du développeur. Un contenu signé peut fournir des notes dans votre langue ; les notes anglaises restent disponibles si ce contenu facultatif ne se charge pas. Les messages du mainteneur sont visibles de tous. Un contenu absent n’empêche pas une mise à jour gratuite.

Aide/Nouveautés ouvre hors ligne les notes incluses dans la version installée, sans rechercher ni installer de mise à jour. Utilisez Rechercher des mises à jour pour lancer explicitement une vérification en ligne.

Soutenir Sally ouvre la page de soutien financier. Dans 1.0.40, les actions de soutien facultatives apparaissent pendant les vérifications et dans la confirmation compacte de réussite. Une clé de soutien volontaire active votre badge : le nom choisi dans À propos et, facultativement, dans le titre de Sally. Pendant une période de soutien active ou future, l’outil masque ses boutons de soutien et de saisie de clé. Votre nom, vos dates et la gestion de la clé restent accessibles dans À propos, et les messages du mainteneur restent visibles. Toutes les fonctions et mises à jour restent gratuites. Fermer ferme simplement la fenêtre sans changer vos préférences de soutien.

Saisir une clé de soutien permet de coller une clé ou d’importer son fichier. La vérification est automatique et hors ligne ; vérifiez le nom et les dates puis choisissez Enregistrer la clé. Dans À propos, Détails du soutien affiche le nom et les dates enregistrés. La case facultative affichant le nom dans le titre est enregistrée immédiatement. La petite flèche près de Fermer propose remplacement, exportation et suppression locale après confirmation. Votre nom est affiché localement sur votre ordinateur.

Après un don via PayPal ou Buy Me a Coffee, utilisez le lien de demande de la page de soutien pour écrire à badges [at] get-sally [dot] app, en indiquant le nom souhaité, l’adresse de livraison, le prestataire de paiement et le nom du payeur ou la référence de transaction. Les clés sont émises manuellement, généralement sous une semaine. Toutes les fonctions et mises à jour restent gratuites.

Les liens des deux panneaux de lecture s’ouvrent à la souris ou par le menu contextuel : activez le panneau puis appuyez sur Shift+F10 ou sur la touche Applications.

Fréquence des vérifications automatiques

Sally recherche aussi automatiquement une nouvelle version chaque semaine, sauf autre choix dans Rechercher les mises à jour de Configuration/Général : de chaque jour à chaque semestre, ou jamais. Seule une nouvelle version déclenche l’affichage de la fenêtre, sans détourner le clavier de votre activité ; son bouton de barre des tâches clignote. Si GitHub est inaccessible, Sally réessaie le lendemain.

Jusqu’à Sally 1.0.36, le plugin Check Version assurait cette fonction. Sally 1.0.37 reprend sa planification et supprime le plugin.

Pour installer une version téléchargée, même hors ligne :

Téléchargez le .zip de votre plateforme et, si possible, Sally-v<version>-SHA256SUMS.txt dans le même dossier.
Déposez le .zip sur utils\salupdate.exe dans le dossier de Sally, ou exécutez utils\salupdate.exe <path to the .zip>.
L’outil indique les versions installée et nouvelle, demande avant une rétrogradation, précise si Sally est en cours et demande une seule confirmation. Sally se ferme, les fichiers sont remplacés et Sally redémarre.

Ligne de commande de l’outil de mise à jour

<file>.zip	Installe une version téléchargée, comme décrit ci-dessus.
--yes	Répond Oui à toutes les questions et s’exécute sans messages, sauf les erreurs. Le résultat est écrit dans le journal ci-dessous.
--install <folder>	Met à jour Sally dans ce dossier plutôt que dans celui de l’outil.
--check	Ouvre la fenêtre de mise à jour, comme Aide/Vérifier les mises à jour....
--whats-new	Affiche hors ligne les notes incluses dans la version installée, comme Aide/Nouveautés. Peut être combiné à --install pour choisir un dossier de Sally. Les options de vérification en ligne et d’installation ne sont pas acceptées dans ce mode.
--auto	Avec --check, n’affiche rien sauf si une version plus récente existe, comme la vérification de Sally. Le code de sortie est 0 si Sally est à jour, 1 si la fenêtre s’est affichée et 2 si GitHub était inaccessible.
--feed <address>	Avec --check, interroge une autre adresse HTTPS répondant comme le flux de versions de GitHub, par exemple un miroir.
--report --result <file>	Affiche le résultat de la mise à jour ayant créé ce fichier de résultat. Sally le lance après une mise à jour.

Exécutez salupdate.exe sans fichier pour annuler une mise à jour interrompue, par exemple par une panne de courant. Sally lance l’outil avec ses propres options supplémentaires (--prepare, --apply et leurs paramètres) pour installer une version ; elles ne sont pas destinées à être saisies manuellement.

Ce qu’une mise à jour modifie

Seuls les fichiers de la version sont remplacés. Les autres, comme une configuration exportée ou vos ajouts, restent intacts.
Un fichier installé par une ancienne version mais retiré de la nouvelle est supprimé, comme le plugin Check Version dans 1.0.37. La liste figure dans sally-update.obsolete dans le dossier de Sally.
Rien ne change avant que les nouveaux fichiers soient prêts. Si un fichier ne peut être remplacé, tous sont remis exactement dans leur état initial.
L’Explorateur Windows garde l’extension du shell de Sally chargée (utils\salextx64.dll, salextx86.dll ou salextARM64.dll). L’outil renomme le fichier chargé, par exemple en salextx64.dll.sally-old, puis installe le nouveau. Sally supprime l’ancien lors d’un démarrage ultérieur, quand l’Explorateur ne l’utilise plus. Aucun redémarrage de Windows n’est nécessaire.
Un dossier de Sally dans Program Files entraîne une demande unique d’autorisation administrateur pour remplacer les fichiers.

Avant l’installation, l’outil vérifie que le paquet est une version de Sally pour votre processeur et refuse tout paquet écrivant hors du dossier de Sally. Une somme SHA-256 différente de celle publiée entraîne un refus ; sans somme de contrôle disponible, une confirmation est nécessaire.

Où chercher en cas de problème

Journal et dernier résultat : %LOCALAPPDATA%\Sally\Update\salupdate.log et result.txt. Les téléchargements restent dans ce dossier jusqu’à la fin de la mise à jour.
Vous pouvez toujours mettre à jour manuellement : fermez Sally et extrayez la nouvelle version dans le dossier de Sally. Si Windows signale que salextx64.dll est utilisé, renommez-le puis recommencez la copie.
Sally 1.0.35 et les versions antérieures n’ont pas cet outil : effectuez une première mise à jour manuelle.

Voir aussi

Configuration/Général
Nouveautés de cette version
Démarrer Sally avec des paramètres

Pour nous écrire, remplacez [at] par @ et [dot] par un point. Indiquez le nom souhaité pour le badge, l’adresse électronique de livraison, le prestataire de paiement et le nom du payeur ou la référence de transaction.

l’adresse de contact du badge: badges [at] get-sally [dot] app