Project Chimera
Меню

Исходники

180 строк · 11 КиБ

code/crates/chl-gui/src/launcher_update_check.rs

1//! Маленькая всплывашка «вышла новая версия лаунчера».
2//!
3//! Устроена по образцу `wine_update_check` — не «похоже», а буквально тем же
4//! способом: фоновая работа в `std::thread`, результат через канал в главный
5//! цикл GTK, системное `gio::Notification` с действием, открывающим нужный
6//! раздел, и память о показанном
7//! (`chl_core::wine_updates::NotifiedUpdates`), чтобы одно и то же
8//! обновление не превращалось в шум на каждом запуске. Второго механизма
9//! уведомлений в этом лаунчере нет и не заводится.
10//!
11//! Отличие от проверки сборок Wine ровно одно, и оно существенное: та читает
12//! локальный каталог, а эта **ходит в сеть**. Поэтому:
13//!
14//! - она выполняется только при включённой настройке
15//! `GlobalSettings::self_update_check` (см. её doc-комментарий: что
16//! отправляется, когда выключать, почему включена по умолчанию);
17//! - любая сетевая неудача — молчание, а не сообщение. Адрес по умолчанию
18//! внутренний (`*.chimera.local`), и вне LAN/VPN он просто не разрешается;
19//! ругаться на это при каждом запуске значило бы наказывать человека за
20//! то, что он не дома.
21//!
22//! Уведомление **ничего не ставит**. Оно доводит до раздела «Обновления»,
23//! где выбор из трёх: установить сейчас, потом, пропустить эту версию.
24
25use adw::prelude::*;
26
27/// Запускает фоновую проверку и, если нашлась не показанная раньше версия,
28/// шлёт одно системное уведомление.
29pub fn spawn(app: &adw::Application) {
30 let (sender, receiver) = std::sync::mpsc::channel();
31 std::thread::spawn(move || {
32 let _ = sender.send(check());
33 });
34
35 let app = app.clone();
36 // Пауза больше, чем у проверки сборок Wine (400 мс): там два файла с
37 // диска, здесь сетевой запрос, который может идти секунды или упасть по
38 // таймауту. Опрос каждые полсекунды, а не блокирующее ожидание, — тот же
39 // приём, и по той же причине: старт окна не должен ждать сеть.
40 gtk::glib::timeout_add_local(std::time::Duration::from_millis(500), move || {
41 match receiver.try_recv() {
42 Ok(Some(found)) => {
43 // Двумя способами об одном, но с разной настойчивостью.
44 //
45 // Полоса в окне показывается **каждый запуск**, пока
46 // обновление не поставлено: она не перебивает работу и
47 // ровно для того и нужна — чтобы новая версия не осталась
48 // незамеченной.
49 //
50 // Системное уведомление — только один раз на версию: оно
51 // всплывает поверх чужих окон, и приходить с этим на каждый
52 // запуск значит добиться того, что уведомления выключат
53 // целиком.
54 crate::window::show_update_banner(&found.version);
55 if found.first_time {
56 notify(&app, &found.version, &found.released_at);
57 }
58 gtk::glib::ControlFlow::Break
59 }
60 Ok(None) => gtk::glib::ControlFlow::Break,
61 Err(std::sync::mpsc::TryRecvError::Empty) => gtk::glib::ControlFlow::Continue,
62 Err(std::sync::mpsc::TryRecvError::Disconnected) => gtk::glib::ControlFlow::Break,
63 }
64 });
65}
66
67/// Найденное обновление.
68struct Found {
69 version: String,
70 released_at: String,
71 /// Про эту версию ещё не говорили системным уведомлением.
72 first_time: bool,
73}
74
75/// Считает, есть ли о чём сообщить. `None` — сообщать нечего или что-то не
76/// сложилось; и то и другое означает молчание.
77fn check() -> Option<Found> {
78 let dirs = chl_core::paths::Dirs::resolve().ok()?;
79 let settings = chl_core::global_settings::GlobalSettings::load(&dirs.global_settings());
80 if !settings.self_update_check {
81 return None;
82 }
83 let url = settings.update_feed_url.trim();
84 if url.is_empty() {
85 return None;
86 }
87
88 let release =
89 chl_selfupdate::feed::fetch(url, &chl_selfupdate::feed::Https::for_manifest()).ok()?;
90 match chl_selfupdate::manifest::offer(
91 &release,
92 chl_selfupdate::current_version(),
93 &settings.skipped_launcher_versions,
94 ) {
95 Ok(chl_selfupdate::manifest::Offer::Update) => {}
96 _ => return None,
97 }
98
99 // Та же память, что у уведомления о сборках Wine, только в своём файле:
100 // «об этой версии уже сказали» — иначе уведомление приходило бы на
101 // каждый запуск, пока человек не поставит обновление, и его выключили бы
102 // целиком.
103 let seen_path = dirs.launcher_updates_seen();
104 let mut seen = chl_core::wine_updates::NotifiedUpdates::load(&seen_path);
105 let fresh = seen.filter_new(&[(
106 chl_selfupdate::current_version().to_string(),
107 release.version.clone(),
108 )]);
109 let first_time = !fresh.is_empty();
110 if first_time {
111 // Не сохранилось — не беда: придёт лишнее уведомление о том же, это
112 // не потеря данных. Тот же выбор, что в `wine_update_check`.
113 let _ = seen.save(&seen_path);
114 }
115 // Возвращаем находку в любом случае, а не только в первый раз: полоса в
116 // окне обязана висеть, пока обновление не поставлено. Память о показанном
117 // теперь управляет только системным уведомлением.
118 Some(Found { version: release.version, released_at: release.released_at, first_time })
119}
120
121/// Одно системное уведомление, ведущее в раздел «Обновления».
122///
123/// Действие заводится тем же способом, что `app.open-wine` у проверки
124/// сборок: `SimpleAction` на приложении плюс `window::open_section` — то
125/// есть тот же путь, каким в этот раздел попадают из боковой панели и из
126/// трея. Второго способа туда попасть не появилось.
127fn notify(app: &adw::Application, version: &str, released_at: &str) {
128 if app.lookup_action("open-updates").is_none() {
129 let action = gtk::gio::SimpleAction::new("open-updates", None);
130 let app_for_action = app.clone();
131 action.connect_activate(move |_, _| {
132 crate::window::open_section(&app_for_action, "updates")
133 });
134 app.add_action(&action);
135 }
136
137 let notification = gtk::gio::Notification::new("Вышла новая версия Chimera-Launcher");
138 notification.set_body(Some(&notification_body(
139 chl_selfupdate::current_version(),
140 version,
141 released_at,
142 )));
143 notification.set_default_action("app.open-updates");
144 // Кнопка прямо в уведомлении — «ознакомиться», как и просили: ничего не
145 // ставит, а открывает раздел с описанием и выбором. Ставить из
146 // уведомления, минуя описание, было бы ровно тем, чего просили не делать.
147 notification.add_button("Посмотреть, что нового", "app.open-updates");
148 app.send_notification(Some("launcher-update"), &notification);
149}
150
151/// Текст уведомления. Отдельной функцией от [`notify`] ровно для того, чтобы
152/// его можно было проверить тестом, не поднимая GTK-приложение — тот же
153/// приём, что у `wine_update_check::notification_body`.
154fn notification_body(current: &str, new: &str, released_at: &str) -> String {
155 format!("{current} → {new} (выпущена {released_at}). Нажми, чтобы посмотреть, что изменилось.")
156}
157
158#[cfg(test)]
159mod tests {
160 use super::*;
161
162 #[test]
163 fn в_уведомлении_видно_обе_версии_и_дату() {
164 let body = notification_body("0.1.0", "0.2.0", "2026-09-08");
165 assert!(body.contains("0.1.0"));
166 assert!(body.contains("0.2.0"));
167 assert!(body.contains("2026-09-08"));
168 }
169
170 #[test]
171 fn уведомление_не_обещает_установку() {
172 // Проверка формулировки, а не текста дословно: уведомление обязано
173 // предлагать посмотреть, а не «обновить» — установку человек
174 // выбирает в разделе, из трёх вариантов.
175 let body = notification_body("0.1.0", "0.2.0", "2026-09-08");
176 assert!(body.contains("посмотреть"));
177 assert!(!body.to_lowercase().contains("устанавл"));
178 }
179}
180