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 | |
| 25 | use adw::prelude::*; |
| 26 | |
| 27 | /// Запускает фоновую проверку и, если нашлась не показанная раньше версия, |
| 28 | /// шлёт одно системное уведомление. |
| 29 | pub 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 | /// Найденное обновление. |
| 68 | struct Found { |
| 69 | version: String, |
| 70 | released_at: String, |
| 71 | /// Про эту версию ещё не говорили системным уведомлением. |
| 72 | first_time: bool, |
| 73 | } |
| 74 | |
| 75 | /// Считает, есть ли о чём сообщить. `None` — сообщать нечего или что-то не |
| 76 | /// сложилось; и то и другое означает молчание. |
| 77 | fn 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 | /// трея. Второго способа туда попасть не появилось. |
| 127 | fn 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(¬ification_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"), ¬ification); |
| 149 | } |
| 150 | |
| 151 | /// Текст уведомления. Отдельной функцией от [`notify`] ровно для того, чтобы |
| 152 | /// его можно было проверить тестом, не поднимая GTK-приложение — тот же |
| 153 | /// приём, что у `wine_update_check::notification_body`. |
| 154 | fn notification_body(current: &str, new: &str, released_at: &str) -> String { |
| 155 | format!("{current} → {new} (выпущена {released_at}). Нажми, чтобы посмотреть, что изменилось.") |
| 156 | } |
| 157 | |
| 158 | #[cfg(test)] |
| 159 | mod 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 |