Gorący restart (Hot Restart) w programowaniu mobilnym — istota, mechanizm i zasada działania

Co to jest gorący restart (Hot Restart)?

Gorący restart (Hot Restart) to mechanizm programistyczny, w którym aplikacja jest całkowicie przeładowywana ze zaktualizowanym kodem źródłowym bez konieczności pełnej rekompilacji projektu. Programista wprowadza zmiany w kodzie, zapisuje plik i przez IDE wysyła polecenie restartu. Aplikacja rekompiluje zmienione pliki, restartuje Dart VM i przechodzi od nowa przez cały cykl życia od main do końcowego renderowania interfejsu użytkownika.

Hot Restart różni się od pełnej przebudowy tym, że wykorzystuje już skompilowane biblioteki binarne i framework Flutter bez rekompilacji natywnych otoczek. Skraca to czas cyklu programowania z kilku minut do kilku sekund. Według ankiety wśród programistów Flutter (2024), średni czas Hot Restart wynosi 2,1 sekundy, co jest około 97% szybsze niż pełna przebudowa projektu przez polecenie flutter build.

Mechanizm jest szczególnie poszukiwany przy tworzeniu interfejsów użytkownika, gdzie wymagane jest częste sprawdzanie zmian wizualnych. Programista może zmienić kolor, rozmiar lub położenie elementu i natychmiast zobaczyć wynik na symulatorze lub fizycznym urządzeniu, nie tracąc kontekstu programowania na długą kompilację. To radykalnie przyspiesza iteracyjne prototypowanie.

Jak działa mechanizm Hot Restart?

Podczas wykonywania polecenia Hot Restart następuje sekwencja operacji: zapis zmienionych plików, inkrementalna kompilacja zmienionych plików Dart do kodu maszynowego, restart Dart VM i ponowne wykonanie punktu wejścia aplikacji. Dart VM to maszyna wirtualna wykonująca kod Dart w trybie JIT (Just-In-Time) podczas programowania i AOT (Ahead-Of-Time) w kompilacjach produkcyjnych.

Cykl życia przy gorącym restarcie

Przy Hot Restart aplikacja przechodzi pełny cykl życia: wywołanie funkcji main, inicjalizacja WidgetsFlutterBinding, uruchomienie runApp i zbudowanie całego drzewa widgetów od zera. Wszystkie poprzednie stany widgetów, zmienne i pamięci podręczne są czyszczone. Gwarantuje to, że aplikacja znajduje się w czystym stanie, w pełni identycznym ze stanem po świeżej instalacji na urządzeniu.

Proces można przedstawić jako sekwencję kroków: programista naciska przycisk Hot Restart w IDE, narzędzia Flutter wysyłają polecenie na urządzenie, urządzenie zapisuje bieżący szkielet aplikacji, restartuje Dart VM z nowym kodem i uruchamia main od nowa. Wszystkie zależności zarejestrowane w kontenerze wstrzykiwania zależności są tworzone od nowa.

Kluczowa cecha — kod binarny natywnej otoczki (wtyczki, kod Kotlin, kod Swift) nie jest rekompilowany. Hot Restart dotyczy tylko warstwy Dart aplikacji, co zapewnia wysoką szybkość restartu. Jeśli zmiany dotyczą kodu natywnego, wymagane jest pełne uruchomienie flutter build.

Implementacja techniczna we Flutter

Flutter wykorzystuje architekturę, w której kod Dart jest wykonywany na Dart VM, a UI jest renderowane przez silnik Skia lub Impeller. Przy Hot Restart narzędzia Flutter restartują izolowany egzemplarz Dart VM (isolate), ładują zaktualizowane pliki .dill (Dart Intermediate Language) i ponownie uruchamiają funkcję main. Cały UI jest budowany od nowa przez wywołanie runApp, co gwarantuje aktualność wszystkich widgetów.

import 'package:flutter/material.dart';

void main() {
  // Po Hot Restart ta funkcja jest wykonywana ponownie
  var prefs = await SharedPreferences.getInstance();
  var themeMode = prefs.getString('theme') ?? 'light';
  runApp(MyApp(themeMode: themeMode));
}

Hot Restart vs Hot Reload: kluczowe różnice

Hot Restart i Hot Reload to dwa mechanizmy przyspieszonego programowania, które często są mylone. Hot Reload ładuje zmiany w działającej aplikacji bez utraty bieżącego stanu, a Hot Restart całkowicie restartuje aplikację. Hot Reload działa szybciej (0,1–1 sekunda), ale nie stosuje zmian dotyczących inicjalizacji lub statycznych pól klasy.

Zachowanie stanu aplikacji

Główna różnica — stan aplikacji. Hot Reload zachowuje bieżący stan widgetów: pozycję przewijania, wprowadzone dane, otwarte okna modalne. Hot Restart resetuje cały stan do początkowego. Jeśli zmiana dotyczy tylko kodu w metodzie build, wystarczy Hot Reload. Jeśli zmiana dotyczy main, zmiennych globalnych lub zależności — wymagany jest Hot Restart.

