Kompilacja AndroidAPS z zapisem na GitHUB

Oto kompletna, uporządkowana od A do Z instrukcja po polsku. Zebraliśmy w jednym miejscu wszystkie kroki, które do tej pory wykonaliśmy. Dzięki temu masz pełen przewodnik, z którego możesz skorzystać teraz lub przy kolejnych konfiguracjach.

CZĘŚĆ 1: Przygotowanie Twojego klucza (Base64 i Android Studio)

Zanim wejdziesz do przeglądarki, musisz wyciągnąć dane ze swojego komputera:

  1. Znajdź plik klucza: Upewnij się, że wiesz, gdzie na komputerze leży Twój plik .jks lub .keystore, którym podpisywałeś aplikację w Android Studio Panda.
  2. Podgląd Aliasu: Otwórz Android Studio -> menu Build -> Generate Signed Bundle / APK… -> Wybierz APK -> Wskaż swój plik klucza, wpisz hasło i kliknij w pole Key alias (ikonę trzech kropek ...), aby odczytać dokładną nazwę aliasu. Zapamiętaj ją lub zapisz. Zmknij okno przyciskiem Cancel.
  3. Konwersja do tekstu: Wejdź na stronę base64.guru/converter/encode/file, wgraj swój plik klucza, kliknij Encode File to Base64 i skopiuj wygenerowany gigantyczny ciąg tekstowy.

CZĘŚĆ 2: GitHub – Spięcie wszystkiego w całość

Przenosimy się na platformę GitHub, aby przygotować automatyzację.

Krok 1: Tworzenie własnej kopii (Fork) i włączenie Actions

  1. Wejdź na oficjalną stronę: github.com/nightscout/AndroidAPS (upewnij się, że jesteś zalogowany).
  2. W prawym górnym rogu kliknij przycisk Fork, a na dole nowej strony kliknij Create fork.
  3. Gdy otworzy się Twoje własne repozytorium, kliknij górną zakładkę Actions (Akcje) i kliknij zielony przycisk „I understand my workflows, go ahead and enable them”.

Krok 2: Wprowadzenie Sekretów (Hasła i Klucze)

  1. W Twoim repozytorium przejdź do zakładki Settings (Ustawienia) na górnym pasku.
  2. W menu po lewej stronie wejdź w Secrets and variables -> Actions.
  3. Klikaj zielony przycisk New repository secret i dodaj kolejno 6 sekretów:
Nazwa sekretu (Name)Co wkleić w pole Wartość (Secret)
SIGNING_KEYCały długi tekst Base64 z Twojego pliku klucza (z Części 1)
KEY_STORE_PASSWORDGłówne hasło do pliku klucza z Android Studio
ALIASDokładna nazwa aliasu (odczytana w Android Studio, np. key0)
KEY_PASSWORDHasło do aliasu (najczęściej takie samo jak do magazynu)

Krok 3: Stworzenie pliku instrukcji (skryptu budowania)

  1. Przejdź do pierwszej zakładki od lewej: Code (Kod).
  2. Kliknij przycisk Add file -> Create new file.
  3. W polu nazwy wpisz dokładnie: .github/workflows/build.yml
  4. W dużym polu tekstowym poniżej wklej poniższy, najnowszy kod (ze zmiennymi dostosowanymi do wymogów GitHuba):

YAML

name: Budowanie AndroidAPS i zapis na GitHUB

on:
  workflow_dispatch:

