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ł | Gdzie | Kiedy używać |
|---|---|---|
| Aktualizacja w aplikacji | Ustawienia → O aplikacji | Normalna droga: aplikacja sama sprawdza nowszą wersję i ją instaluje |
| Bezpośredni plik najnowszego wydania | https://fyndi.app/downloads/latest.apk | Gdy instalujesz na nowym telefonie albo nie chcesz czekać na sprawdzenie w aplikacji |
| Plik konkretnej wersji | archiwum wydań w tej samej domenie | Gdy potrzebujesz cofnąć się do starszej wersji lub porównać zachowanie |
| Opis wydania w panelu | Panel staff → Wydania | Dla 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.
- Wersja rośnie w pliku wersji.
android/app/build.gradle.ktstrzyma listę parversionCodeiversionName; do APK wchodzi para o najwyższymversionCode, a kolejność wpisów nie ma znaczenia. Numer nigdy się nie cofa i nigdy nie wraca. bash scripts/build_release_apk.shrobi 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) —VerifyErroralboFATAL EXCEPTIONw logu przerywa wydanie.- Publikacja to jedna operacja. Skrypt kopiuje APK do katalogu wydań, przepisuje
manifest.json(z sumą SHA-256) ilatest.apk, nadaje tagvX.Y.Zna 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. - 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.
| Sprawa | Jak jest |
|---|---|
| Nazwa podmiotu w kluczu | CN=Fyndi release |
| Od kiedy ten klucz | Od pierwszych wydań publikowanych z naszego serwera; wcześniejsze wersje były podpisane kluczem o innej nazwie |
| Dlaczego to ważne | Ten sam podpis między wersjami sprawia, że nowa wersja instaluje się na wierzch starej — bez odinstalowywania i utraty postępów |
| Wyjątek | Przy pierwszej instalacji po zmianie klucza system wymaga jednorazowego odinstalowania starszej aplikacji: Android nie nadpisze aplikacji innym podpisem |
| Kopia klucza | Trzymana 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#
| Element | Znaczenie |
|---|---|
| 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.Z | Znacznik w repozytorium dla historii kodu — nadaje go skrypt wydania, nie uruchamia żadnego workflow |
| Wersja API | Numerowana 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).