Przejdź do treści
Fyndi docs
English

Wydania APK#

Ta strona opisuje, skąd pobrać aplikację, jak powstaje nowe wydanie i dlaczego instaluje się „na wierzch” poprzedniego, bez utraty danych.

Skąd pobrać aplikację#

KanałGdzieKiedy używać
Aktualizacja w aplikacjiUstawienia → O aplikacjiNormalna droga: aplikacja sama sprawdza nowszą wersję i ją instaluje
Bezpośredni plik najnowszego wydaniahttps://fyndi.app/downloads/latest.apkGdy instalujesz na nowym telefonie albo nie chcesz czekać na sprawdzenie w aplikacji
Plik konkretnej wersjiarchiwum wydań w tej samej domenieGdy potrzebujesz cofnąć się do starszej wersji lub porównać zachowanie
Opis wydania w paneluPanel staff → WydaniaDla staffu: co jest w archiwum i co zobaczy telefon przy aktualizacji

Kanał dla użytkownika to jedno miejsce: katalog wydań pod domeną fyndi.app. Aplikacja czyta z niego manifest wydania, porównuje numer wersji i pobiera nowszy plik. Wersję i rozmiar aktualnego wydania widać też na żywo w stopce tej dokumentacji — są pobierane z serwera, więc po nowym wydaniu nie ma czego poprawiać w tekście.

Szczegóły instalacji i wymagania telefonu: Instalacja oraz Aktualizacje aplikacji. Instalacja ręczna z pliku: instalacja ręczna.

Jak powstaje wydanie#

Wydania budujemy i publikujemy na własnym serwerze, jednym poleceniem, bez pośrednictwa zewnętrznych usług budujących i bez workflow GitHub. Repozytorium jest miejscem na kod i znaczniki wersji — nie kanałem publikacji.

  1. Wersja rośnie w pliku wersji. android/app/build.gradle.kts trzyma listę par versionCode i versionName; do APK wchodzi para o najwyższym versionCode, a kolejność wpisów nie ma znaczenia. Numer nigdy się nie cofa i nigdy nie wraca.
  2. bash scripts/build_release_apk.sh robi całe wydanie. Uruchamia testy JVM (:core, :ar, :app), buduje wariant wydania i podpisuje plik kluczem wydania. Po drodze przechodzi własne bramki: podpis nie może być kluczem testowym, a w aplikacji muszą być wbudowane klucz ARCore i token Mapbox. Na końcu robi smoke ART na emulatorze (instalacja APK i start ekranu markerów AR) — VerifyError albo FATAL EXCEPTION w logu przerywa wydanie.
  3. Publikacja to jedna operacja. Skrypt kopiuje APK do katalogu wydań, przepisuje manifest.json (z sumą SHA-256) i latest.apk, nadaje tag vX.Y.Z na commicie wydania i sprawdza własne wydanie przez HTTPS — pobiera plik po publicznym adresie i porównuje rozmiar, sumę kontrolną oraz numer wersji odczytany z manifestu APK.
  4. Telefon widzi nową wersję przy następnym sprawdzeniu aktualizacji: Ustawienia → O aplikacji.

Przed budową emulator musi być wygaszony — serwer, na którym stoi produkcja, dzieli pamięć z buildem, a proces budujący nie zostawia po sobie działającego w tle demona.

Podpis i klucz wydania#

Aplikację podpisujemy kluczem wydania trzymanym tylko na serwerze — nigdy w repozytorium i nigdy w sekretach zewnętrznej usługi. Hasła do klucza czytane są z pliku o ograniczonym dostępie i nie są nigdzie wypisywane.

SprawaJak jest
Nazwa podmiotu w kluczuCN=Fyndi release
Od kiedy ten kluczOd pierwszych wydań publikowanych z naszego serwera; wcześniejsze wersje były podpisane kluczem o innej nazwie
Dlaczego to ważneTen sam podpis między wersjami sprawia, że nowa wersja instaluje się na wierzch starej — bez odinstalowywania i utraty postępów
WyjątekPrzy pierwszej instalacji po zmianie klucza system wymaga jednorazowego odinstalowania starszej aplikacji: Android nie nadpisze aplikacji innym podpisem
Kopia kluczaTrzymana także poza serwerem, żeby utrata jednej kopii nie zablokowała możliwości wydawania nowych wersji

Skrypt wydania wypisuje na końcu odcisk użytego klucza i sumę kontrolną pliku — to dwie liczby, którymi można sprawdzić, że opublikowany plik jest tym, który został zbudowany.

Numeracja wersji#

ElementZnaczenie
versionCode (liczba)Rośnie o 1 przy każdym wydaniu; po niej telefon rozstrzyga, że widzi nowszą wersję
versionName (nazwa)Wersja czytelna dla człowieka; tę wartość pokazuje ekran O aplikacji (Ustawienia → O aplikacji) i stopka tej dokumentacji
Tag vX.Y.ZZnacznik w repozytorium dla historii kodu — nadaje go skrypt wydania, nie uruchamia żadnego workflow
Wersja APINumerowana osobno od aplikacji; widać ją w stopce dokumentacji i w panelu

Pary versionCode / versionName leżą w jednym miejscu — w android/app/build.gradle.kts — i tylko jedna z nich trafia do APK: ta o najwyższym numerze. Numer wersji nigdy się nie cofa i nigdy nie wraca: nowe wydanie to zawsze numer wyższy od wszystkiego, co już wyszło. Jeden numer = jedno wydanie, więc ta sama liczba nigdy nie opisze dwóch różnych plików. Pilnuje tego bramka numeru (tools/ci/check-release-version.py): przed budową mówi, która para realnie wejdzie do pliku, i odmawia budowy, gdy w pliku jest para wyższa od budowanej albo numer cofa się względem manifestu; po budowie sprawdza numer w gotowym APK.

Drobne poprawki zbieramy w jedno wydanie: jedno nowe wydanie to komplet zmian z danego dnia, a nie osobne wydanie po każdej poprawce. Historia zmian napisana językiem użytkownika jest na stronie Historia zmian, a pełny zapis techniczny zostaje w repozytorium.


Opis zgodny z aplikacją 0.357.3 (zaktualizowano 2026-11-12).

Wersja aplikacji: 0.357.3 Wersja API: 0.73.0

docs.fyndi.app · 2026-11-12