env:
  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Pobranie kodu z repozytorium
        uses: actions/checkout@v4

      - name: Konfiguracja Javy
        uses: actions/setup-java@v4
        with:
          distribution: 'zulu'
          java-version: '21'

      - name: Budowanie i podpisywanie aplikacji
        run: |
          echo "${{ secrets.SIGNING_KEY }}" | base64 -d > ${{ github.workspace }}/app/my-release-key.jks
          ./gradlew :app:assembleFullRelease \
            -x test \
            -Pandroid.lint.abortOnError=false \
            -Pandroid.lint.checkReleaseBuilds=false \
            -Pandroid.injected.signing.store.file=${{ github.workspace }}/app/my-release-key.jks \
            -Pandroid.injected.signing.store.password="${{ secrets.KEY_STORE_PASSWORD }}" \
            -Pandroid.injected.signing.key.alias="${{ secrets.ALIAS }}" \
            -Pandroid.injected.signing.key.password="${{ secrets.KEY_PASSWORD }}"

      - name: Zapisanie gotowego pliku APK na GitHubie
        uses: actions/upload-artifact@v4
        with:
          name: name: AndroidAPS-${{ github.ref_name }}
          path: app/build/outputs/apk/**/*.apk
          if-no-files-found: error
  1. Kliknij zielony przycisk Commit changes… w prawym górnym rogu i zatwierdź zapisanie.

CZĘŚĆ 4: Uruchomienie i każda kolejna aktualizacja

Gdy powyższa konfiguracja jest skończona, proces uruchamiasz zawsze w ten sam sposób:

  1. Wejdź na GitHub do swojego projektu -> zakładka Actions.
  2. Kliknij po lewej stronie „Budowanie AndroidAPS z zapisem na GitHUB”.
  3. Kliknij po prawej stronie przycisk Run workflow -> potwierdź zielonym przyciskiem.
  4. Po około 15 minutach proces zakończy się zielonym ptaszkiem, a gotowy plik .apk znajdziesz na swoim GitHUB w secji Artifacts. Pobierasz go bezpośrednio na telefon i instalujesz jako aktualizację.

Gdy w przyszłości wyjdzie nowa wersja AndroidAPS: Wchodzisz na główną stronę swojego kodu na GitHubie, klikasz przycisk Sync fork -> Update branch, a następnie od razu przechodzisz do zakładki Actions, aby kliknąć Run workflow. Cała aktualizacja zajmie Ci wtedy 30 sekund w przeglądarce!

Instrukcja aktualizacji AndroidAPS (Prywatne Repozytorium)

Ponieważ Twoje repozytorium jest prywatne, najwygodniejszą i najbardziej niezawodną metodą aktualizacji jest użycie GitHub Codespaces (wbudowanego terminala w przeglądarce). Nie musisz nic instalować na komputerze.

Krok 1: Otwarcie terminala w przeglądarce

  1. Wejdź na stronę główną swojego prywatnego repozytorium na GitHubie (np. github.com/TwojNick/AndroidAPS).
  2. Będąc na stronie głównej repozytorium, naciśnij na klawiaturze fizycznej klawisz kropki (.).
  3. Strona przeładuje się i otworzy się internetowy edytor kodu.
  4. Na samym dole ekranu znajdź zakładkę TERMINAL i kliknij w nią myszką, aby aktywować kursor (pojawi się migający znaczek za znakiem $).

Krok 2: Wykonanie komend aktualizacyjnych

Wpisuj w terminalu poniższe komendy po jednej, każdą zatwierdzając klawiszem Enter:

1. Pobranie najnowszych wersji z oficjalnego projektu:

Bash

git fetch upstream --tags

Gdy Git skończy pobieranie, wyświetli listę nowych wersji (tagów).

2. Scalenie nowego kodu z Twoim prywatnym:

Bash

git merge upstream/master --no-ff
  • Ważne: Po wpisaniu tej komendy Git poprosi o zatwierdzenie komunikatu. Na górze ekranu otworzy się nowa karta o nazwie MERGE_MSG. Zamknij tę kartę krzyżykiem X, aby proces scalania mógł się zakończyć. W terminalu linia poleceń znów musi zaczynać się od zielonego tekstu i znaku $.

3. Wysłanie zaktualizowanego kodu na Twój serwer GitHub:

Bash

git push origin master --tags

Ta komenda przesyła zaktualizowany kod. Na ekranie zobaczysz m.in. postęp procentowy i informację o przesłaniu nowego tagu (wersji).

