diff --git a/i18n/ar/Tooltips.ar.resx b/i18n/ar/Tooltips.ar.resx
index e17cf9a4..15e4360c 100644
--- a/i18n/ar/Tooltips.ar.resx
+++ b/i18n/ar/Tooltips.ar.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089الاستعلام من صفحة الإصدارات العامة عن إصدار أحدث · بضع ثوانٍ
- ضغط السجلات وتقرير عن البيئة في ملف ZIP داخل مجلد تختاره؛ ولا تُضمَّن الإعدادات وكلمات المرور
- فتح صفحة الإصدار في المستعرضفتح الترخيص في المستعرضفتح المجلد الذي يضم قاعدة البيانات والإعدادات والسجلاتفتح صفحة الإصدارات العامة في المستعرض
@@ -139,7 +137,6 @@
حذف الإطارات المُفرَغة والصور المصغرة المخزنة مؤقتًا؛ مع طلب التأكيد أولًاقاعدة البيانات والإعدادات والسجلات وذاكرات التخزين المؤقت لهذا الكمبيوترالخادم الذي يتصل به Titano عند البدء؛ تغييره يسجّل الخروج · Enter للتطبيق، Esc للتراجع
- ضغط السجلات وتقرير عن البيئة في ملف ZIP داخل مجلد تختارهحفظ كل الإعدادات بتنسيق JSON، دون رمز الجلسةاسم ملف كل إطار، مثل {date}_{time}_{n:0000}؛ ويُضاف الامتداد · Enter للتطبيق، Esc للتراجعمجلدات الأرشيف، مثل {year}/{date} {camera}؛ الشرطة المائلة تبدأ مجلدًا فرعيًا · Enter للتطبيق، Esc للتراجع
diff --git a/i18n/cs/Tooltips.cs.resx b/i18n/cs/Tooltips.cs.resx
index 688a1f35..815df36e 100644
--- a/i18n/cs/Tooltips.cs.resx
+++ b/i18n/cs/Tooltips.cs.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Zjistí na veřejné stránce vydání, zda je k dispozici novější verze · několik sekund
- Zabalí protokoly a zprávu o prostředí do souboru ZIP ve zvolené složce; nastavení a hesla nejsou zahrnuta
- Otevře stránku vydání v prohlížečiOtevře licenci v prohlížečiOtevře složku s databází, nastavením a protokolyOtevře veřejnou stránku vydání v prohlížeči
@@ -137,7 +135,6 @@
Odstraní odložené snímky a miniatury v mezipaměti; nejprve se zeptáDatabáze, nastavení, protokoly a mezipaměti tohoto počítačeServer, ke kterému se Titano připojí při spuštění; změna vás odhlásí · Enter použije, Esc vrátí zpět
- Zabalí protokoly a zprávu o prostředí do souboru ZIP ve zvolené složceUloží všechna nastavení jako JSON, bez tokenu relaceNázev souboru každého snímku, například {date}_{time}_{n:0000}; přípona se přidá · Enter použije, Esc vrátí zpětSložky archivu, například {year}/{date} {camera}; lomítko zahájí podsložku · Enter použije, Esc vrátí zpět
diff --git a/i18n/da/Tooltips.da.resx b/i18n/da/Tooltips.da.resx
index 4d3be04a..46442f2b 100644
--- a/i18n/da/Tooltips.da.resx
+++ b/i18n/da/Tooltips.da.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Spørg den offentlige udgivelsesside efter en nyere version · et par sekunder
- Pak logfilerne og en miljørapport som ZIP i en mappe, du vælger; indstillinger og adgangskoder medtages ikke
- Åbn udgivelsessiden i browserenÅbn licensen i browserenÅbn mappen med database, indstillinger og loggeÅbn den offentlige udgivelsesside i browseren
@@ -135,7 +133,6 @@
Slet udlagte billeder og cachelagrede miniaturer; spørger førstDatabase, indstillinger, logge og cacher på denne pcServer, som Titano opretter forbindelse til ved start; en ændring logger dig af · Enter anvender, Esc fortryder
- Pak logfilerne og en miljørapport som ZIP i en mappe, du vælgerGem alle indstillinger som JSON uden sessionstokenetFilnavn for hvert billede, f.eks. {date}_{time}_{n:0000}; filtypenavnet tilføjes · Enter anvender, Esc fortryderArkivmapper, f.eks. {year}/{date} {camera}; en skråstreg starter en undermappe · Enter anvender, Esc fortryder
diff --git a/i18n/de/Tooltips.de.resx b/i18n/de/Tooltips.de.resx
index 46e24161..764b5e00 100644
--- a/i18n/de/Tooltips.de.resx
+++ b/i18n/de/Tooltips.de.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Auf der öffentlichen Release-Seite nach einer neueren Version suchen · wenige Sekunden
- Protokolle und einen Umgebungsbericht als ZIP in einen Ordner Ihrer Wahl packen; Einstellungen und Kennwörter sind nicht enthalten
- Release-Seite im Browser öffnenLizenz im Browser öffnenOrdner mit Datenbank, Einstellungen und Protokollen öffnenÖffentliche Release-Seite im Browser öffnen
@@ -135,7 +133,6 @@
Ausgelagerte Frames und zwischengespeicherte Miniaturansichten löschen; fragt vorher nachDatenbank, Einstellungen, Protokolle und Caches dieses PCsServer, mit dem sich Titano beim Start verbindet; eine Änderung meldet Sie ab · Enter übernimmt, Esc macht rückgängig
- Protokolle und einen Umgebungsbericht als ZIP in einen Ordner Ihrer Wahl packenAlle Einstellungen als JSON speichern, ohne das SitzungstokenDateiname jedes Frames, zum Beispiel {date}_{time}_{n:0000}; die Erweiterung wird angehängt · Enter übernimmt, Esc macht rückgängigArchivordner, zum Beispiel {year}/{date} {camera}; ein Schrägstrich beginnt einen Unterordner · Enter übernimmt, Esc macht rückgängig
diff --git a/i18n/el/Tooltips.el.resx b/i18n/el/Tooltips.el.resx
index a5f9d563..1b135fae 100644
--- a/i18n/el/Tooltips.el.resx
+++ b/i18n/el/Tooltips.el.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Αναζήτηση νεότερης έκδοσης στη δημόσια σελίδα εκδόσεων · λίγα δευτερόλεπτα
- Συμπίεση των αρχείων καταγραφής και μιας αναφοράς περιβάλλοντος σε ZIP, σε φάκελο της επιλογής σας. Οι ρυθμίσεις και οι κωδικοί πρόσβασης δεν περιλαμβάνονται
- Άνοιγμα της σελίδας της έκδοσης στο πρόγραμμα περιήγησηςΆνοιγμα της άδειας χρήσης στο πρόγραμμα περιήγησηςΆνοιγμα του φακέλου με τη βάση δεδομένων, τις ρυθμίσεις και τα αρχεία καταγραφήςΆνοιγμα της δημόσιας σελίδας εκδόσεων στο πρόγραμμα περιήγησης
diff --git a/i18n/en/About.resx b/i18n/en/About.resx
index 1dc68f3f..37466cd9 100644
--- a/i18n/en/About.resx
+++ b/i18n/en/About.resx
@@ -19,6 +19,7 @@
NoneTranslationTitano {0} available
+ CancelCheck for updatesChecking…Up to date
@@ -28,6 +29,6 @@
Check failedDownload not verifiedTitano {0} downloaded
- Show setup
+ Show fileUpdates
diff --git a/i18n/en/Tooltips.resx b/i18n/en/Tooltips.resx
index 5b582eb1..6ece7aea 100644
--- a/i18n/en/Tooltips.resx
+++ b/i18n/en/Tooltips.resx
@@ -4,13 +4,17 @@
2.0System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
+ Stop the download; Download resumes it later from where it stoppedAsk the public releases page for a newer version · a few secondsZip the logs, a system and codec report, settings and recent failed jobs into a folder you choose; passwords, tokens and photos are left out
- Download the setup, check it against the release's SHA-256 list and show it in Explorer · tens of MB
+ Download the setup, check it against the release's SHA-256 list and show it in Explorer · {0}
+ Open the page of this release in the browser
+ Download the portable zip, check it against the release's SHA-256 list and show it in Explorer · {0}Open the licence in the browserOpen the folder with database, settings and logsOpen the public releases page in the browserEvery language but English is machine-translated; propose a better wording on the public issue tracker
+ Show the verified zip in Explorer; close Titano and unpack it over this folder to upgrade. The data folder is keptShow the verified setup in Explorer; close Titano and run it to upgrade. Archive and settings are keptTitano uses no third-party code: everything beyond .NET and Windows is written in-houseDismiss
diff --git a/i18n/es/Tooltips.es.resx b/i18n/es/Tooltips.es.resx
index 807e5d05..725b7a2a 100644
--- a/i18n/es/Tooltips.es.resx
+++ b/i18n/es/Tooltips.es.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Consulta la página pública de versiones por si hay una más reciente · unos segundos
- Comprime los registros y un informe del entorno en una carpeta que elijas; no incluye la configuración ni las contraseñas
- Abre la página de la versión en el navegadorAbre la licencia en el navegadorAbre la carpeta con la base de datos, la configuración y los registrosAbre la página pública de versiones en el navegador
@@ -135,7 +133,6 @@
Elimina los fotogramas volcados y las miniaturas en caché; pide confirmación antesBase de datos, configuración, registros y cachés de este equipoServidor al que se conecta Titano al iniciar; si lo cambias, se cierra la sesión · Enter aplica, Esc revierte
- Comprime los registros y un informe del entorno en una carpeta que elijasGuarda todos los ajustes como JSON, sin el token de sesiónNombre de archivo de cada fotograma, por ejemplo {date}_{time}_{n:0000}; la extensión se añade sola · Enter aplica, Esc revierteCarpetas de la fototeca, por ejemplo {year}/{date} {camera}; una barra inicia una subcarpeta · Enter aplica, Esc revierte
diff --git a/i18n/et/Tooltips.et.resx b/i18n/et/Tooltips.et.resx
index d6aaa068..79098c4b 100644
--- a/i18n/et/Tooltips.et.resx
+++ b/i18n/et/Tooltips.et.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Kontrollige avalikult väljalasete lehelt, kas on uuem versioon · mõni sekund
- Pakkige logid ja keskkonnaaruanne ZIP-faili teie valitud kausta; sätteid ja paroole ei lisata
- Avage väljalaske leht brauserisAvage litsents brauserisAvage andmebaasi, sätete ja logidega kaustAvage avalik väljalasete leht brauseris
@@ -135,7 +133,6 @@
Kustutage kettale tõstetud kaadrid ja vahemällu salvestatud pisipildid; küsitakse eelnevalt kinnitustSelle arvuti andmebaas, sätted, logid ja vahemäludServer, millega Titano käivitumisel ühendub; muutmine logib välja · Enter rakendab, Esc taastab
- Pakkige logid ja keskkonnaaruanne ZIP-faili teie valitud kaustaSalvestage kõik sätted JSON-failina, ilma seansiloataIga kaadri failinimi, näiteks {date}_{time}_{n:0000}; laiend lisatakse · Enter rakendab, Esc taastabArhiivi kaustad, näiteks {year}/{date} {camera}; kaldkriips alustab alamkausta · Enter rakendab, Esc taastab
diff --git a/i18n/fi/Tooltips.fi.resx b/i18n/fi/Tooltips.fi.resx
index 709ea9de..f76e3842 100644
--- a/i18n/fi/Tooltips.fi.resx
+++ b/i18n/fi/Tooltips.fi.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Kysy julkisten julkaisujen sivulta, onko uudempaa versiota · muutama sekunti
- Pakkaa lokit ja ympäristöraportti ZIP-tiedostoon valitsemaasi kansioon; asetuksia ja salasanoja ei sisällytetä
- Avaa julkaisusivu selaimessaAvaa lisenssi selaimessaAvaa kansio, jossa ovat tietokanta, asetukset ja lokitAvaa julkisten julkaisujen sivu selaimessa
@@ -135,7 +133,6 @@
Poista levylle siirretyt kuvat ja välimuistissa olevat pikkukuvat; kysyy ensinTämän tietokoneen tietokanta, asetukset, lokit ja välimuistitPalvelin, johon Titano yhdistää käynnistyessään; vaihtaminen kirjaa ulos · Enter ottaa käyttöön, Esc palauttaa
- Pakkaa lokit ja ympäristöraportti ZIP-tiedostoon valitsemaasi kansioonTallenna kaikki asetukset JSON-muodossa ilman istuntotunnustaKunkin kuvan tiedostonimi, esimerkiksi {date}_{time}_{n:0000}; tiedostotunniste lisätään · Enter ottaa käyttöön, Esc palauttaaArkiston kansiot, esimerkiksi {year}/{date} {camera}; kauttaviiva aloittaa alikansion · Enter ottaa käyttöön, Esc palauttaa
diff --git a/i18n/fr/Tooltips.fr.resx b/i18n/fr/Tooltips.fr.resx
index 7b8a4b75..461f6ee1 100644
--- a/i18n/fr/Tooltips.fr.resx
+++ b/i18n/fr/Tooltips.fr.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Interroger la page publique des versions pour trouver une version plus récente · quelques secondes
- Compresser les journaux et un rapport d'environnement dans un dossier de votre choix ; les paramètres et les mots de passe ne sont pas inclus
- Ouvrir la page de la version dans le navigateurOuvrir la licence dans le navigateurOuvrir le dossier contenant la base de données, les paramètres et les journauxOuvrir la page publique des versions dans le navigateur
@@ -135,7 +133,6 @@
Supprimer les images en débordement et les miniatures en cache ; demande confirmationBase de données, paramètres, journaux et caches de ce PCServeur auquel Titano se connecte au démarrage ; le modifier ferme la session · Enter pour appliquer, Esc pour rétablir
- Compresser les journaux et un rapport d'environnement dans un dossier de votre choixEnregistrer tous les paramètres au format JSON, sans le jeton de sessionNom de fichier de chaque image, par exemple {date}_{time}_{n:0000} ; l'extension est ajoutée · Enter pour appliquer, Esc pour rétablirDossiers de l'archive, par exemple {year}/{date} {camera} ; une barre oblique crée un sous-dossier · Enter pour appliquer, Esc pour rétablir
diff --git a/i18n/he/Tooltips.he.resx b/i18n/he/Tooltips.he.resx
index aa81c258..4e9de151 100644
--- a/i18n/he/Tooltips.he.resx
+++ b/i18n/he/Tooltips.he.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089בדיקה בדף הגרסאות הציבורי אם יש גרסה חדשה יותר · כמה שניות
- דחיסת היומנים ודוח סביבה לקובץ ZIP בתיקייה לבחירתך; הגדרות וסיסמאות אינן נכללות
- פתיחת דף הגרסה בדפדפןפתיחת הרישיון בדפדפןפתיחת התיקייה עם מסד הנתונים, ההגדרות והיומניםפתיחת דף הגרסאות הציבורי בדפדפן
@@ -137,7 +135,6 @@
מחיקת פריימים שנשפכו לדיסק ותמונות ממוזערות שבמטמון; מבקש אישור תחילהמסד הנתונים, ההגדרות, היומנים והמטמונים של המחשב הזההשרת ש-Titano מתחבר אליו בהפעלה; שינוי שלו מוציא מהחשבון · Enter מחיל, Esc מבטל
- דחיסת היומנים ודוח סביבה לקובץ ZIP בתיקייה לבחירתךשמירת כל ההגדרות כ-JSON, ללא אסימון הסשןשם הקובץ של כל פריים, לדוגמה {date}_{time}_{n:0000}; הסיומת מתווספת · Enter מחיל, Esc מבטלתיקיות הארכיון, לדוגמה {year}/{date} {camera}; לוכסן פותח תת-תיקייה · Enter מחיל, Esc מבטל
diff --git a/i18n/hi/Tooltips.hi.resx b/i18n/hi/Tooltips.hi.resx
index 427932cd..b00abe61 100644
--- a/i18n/hi/Tooltips.hi.resx
+++ b/i18n/hi/Tooltips.hi.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089नए संस्करण के लिए सार्वजनिक रिलीज़ पेज से पूछें · कुछ सेकंड
- लॉग और परिवेश रिपोर्ट को आपके चुने फ़ोल्डर में ज़िप करें; सेटिंग्स और पासवर्ड शामिल नहीं होते
- रिलीज़ पेज ब्राउज़र में खोलेंलाइसेंस ब्राउज़र में खोलेंडेटाबेस, सेटिंग्स और लॉग वाला फ़ोल्डर खोलेंसार्वजनिक रिलीज़ पेज ब्राउज़र में खोलें
@@ -135,7 +133,6 @@
डिस्क पर उतारे गए फ़्रेम और कैश किए गए थंबनेल हटाएँ; पहले पूछता हैइस PC का डेटाबेस, सेटिंग्स, लॉग और कैशवह सर्वर जिससे Titano शुरू होने पर कनेक्ट होता है; इसे बदलने पर साइन आउट हो जाता है · Enter से लागू, Esc से पूर्ववत
- लॉग और परिवेश रिपोर्ट को आपके चुने फ़ोल्डर में ज़िप करेंसत्र टोकन के बिना सभी सेटिंग्स JSON के रूप में सहेजेंहर फ़्रेम का फ़ाइल नाम, उदाहरण के लिए {date}_{time}_{n:0000}; एक्सटेंशन जोड़ दिया जाता है · Enter से लागू, Esc से पूर्ववतसंग्रह फ़ोल्डर, उदाहरण के लिए {year}/{date} {camera}; स्लैश से उप-फ़ोल्डर शुरू होता है · Enter से लागू, Esc से पूर्ववत
diff --git a/i18n/it/About.it.resx b/i18n/it/About.it.resx
index 2f871e07..c290af5d 100644
--- a/i18n/it/About.it.resx
+++ b/i18n/it/About.it.resx
@@ -19,6 +19,7 @@
NessunoTraduzioneTitano {0} disponibile
+ AnnullaCerca aggiornamentiVerifica in corso…Aggiornato
@@ -28,6 +29,6 @@
Verifica non riuscitaDownload non verificatoTitano {0} scaricato
- Mostra installer
+ Mostra fileAggiornamenti
diff --git a/i18n/it/Tooltips.it.resx b/i18n/it/Tooltips.it.resx
index 313730a4..4246176c 100644
--- a/i18n/it/Tooltips.it.resx
+++ b/i18n/it/Tooltips.it.resx
@@ -4,13 +4,17 @@
2.0System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
+ Interrompe il download; Scarica lo riprende in seguito dal punto in cui si è fermatoChiede alla pagina pubblica delle versioni se ne esiste una più recente · pochi secondiComprime log, rapporto su sistema e codec, impostazioni e attività fallite di recente in una cartella a tua scelta; password, token e foto restano fuori
- Scarica l'installer, lo confronta con l'elenco SHA-256 della versione e lo mostra in Esplora file · decine di MB
+ Scarica l'installer, lo confronta con l'elenco SHA-256 della versione e lo mostra in Esplora file · {0}
+ Apre la pagina di questa versione nel browser
+ Scarica lo zip portatile, lo confronta con l'elenco SHA-256 della versione e lo mostra in Esplora file · {0}Apre la licenza nel browserApri la cartella con database, impostazioni e logApri la pagina pubblica delle versioni nel browserTutte le lingue tranne l'inglese sono tradotte automaticamente; proponi una formulazione migliore nel tracker pubblico
+ Mostra in Esplora file lo zip verificato; chiudi Titano ed estrailo sopra questa cartella per aggiornare. La cartella dei dati resta invariataMostra in Esplora file l'installer verificato; chiudi Titano ed eseguilo per aggiornare. Archivio e impostazioni restano invariatiTitano non usa codice di terze parti: tutto ciò che va oltre .NET e Windows è scritto internamenteChiudi
diff --git a/i18n/ja/Tooltips.ja.resx b/i18n/ja/Tooltips.ja.resx
index 3a191e64..a02cdba6 100644
--- a/i18n/ja/Tooltips.ja.resx
+++ b/i18n/ja/Tooltips.ja.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089公開リリースページで新しいバージョンを確認します · 数秒
- ログと環境レポートを ZIP にまとめ、選択したフォルダーに保存します。設定とパスワードは含まれません。
- ブラウザーでリリースページを開きます。ブラウザーでライセンスを開きます。データベース、設定、ログがあるフォルダーを開きます。ブラウザーで公開リリースページを開きます。
@@ -135,7 +133,6 @@
一時退避したフレームとキャッシュされたサムネイルを削除します。実行前に確認します。この PC のデータベース、設定、ログ、キャッシュTitano が起動時に接続するサーバーです。変更するとサインアウトします · Enter で適用、Esc で元に戻す
- ログと環境レポートを ZIP にまとめ、選択したフォルダーに保存します。セッショントークンを除くすべての設定を JSON として保存します。各フレームのファイル名です。例: {date}_{time}_{n:0000}。拡張子は自動で付きます · Enter で適用、Esc で元に戻すアーカイブのフォルダーです。例: {year}/{date} {camera}。スラッシュでサブフォルダーになります · Enter で適用、Esc で元に戻す
diff --git a/i18n/ko/Tooltips.ko.resx b/i18n/ko/Tooltips.ko.resx
index 70eb6ca7..92eaf41e 100644
--- a/i18n/ko/Tooltips.ko.resx
+++ b/i18n/ko/Tooltips.ko.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089공개 릴리스 페이지에서 새 버전을 확인합니다 · 몇 초 소요
- 로그와 환경 보고서를 원하는 폴더에 ZIP으로 압축합니다. 설정과 암호는 포함되지 않습니다.
- 브라우저에서 릴리스 페이지를 엽니다.브라우저에서 라이선스를 엽니다.데이터베이스, 설정, 로그가 있는 폴더를 엽니다.브라우저에서 공개 릴리스 페이지를 엽니다.
@@ -135,7 +133,6 @@
디스크로 옮겨진 프레임과 캐시된 썸네일을 삭제합니다. 먼저 확인을 요청합니다.이 PC의 데이터베이스, 설정, 로그 및 캐시Titano가 시작할 때 연결하는 서버입니다. 변경하면 로그아웃됩니다 · Enter로 적용, Esc로 되돌리기
- 로그와 환경 보고서를 원하는 폴더에 ZIP으로 압축합니다.세션 토큰을 제외한 모든 설정을 JSON으로 저장합니다.각 프레임의 파일 이름입니다. 예: {date}_{time}_{n:0000}. 확장자는 자동으로 추가됩니다 · Enter로 적용, Esc로 되돌리기아카이브 폴더입니다. 예: {year}/{date} {camera}. 슬래시로 하위 폴더를 만듭니다 · Enter로 적용, Esc로 되돌리기
diff --git a/i18n/nb/Tooltips.nb.resx b/i18n/nb/Tooltips.nb.resx
index 4c6b06fb..6c08eeb9 100644
--- a/i18n/nb/Tooltips.nb.resx
+++ b/i18n/nb/Tooltips.nb.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Spør den offentlige utgivelsessiden om en nyere versjon · noen sekunder
- Pakk loggene og en miljørapport som ZIP i en mappe du velger; innstillinger og passord er ikke med
- Åpne utgivelsessiden i nettleserenÅpne lisensen i nettleserenÅpne mappen med database, innstillinger og loggerÅpne den offentlige utgivelsessiden i nettleseren
@@ -135,7 +133,6 @@
Slett bilder som er flyttet ut av minnet, og hurtigbufrede miniatyrbilder; spør førstDatabase, innstillinger, logger og hurtigbuffere for denne PC-enServeren Titano kobler til ved oppstart; hvis du endrer den, logges du av · Enter tar i bruk, Esc angrer
- Pakk loggene og en miljørapport som ZIP i en mappe du velgerLagre alle innstillinger som JSON, uten økttokenetFilnavnet på hvert bilde, for eksempel {date}_{time}_{n:0000}; filtypen legges til · Enter tar i bruk, Esc angrerArkivmapper, for eksempel {year}/{date} {camera}; en skråstrek starter en undermappe · Enter tar i bruk, Esc angrer
diff --git a/i18n/nl/Tooltips.nl.resx b/i18n/nl/Tooltips.nl.resx
index 7dae1c26..0cfbd9f8 100644
--- a/i18n/nl/Tooltips.nl.resx
+++ b/i18n/nl/Tooltips.nl.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Vraag de openbare releasepagina naar een nieuwere versie · enkele seconden
- Sla de logboeken en een omgevingsrapport als ZIP op in een map naar keuze; instellingen en wachtwoorden worden niet meegenomen
- Open de releasepagina in de browserOpen de licentie in de browserOpen de map met database, instellingen en logboekenOpen de openbare releasepagina in de browser
@@ -135,7 +133,6 @@
Verwijder tijdelijk weggeschreven frames en miniaturen in de cache; vraagt eerst om bevestigingDatabase, instellingen, logboeken en caches van deze pcServer waarmee Titano bij het starten verbinding maakt; wijzigen meldt je af · Enter past toe, Esc maakt ongedaan
- Sla de logboeken en een omgevingsrapport als ZIP op in een map naar keuzeSla alle instellingen op als JSON, zonder het sessietokenBestandsnaam van elk frame, bijvoorbeeld {date}_{time}_{n:0000}; de extensie wordt toegevoegd · Enter past toe, Esc maakt ongedaanArchiefmappen, bijvoorbeeld {year}/{date} {camera}; een slash begint een submap · Enter past toe, Esc maakt ongedaan
diff --git a/i18n/pl/Tooltips.pl.resx b/i18n/pl/Tooltips.pl.resx
index 23a8dd60..41cb0bb3 100644
--- a/i18n/pl/Tooltips.pl.resx
+++ b/i18n/pl/Tooltips.pl.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Sprawdź na publicznej stronie wydań, czy jest nowsza wersja · kilka sekund
- Spakuj dzienniki i raport o środowisku do wybranego folderu; ustawienia i hasła nie są dołączane
- Otwórz stronę wydania w przeglądarceOtwórz licencję w przeglądarceOtwórz folder z bazą danych, ustawieniami i dziennikamiOtwórz publiczną stronę wydań w przeglądarce
@@ -139,7 +137,6 @@
Usuń klatki przeniesione na dysk i miniatury z pamięci podręcznej; najpierw pyta o potwierdzenieBaza danych, ustawienia, dzienniki i pamięć podręczna tego komputeraSerwer, z którym Titano łączy się przy uruchomieniu; jego zmiana powoduje wylogowanie · Enter stosuje, Esc przywraca
- Spakuj dzienniki i raport o środowisku do wybranego folderuZapisz wszystkie ustawienia jako JSON, bez tokenu sesjiNazwa pliku każdej klatki, np. {date}_{time}_{n:0000}; rozszerzenie jest dodawane automatycznie · Enter stosuje, Esc przywracaFoldery archiwum, np. {year}/{date} {camera}; ukośnik tworzy podfolder · Enter stosuje, Esc przywraca
diff --git a/i18n/pt-BR/Tooltips.pt-BR.resx b/i18n/pt-BR/Tooltips.pt-BR.resx
index 888c910d..37d48ccb 100644
--- a/i18n/pt-BR/Tooltips.pt-BR.resx
+++ b/i18n/pt-BR/Tooltips.pt-BR.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Consulta a página pública de versões em busca de uma versão mais recente · alguns segundos
- Compacta os logs e um relatório do ambiente em uma pasta de sua escolha; configurações e senhas não são incluídas
- Abre a página da versão no navegadorAbre a licença no navegadorAbre a pasta com banco de dados, configurações e logsAbre a página pública de versões no navegador
@@ -135,7 +133,6 @@
Exclui os quadros temporários e as miniaturas em cache; pede confirmação antesBanco de dados, configurações, logs e caches deste PCServidor ao qual o Titano se conecta ao iniciar; alterá-lo encerra a sessão · Enter aplica, Esc reverte
- Compacta os logs e um relatório do ambiente em uma pasta de sua escolhaSalva todas as configurações como JSON, sem o token de sessãoNome do arquivo de cada quadro, por exemplo {date}_{time}_{n:0000}; a extensão é adicionada · Enter aplica, Esc revertePastas do acervo, por exemplo {year}/{date} {camera}; uma barra inicia uma subpasta · Enter aplica, Esc reverte
diff --git a/i18n/pt-PT/Tooltips.pt-PT.resx b/i18n/pt-PT/Tooltips.pt-PT.resx
index d68bee32..546513b1 100644
--- a/i18n/pt-PT/Tooltips.pt-PT.resx
+++ b/i18n/pt-PT/Tooltips.pt-PT.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Consultar a página pública de versões à procura de uma versão mais recente · alguns segundos
- Comprimir os registos e um relatório do ambiente num ZIP, numa pasta à sua escolha; as definições e as palavras-passe não são incluídas
- Abrir a página da versão no browserAbrir a licença no browserAbrir a pasta com a base de dados, as definições e os registosAbrir a página pública de versões no browser
@@ -135,7 +133,6 @@
Eliminar os fotogramas em cache no disco e as miniaturas em cache; pede confirmação primeiroBase de dados, definições, registos e caches deste PCServidor a que o Titano se liga ao iniciar; alterá-lo termina a sessão · Enter aplica, Esc reverte
- Comprimir os registos e um relatório do ambiente num ZIP, numa pasta à sua escolhaGuardar todas as definições como JSON, sem o token de sessãoNome de ficheiro de cada fotograma, por exemplo {date}_{time}_{n:0000}; a extensão é acrescentada · Enter aplica, Esc revertePastas do arquivo, por exemplo {year}/{date} {camera}; uma barra inicia uma subpasta · Enter aplica, Esc reverte
diff --git a/i18n/ru/Tooltips.ru.resx b/i18n/ru/Tooltips.ru.resx
index 56ff469f..6ea436af 100644
--- a/i18n/ru/Tooltips.ru.resx
+++ b/i18n/ru/Tooltips.ru.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Проверить наличие новой версии на общедоступной странице выпусков · несколько секунд
- Упаковать журналы и отчёт о среде в ZIP в выбранной папке; параметры и пароли не включаются
- Открыть страницу выпуска в браузереОткрыть лицензию в браузереОткрыть папку с базой данных, параметрами и журналамиОткрыть общедоступную страницу выпусков в браузере
@@ -139,7 +137,6 @@
Удалить выгруженные кадры и кэшированные эскизы; сначала будет запрошено подтверждениеБаза данных, параметры, журналы и кэши этого ПКСервер, к которому Titano подключается при запуске; при его смене выполняется выход · Enter — применить, Esc — отменить
- Упаковать журналы и отчёт о среде в ZIP в выбранной папкеСохранить все параметры в JSON, без токена сеансаИмя файла каждого кадра, например {date}_{time}_{n:0000}; расширение добавляется автоматически · Enter — применить, Esc — отменитьПапки архива, например {year}/{date} {camera}; косая черта начинает вложенную папку · Enter — применить, Esc — отменить
diff --git a/i18n/sv/Tooltips.sv.resx b/i18n/sv/Tooltips.sv.resx
index bb863c32..6d070a49 100644
--- a/i18n/sv/Tooltips.sv.resx
+++ b/i18n/sv/Tooltips.sv.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Fråga den offentliga versionssidan efter en nyare version · några sekunder
- Packa loggarna och en miljörapport som ZIP i en mapp du väljer; inställningar och lösenord ingår inte
- Öppna versionssidan i webbläsarenÖppna licensen i webbläsarenÖppna mappen med databas, inställningar och loggarÖppna den offentliga versionssidan i webbläsaren
@@ -135,7 +133,6 @@
Radera bildrutor i diskcachen och cachade miniatyrer; frågar förstDatabas, inställningar, loggar och cachar för den här datornServer som Titano ansluter till vid start; om du ändrar den loggas du ut · Enter tillämpar, Esc återställer
- Packa loggarna och en miljörapport som ZIP i en mapp du väljerSpara alla inställningar som JSON, utan sessionstokenFilnamn för varje bildruta, till exempel {date}_{time}_{n:0000}; filändelsen läggs till · Enter tillämpar, Esc återställerArkivmappar, till exempel {year}/{date} {camera}; ett snedstreck startar en undermapp · Enter tillämpar, Esc återställer
diff --git a/i18n/tr/Tooltips.tr.resx b/i18n/tr/Tooltips.tr.resx
index 542a2c4f..27ad42b9 100644
--- a/i18n/tr/Tooltips.tr.resx
+++ b/i18n/tr/Tooltips.tr.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Herkese açık sürümler sayfasında daha yeni bir sürüm olup olmadığını denetler · birkaç saniye
- Günlükleri ve bir ortam raporunu seçtiğiniz klasöre ZIP olarak paketler; ayarlar ve parolalar dahil edilmez
- Sürüm sayfasını tarayıcıda açarLisansı tarayıcıda açarVeritabanı, ayarlar ve günlüklerin bulunduğu klasörü açarHerkese açık sürümler sayfasını tarayıcıda açar
@@ -135,7 +133,6 @@
Diske taşan kareleri ve önbellekteki küçük resimleri siler; önce sorarBu bilgisayarın veritabanı, ayarları, günlükleri ve önbellekleriTitano'nun başlangıçta bağlandığı sunucu; değiştirmek oturumu kapatır · Enter uygular, Esc geri alır
- Günlükleri ve bir ortam raporunu seçtiğiniz klasöre ZIP olarak paketlerTüm ayarları oturum belirteci olmadan JSON olarak kaydederHer karenin dosya adı, örneğin {date}_{time}_{n:0000}; uzantı otomatik eklenir · Enter uygular, Esc geri alırArşiv klasörleri, örneğin {year}/{date} {camera}; eğik çizgi bir alt klasör başlatır · Enter uygular, Esc geri alır
diff --git a/i18n/uk/Tooltips.uk.resx b/i18n/uk/Tooltips.uk.resx
index dd357d64..dab59177 100644
--- a/i18n/uk/Tooltips.uk.resx
+++ b/i18n/uk/Tooltips.uk.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089Перевірити на публічній сторінці випусків, чи є новіша версія · кілька секунд
- Запакувати журнали та звіт про середовище в ZIP у вибрану вами папку; налаштування й паролі не додаються
- Відкрити сторінку випуску в браузеріВідкрити ліцензію в браузеріВідкрити папку з базою даних, налаштуваннями та журналамиВідкрити публічну сторінку випусків у браузері
@@ -139,7 +137,6 @@
Видалити скинуті на диск кадри та кешовані мініатюри; спершу з’явиться запитБаза даних, налаштування, журнали й кеші цього ПКСервер, до якого Titano підключається під час запуску; у разі зміни виконується вихід · Enter застосовує, Esc скасовує
- Запакувати журнали та звіт про середовище в ZIP у вибрану вами папкуЗберегти всі налаштування як JSON, без токена сеансуІм’я файлу кожного кадру, наприклад {date}_{time}_{n:0000}; розширення додається автоматично · Enter застосовує, Esc скасовуєПапки архіву, наприклад {year}/{date} {camera}; скісна риска починає вкладену папку · Enter застосовує, Esc скасовує
diff --git a/i18n/zh-Hans/Tooltips.zh-Hans.resx b/i18n/zh-Hans/Tooltips.zh-Hans.resx
index a372a266..ceb20207 100644
--- a/i18n/zh-Hans/Tooltips.zh-Hans.resx
+++ b/i18n/zh-Hans/Tooltips.zh-Hans.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089向公开发布页面查询是否有新版本 · 需要几秒钟
- 将日志和环境报告打包为 ZIP,保存到你选择的文件夹;不包含设置和密码
- 在浏览器中打开发布页面在浏览器中打开许可证打开包含数据库、设置和日志的文件夹在浏览器中打开公开发布页面
@@ -135,7 +133,6 @@
删除溢出的帧和缓存的缩略图;会先询问此电脑的数据库、设置、日志和缓存Titano 启动时连接的服务器;更改后将退出登录 · Enter 应用,Esc 还原
- 将日志和环境报告打包为 ZIP,保存到你选择的文件夹将所有设置保存为 JSON,不含会话令牌每一帧的文件名,例如 {date}_{time}_{n:0000};扩展名会自动添加 · Enter 应用,Esc 还原档案库文件夹,例如 {year}/{date} {camera};斜杠表示开始一个子文件夹 · Enter 应用,Esc 还原
diff --git a/i18n/zh-Hant/Tooltips.zh-Hant.resx b/i18n/zh-Hant/Tooltips.zh-Hant.resx
index 0dd71d15..f451a5de 100644
--- a/i18n/zh-Hant/Tooltips.zh-Hant.resx
+++ b/i18n/zh-Hant/Tooltips.zh-Hant.resx
@@ -5,8 +5,6 @@
System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089向公開發行頁面查詢是否有較新版本 · 需要幾秒鐘
- 將記錄與環境報告壓縮到您選擇的資料夾;不包含設定與密碼
- 在瀏覽器中開啟發行頁面在瀏覽器中開啟授權條款開啟存放資料庫、設定與記錄的資料夾在瀏覽器中開啟公開發行頁面
@@ -135,7 +133,6 @@
刪除溢出的影格與快取的縮圖;會先詢問此電腦的資料庫、設定、記錄與快取Titano 啟動時連線的伺服器;變更後會登出 · Enter 套用,Esc 還原
- 將記錄與環境報告壓縮到您選擇的資料夾將所有設定儲存為 JSON,不含工作階段權杖每個影格的檔名,例如 {date}_{time}_{n:0000};副檔名會自動加上 · Enter 套用,Esc 還原典藏庫資料夾,例如 {year}/{date} {camera};斜線表示開始一個子資料夾 · Enter 套用,Esc 還原
diff --git a/src/Titano.App/About/UpdateDownload.cs b/src/Titano.App/About/UpdateDownload.cs
index 7fade974..0797b554 100644
--- a/src/Titano.App/About/UpdateDownload.cs
+++ b/src/Titano.App/About/UpdateDownload.cs
@@ -1,5 +1,7 @@
using System.Buffers;
+using System.Globalization;
using System.IO;
+using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Security.Cryptography;
@@ -10,31 +12,47 @@ namespace Titano.App.About;
public sealed class UpdateVerificationException(string message) : Exception(message);
///
-/// "Download" of the update notice (BRIEF §18, P1): fetches the desktop setup of the latest release into a temporary
-/// folder and keeps it only when its SHA-256 equals the line for it in the release's SHA256SUMS. BRIEF §8.6 does
-/// not list starting an installer among the OS actions Titano may perform, so callers show the verified file in
-/// Explorer and the user runs it.
+/// "Download" of the update notice (BRIEF §18, P1): fetches the package of the latest release that upgrades this copy
+/// (the setup, or the portable zip for a portable copy) into a temporary folder and keeps it only when its SHA-256
+/// equals the line for it in the release's SHA256SUMS. BRIEF §8.6 does not list starting an installer among the
+/// OS actions Titano may perform, so callers show the verified file in Explorer and the user runs or unpacks it. An
+/// interrupted download resumes from its partial file; a transfer that stalls fails after
+/// instead of hanging.
///
public static class UpdateDownload
{
public const string ChecksumsName = "SHA256SUMS";
+
+ /// A transfer that delivers no byte for this long fails (and can be resumed).
+ public static readonly TimeSpan IdleTimeout = TimeSpan.FromSeconds(60);
+
+ private const string PartSuffix = ".part";
private const int MaxChecksumsBytes = 64 * 1024;
private static readonly SearchValues Hex = SearchValues.Create("0123456789abcdefABCDEF");
- /// The desktop setup ("Titano-Setup-1.2.3.exe"), not the Uploader's.
- public static ReleaseAsset? Installer(ReleaseInfo release) =>
- release.Assets.FirstOrDefault(a => a.Name.StartsWith("Titano-Setup-", StringComparison.OrdinalIgnoreCase)
- && a.Name.EndsWith(".exe", StringComparison.OrdinalIgnoreCase)
- && a.Name == Path.GetFileName(a.Name));
+ ///
+ /// The file that upgrades this copy: the desktop setup ("Titano-Setup-1.2.3.exe", not the Uploader's) or, for a
+ /// portable copy, the portable zip ("Titano-win-x64-portable-1.2.3.zip"); null when the release has none.
+ ///
+ public static ReleaseAsset? Package(ReleaseInfo release, bool portable)
+ {
+ var (prefix, extension) = portable ? ("Titano-win-x64-portable-", ".zip") : ("Titano-Setup-", ".exe");
+ return release.Assets.FirstOrDefault(a => a.Name.StartsWith(prefix, StringComparison.OrdinalIgnoreCase)
+ && a.Name.EndsWith(extension, StringComparison.OrdinalIgnoreCase)
+ && a.Name == Path.GetFileName(a.Name));
+ }
public static ReleaseAsset? Checksums(ReleaseInfo release) => release.Assets.FirstOrDefault(a => a.Name == ChecksumsName);
- /// The release carries both a setup and SHA256SUMS; otherwise only its page can be opened.
- public static bool CanDownload(ReleaseInfo release) => Installer(release) is not null && Checksums(release) is not null;
+ /// The release carries both the package for this copy and SHA256SUMS; otherwise only its page can be opened.
+ public static bool CanDownload(ReleaseInfo release, bool portable) => Package(release, portable) is not null && Checksums(release) is not null;
- /// %TEMP%\Titano\updates\<tag> under .
- public static string Folder(string tempRoot, ReleaseInfo release) =>
- Path.Combine(tempRoot, "Titano", "updates", string.Concat(release.Tag.Select(c => char.IsAsciiLetterOrDigit(c) || c is '.' or '-' ? c : '_')));
+ /// %TEMP%\Titano\updates: one folder per release below it, all owned by Titano.
+ public static string Root(string tempPath) => Path.Combine(tempPath, "Titano", "updates");
+
+ /// The folder of one release below , named after its tag.
+ public static string Folder(string root, ReleaseInfo release) =>
+ Path.Combine(root, string.Concat(release.Tag.Select(c => char.IsAsciiLetterOrDigit(c) || c is '.' or '-' ? c : '_')));
///
/// File name → lower-case hex SHA-256 from sha256sum output (hash name or hash *name); lines
@@ -55,80 +73,134 @@ public static class UpdateDownload
}
///
- /// Downloads the setup of into , verifies it against
- /// SHA256SUMS and returns its path. A verified copy already there is reused; a partial or mismatching
- /// download is deleted.
+ /// Downloads the of for this copy into its under
+ /// , verifies it against SHA256SUMS and returns its path. A verified copy already there
+ /// is reused; an interrupted or cancelled transfer keeps its partial file for the next attempt; bytes that do not
+ /// verify are deleted. After a verified download the folders of other releases under are removed.
///
/// The release cannot be verified or the bytes do not match.
/// A request failed.
- public static async Task DownloadAsync(HttpClient http, ReleaseInfo release, string folder, string userAgentVersion, IProgress? progress,
- CancellationToken ct)
+ /// No byte arrived for .
+ /// The transfer ended early or the file could not be written.
+ public static async Task DownloadAsync(HttpClient http, ReleaseInfo release, bool portable, string root, string userAgentVersion,
+ IProgress? progress, TimeSpan idleTimeout, CancellationToken ct)
{
- var installer = Installer(release) ?? throw new UpdateVerificationException($"Release {release.Tag} has no Titano setup.");
+ var package = Package(release, portable)
+ ?? throw new UpdateVerificationException($"Release {release.Tag} has no {(portable ? "portable zip" : "Titano setup")}.");
var checksums = Checksums(release) ?? throw new UpdateVerificationException($"Release {release.Tag} has no {ChecksumsName}.");
- var expected = ParseChecksums(await ReadChecksumsAsync(http, checksums, userAgentVersion, ct).ConfigureAwait(false)).GetValueOrDefault(installer.Name)
- ?? throw new UpdateVerificationException($"{ChecksumsName} of {release.Tag} has no line for {installer.Name}.");
+ var text = await WhileReceivingAsync(idle => ReadChecksumsAsync(http, checksums, userAgentVersion, idle.Token), idleTimeout, ct).ConfigureAwait(false);
+ var expected = ParseChecksums(text).GetValueOrDefault(package.Name)
+ ?? throw new UpdateVerificationException($"{ChecksumsName} of {release.Tag} has no line for {package.Name}.");
+ var folder = Folder(root, release);
Directory.CreateDirectory(folder);
- var target = Path.Combine(folder, installer.Name);
+ var target = Path.Combine(folder, package.Name);
if (File.Exists(target) && await HashFileAsync(target, ct).ConfigureAwait(false) == expected)
{
progress?.Report(1);
return target;
}
- var part = target + ".part";
- try
- {
- var actual = await DownloadToAsync(http, installer, part, userAgentVersion, progress, ct).ConfigureAwait(false);
- if (actual != expected) throw new UpdateVerificationException($"{installer.Name}: SHA-256 {actual} does not match {expected} in {ChecksumsName}.");
- File.Move(part, target, overwrite: true);
- return target;
- }
- finally
+ var part = target + PartSuffix;
+ var actual = await WhileReceivingAsync(idle => DownloadToAsync(http, package, part, userAgentVersion, progress, idle, idleTimeout), idleTimeout, ct)
+ .ConfigureAwait(false);
+ if (actual != expected)
{
DeleteQuietly(part);
+ throw new UpdateVerificationException($"{package.Name}: SHA-256 {actual} does not match {expected} in {ChecksumsName}.");
+ }
+ File.Move(part, target, overwrite: true);
+ RemoveOtherReleases(root, folder);
+ return target;
+ }
+
+ ///
+ /// Runs one network phase under a token that fires when nothing arrives for (the phase
+ /// re-arms it on every read) and reports that as a ; the caller's cancellation stays a cancellation.
+ ///
+ private static async Task WhileReceivingAsync(Func> phase, TimeSpan idleTimeout, CancellationToken ct)
+ {
+ using var idle = CancellationTokenSource.CreateLinkedTokenSource(ct);
+ idle.CancelAfter(idleTimeout);
+ try
+ {
+ return await phase(idle).ConfigureAwait(false);
+ }
+ catch (OperationCanceledException) when (idle.IsCancellationRequested && !ct.IsCancellationRequested)
+ {
+ throw new TimeoutException(string.Create(CultureInfo.InvariantCulture, $"No data received for {idleTimeout.TotalSeconds:0} s."));
}
}
private static async Task ReadChecksumsAsync(HttpClient http, ReleaseAsset asset, string userAgentVersion, CancellationToken ct)
{
- using var response = await SendAsync(http, asset, userAgentVersion, ct).ConfigureAwait(false);
+ using var response = await SendAsync(http, asset, userAgentVersion, 0, ct).ConfigureAwait(false);
if (response.Content.Headers.ContentLength > MaxChecksumsBytes) throw new UpdateVerificationException($"{ChecksumsName} is too large.");
var bytes = await response.Content.ReadAsByteArrayAsync(ct).ConfigureAwait(false);
if (bytes.Length > MaxChecksumsBytes) throw new UpdateVerificationException($"{ChecksumsName} is too large.");
return System.Text.Encoding.UTF8.GetString(bytes);
}
- /// Streams the asset into , hashing as it goes; refuses more bytes than the release announced.
+ ///
+ /// Streams the asset into , continuing an existing partial file when the server honours the
+ /// range request, and returns the SHA-256 of the whole file. Refuses more bytes than the release announced and
+ /// fails with an (partial file kept) when the transfer ends before the announced size.
+ ///
private static async Task DownloadToAsync(HttpClient http, ReleaseAsset asset, string path, string userAgentVersion, IProgress? progress,
- CancellationToken ct)
+ CancellationTokenSource idle, TimeSpan idleTimeout)
{
- using var response = await SendAsync(http, asset, userAgentVersion, ct).ConfigureAwait(false);
- var length = asset.Size > 0 ? asset.Size : response.Content.Headers.ContentLength ?? -1;
- await using var input = await response.Content.ReadAsStreamAsync(ct).ConfigureAwait(false);
- await using var output = new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None, 1 << 16, FileOptions.Asynchronous);
+ var ct = idle.Token;
using var hash = IncrementalHash.CreateHash(HashAlgorithmName.SHA256);
var buffer = new byte[1 << 16];
+
+ // Resume only with a known size: a partial file of an unknown total cannot be checked against it.
+ var offset = File.Exists(path) ? new FileInfo(path).Length : 0;
+ if (asset.Size <= 0 || offset > asset.Size) offset = 0;
+ if (offset > 0 && offset == asset.Size) return await HashFileAsync(path, ct).ConfigureAwait(false);
+
+ using var response = await SendAsync(http, asset, userAgentVersion, offset, ct).ConfigureAwait(false);
+ var resumed = offset > 0 && response.StatusCode == HttpStatusCode.PartialContent && response.Content.Headers.ContentRange?.From == offset;
+ await using var output = new FileStream(path, resumed ? FileMode.Open : FileMode.Create, FileAccess.ReadWrite, FileShare.None, 1 << 16, FileOptions.Asynchronous);
long total = 0;
+ if (resumed)
+ {
+ int kept;
+ while (total < offset && (kept = await output.ReadAsync(buffer.AsMemory(0, (int)Math.Min(buffer.Length, offset - total)), ct).ConfigureAwait(false)) > 0)
+ {
+ hash.AppendData(buffer, 0, kept);
+ total += kept;
+ }
+ output.SetLength(total);
+ }
+
+ await using var input = await response.Content.ReadAsStreamAsync(ct).ConfigureAwait(false);
int read;
while ((read = await input.ReadAsync(buffer, ct).ConfigureAwait(false)) > 0)
{
+ idle.CancelAfter(idleTimeout);
total += read;
- if (asset.Size > 0 && total > asset.Size) throw new UpdateVerificationException($"{asset.Name} is larger than the release announced.");
+ if (asset.Size > 0 && total > asset.Size)
+ {
+ await output.DisposeAsync().ConfigureAwait(false);
+ DeleteQuietly(path);
+ throw new UpdateVerificationException($"{asset.Name} is larger than the release announced.");
+ }
hash.AppendData(buffer, 0, read);
await output.WriteAsync(buffer.AsMemory(0, read), ct).ConfigureAwait(false);
- if (length > 0) progress?.Report(Math.Min(1.0, (double)total / length));
+ if (asset.Size > 0) progress?.Report((double)total / asset.Size);
}
await output.FlushAsync(ct).ConfigureAwait(false);
+ if (asset.Size > 0 && total < asset.Size)
+ throw new IOException(string.Create(CultureInfo.InvariantCulture, $"{asset.Name}: the transfer ended after {total} of {asset.Size} bytes."));
return Convert.ToHexStringLower(hash.GetHashAndReset());
}
- private static async Task SendAsync(HttpClient http, ReleaseAsset asset, string userAgentVersion, CancellationToken ct)
+ private static async Task SendAsync(HttpClient http, ReleaseAsset asset, string userAgentVersion, long offset, CancellationToken ct)
{
using var request = new HttpRequestMessage(HttpMethod.Get, asset.DownloadUrl);
request.Headers.UserAgent.Add(new ProductInfoHeaderValue("Titano", userAgentVersion));
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/octet-stream"));
+ if (offset > 0) request.Headers.Range = new RangeHeaderValue(offset, null);
var response = await http.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, ct).ConfigureAwait(false);
try
{
@@ -142,18 +214,32 @@ public static class UpdateDownload
}
}
+ /// Drops the folders of other (older) releases: only the verified setup is worth keeping.
+ private static void RemoveOtherReleases(string root, string keep)
+ {
+ foreach (var folder in Directory.EnumerateDirectories(root))
+ {
+ if (string.Equals(Path.GetFullPath(folder), Path.GetFullPath(keep), StringComparison.OrdinalIgnoreCase)) continue;
+ try
+ {
+ Directory.Delete(folder, recursive: true);
+ }
+ catch (Exception ex) when (ex is IOException or UnauthorizedAccessException)
+ {
+ // A setup still open (running, scanned) stays until the next verified download.
+ }
+ }
+ }
+
private static void DeleteQuietly(string path)
{
try
{
File.Delete(path);
}
- catch (IOException)
- {
- // A scanner may hold the partial file; %TEMP% cleanup removes it later.
- }
- catch (UnauthorizedAccessException)
+ catch (Exception ex) when (ex is IOException or UnauthorizedAccessException)
{
+ // A scanner may hold the file; the next download overwrites it.
}
}
diff --git a/src/Titano.App/About/UpdateFlow.cs b/src/Titano.App/About/UpdateFlow.cs
new file mode 100644
index 00000000..e1f0c424
--- /dev/null
+++ b/src/Titano.App/About/UpdateFlow.cs
@@ -0,0 +1,177 @@
+using System.IO;
+using System.Net.Http;
+using Titano.Core.Diagnostics;
+using Titano.Ui.Mvvm;
+
+namespace Titano.App.About;
+
+/// Where the update notice stands.
+public enum UpdateState
+{
+ Unknown,
+ Checking,
+ UpToDate,
+ Available,
+ Failed,
+ Downloading,
+ Downloaded,
+ DownloadFailed,
+ NotVerified,
+}
+
+/// What needs from the application: the running version, the mode, the network and the shell.
+public sealed record UpdateHost(
+ Version Running,
+ bool IsCapture,
+ bool IsPortable,
+ Func> CheckAsync,
+ Func?, CancellationToken, Task> DownloadAsync,
+ Action OpenUrl,
+ Action Reveal);
+
+///
+/// The update notice of About and Settings › Updates (BRIEF §18): checks the latest release, downloads and verifies the
+/// package that upgrades this copy (: the setup, or the portable zip for a portable copy)
+/// and shows it in Explorer. Running it is left to the user because BRIEF §8.6 lets Titano only open links and show
+/// files. A release without that package or without SHA256SUMS only opens its page; a capture run never touches
+/// the network. The flow owns its two commands so that their can-execute state follows every change.
+///
+public sealed class UpdateFlow
+{
+ private static readonly TimeSpan CheckTimeout = TimeSpan.FromSeconds(30);
+
+ private readonly UpdateHost _host;
+
+ public UpdateFlow(UpdateHost host)
+ {
+ _host = host;
+ Check = new AsyncRelayCommand((_, ct) => CheckAsync(ct), _ => State is not (UpdateState.Checking or UpdateState.Downloading));
+ Download = new AsyncRelayCommand((_, ct) => DownloadAsync(ct), _ => IsDownloadOffered);
+ }
+
+ /// Raised after every change of state, release, progress or downloaded file.
+ public event Action? Changed;
+
+ public UpdateState State { get; private set; } = UpdateState.Unknown;
+
+ /// The newer release, or null when there is none (or no check has succeeded yet).
+ public ReleaseInfo? Release { get; private set; }
+
+ /// Fraction of the package downloaded so far.
+ public double Downloaded { get; private set; }
+
+ /// The verified package; null until a download succeeded.
+ public string? PackagePath { get; private set; }
+
+ public bool IsPortable => _host.IsPortable;
+
+ public AsyncRelayCommand Check { get; }
+
+ public AsyncRelayCommand Download { get; }
+
+ /// Download is offered: a newer release exists and no verified package is waiting (a failed download can be retried).
+ public bool IsDownloadOffered =>
+ Release is not null && State is UpdateState.Available or UpdateState.DownloadFailed or UpdateState.NotVerified;
+
+ /// The package Download fetches; null when Download opens the release page instead.
+ public ReleaseAsset? Package =>
+ Release is { } release && UpdateDownload.CanDownload(release, _host.IsPortable) ? UpdateDownload.Package(release, _host.IsPortable) : null;
+
+ /// Stops a download in progress; its partial file is kept and the next Download resumes it.
+ public void CancelDownload() => Download.Cancel();
+
+ /// The start-up check (BRIEF §18): only when the user left it on and never in a capture run.
+ public Task CheckOnStartAsync(bool enabled) => enabled ? CheckAsync(CancellationToken.None) : Task.FromResult(null);
+
+ /// Asks for the latest release and returns it when it is newer than the running version.
+ public async Task CheckAsync(CancellationToken ct)
+ {
+ if (_host.IsCapture || State is UpdateState.Checking or UpdateState.Downloading) return null;
+ SetState(UpdateState.Checking);
+ ReleaseInfo? latest = null;
+ var failed = true;
+ try
+ {
+ using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
+ timeout.CancelAfter(CheckTimeout);
+ latest = await _host.CheckAsync(timeout.Token);
+ failed = false;
+ }
+ catch (Exception ex) when (ex is HttpRequestException or OperationCanceledException or IOException)
+ {
+ Log.Info("update", "Update check failed: " + ex.Message);
+ }
+ finally
+ {
+ SetResult(latest, failed);
+ }
+ return Release;
+ }
+
+ /// Sets a check result without the network (capture, tests). A package already verified for the same release stays offered.
+ public void SetResult(ReleaseInfo? release, bool failed = false)
+ {
+ var newer = !failed && release is not null && UpdateCheck.IsNewer(release, _host.Running) ? release : null;
+ var keepPackage = newer is not null && PackagePath is not null && newer.Tag == Release?.Tag && File.Exists(PackagePath);
+ Release = newer;
+ if (!keepPackage) PackagePath = null;
+ SetState(failed ? UpdateState.Failed
+ : newer is null ? UpdateState.UpToDate
+ : keepPackage ? UpdateState.Downloaded
+ : UpdateState.Available);
+ }
+
+ private async Task DownloadAsync(CancellationToken ct)
+ {
+ if (Release is not { } release || _host.IsCapture) return;
+ if (Package is null)
+ {
+ _host.OpenUrl(release.PageUrl);
+ return;
+ }
+ Downloaded = 0;
+ SetState(UpdateState.Downloading);
+ var progress = new Progress(fraction =>
+ {
+ if (State != UpdateState.Downloading || fraction - Downloaded < 0.01) return;
+ Downloaded = fraction;
+ Changed?.Invoke();
+ });
+ try
+ {
+ var path = await _host.DownloadAsync(release, progress, ct);
+ PackagePath = path;
+ Log.Info("update", $"{Path.GetFileName(path)} of {release.Tag} downloaded and verified: {path}");
+ SetState(UpdateState.Downloaded);
+ _host.Reveal(path);
+ }
+ catch (UpdateVerificationException ex)
+ {
+ Log.Warning("update", "Update download refused: " + ex.Message);
+ SetState(UpdateState.NotVerified);
+ }
+ catch (OperationCanceledException) when (ct.IsCancellationRequested)
+ {
+ Log.Info("update", $"Download of {release.Tag} cancelled; the next one resumes it.");
+ SetState(UpdateState.Available);
+ }
+ catch (Exception ex) when (ex is HttpRequestException or TimeoutException or OperationCanceledException or IOException or UnauthorizedAccessException)
+ {
+ Log.Warning("update", "Update download failed: " + ex.Message);
+ SetState(UpdateState.DownloadFailed);
+ }
+ finally
+ {
+ // Anything unexpected still reaches the command's error report; the notice must not stay "Downloading".
+ if (State == UpdateState.Downloading) SetState(UpdateState.DownloadFailed);
+ }
+ }
+
+ private void SetState(UpdateState state)
+ {
+ State = state;
+ Changed?.Invoke();
+ Check.RaiseCanExecuteChanged();
+ Download.RaiseCanExecuteChanged();
+ }
+}
diff --git a/src/Titano.App/Infrastructure/AppServices.cs b/src/Titano.App/Infrastructure/AppServices.cs
index d6dc5a8d..4744f842 100644
--- a/src/Titano.App/Infrastructure/AppServices.cs
+++ b/src/Titano.App/Infrastructure/AppServices.cs
@@ -39,8 +39,8 @@ public sealed class AppServices : IAsyncDisposable
private static readonly Lazy Http = new(() => new HttpClient { Timeout = TimeSpan.FromSeconds(20) });
- /// Setups are large: the download is bounded by the caller's cancellation, not a short timeout.
- private static readonly Lazy DownloadHttp = new(() => new HttpClient { Timeout = TimeSpan.FromMinutes(30) });
+ /// Update packages are large: their download fails when it stalls (), never after a fixed total time.
+ private static readonly Lazy DownloadHttp = new(() => new HttpClient { Timeout = Timeout.InfiniteTimeSpan });
private readonly CancellationTokenSource _stopping = new();
private readonly Dictionary _scans = [];
private Task _polling = Task.CompletedTask;
@@ -59,7 +59,8 @@ public sealed class AppServices : IAsyncDisposable
Encoders = new MediaFoundationInventory();
CheckForUpdateAsync = ct => UpdateCheck.FetchAsync(Http.Value, ProductLinks.LatestReleaseApi, VersionText, ct);
DownloadUpdateAsync = (release, progress, ct) =>
- UpdateDownload.DownloadAsync(DownloadHttp.Value, release, UpdateDownload.Folder(Path.GetTempPath(), release), VersionText, progress, ct);
+ UpdateDownload.DownloadAsync(DownloadHttp.Value, release, environment.IsPortable, UpdateDownload.Root(Path.GetTempPath()), VersionText, progress,
+ UpdateDownload.IdleTimeout, ct);
}
public AppEnvironment Environment { get; }
@@ -94,7 +95,7 @@ public sealed class AppServices : IAsyncDisposable
/// Latest public release (GitHub Releases API of the releases repository, BRIEF §18).
public Func> CheckForUpdateAsync { get; set; }
- /// Downloads and verifies the setup of a release (BRIEF §18 P1) and returns its path.
+ /// Downloads and verifies the package of a release for this copy (setup, or portable zip; BRIEF §18 P1) and returns its path.
public Func?, CancellationToken, Task> DownloadUpdateAsync { get; set; }
/// The index; null until succeeded.
diff --git a/src/Titano.App/Sections/AboutView.xaml b/src/Titano.App/Sections/AboutView.xaml
index 7b445788..805a251a 100644
--- a/src/Titano.App/Sections/AboutView.xaml
+++ b/src/Titano.App/Sections/AboutView.xaml
@@ -55,11 +55,14 @@
-
+
+
diff --git a/src/Titano.App/Sections/AboutViewModel.cs b/src/Titano.App/Sections/AboutViewModel.cs
index 765cfcab..f11240da 100644
--- a/src/Titano.App/Sections/AboutViewModel.cs
+++ b/src/Titano.App/Sections/AboutViewModel.cs
@@ -1,12 +1,10 @@
using System.IO;
-using System.Net.Http;
using System.Reflection;
using System.Runtime.InteropServices;
using System.Windows.Input;
using Titano.App.About;
using Titano.App.Infrastructure;
using Titano.App.Shell;
-using Titano.Core.Diagnostics;
using Titano.Core.Localization;
using Titano.Ui.Controls;
using Titano.Ui.Mvvm;
@@ -15,27 +13,26 @@ namespace Titano.App.Sections;
///
/// About (BRIEF §12.9): version and build, licence link, third-party notice (none), translation notice,
-/// diagnostics bundle and the update check against the public releases repository (BRIEF §18). Download fetches the
-/// setup and verifies it against the release's SHA256SUMS, then shows it in Explorer: BRIEF §8.6 does not allow Titano
-/// to start an installer, so the user runs it.
+/// diagnostics bundle and the update notice of (BRIEF §18), which Settings › Updates shows too.
///
public sealed class AboutViewModel : SectionViewModel
{
- private ReleaseInfo? _release;
- private UpdateState _state = UpdateState.Unknown;
- private double _downloaded;
- private string? _setupPath;
+ private readonly UpdateFlow _update;
public AboutViewModel(ShellViewModel shell)
: base(SectionKey.About, "Icon.About")
{
Shell = shell;
- CheckCommand = new AsyncRelayCommand(() => CheckAsync(notify: false), () => _state is not (UpdateState.Checking or UpdateState.Downloading));
- DownloadCommand = new AsyncRelayCommand(DownloadAsync, () => _release is not null && _state != UpdateState.Downloading);
- ShowSetupCommand = new RelayCommand(() =>
+ var environment = shell.Services.Environment;
+ _update = new UpdateFlow(new UpdateHost(UpdateCheck.RunningVersion(Version), environment.IsCapture, environment.IsPortable,
+ ct => Shell.Services.CheckForUpdateAsync(ct), (release, progress, ct) => Shell.Services.DownloadUpdateAsync(release, progress, ct),
+ ShellActions.OpenUrl, ShellActions.Reveal));
+ _update.Changed += RaiseUpdate;
+ ShowPackageCommand = new RelayCommand(() =>
{
- if (_setupPath is { } path) ShellActions.Reveal(path);
- }, () => _setupPath is not null);
+ if (_update.PackagePath is { } path) ShellActions.Reveal(path);
+ }, () => _update.PackagePath is not null);
+ CancelDownloadCommand = new RelayCommand(_update.CancelDownload, () => IsDownloading);
OpenReleasesCommand = new RelayCommand(() => ShellActions.OpenUrl(ProductLinks.Releases));
OpenLicenceCommand = new RelayCommand(() => ShellActions.OpenUrl(ProductLinks.Licence));
ReviewTranslationCommand = new RelayCommand(() => ShellActions.OpenUrl(ProductLinks.Issues));
@@ -43,19 +40,6 @@ public sealed class AboutViewModel : SectionViewModel
DiagnosticsCommand = new AsyncRelayCommand(DiagnosticsAsync);
}
- private enum UpdateState
- {
- Unknown,
- Checking,
- UpToDate,
- Available,
- Failed,
- Downloading,
- Downloaded,
- DownloadFailed,
- NotVerified,
- }
-
public ShellViewModel Shell { get; }
public string Version => AppServices.VersionText;
@@ -73,9 +57,10 @@ public sealed class AboutViewModel : SectionViewModel
/// Every language but English is machine-translated and open to review (BRIEF §16).
public bool IsTranslated => !Loc.Culture.TwoLetterISOLanguageName.Equals("en", StringComparison.OrdinalIgnoreCase);
- public ICommand CheckCommand { get; }
- public ICommand DownloadCommand { get; }
- public ICommand ShowSetupCommand { get; }
+ public ICommand CheckCommand => _update.Check;
+ public ICommand DownloadCommand => _update.Download;
+ public ICommand ShowPackageCommand { get; }
+ public ICommand CancelDownloadCommand { get; }
public ICommand OpenReleasesCommand { get; }
public ICommand OpenLicenceCommand { get; }
public ICommand ReviewTranslationCommand { get; }
@@ -83,20 +68,20 @@ public sealed class AboutViewModel : SectionViewModel
public ICommand DiagnosticsCommand { get; }
/// "Up to date", "Titano 0.2.0 available", …; null before the first check.
- public string? UpdateText => _state switch
+ public string? UpdateText => _update.State switch
{
UpdateState.Checking => Loc.L("About.Update.Checking"),
UpdateState.UpToDate => Loc.L("About.Update.Current"),
- UpdateState.Available when _release is { } r => Loc.L("About.Update.Available", UpdateCheck.Display(r.Version)),
+ UpdateState.Available when _update.Release is { } r => Loc.L("About.Update.Available", UpdateCheck.Display(r.Version)),
UpdateState.Failed => Loc.L("About.Update.Failed"),
- UpdateState.Downloading => Loc.L("About.Update.Downloading", _downloaded),
- UpdateState.Downloaded when _release is { } r => Loc.L("About.Update.Ready", UpdateCheck.Display(r.Version)),
+ UpdateState.Downloading => Loc.L("About.Update.Downloading", _update.Downloaded),
+ UpdateState.Downloaded when _update.Release is { } r => Loc.L("About.Update.Ready", UpdateCheck.Display(r.Version)),
UpdateState.DownloadFailed => Loc.L("About.Update.DownloadFailed"),
UpdateState.NotVerified => Loc.L("About.Update.NotVerified"),
_ => null,
};
- public StatusKind UpdateKind => _state switch
+ public StatusKind UpdateKind => _update.State switch
{
UpdateState.Checking or UpdateState.Downloading => StatusKind.Running,
UpdateState.UpToDate or UpdateState.Downloaded => StatusKind.Done,
@@ -106,89 +91,32 @@ public sealed class AboutViewModel : SectionViewModel
public bool HasUpdateText => UpdateText is not null;
- /// Download is offered: a newer release exists and no verified setup is waiting (a failed download can be retried).
- public bool IsUpdateAvailable => _state is UpdateState.Available or UpdateState.DownloadFailed or UpdateState.NotVerified;
+ /// Download is offered: a newer release exists and no verified package is waiting (a failed download can be retried).
+ public bool IsUpdateAvailable => _update.IsDownloadOffered;
- /// The verified setup is in the temporary folder.
- public bool IsSetupReady => _state == UpdateState.Downloaded;
+ /// The verified setup or portable zip is in the temporary folder.
+ public bool IsPackageReady => _update.State == UpdateState.Downloaded;
- /// Starts the update check on start when allowed (opt-out, BRIEF §18).
- public void Attach()
- {
- if (Shell.Services.Settings.CheckForUpdates && !Shell.Services.Environment.IsCapture) _ = CheckAsync(notify: true);
- }
+ public bool IsDownloading => _update.State == UpdateState.Downloading;
+
+ /// What Download does here: fetch and verify the setup or the portable zip (with its size), or open the release page.
+ public string DownloadToolTip => _update.Package is { } package
+ ? Loc.L(_update.IsPortable ? "Tooltips.About.DownloadPortable" : "Tooltips.About.Download", Formatting.Bytes(package.Size))
+ : Loc.L("Tooltips.About.DownloadPage");
+
+ public string ShowPackageToolTip => Loc.L(_update.IsPortable ? "Tooltips.About.ShowPortable" : "Tooltips.About.ShowSetup");
+
+ /// Starts the update check on start when allowed (opt-out, BRIEF §18); never in a capture run.
+ public void Attach() => _ = NotifyAsync();
/// Sets a result without the network (capture, tests).
- internal void SetResult(ReleaseInfo? release, bool failed = false)
- {
- _release = release is not null && UpdateCheck.IsNewer(release, UpdateCheck.RunningVersion(Version)) ? release : null;
- _state = failed ? UpdateState.Failed : _release is null ? UpdateState.UpToDate : UpdateState.Available;
- _setupPath = null;
- RaiseUpdate();
- }
+ internal void SetResult(ReleaseInfo? release, bool failed = false) => _update.SetResult(release, failed);
- private async Task CheckAsync(bool notify)
+ private async Task NotifyAsync()
{
- _state = UpdateState.Checking;
- RaiseUpdate();
- try
- {
- using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(30));
- var release = await Shell.Services.CheckForUpdateAsync(timeout.Token);
- SetResult(release);
- if (notify && _release is { } newer)
- {
- Shell.Notify(Loc.L("About.Update.Available", UpdateCheck.Display(newer.Version)), actionText: Loc.L("About.Update.Download"),
- actionToolTip: Loc.L("Tooltips.About.Download"), action: () => DownloadCommand.Execute(null));
- }
- }
- catch (Exception ex) when (ex is HttpRequestException or OperationCanceledException or IOException)
- {
- Log.Info("update", "Update check failed: " + ex.Message);
- SetResult(null, failed: true);
- }
- }
-
- ///
- /// Downloads and verifies the setup, then shows it in Explorer. A release without a setup or SHA256SUMS only opens
- /// the release page; a capture run never touches the network.
- ///
- private async Task DownloadAsync()
- {
- if (_release is not { } release || Shell.Services.Environment.IsCapture) return;
- if (!UpdateDownload.CanDownload(release))
- {
- ShellActions.OpenUrl(release.PageUrl);
- return;
- }
- _state = UpdateState.Downloading;
- _downloaded = 0;
- RaiseUpdate();
- var progress = new Progress(fraction =>
- {
- if (_state != UpdateState.Downloading || fraction - _downloaded < 0.01) return;
- _downloaded = fraction;
- OnPropertyChanged(nameof(UpdateText));
- });
- try
- {
- using var timeout = new CancellationTokenSource(TimeSpan.FromMinutes(30));
- _setupPath = await Shell.Services.DownloadUpdateAsync(release, progress, timeout.Token);
- _state = UpdateState.Downloaded;
- Log.Info("update", $"Setup of {release.Tag} downloaded and verified: {_setupPath}");
- ShellActions.Reveal(_setupPath);
- }
- catch (UpdateVerificationException ex)
- {
- Log.Warning("update", "Update download refused: " + ex.Message);
- _state = UpdateState.NotVerified;
- }
- catch (Exception ex) when (ex is HttpRequestException or OperationCanceledException or IOException or UnauthorizedAccessException)
- {
- Log.Warning("update", "Update download failed: " + ex.Message);
- _state = UpdateState.DownloadFailed;
- }
- RaiseUpdate();
+ if (await _update.CheckOnStartAsync(Shell.Services.Settings.CheckForUpdates) is not { } newer) return;
+ Shell.Notify(Loc.L("About.Update.Available", UpdateCheck.Display(newer.Version)), actionText: Loc.L("About.Update.Download"),
+ actionToolTip: DownloadToolTip, action: () => DownloadCommand.Execute(null));
}
private async Task DiagnosticsAsync()
@@ -212,7 +140,9 @@ public sealed class AboutViewModel : SectionViewModel
OnPropertyChanged(nameof(UpdateKind));
OnPropertyChanged(nameof(HasUpdateText));
OnPropertyChanged(nameof(IsUpdateAvailable));
- OnPropertyChanged(nameof(IsSetupReady));
+ OnPropertyChanged(nameof(IsPackageReady));
+ OnPropertyChanged(nameof(IsDownloading));
+ OnPropertyChanged(nameof(DownloadToolTip));
CommandManager.InvalidateRequerySuggested();
}
}
diff --git a/src/Titano.App/Sections/SettingsView.xaml b/src/Titano.App/Sections/SettingsView.xaml
index 018d322c..52b4b36d 100644
--- a/src/Titano.App/Sections/SettingsView.xaml
+++ b/src/Titano.App/Sections/SettingsView.xaml
@@ -291,12 +291,15 @@
-
-
+ Visibility="{Binding Shell.About.IsDownloading, Converter={StaticResource BoolToVisibility}}" />
+
diff --git a/tests/Titano.App.Tests/About/UpdateDownloadTests.cs b/tests/Titano.App.Tests/About/UpdateDownloadTests.cs
index 3929ab4a..cd786f39 100644
--- a/tests/Titano.App.Tests/About/UpdateDownloadTests.cs
+++ b/tests/Titano.App.Tests/About/UpdateDownloadTests.cs
@@ -1,6 +1,7 @@
using System.IO;
using System.Net;
using System.Net.Http;
+using System.Net.Http.Headers;
using System.Security.Cryptography;
using System.Text;
using Titano.App.About;
@@ -10,10 +11,13 @@ namespace Titano.App.Tests.About;
public sealed class UpdateDownloadTests(TestContext context)
{
- private const string SetupUrl = "https://github.com/o/r/releases/download/v1.0.0/Titano-Setup-1.0.0.exe";
- private const string SumsUrl = "https://github.com/o/r/releases/download/v1.0.0/SHA256SUMS";
+ private const string Base = "https://github.com/o/r/releases/download/v1.0.0/";
+ private const string SetupName = "Titano-Setup-1.0.0.exe";
+ private const string PortableName = "Titano-win-x64-portable-1.0.0.zip";
+ private static readonly TimeSpan Idle = TimeSpan.FromSeconds(30);
private static readonly byte[] Setup = Encoding.ASCII.GetBytes(string.Concat(Enumerable.Repeat("MZ setup payload ", 20_000)));
+ private static readonly byte[] Portable = Encoding.ASCII.GetBytes(string.Concat(Enumerable.Repeat("PK portable zip ", 9_000)));
[Test]
public void ChecksumLinesOfBothSha256sumModesAreRead()
@@ -27,116 +31,295 @@ public sealed class UpdateDownloadTests(TestContext context)
}
[Test]
- public void TheDesktopSetupAndTheChecksumsAreFoundAmongTheAssets()
+ public void ThePackageForEachKindOfCopyAndTheChecksumsAreFoundAmongTheAssets()
{
var release = UpdateCheck.Parse($$"""
{ "tag_name": "v1.0.0", "html_url": "https://github.com/o/r/releases/tag/v1.0.0", "assets": [
- { "name": "Titano-Uploader-Setup-1.0.0.exe", "browser_download_url": "https://github.com/o/r/releases/download/v1.0.0/Titano-Uploader-Setup-1.0.0.exe", "size": 10 },
- { "name": "Titano-Setup-1.0.0.exe", "browser_download_url": "{{SetupUrl}}", "size": {{Setup.Length}} },
- { "name": "SHA256SUMS", "browser_download_url": "{{SumsUrl}}", "size": 300 },
+ { "name": "Titano-Uploader-Setup-1.0.0.exe", "browser_download_url": "{{Base}}Titano-Uploader-Setup-1.0.0.exe", "size": 10 },
+ { "name": "{{SetupName}}", "browser_download_url": "{{Base}}{{SetupName}}", "size": {{Setup.Length}} },
+ { "name": "{{PortableName}}", "browser_download_url": "{{Base}}{{PortableName}}", "size": {{Portable.Length}} },
+ { "name": "SHA256SUMS", "browser_download_url": "{{Base}}SHA256SUMS", "size": 300 },
{ "name": "evil.exe", "browser_download_url": "http://example.com/evil.exe", "size": 1 }
] }
""")!;
- Assert.Equal(3, release.Assets.Count);
- Assert.Equal("Titano-Setup-1.0.0.exe", UpdateDownload.Installer(release)!.Name);
- Assert.Equal(SumsUrl, UpdateDownload.Checksums(release)!.DownloadUrl);
- Assert.True(UpdateDownload.CanDownload(release));
- Assert.False(UpdateDownload.CanDownload(release with { Assets = [.. release.Assets.Where(a => a.Name != "SHA256SUMS")] }));
- Assert.True(UpdateDownload.Folder(Path.GetTempPath(), release).EndsWith(Path.Combine("Titano", "updates", "v1.0.0"), StringComparison.Ordinal));
+ Assert.Equal(4, release.Assets.Count);
+ Assert.Equal(SetupName, UpdateDownload.Package(release, portable: false)!.Name);
+ Assert.Equal(PortableName, UpdateDownload.Package(release, portable: true)!.Name);
+ Assert.Equal(Base + "SHA256SUMS", UpdateDownload.Checksums(release)!.DownloadUrl);
+ Assert.True(UpdateDownload.CanDownload(release, portable: false));
+ Assert.True(UpdateDownload.CanDownload(release, portable: true));
+ Assert.False(UpdateDownload.CanDownload(release with { Assets = [.. release.Assets.Where(a => a.Name != "SHA256SUMS")] }, portable: false));
+ Assert.False(UpdateDownload.CanDownload(release with { Assets = [.. release.Assets.Where(a => a.Name != PortableName)] }, portable: true));
+ var root = UpdateDownload.Root(Path.GetTempPath());
+ Assert.True(root.EndsWith(Path.Combine("Titano", "updates"), StringComparison.Ordinal), root);
+ Assert.Equal(Path.Combine(root, "v1.0.0"), UpdateDownload.Folder(root, release));
}
[Test]
public async Task AVerifiedSetupIsKeptAndReusedWithoutDownloadingAgain()
{
- var folder = context.CreateTempDirectory();
- var server = new FakeReleases(Sums(Setup), Setup);
+ var root = context.CreateTempDirectory();
+ var server = new FakeReleases(Setup);
using var http = new HttpClient(server);
var reported = new List();
- var path = await UpdateDownload.DownloadAsync(http, Release(), folder, "0.1.0", new SyncProgress(reported.Add), CancellationToken.None);
- Assert.Equal(Path.Combine(folder, "Titano-Setup-1.0.0.exe"), path);
+ var path = await DownloadAsync(http, root, progress: new SyncProgress(reported.Add));
+ Assert.Equal(Path.Combine(root, "v1.0.0", SetupName), path);
Assert.SequenceEqual(Setup, await File.ReadAllBytesAsync(path));
Assert.Equal(1.0, reported[^1]);
- Assert.Equal(1, server.SetupRequests);
- Assert.SequenceEqual(new[] { "Titano-Setup-1.0.0.exe" }, Directory.GetFiles(folder).Select(f => Path.GetFileName(f)));
+ Assert.Equal(1, server.PackageRequests);
+ Assert.SequenceEqual(new[] { SetupName }, Directory.GetFiles(Path.GetDirectoryName(path)!).Select(f => Path.GetFileName(f)));
- await UpdateDownload.DownloadAsync(http, Release(), folder, "0.1.0", null, CancellationToken.None);
- Assert.Equal(1, server.SetupRequests);
+ await DownloadAsync(http, root);
+ Assert.Equal(1, server.PackageRequests);
+ }
+
+ [Test]
+ public async Task APortableCopyGetsThePortableZipNeverTheSetup()
+ {
+ var root = context.CreateTempDirectory();
+ var server = new FakeReleases(Setup);
+ using var http = new HttpClient(server);
+ var path = await DownloadAsync(http, root, portable: true);
+ Assert.Equal(PortableName, Path.GetFileName(path));
+ Assert.SequenceEqual(Portable, await File.ReadAllBytesAsync(path));
+ Assert.SequenceEqual(new[] { Base + PortableName }, server.PackageUrls);
}
[Test]
public async Task ASetupThatDoesNotMatchItsChecksumIsDeleted()
{
- var folder = context.CreateTempDirectory();
+ var root = context.CreateTempDirectory();
var tampered = Setup.ToArray();
tampered[^1] ^= 1;
- using var http = new HttpClient(new FakeReleases(Sums(Setup), tampered));
- var error = await Assert.ThrowsAsync(() =>
- UpdateDownload.DownloadAsync(http, Release(), folder, "0.1.0", null, CancellationToken.None));
+ using var http = new HttpClient(new FakeReleases(Setup) { Served = tampered });
+ var error = await Assert.ThrowsAsync(() => DownloadAsync(http, root));
Assert.Contains("does not match", error.Message);
- Assert.Empty(Directory.GetFiles(folder));
+ Assert.Empty(Directory.GetFiles(root, "*", SearchOption.AllDirectories));
+ }
+
+ [Test]
+ public async Task ACorruptedSetupLeftFromBeforeIsReplacedByAFreshDownload()
+ {
+ var root = context.CreateTempDirectory();
+ var server = new FakeReleases(Setup);
+ using var http = new HttpClient(server);
+ var target = Path.Combine(root, "v1.0.0", SetupName);
+ Directory.CreateDirectory(Path.GetDirectoryName(target)!);
+ await File.WriteAllBytesAsync(target, Setup[..1000]);
+
+ Assert.Equal(target, await DownloadAsync(http, root));
+ Assert.SequenceEqual(Setup, await File.ReadAllBytesAsync(target));
+ Assert.Equal(1, server.PackageRequests);
}
[Test]
public async Task ASetupWithoutAChecksumLineIsNeverDownloaded()
{
- var folder = context.CreateTempDirectory();
- var server = new FakeReleases($"{new string('0', 64)} Titano-Uploader-Setup-1.0.0.exe\n", Setup);
+ var root = context.CreateTempDirectory();
+ var server = new FakeReleases(Setup) { Sums = $"{new string('0', 64)} Titano-Uploader-Setup-1.0.0.exe\n" };
using var http = new HttpClient(server);
- await Assert.ThrowsAsync(() => UpdateDownload.DownloadAsync(http, Release(), folder, "0.1.0", null, CancellationToken.None));
- Assert.Equal(0, server.SetupRequests);
- Assert.Empty(Directory.GetFiles(folder));
+ await Assert.ThrowsAsync(() => DownloadAsync(http, root));
+ Assert.Equal(0, server.PackageRequests);
+ Assert.Empty(Directory.GetFiles(root, "*", SearchOption.AllDirectories));
}
[Test]
public async Task MoreBytesThanTheReleaseAnnouncedAreRefused()
{
- var folder = context.CreateTempDirectory();
+ var root = context.CreateTempDirectory();
var longer = Setup.Concat(new byte[100]).ToArray();
- using var http = new HttpClient(new FakeReleases(Sums(longer), longer));
- await Assert.ThrowsAsync(() => UpdateDownload.DownloadAsync(http, Release(), folder, "0.1.0", null, CancellationToken.None));
- Assert.Empty(Directory.GetFiles(folder));
+ using var http = new HttpClient(new FakeReleases(Setup) { Served = longer, Sums = Sums(longer, Portable) });
+ await Assert.ThrowsAsync(() => DownloadAsync(http, root));
+ Assert.Empty(Directory.GetFiles(root, "*", SearchOption.AllDirectories));
}
[Test]
- public async Task AFailedRequestLeavesNoPartialFile()
+ public async Task AFailedRequestLeavesNoFile()
{
- var folder = context.CreateTempDirectory();
- using var http = new HttpClient(new FakeReleases(Sums(Setup), null));
- await Assert.ThrowsAsync(() => UpdateDownload.DownloadAsync(http, Release(), folder, "0.1.0", null, CancellationToken.None));
- Assert.Empty(Directory.GetFiles(folder));
+ var root = context.CreateTempDirectory();
+ using var http = new HttpClient(new FakeReleases(Setup) { Fail = true });
+ await Assert.ThrowsAsync(() => DownloadAsync(http, root));
+ Assert.Empty(Directory.GetFiles(root, "*", SearchOption.AllDirectories));
}
+ [Test]
+ public async Task ATransferCutShortIsResumedWhereItStopped()
+ {
+ var root = context.CreateTempDirectory();
+ var server = new FakeReleases(Setup) { CutAfter = 100_000 };
+ using var http = new HttpClient(server);
+ await Assert.ThrowsAsync(() => DownloadAsync(http, root));
+ var part = Path.Combine(root, "v1.0.0", SetupName + ".part");
+ Assert.Equal(100_000L, new FileInfo(part).Length);
+
+ server.CutAfter = null;
+ var path = await DownloadAsync(http, root);
+ Assert.SequenceEqual(Setup, await File.ReadAllBytesAsync(path));
+ Assert.SequenceEqual(new long?[] { null, 100_000 }, server.Ranges);
+ Assert.FileMissing(part);
+ }
+
+ [Test]
+ public async Task AServerThatIgnoresTheRangeStartsTheFileAgain()
+ {
+ var root = context.CreateTempDirectory();
+ var server = new FakeReleases(Setup) { CutAfter = 50_000 };
+ using var http = new HttpClient(server);
+ await Assert.ThrowsAsync(() => DownloadAsync(http, root));
+
+ server.CutAfter = null;
+ server.HonourRange = false;
+ var path = await DownloadAsync(http, root);
+ Assert.SequenceEqual(Setup, await File.ReadAllBytesAsync(path));
+ }
+
+ [Test]
+ public async Task ACancelledDownloadKeepsItsPartialFileForTheNextAttempt()
+ {
+ var root = context.CreateTempDirectory();
+ var server = new FakeReleases(Setup) { StallAfter = 64 * 1024 };
+ using var http = new HttpClient(server);
+ using var cts = new CancellationTokenSource();
+ var reported = new List();
+ var download = DownloadAsync(http, root, progress: new SyncProgress(f =>
+ {
+ reported.Add(f);
+ cts.Cancel();
+ }), ct: cts.Token);
+ await Assert.ThrowsAsync(() => download);
+ var part = Path.Combine(root, "v1.0.0", SetupName + ".part");
+ Assert.Equal(64L * 1024, new FileInfo(part).Length);
+
+ server.StallAfter = null;
+ Assert.SequenceEqual(Setup, await File.ReadAllBytesAsync(await DownloadAsync(http, root)));
+ Assert.Equal(64L * 1024, server.Ranges[^1]);
+ }
+
+ [Test]
+ public async Task ATransferThatStallsFailsAfterTheIdleTimeout()
+ {
+ var root = context.CreateTempDirectory();
+ using var http = new HttpClient(new FakeReleases(Setup) { StallAfter = 10_000 });
+ var started = DateTime.UtcNow;
+ var error = await Assert.ThrowsAsync(() => DownloadAsync(http, root, idle: TimeSpan.FromMilliseconds(300)));
+ Assert.Contains("No data received", error.Message);
+ Assert.Less((DateTime.UtcNow - started).TotalSeconds, 20);
+ Assert.FileExists(Path.Combine(root, "v1.0.0", SetupName + ".part"));
+ }
+
+ [Test]
+ public async Task AnAssetOfUnknownSizeIsStillVerified()
+ {
+ var root = context.CreateTempDirectory();
+ using var http = new HttpClient(new FakeReleases(Setup));
+ var release = Release() with { Assets = [new ReleaseAsset(SetupName, Base + SetupName, -1), new ReleaseAsset("SHA256SUMS", Base + "SHA256SUMS", -1)] };
+ var reported = new List();
+ var path = await UpdateDownload.DownloadAsync(http, release, false, root, "0.1.0", new SyncProgress(reported.Add), Idle, CancellationToken.None);
+ Assert.SequenceEqual(Setup, await File.ReadAllBytesAsync(path));
+ Assert.Empty(reported);
+ }
+
+ [Test]
+ public async Task AVerifiedDownloadRemovesTheFoldersOfOtherReleases()
+ {
+ var root = context.CreateTempDirectory();
+ var old = Directory.CreateDirectory(Path.Combine(root, "v0.9.0")).FullName;
+ await File.WriteAllTextAsync(Path.Combine(old, "Titano-Setup-0.9.0.exe"), "old setup");
+ using var http = new HttpClient(new FakeReleases(Setup));
+ await DownloadAsync(http, root);
+ Assert.SequenceEqual(new[] { "v1.0.0" }, Directory.GetDirectories(root).Select(d => Path.GetFileName(d)));
+ }
+
+ private static Task DownloadAsync(HttpClient http, string root, bool portable = false, IProgress? progress = null, TimeSpan? idle = null,
+ CancellationToken ct = default) =>
+ UpdateDownload.DownloadAsync(http, Release(), portable, root, "0.1.0", progress, idle ?? Idle, ct);
+
private static ReleaseInfo Release() => new(new Version(1, 0, 0), "v1.0.0", "https://github.com/o/r/releases/tag/v1.0.0")
{
Assets =
[
- new ReleaseAsset("Titano-Setup-1.0.0.exe", SetupUrl, Setup.Length),
- new ReleaseAsset("SHA256SUMS", SumsUrl, 200),
+ new ReleaseAsset(SetupName, Base + SetupName, Setup.Length),
+ new ReleaseAsset(PortableName, Base + PortableName, Portable.Length),
+ new ReleaseAsset("SHA256SUMS", Base + "SHA256SUMS", 300),
],
};
- private static string Sums(byte[] setup) =>
- $"{new string('1', 64)} Titano-Uploader-Setup-1.0.0.exe\n{Convert.ToHexStringLower(SHA256.HashData(setup))} Titano-Setup-1.0.0.exe\n";
+ private static string Sums(byte[] setup, byte[] portable) =>
+ $"{new string('1', 64)} Titano-Uploader-Setup-1.0.0.exe\n{Hash(setup)} {SetupName}\n{Hash(portable)} *{PortableName}\n";
- /// Serves SHA256SUMS and the setup (null: the setup answers 500).
- private sealed class FakeReleases(string sums, byte[]? setup) : HttpMessageHandler
+ private static string Hash(byte[] bytes) => Convert.ToHexStringLower(SHA256.HashData(bytes));
+
+ ///
+ /// Serves SHA256SUMS, the setup and the portable zip like GitHub's release downloads: honours single open-ended
+ /// ranges, and can fail, end a transfer early or stall in the middle of it.
+ ///
+ private sealed class FakeReleases(byte[] setup) : HttpMessageHandler
{
- public int SetupRequests { get; private set; }
+ public string Sums { get; set; } = UpdateDownloadTests.Sums(setup, Portable);
+
+ /// The setup bytes actually served (tampered or longer ones); the real setup by default.
+ public byte[] Served { get; set; } = setup;
+
+ public bool Fail { get; set; }
+ public bool HonourRange { get; set; } = true;
+ public int? CutAfter { get; set; }
+ public int? StallAfter { get; set; }
+ public int PackageRequests => PackageUrls.Count;
+ public List PackageUrls { get; } = [];
+ public List Ranges { get; } = [];
protected override Task SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
{
Assert.True(request.Headers.UserAgent.ToString().StartsWith("Titano/", StringComparison.Ordinal), "GitHub requires a User-Agent");
var url = request.RequestUri!.AbsoluteUri;
- if (url == SumsUrl) return Task.FromResult(new HttpResponseMessage(HttpStatusCode.OK) { Content = new StringContent(sums) });
- Assert.Equal(SetupUrl, url);
- SetupRequests++;
- return Task.FromResult(setup is null
- ? new HttpResponseMessage(HttpStatusCode.InternalServerError)
- : new HttpResponseMessage(HttpStatusCode.OK) { Content = new ByteArrayContent(setup) });
+ if (url == Base + "SHA256SUMS") return Task.FromResult(new HttpResponseMessage(HttpStatusCode.OK) { Content = new StringContent(Sums) });
+ var bytes = url == Base + SetupName ? Served : url == Base + PortableName ? Portable : throw new AssertionException("Unexpected request " + url);
+ PackageUrls.Add(url);
+ var from = request.Headers.Range?.Ranges.Single().From;
+ Ranges.Add(from);
+ if (Fail) return Task.FromResult(new HttpResponseMessage(HttpStatusCode.InternalServerError));
+
+ var offset = HonourRange && from is { } start ? (int)start : 0;
+ var end = CutAfter is { } cut ? System.Math.Min(bytes.Length, offset + cut) : bytes.Length;
+ var body = new StreamContent(new Body(bytes[offset..end], StallAfter));
+ var response = new HttpResponseMessage(offset > 0 ? HttpStatusCode.PartialContent : HttpStatusCode.OK) { Content = body };
+ if (offset > 0) body.Headers.ContentRange = new ContentRangeHeaderValue(offset, bytes.Length - 1, bytes.Length);
+ return Task.FromResult(response);
}
}
+ /// A non-seekable body (no Content-Length) that waits for cancellation once bytes are read.
+ private sealed class Body(byte[] bytes, int? stallAfter) : Stream
+ {
+ private int _position;
+
+ public override bool CanRead => true;
+ public override bool CanSeek => false;
+ public override bool CanWrite => false;
+ public override long Length => throw new NotSupportedException();
+ public override long Position { get => _position; set => throw new NotSupportedException(); }
+
+ public override async ValueTask ReadAsync(Memory buffer, CancellationToken cancellationToken = default)
+ {
+ if (_position == stallAfter) await Task.Delay(Timeout.Infinite, cancellationToken);
+ var limit = stallAfter is { } stall && _position < stall ? stall : bytes.Length;
+ var count = System.Math.Min(buffer.Length, limit - _position);
+ bytes.AsMemory(_position, count).CopyTo(buffer);
+ _position += count;
+ return count;
+ }
+
+ public override Task ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken) =>
+ ReadAsync(buffer.AsMemory(offset, count), cancellationToken).AsTask();
+
+ public override int Read(byte[] buffer, int offset, int count) => ReadAsync(buffer, offset, count, CancellationToken.None).GetAwaiter().GetResult();
+ public override void Flush() => throw new NotSupportedException();
+ public override long Seek(long offset, SeekOrigin origin) => throw new NotSupportedException();
+ public override void SetLength(long value) => throw new NotSupportedException();
+ public override void Write(byte[] buffer, int offset, int count) => throw new NotSupportedException();
+ }
+
/// Reports synchronously ( would post to the thread pool).
private sealed class SyncProgress(Action report) : IProgress
{
diff --git a/tests/Titano.App.Tests/About/UpdateFlowTests.cs b/tests/Titano.App.Tests/About/UpdateFlowTests.cs
new file mode 100644
index 00000000..ca68dbcd
--- /dev/null
+++ b/tests/Titano.App.Tests/About/UpdateFlowTests.cs
@@ -0,0 +1,208 @@
+using System.IO;
+using Titano.App.About;
+using Titano.Testing;
+using Titano.Ui.Mvvm;
+
+namespace Titano.App.Tests.About;
+
+/// The update notice: start-up opt-out, capture runs, portable copies, failures and cancellation of the download.
+[Serial] // AsyncRelayCommand.Failed is a static event
+public sealed class UpdateFlowTests(TestContext context)
+{
+ private const string Page = "https://github.com/o/r/releases/tag/v1.0.0";
+
+ [Test]
+ public async Task TheStartUpCheckFollowsTheOptOut()
+ {
+ var host = new Host();
+ var flow = host.Flow();
+ Assert.Null(await flow.CheckOnStartAsync(enabled: false));
+ Assert.Equal(0, host.Checks);
+ Assert.Equal(UpdateState.Unknown, flow.State);
+
+ Assert.Equal("v1.0.0", (await flow.CheckOnStartAsync(enabled: true))?.Tag);
+ Assert.Equal(1, host.Checks);
+ Assert.Equal(UpdateState.Available, flow.State);
+ }
+
+ [Test]
+ public async Task ACaptureRunNeverTouchesTheNetwork()
+ {
+ var host = new Host { IsCapture = true };
+ var flow = host.Flow();
+ Assert.Null(await flow.CheckOnStartAsync(enabled: true));
+ Assert.Null(await flow.CheckAsync(CancellationToken.None));
+ Assert.Equal(0, host.Checks);
+
+ flow.SetResult(Release(withSetup: true, withZip: true, withSums: true));
+ await RunAsync(flow.Download);
+ Assert.Equal(0, host.Downloads);
+ Assert.Empty(host.Opened);
+ }
+
+ [Test]
+ public async Task ADownloadedSetupIsShownAndOfferedUntilANewerReleaseAppears()
+ {
+ var host = new Host { Downloaded = Path.Combine(context.CreateTempDirectory(), "Titano-Setup-1.0.0.exe") };
+ File.WriteAllText(host.Downloaded, "setup");
+ var flow = host.Flow();
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true));
+ Assert.Equal("Titano-Setup-1.0.0.exe", flow.Package?.Name);
+
+ await RunAsync(flow.Download);
+ Assert.Equal((UpdateState.Downloaded, host.Downloaded), (flow.State, flow.PackagePath));
+ Assert.SequenceEqual(new[] { host.Downloaded }, host.Revealed);
+ Assert.False(flow.IsDownloadOffered);
+
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true));
+ Assert.Equal(UpdateState.Downloaded, flow.State);
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true) with { Version = new Version(1, 1, 0), Tag = "v1.1.0" });
+ Assert.Equal((UpdateState.Available, (string?)null), (flow.State, flow.PackagePath));
+ }
+
+ [Test]
+ public async Task APortableCopyNeverDownloadsTheSetup()
+ {
+ var host = new Host { IsPortable = true };
+ var flow = host.Flow();
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true));
+ Assert.Null(flow.Package);
+ await RunAsync(flow.Download);
+ Assert.Equal(0, host.Downloads);
+ Assert.SequenceEqual(new[] { Page }, host.Opened);
+
+ flow.SetResult(Release(withSetup: true, withZip: true, withSums: true));
+ Assert.Equal("Titano-win-x64-portable-1.0.0.zip", flow.Package?.Name);
+ await RunAsync(flow.Download);
+ Assert.Equal(1, host.Downloads);
+ Assert.Equal(UpdateState.Downloaded, flow.State);
+ }
+
+ [Test]
+ public async Task AReleaseWithoutChecksumsOnlyOpensItsPage()
+ {
+ var host = new Host();
+ var flow = host.Flow();
+ flow.SetResult(Release(withSetup: true, withZip: true, withSums: false));
+ await RunAsync(flow.Download);
+ Assert.Equal(0, host.Downloads);
+ Assert.SequenceEqual(new[] { Page }, host.Opened);
+ Assert.Equal(UpdateState.Available, flow.State);
+ }
+
+ [Test]
+ public async Task ARefusedDownloadIsReportedAndCanBeRetried()
+ {
+ var host = new Host { Failure = new UpdateVerificationException("SHA-256 mismatch") };
+ var flow = host.Flow();
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true));
+ await RunAsync(flow.Download);
+ Assert.Equal(UpdateState.NotVerified, flow.State);
+ Assert.True(flow.IsDownloadOffered);
+ Assert.True(flow.Download.CanExecute(null));
+ Assert.True(flow.Check.CanExecute(null));
+ }
+
+ [Test]
+ public async Task AStalledDownloadFailsAndCanBeRetried()
+ {
+ var host = new Host { Failure = new TimeoutException("No data received for 60 s.") };
+ var flow = host.Flow();
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true));
+ await RunAsync(flow.Download);
+ Assert.Equal(UpdateState.DownloadFailed, flow.State);
+ Assert.True(flow.IsDownloadOffered);
+ }
+
+ [Test]
+ public async Task AnUnexpectedFailureIsReportedAndNeverLeavesTheNoticeDownloading()
+ {
+ var host = new Host { Failure = new UriFormatException("bad asset link") };
+ var flow = host.Flow();
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true));
+ var reported = new List();
+ AsyncRelayCommand.Failed += reported.Add;
+ try
+ {
+ await RunAsync(flow.Download);
+ }
+ finally
+ {
+ AsyncRelayCommand.Failed -= reported.Add;
+ }
+ Assert.True(reported.Single() is UriFormatException, reported.Single().GetType().Name);
+ Assert.Equal(UpdateState.DownloadFailed, flow.State);
+ Assert.True(flow.Check.CanExecute(null));
+ Assert.True(flow.Download.CanExecute(null));
+ }
+
+ [Test]
+ public async Task CancellingADownloadOffersItAgain()
+ {
+ var host = new Host { Stall = true };
+ var flow = host.Flow();
+ flow.SetResult(Release(withSetup: true, withZip: false, withSums: true));
+ flow.Download.Execute(null);
+ await host.Started.Task.WaitAsync(TimeSpan.FromSeconds(10));
+ Assert.Equal(UpdateState.Downloading, flow.State);
+ Assert.False(flow.Check.CanExecute(null));
+
+ flow.CancelDownload();
+ await WaitAsync(flow.Download);
+ Assert.Equal(UpdateState.Available, flow.State);
+ Assert.True(flow.IsDownloadOffered);
+ Assert.True(flow.Check.CanExecute(null));
+ }
+
+ private static ReleaseInfo Release(bool withSetup, bool withZip, bool withSums)
+ {
+ const string Base = "https://github.com/o/r/releases/download/v1.0.0/";
+ var assets = new List();
+ if (withSetup) assets.Add(new ReleaseAsset("Titano-Setup-1.0.0.exe", Base + "Titano-Setup-1.0.0.exe", 1000));
+ if (withZip) assets.Add(new ReleaseAsset("Titano-win-x64-portable-1.0.0.zip", Base + "Titano-win-x64-portable-1.0.0.zip", 900));
+ if (withSums) assets.Add(new ReleaseAsset("SHA256SUMS", Base + "SHA256SUMS", 300));
+ return new ReleaseInfo(new Version(1, 0, 0), "v1.0.0", Page) { Assets = assets };
+ }
+
+ private static async Task RunAsync(AsyncRelayCommand command)
+ {
+ command.Execute(null);
+ await WaitAsync(command);
+ }
+
+ private static async Task WaitAsync(AsyncRelayCommand command)
+ {
+ for (var i = 0; i < 500 && command.IsRunning; i++) await Task.Delay(10);
+ Assert.False(command.IsRunning, "the command did not finish");
+ }
+
+ private sealed class Host
+ {
+ public bool IsCapture { get; init; }
+ public bool IsPortable { get; init; }
+ public Exception? Failure { get; init; }
+ public bool Stall { get; init; }
+ public string Downloaded { get; init; } = "Titano-Setup-1.0.0.exe";
+ public int Checks { get; private set; }
+ public int Downloads { get; private set; }
+ public List Opened { get; } = [];
+ public List Revealed { get; } = [];
+ public TaskCompletionSource Started { get; } = new(TaskCreationOptions.RunContinuationsAsynchronously);
+
+ public UpdateFlow Flow() => new(new UpdateHost(new Version(0, 9, 0), IsCapture, IsPortable,
+ _ =>
+ {
+ Checks++;
+ return Task.FromResult(Release(withSetup: true, withZip: true, withSums: true));
+ },
+ async (_, _, ct) =>
+ {
+ Downloads++;
+ Started.TrySetResult();
+ if (Stall) await Task.Delay(Timeout.Infinite, ct);
+ await Task.Yield();
+ return Failure is null ? Downloaded : throw Failure;
+ },
+ Opened.Add, Revealed.Add));
+ }
+}