Hot Reload stosuje zmiany przez wstrzyknięcie zaktualizowanego kodu do Dart VM bez restartowania isolate. Jest to możliwe tylko dla zmian, które nie naruszają struktury typów i nie wymagają ponownej inicjalizacji widgetów. Przy Hot Restart isolate jest restartowany całkowicie, co pozwala zastosować dowolne zmiany, w tym usuwanie lub zmiana nazw klas i metod.

Wydajność i scenariusze

Według zespołu Flutter, Hot Reload trwa mniej niż 1 sekundę dla większości zmian, podczas gdy Hot Restart — od 1 do 3 sekund. Dla około 80% zmian interfejsu użytkownika wystarczy Hot Reload. Hot Restart jest wymagany przy zmianie konfiguracji aplikacji, zmiennych globalnych, natywnych wtyczek w otoczce Dart i rozwiązań architektonicznych.

Zalecana jest następująca strategia: używaj Hot Reload dla poprawek wizualnych UI i drobnych zmian logiki; przełączaj się na Hot Restart przy zmianie struktury danych, dodawaniu zależności lub poprawianiu kodu inicjalizacji. Minimalizuje to czas oczekiwania i utrzymuje produktywność programowania na wysokim poziomie.

Implementacja Hot Restart w popularnych frameworkach

Mechanizm gorącego restartu jest zaimplementowany różnie w zależności od frameworka i języka programowania. Flutter zapewnia najbardziej dojrzałą implementację Hot Restart przez kompilację JIT Dart VM, a React Native używa podobnego mechanizmu przez Metro Bundler i JavaScript Core lub Hermes.

Hot Restart we Flutter

We Flutter Hot Restart jest aktywowany poleceniem r w terminalu po uruchomieniu aplikacji przez flutter run. Alternatywnie — przycisk Hot Restart w Android Studio, VS Code lub IntelliJ IDEA. Hot Restart działa tylko w trybie debug i jest niedostępny w kompilacjach profile i release. Podczas wykonywania narzędzia Flutter rekompilują zmienione pliki do formatu kernel i wysyłają je na urządzenie.

// Przed Hot Restart: stara wersja
class Counter extends StatefulWidget {
  final int initialValue = 0;
  // Po Hot Restart: nowa wartość wejdzie w życie
  // final int initialValue = 10;
}

class CounterState extends State<Counter> {
  int _count = 0;
  // Hot Reload zachowa _count, Hot Restart zresetuje do 0
}

Ograniczenie Hot Restart we Flutter — niemożność zachowania stanu debugowania. Po restarcie wszystkie punkty przerwania są zachowane, ale wartości zmiennych w debuggerze są resetowane. Do zachowania stanu między restartami używane są mechanizmy zapisywania stanu aplikacji State Restoration.

Hot Restart w React Native

W React Native gorący restart jest zaimplementowany przez Metro Bundler — narzędzie do budowania modułów JavaScript. Przy zmianie kodu Metro przebudowuje zmienione moduły i wysyła zaktualizowany bundle na urządzenie. React Native obsługuje Fast Refresh — odpowiednik Hot Reload, który zachowuje stan komponentów funkcyjnych za pomocą hooków React.

Pełny restart (Reload) w React Native przeładowuje silnik JavaScript i całą aplikację w całości. Jest to w pełni analogiczne do Hot Restart we Flutter. Do uruchomienia używana jest kombinacja Cmd+R na symulatorze iOS lub podwójne naciśnięcie R na Androidzie. Czas pełnego restartu w React Native waha się od 2 do 8 sekund w zależności od rozmiaru bundle.

Kiedy stosować Hot Restart w programowaniu

Hot Restart to niezastąpione narzędzie w wielu scenariuszach programowania. Pierwszy i najbardziej oczywisty — zmiana globalnej konfiguracji aplikacji: motywów, lokalizacji, dostawców stanu. Jeśli zmieniłeś dostawcę w korzeniu drzewa widgetów lub dodałeś nowy moduł do kontenera DI, Hot Restart gwarantuje poprawną inicjalizację wszystkich komponentów.

Drugi scenariusz — zmiana zmiennych statycznych i stałych. W Dart pola statyczne są inicjalizowane raz przy ładowaniu klasy. Hot Reload nie stosuje zmian pól statycznych, dlatego do ich aktualizacji wymagany jest Hot Restart. Jest to szczególnie istotne przy pracy z konfiguracyjnymi stałymi, adresami URL API i flagami funkcji.

Trzeci scenariusz — debugowanie inicjalizacji: sprawdzanie działania funkcji main, ekranu powitalnego, ładowania zależności. Przy każdym Hot Restart aplikacja przechodzi pełny cykl inicjalizacji, co pozwala wykryć błędy występujące tylko przy starcie — problemy z SharedPreferences, błędy połączenia z bazą danych, timeouty inicjalizacji.

Czwarty scenariusz — testowanie pustego stanu. Hot Restart resetuje cały stan aplikacji, co pozwala sprawdzić zachowanie przy pierwszym uruchomieniu: wyświetlanie onboardingu, żądanie uprawnień, puste listy i placeholderów. Do powtarzalnego testowania jest to znacznie szybsze niż ponowna instalacja aplikacji.