📦 InstalacjaInstallation

Jak dodać ADict Library do projektuHow to add ADict Library to your project

📋 WymaganiaRequirements

WymaganieRequirementWersjaVersion
Android StudioArctic Fox+
Min SDK26
Target SDK36
Kotlin2.2.0
Gradle8.11.0

1️⃣ Dodaj repozytorium GitHub PackagesAdd GitHub Packages Repository

W pliku settings.gradle:

settings.gradle
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()

        // GitHub Packages dla ADict
        maven {
            url = uri("https://maven.pkg.github.com/nerdrip/adictlibrary")
            credentials {
                username = project.findProperty("gpr.user") ?: System.getenv("GITHUB_ACTOR")
                password = project.findProperty("gpr.token") ?: System.getenv("GITHUB_TOKEN")
            }
        }
    }
}

2️⃣ Dodaj zależnośćAdd Dependency

W build.gradle modułu app:In build.gradle of the app module:

build.gradle (Module: app)
dependencies {
    implementation "rip.nerd.adictlibrary:adictlibrary:1.6.0"

    // lub wersja SNAPSHOT (development):
    // implementation "rip.nerd.adictlibrary:adictlibrary:1.6.0-SNAPSHOT"
}
✅ To wszystko!That's it! Biblioteka zawiera wszystkie wymagane zależnościThe library includes all required dependencies (Firebase, BillingBilling, UMP, etc.) w pliku POM - zostaną automatycznie pobrane z artefaktemwill be automatically fetched with the artifact.

3️⃣ SkonfigurujConfigure local.properties

local.properties
gpr.user=TWOJA_NAZWA_GITHUB
gpr.token=TWÓJ_TOKEN_GITHUB
⚠️ Ważne⚠️ Important: Nigdy nie commituj tokenów do repozytorium!Never commit tokens to the repository!

Jak wygenerować token GitHubHow to Generate a GitHub Token

  1. Przejdź doGo to GitHub Settings → Tokens
  2. KliknijClick "Generate new token (classic)"
  3. Zaznacz uprawnieniaSelect permissions:
    • read:packages - pobieranie pakietów
    • write:packages - publikowanie (opcjonalne)
  4. Skopiuj token i wklej doCopy the token and paste it into local.properties

4️⃣ Uprawnienia wPermissions in AndroidManifest.xml

AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!-- Wymagane dla Firebase Analytics -->
<uses-permission android:name="android.permission.WAKE_LOCK"/>

5️⃣ Metadata wMetadata in AndroidManifest.xml

AndroidManifest.xml (wewnątrz <application>)AndroidManifest.xml (inside <application>)
<application>
    <!-- AdMob App ID (wymagane!) -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-XXXXXXXXXXXXXXXX~XXXXXXXXXX"/>

    <!-- Opcjonalnie: Remote Config defaults -->
    <meta-data
        android:name="com.google.firebase.remoteconfig.DEFAULT_VALUE_RESOURCE"
        android:resource="@xml/remote_config_defaults" />
</application>

✅ Zależności w zestawieBundled Dependencies

Biblioteka automatycznie pobiera następujące zależności:The library automatically fetches the following dependencies:

Nie musisz dodawać ich ręcznie!You don't need to add them manually!