Kompilacja AndroidAPS (AAPS) przy użyciu Android Studio to proces, który wymaga precyzji, ale jest w pełni wykonalny krok po kroku. Pamiętaj, że ze względów bezpieczeństwa i prawnych, oficjalna wersja nie jest dostępna jako gotowy plik .apk – każdy użytkownik musi zbudować ją samodzielnie.
Wersja Android Studio Panda 2 (2026.1.1) posiada odświeżony interfejs, więc poniższa instrukcja uwzględnia specyficzne rozmieszczenie przycisków w tej edycji.
Proces kompilacji AndroidAPS (AAPS) dzieli się na trzy główne etapy: przygotowanie kodu, konfigurację środowiska oraz samo budowanie pliku APK.
Krok 1: Pobranie kodu źródłowego (Git)
Zanim otworzysz Android Studio, musisz mieć lokalną kopię kodu.
- Upewnij się, że masz zainstalowany program Git.
- Otwórz folder, w którym chcesz trzymać projekt. Kliknij prawym przyciskiem myszy i wybierz „Git Bash Here” (lub otwórz terminal).
- Wpisz komendę: git clone https://github.com/nightscout/AndroidAPS.git
- Poczekaj, aż proces dobiegnie końca (100%).
Krok 2: Pierwsze uruchomienie w Android Studio Panda 2
- Otwórz Android Studio. Na ekranie powitalnym kliknij Open.
- Wskaż folder, do którego przed chwilą pobrałeś kod (ikonka folderu powinna mieć mały symbol Androida).
- Kluczowy moment: Po otwarciu, w prawym dolnym rogu zobaczysz pasek postępu „Gradle Sync”.
- Nic nie klikaj, dopóki ten pasek nie zniknie. Program pobiera teraz ok. 1-2 GB bibliotek i narzędzi (tzw. SDK i Build Tools).
- Jeśli wyskoczy okno „Trust Project?”, kliknij Trust Project.
Krok 3: Konfiguracja wariantów budowania
Domyślnie Android Studio chce zbudować wersję testową (debug), która nie nadaje się do codziennego użytku.
- W nowym interfejsie Panda 2, kliknij w menu View -> Tool Windows -> Build Variants (lub znajdź ikonkę kwadratu z trybikiem po lewej stronie pionowego paska).
- W oknie, które się pojawi, znajdziesz tabelę. W rzędzie app zmień wartość w kolumnie Active Build Variant z debug na fullRelease.
- Czekaj – program ponownie przeładuje konfigurację dla pełnej wersji.
Krok 4: Generowanie klucza podpisu (Keystore)
System Android wymaga, aby każda aplikacja była podpisana przez autora. Ponieważ Ty jesteś „autorem” tej kompilacji, musisz stworzyć własny klucz.
- W górnym menu wybierz: Build -> Generate Signed Bundle / APK…
- Zaznacz APK i kliknij Next.
- Przy polu Key store path kliknij Create new…:
- Path: Wybierz folder (np. Dokumenty) i nadaj nazwę plikowi (np. moj_klucz.jks).
- Password: Wpisz bezpieczne hasło (zapamiętaj je!).
- Alias: Możesz zostatwić key0.
- Validity (years): Wpisz 25.
- Certificate: Wypełnij przynajmniej jedno pole (np. First and Last Name).
- Kliknij OK, a potem Next.
Krok 5: Finalna kompilacja
- W oknie „Generate Signed APK” upewnij się, że zaznaczony jest wariant fullRelease.
- Zaznacz obie opcje podpisów (jeśli są widoczne): V1 (Jar Signature) oraz V2 (Full APK Signature).
- Kliknij Create (lub Finish).
Krok 6: Instalacja na telefonie
- Kompilacja potrwa od 2 do 10 minut (zależnie od procesora).
- Gdy zobaczysz dymek „Generate Signed APK: APK(s) generated successfully”, kliknij w nim niebieski napis locate.
- Otworzy się folder w Windows Explorer. Plik, którego szukasz, to zazwyczaj app-full-release.apk.
- Prześlij ten plik na telefon (przez kabel USB, Google Drive lub Telegram) i uruchom go na smartfonie, aby zainstalować aplikację.
Rozwiązywanie problemów (Troubleshooting):
Błąd „Java version mismatch”: W Panda 2 wejdź w Settings -> Build, Execution, Deployment -> Build Tools -> Gradle. Sprawdź pole Gradle JDK – powinno być ustawione na wersję 17 lub wyższą (zazwyczaj dostarczoną z Android Studio).
Błąd „SDK not found”: Wejdź w Settings -> Languages & Frameworks -> Android SDK i upewnij się, że masz zainstalowaną najnowszą wersję Androida (np. Android 14 lub 15).
