Konwertuj TGZ na APK

Urządzenie z Androidem akceptuje plik APK, a nie TGZ, dlatego plik TGZ może wymagać przetworzenia, gdy aplikacja została dostarczona jako archiwum lub projekt Android musi wygenerować pakiet instalacyjny. Prawidłową operacją jest ekstrakcja oraz, w razie potrzeby, kompilacja; zmiana rozszerzenia nazwy pliku nie konwertuje pliku.

Czym jest format TGZ

TGZ to archiwum tar skompresowane za pomocą gzip, zapisywane również jako .tar.gz. Narzędzia Unix i Linux, repozytoria kodu źródłowego, systemy kompilacji oraz procesy tworzenia aplikacji na Androida używają go do pakowania katalogów z zachowaniem ścieżek oraz, jeśli jest to obsługiwane, uprawnień.

Plik TGZ w kontekście tworzenia aplikacji mobilnych może zawierać projekt Android Studio z plikiem settings.gradle lub settings.gradle.kts, pliki kompilacji Gradle, gradlew, plik AndroidManifest.xml, kod źródłowy, zasoby i biblioteki natywne. Może też zawierać gotowy plik APK lub niezwiązane pliki. Rozszerzenie archiwum nie identyfikuje jego zawartości.

Czym jest format APK

APK to instalowalny pakiet aplikacji systemu Android. Jest to pakiet oparty na formacie ZIP, zawierający skompilowany kod aplikacji, zasoby, manifest, opcjonalne biblioteki natywne oraz dane podpisu Android. Menedżer pakietów Android sprawdza przed instalacją podpis APK, żądane uprawnienia, wymagania dotyczące minimalnej i docelowej wersji SDK, zasady urządzenia oraz zgodną architekturę procesora.

APK jest wynikiem kompilacji, a nie archiwum projektu Android. Android Gradle Plugin kompiluje kod źródłowy i zasoby, pakuje je oraz podpisuje wynik. Dlatego archiwum zawierające kod źródłowy musi zostać skompilowane; archiwum zawierające istniejący plik APK wymaga jedynie ekstrakcji. Pliki APK umożliwiają bezpośrednie testowanie i instalację sideloading, w tym instalację offline, jednak publikacja w Play Store zazwyczaj korzysta zamiast tego z Android App Bundle (.aab).

Jak przetworzyć plik TGZ zawierający APK

1. Wyodrębnij zawartość TGZ za pomocą narzędzia desktopowego, takiego jak 7-Zip lub PeaZip, albo z użyciem wiersza poleceń:

tar -xzf package.tgz -C extracted

2. Wyszukaj w wyodrębnionym katalogu pliki kończące się rozszerzeniem .apk. Sprawdź nazwę i lokalizację pliku, aby wybrać odpowiedni wariant, na przykład debug, release lub kompilację przeznaczoną dla konkretnego urządzenia.
3. Skopiuj APK na urządzenie i otwórz go albo zainstaluj go za pomocą Android Debug Bridge:

adb install path/to/app-release.apk

Podczas instalacji sideloading za pomocą menedżera plików włącz instalowanie z odpowiedniego ustawienia dotyczącego nieznanych źródeł i nie instaluj pliku APK z niezaufanego źródła. Jeśli menedżer pakietów odrzuci plik, sprawdź podpis, wersję Androida, architekturę procesora, zasady urządzenia oraz to, czy nie istnieje już inna instalacja z innym kluczem podpisu.

Przywróć rozszerzenie .apk tylko wtedy, gdy plik faktycznie jest APK, którego nazwa została zmieniona. TGZ to skompresowane za pomocą gzip dane TAR; zmiana jego nazwy na .apk nie uczyni go instalowalnym. Prawdziwy plik APK jest oparty na formacie ZIP i można go rozpoznać po strukturze pliku lub otwierając go za pomocą narzędzia do archiwów, jednak sama zmiana nazwy nie powinna służyć do omijania mechanizmów bezpieczeństwa.

