Převod souboru ZIP do AAR

Android library může být distribuována jako ZIP, i když Android Studio nebo Gradle vyžaduje závislost AAR. Požadovaným krokem je buď znovu sestavit projekt knihovny, nebo ověřit, zda ZIP již má strukturu AAR; změna přípony .zip na .aar obvykle nepředstavuje konverzi.

Co je formát ZIP

ZIP je univerzální archivní formát pro sdružování a komprimaci souborů. Vývojáři jej používají pro zdrojové projekty Androidu, balíčky SDK, ukázkový kód, zkompilované soubory a distribuční balíčky; Windows, macOS, Linux, 7-Zip a buildovací systémy jej mohou vytvářet i rozbalovat.

ZIP nepředepisuje žádnou strukturu adresářů specifickou pro Android. Před výběrem metody konverze archiv prozkoumejte: může obsahovat kompletní projekt Gradle, již zabalenou knihovnu, zdrojové soubory nebo nesouvisející soubory.

Co je formát AAR

AAR neboli Android Archive je formát balíčku vytvářený pro modul knihovny Androidu. Android Gradle Plugin a Android Studio jej mohou používat jako lokální závislost a Maven repository jej může distribuovat spolu s doprovodnými metadaty.

AAR je technicky soubor ZIP se strukturou knihovny Androidu. Běžný AAR obsahuje AndroidManifest.xml, classes.jar, res/ a R.txt; může také obsahovat assets/, jni/, libs/, prefab/, public.txt, proguard.txt, lint.jar a další podporované položky. Může obsahovat zkompilovaný bytecode Java nebo Kotlin, zdroje Androidu, deklarace manifestu, nativní knihovny a pravidla R8 nebo ProGuard pro uživatele knihovny. Na rozdíl od běžného JAR může obsahovat zdroje Androidu a nativní komponenty.

Jak převést ZIP obsahující projekt knihovny

1. Rozbalte ZIP pomocí 7-Zip, systémového nástroje pro práci s archivy nebo Android Studio. Najděte settings.gradle nebo settings.gradle.kts a modul obsahující build.gradle nebo build.gradle.kts.
2. Ověřte, že cílový modul používá plugin knihovny Androidu, například com.android.library, nikoli com.android.application. Neměňte modul aplikace na knihovnu bez kontroly jeho manifestu, závislostí a konfigurace sestavení.
3. Otevřete rozbalený projekt v Android Studio, nainstalujte verze SDK a build-tools požadované projektem a nechte dokončit synchronizaci Gradle. Před sestavením vyřešte chybějící repository, pluginy a závislosti.
4. Sestavte release variantu v Android Studio pomocí Build → Make Project nebo spusťte úlohu modulu z adresáře projektu:

./gradlew :library:assembleRelease

V systému Windows spusťte gradlew.bat :library:assembleRelease. Nahraďte library skutečným názvem modulu. Výstup se obvykle nachází v library/build/outputs/aar/, například jako library-release.aar. Úlohu debug použijte pouze v případě, že je vyžadován debug AAR.

Jak naložit se ZIPem, který již je AAR

Otevřete archiv pomocí 7-Zip nebo jiného nástroje pro práci s archivy a prozkoumejte jeho nejvyšší úroveň. Pokud obsahuje strukturu AAR včetně AndroidManifest.xml, classes.jar, res/ a R.txt, mohla mu být přiřazena nesprávná přípona. Vytvořte kopii a přejmenujte ji:

mv library.zip library.aar

V systému Windows:

ren library.zip library.aar

Pokud jsou soubory vnořené v dalším adresáři, zabalte obsah znovu tak, aby se tyto položky nacházely v kořenu archivu. Přejmenování ani opětovné zabalení nezkompiluje zdrojový kód, nezpracuje zdroje, nevygeneruje R.txt ani nepřidá manifest. Výsledný AAR otestujte v malé aplikaci Android.

Jak naložit se zdrojovými nebo libovolnými soubory

ZIP obsahující pouze soubory .java, .kt, .class, dokumenty nebo libovolné složky nelze spolehlivě převést pomocí konvertoru archivů. Vytvořte nebo otevřete modul knihovny Androidu, umístěte zdrojový kód do src/main/java/ nebo src/main/kotlin/, zdroje do src/main/res/, assets do src/main/assets/, nakonfigurujte manifest a závislosti a spusťte assembleRelease.

Nativní soubory musí používat očekávané adresáře ABI, například src/main/jniLibs/arm64-v8a/. Android Gradle Plugin musí zkompilovat kód a zdroje; obecný nástroj pro práci se ZIP nemůže tyto kroky provést.

Desktopové a online nástroje

Android Studio s Gradle je vhodnou desktopovou možností, pokud ZIP obsahuje zdrojový kód nebo projekt Gradle. 7-Zip, Finder, File Explorer a nástroje příkazového řádku unzip nebo zip jsou vhodné pro kontrolu a jednoduché opětovné zabalení.

Online služby pro práci s archivy, jako CloudConvert nebo Zamzar, mohou podporovat obecné opětovné zabalení ZIP nebo konverzi přípony, ale nedokážou vyřešit závislosti Androidu ani sestavit AAR. Online službu použijte pouze pro archiv bez důvěrných údajů, který již obsahuje správný obsah AAR; nenahrávejte proprietární zdrojový kód, SDK, podpisové materiály ani soukromé knihovny.

Kontroly kompatibility

Před distribucí výsledku otevřete AAR jako ZIP a ověřte jeho manifest, classes.jar, zdroje, nativní knihovny, assets a pravidla pro uživatele knihovny. Otestujte jej s verzí Android Gradle Plugin, compile SDK, verzí Kotlin a podporovanými ABI zařízení používanými projektem, který knihovnu využívá.

AAR automaticky nezabalí každou externí Maven dependency. Uživatelé možná budou muset tyto závislosti deklarovat samostatně a lokální file dependency neposkytuje metadata závislostí, která poskytuje Maven publication. Přidejte lokální AAR pomocí Gradle dependency, například implementation files('libs/library-release.aar'), nebo publikujte AAR do Maven repository spolu s jeho POM a module metadata.