📦 Instalacja

KitsuneScript jest dostępny jako biblioteka Maven poprzez GitHub Packages.

Wymagania

Android SDK 21+ (Android 5.0 Lollipop)
Kotlin 1.8+
Gradle 7.0+

Krok 1: Konfiguracja repozytorium

Dodaj repozytorium GitHub Packages do swojego projektu. W pliku settings.gradle lub build.gradle (project-level):

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven {
            name = "GitHubPackages"
            url = uri("https://maven.pkg.github.com/nerdrip/kitsunescript")
            credentials {
                username = providers.gradleProperty("GITHUB_ACTOR")
                    .orElse(providers.environmentVariable("GITHUB_ACTOR"))
                    .getOrNull()
                password = providers.gradleProperty("GITHUB_TOKEN")
                    .orElse(providers.environmentVariable("GITHUB_TOKEN"))
                    .getOrNull()
            }
        }
    }
}
        

⚠️ Uwaga

GitHub Packages wymaga autentykacji nawet dla publicznych pakietów. Potrzebujesz Personal Access Token z uprawnieniem read:packages.

Krok 2: Dodanie zależności

W pliku app/build.gradle lub app/build.gradle.kts:

// build.gradle.kts
dependencies {
    implementation("rip.nerd.kitsunescript:kitsunescript:1.0.0")
}
        

Lub dla Groovy:

// build.gradle
dependencies {
    implementation 'rip.nerd.kitsunescript:kitsunescript:1.0.0'
}
        

Krok 3: Synchronizacja projektu

Zsynchronizuj projekt z Gradle. W Android Studio: File → Sync Project with Gradle Files

Konfiguracja credentiali

Opcja A: Plik gradle.properties

W pliku ~/.gradle/gradle.properties (globalnie) lub gradle.properties (w projekcie):

GITHUB_ACTOR=twoj-github-username
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
        

🔒 Bezpieczeństwo

Nigdy nie commituj tokenów do repozytorium! Dodaj gradle.properties do .gitignore jeśli zawiera tokeny.

Opcja B: Zmienne środowiskowe

# Windows PowerShell
$env:GITHUB_ACTOR = "twoj-username"
$env:GITHUB_TOKEN = "ghp_xxxxxxxxxxxxxxxxxxxx"

# Linux/macOS
export GITHUB_ACTOR="twoj-username"
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"
        

Weryfikacja instalacji

Po instalacji możesz przetestować silnik:

import rip.nerd.kitsunescript.api.KitsuneScriptEngine

val engine = KitsuneScriptEngine()
val result = engine.eval("""
    let x = 10 + 20;
    x * 2;
""")

println("Wynik: $result")  // Wynik: 60.0
        

✅ Gratulacje!

KitsuneScript jest teraz zainstalowany w Twoim projekcie. Przejdź do sekcji "Szybki start" aby nauczyć się podstaw.

Wersjonowanie

Wersja	Data	Opis
`1.0.0`	2024	Pierwsza stabilna wersja