Jak zbudować APK z projektu Android

1. Zainstaluj Android Studio, wersję JDK wymaganą przez Android Gradle Plugin projektu oraz wymagane przez niego komponenty Android SDK. Wyodrębnij plik TGZ do katalogu z prawem zapisu.
2. Otwórz wyodrębniony projekt w Android Studio za pomocą File → Open. Wybierz katalog zawierający settings.gradle lub settings.gradle.kts, a nie sam plik TGZ.
3. Poczekaj na zakończenie synchronizacji Gradle. Zainstaluj żądane platformy SDK i narzędzia kompilacji oraz rozwiąż zależności z repozytoriów zadeklarowanych przez projekt. Projektu z brakującymi plikami źródłowymi, niedostępnymi prywatnymi zależnościami lub niezgodnymi wersjami Gradle i pluginu nie można skompilować bez modyfikacji.
4. Aby wykonać kompilację testową, wybierz Build → Generate App Bundles or APKs → Generate APKs i wybierz wymagany moduł oraz wariant. Android Studio zazwyczaj umieszcza wynik w katalogu app/build/outputs/apk/, chociaż nazwa modułu i warianty produktu mogą zmienić tę ścieżkę.
5. W celu dystrybucji użyj Build → Generate App Bundles or APKs → Generate Signed App Bundle or APK, wybierz APK i podpisz wariant release za pomocą prywatnego magazynu kluczy. Przechowuj magazyn kluczy i hasła oddzielnie od pliku TGZ oraz repozytorium kodu źródłowego.

Odpowiednie polecenia Gradle, uruchamiane z katalogu projektu, to:

./gradlew assembleDebug
./gradlew assembleRelease

W systemie Windows użyj polecenia gradlew.bat assembleDebug lub gradlew.bat assembleRelease. Projekty z wariantami mogą wymagać zadania takiego jak assembleFreeRelease; dostępne zadania wyświetlisz za pomocą ./gradlew tasks.

Wybór narzędzi online i desktopowych

7-Zip i PeaZip to odpowiednie narzędzia desktopowe do wyodrębniania plików TGZ. Android Studio wraz z wrapperem Gradle projektu jest właściwym lokalnym narzędziem kompilacji; użycie wrappera zachowuje wersję Gradle oczekiwaną przez projekt.

Nie istnieje niezawodny, ogólny konwerter TGZ do APK online: usługa internetowa nie jest w stanie określić, jak skompilować dowolny kod źródłowy, dostarczyć prywatnych zależności, wybrać zgodnych wersji SDK ani bezpiecznie utworzyć podpisu release. W przypadku kompilacji w chmurze usługa oparta na repozytorium, taka jak GitHub Actions lub Codemagic, może uruchomić kompilację Gradle projektu, jednak samodzielnie skonfiguruj przepływ pracy, SDK, zależności, sekrety podpisu i obsługę artefaktów. Nie przesyłaj zastrzeżonego kodu źródłowego ani magazynów kluczy do niezweryfikowanego konwertera.

Ograniczenia zgodności i jakości

Plik TGZ zawierający dowolne pliki, pliki binarne Linux, niekompletny kod źródłowy lub wyłącznie moduł biblioteki Android nie prowadzi automatycznie do uzyskania APK. Pomyślna kompilacja nie gwarantuje możliwości instalacji: pakiet może wymagać nowszej wersji Androida, nieobsługiwanego ABI, niedostępnego sprzętu, uprawnień zablokowanych przez zasady lub klucza podpisu kolidującego z już zainstalowaną wersją.

Pliki APK debug są podpisywane kluczem debug i są przeznaczone do testowania. Pliki APK release wymagają kontrolowanego klucza podpisu, a jego zmiana uniemożliwia aktualizację istniejącej instalacji podpisanej oryginalnym kluczem. Jeśli projekt obsługuje kilka architektur lub wersji Androida, utwórz odpowiednie warianty albo użyj udokumentowanej konfiguracji pakowania projektu.