Krok 3: Pobranie gotowej aplikacji (APK)

  1. Po wykonaniu ostatniej komendy możesz zamknąć kartę z edytorem i terminalem.
  2. Wróć do swojego głównego repozytorium na GitHubie i kliknij zakładkę Actions na górnym pasku.
  3. Na samej górze listy zobaczysz uruchomione zadanie (oznaczone pomarańczowym, kręcącym się kółkiem) – to serwer automatycznie buduje Twoją aplikację.
  4. Poczekaj około 10-15 minut, aż kółko zmieni się w zielony ptaszek.
  5. Kliknij w to ukończone zadanie, zjedź na sam dół strony do sekcji Artifacts i pobierz gotowy plik aplikacji.

Dodatkowa wskazówka:

Jeśli podczas wykonywania Kroku 2 (punkt 1) terminal wyświetli błąd fatal: remote upstream already exists, oznacza to, że oficjalne źródło jest już prawidłowo dodane i możesz bez obaw przejść od razu do kolejnych komend.

UZUPEŁNIENIE

Oto uzupełnienie do powyższego poradnika. Jeśli ktoś nigdy nie budował aplikacji lokalnie i nie posiada własnego pliku klucza (.jks), nie musi instalować Android Studio, aby go wygenerować. Można to zrobić bezpośrednio na komputerze za pomocą jednego polecenia.

Dopisz ten krok na samym początku CZĘŚCI 1 jako alternatywę:

Alternatywa dla Kroku 1: Generowanie nowego klucza od zera (Bez Android Studio)

Każdy komputer z systemem Windows, Mac lub Linux posiada wbudowane narzędzie keytool (jest ono częścią środowiska Java, które zazwyczaj jest już w systemie).

  1. Otwórz Terminal (Mac/Linux) lub Wiersz polecenia / PowerShell (Windows).
  2. Skopiuj, wklej i zatwierdź enterem poniższe polecenie:

Bash

keytool -genkey -v -keystore androidaps.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-key-alias
  1. System zada Ci kilka pytań:
    • Wprowadź hasło do magazynu kluczy: Wpisz swoje bezpieczne hasło (podczas wpisywania znaki nie będą się pojawiać – to normalne ze względów bezpieczeństwa). Naciśnij Enter.
    • Powtórz nowe hasło: Wpisz je ponownie.
    • Imię i nazwisko, sekcja, organizacja itp.: Możesz wpisać cokolwiek (np. swoje inicjały) lub po prostu naciskać Enter, aby pominąć te pytania.
    • Na koniec system zapyta, czy dane są poprawne ([nie] / [tak]). Wpisz tak (lub yes) i naciśnij Enter.
  2. Wynik: W folderze, w którym aktualnie znajdował się Twój terminal (najczęściej jest to folder użytkownika, np. C:\Users\TwojaNazwa\), pojawi się nowiutki plik o nazwie androidaps.jks.

Jak uzupełnić dane na GitHubie dla nowego klucza?

Gdy przejdziesz do uzupełniania tabeli z sekretami w CZĘŚCI 2 (Krok 2), Twoje dane z nowego klucza będą wyglądać następująco:

  • SIGNING_KEY -> Cały tekst Base64 wygenerowany z pliku androidaps.jks (za pomocą strony base64.guru).
  • KEY_STORE_PASSWORD -> Hasło, które sam przed chwilą wymyśliłeś w terminalu.
  • ALIAS -> Dokładnie: my-key-alias (ponieważ tak nazwaliśmy go w powyższym poleceniu).
  • KEY_PASSWORD -> Dokładnie takie samo hasło, jak do magazynu kluczy.

Ważne: Zapisz ten wygenerowany plik androidaps.jks w bezpiecznym miejscu (np. na pendrive lub bezpiecznym dysku). Jeśli kiedyś zmienisz telefon, będziesz potrzebować dokładnie tego samego pliku, aby zaktualizować aplikację bez utraty bazy danych cukrzycowych.

0
Chętnie poznam Twoje przemyślenia, skomentuj.x