📦 Instalacja

Jak dodać ADict Library do projektu

📋 Wymagania

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

1️⃣ Dodaj repozytorium GitHub Packages

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ść

W build.gradle modułu app:

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

    // lub wersja SNAPSHOT (development):
    // implementation "rip.nerd.adictlibrary:adictlibrary:1.5.0-SNAPSHOT"
}
✅ To wszystko! Biblioteka zawiera wszystkie wymagane zależności (Firebase, Billing, UMP, etc.) w pliku POM - zostaną automatycznie pobrane z artefaktem.

3️⃣ Skonfiguruj local.properties

local.properties
gpr.user=TWOJA_NAZWA_GITHUB
gpr.token=TWÓJ_TOKEN_GITHUB
⚠️ Ważne: Nigdy nie commituj tokenów do repozytorium!

Jak wygenerować token GitHub

  1. Przejdź do GitHub Settings → Tokens
  2. Kliknij "Generate new token (classic)"
  3. Zaznacz uprawnienia:
    • read:packages - pobieranie pakietów
    • write:packages - publikowanie (opcjonalne)
  4. Skopiuj token i wklej do local.properties

4️⃣ Uprawnienia w 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 w AndroidManifest.xml

AndroidManifest.xml (wewnątrz <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 zestawie

Biblioteka automatycznie pobiera następujące zależności:

Nie musisz dodawać ich ręcznie!