Dependencias del Proyecto PAE

El proyecto PAE utiliza un conjunto seleccionado de dependencias que balancean funcionalidad, performance y mantenibilidad.

┌─────────────────────────────────────────────────────┐
│          grouplabs.versions.toml                     │
│  (Centralized version management)                   │
└──────────────────┬──────────────────────────────────┘
                   │
    ┌──────────────┼──────────────┐
    │              │              │
    ▼              ▼              ▼
 Android      Kotlin        Others
  Gradle     Language       Libraries

Ubicación: gradle/libs.versions.toml

[versions]
kotlin = "2.3.10"
gradle = "8.0"
compose = "1.5.4"
compileSdk = "36"
minSdk = "27"
targetSdk = "36"
jvmTarget = "17"

[libraries]
# Android Core
androidx-core-ktx = "1.10.1"
androidx-lifecycle-runtime-ktx = "2.6.1"
androidx-activity-compose = "1.7.2"

# Compose
androidx-compose-bom = "2023.09.00"
androidx-compose-ui = { module = "androidx.compose.ui:ui", version.ref = "compose" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3", version = "1.1.2" }

# Coroutines
kotlinx-coroutines-core = "1.7.3"
kotlinx-coroutines-android = "1.7.3"

# Serialization
kotlinx-serialization-json = "1.6.2"

# HTTP Client
fuel = "2.3.1"
okhttp = "4.11.0"

# Dependency Injection
hilt-android = "2.48"

# WorkManager
androidx-work-runtime-ktx = "2.8.1"

# Database
room-runtime = "2.6.0"

# Security
androidx-security-crypto = "1.1.0-alpha06"
google-play-services-integrity = "1.2.0"

# Testing
junit = "4.13.2"
mockito-kotlin = "5.1.0"
robolectric = "4.12.1"

[plugins]
android-application = "com.android.application:8.1.0"
android-library = "com.android.library:8.1.0"
kotlin-android = "org.jetbrains.kotlin.android:1.9.20"
kotlin-kapt = "org.jetbrains.kotlin.kapt:1.9.20"
hilt-gradle = "com.google.dagger.hilt.android:2.48"

BOM (Bill of Materials): versionado coordinado automático

// build.gradle.kts
dependencies {
    implementation(platform(libs.androidx.compose.bom))
    implementation(libs.androidx.compose.ui)
    // versiones automáticas coordinadas
}

Por qué Fuel + OKHttp:

• Fuel es wrapper ligero sobre OKHttp
• OKHttp es estándar de Android
• OKHttp soporta certificate pinning

Nota: RutaPAE usa inyección manual en DomainManager para mayor simplicity.

Por qué custom VectorDB:

• Room no soporta búsqueda vectorial
• VectorDB proporciona ORM + índices HNSW
• Control fino sobre esquema

Uso en RutaPAE: DeliverySyncWorker se ejecuta periódicamente

plugins {
    id("com.android.application") version "8.1.0"
    id("com.google.dagger.hilt.android") version "2.48"
    kotlin("android") version "2.3.10"
    kotlin("kapt") version "2.3.10"
}

                    Machine  RutaPAE  Domain  Data  Contract  Core  DirectLink
android:core-ktx      ✓        ✓       ✓      ✓                ✓       ✓
compose:ui            ✓        ✓
compose:material3     ✓        ✓
coroutines            ✓        ✓       ✓      ✓              ✓       ✓
serialization         ✓        ✓       ✓      ✓       ✓       ✓
fuel/okhttp           ✓        ✓       ✓      ✓       ✓             ✓
hilt                  ✓
room                                   ✓      ✓
VectorDB                               ✓      ✓
security:crypto       ✓        ✓
work:runtime          ✓        ✓
camera:camera2        ✓
tensorflow            ✓
timber                ✓        ✓       ✓      ✓               ✓

• Kotlin: 2.3.10 (versión nueva, kotlin multiplatform compatible)
• Android Gradle Plugin: 8.1.0 (namespace required)
• Compose: BOM 2023.09 (versionado coordinado)
• Librerías Android: latest estables (1-2 versiones atrás)

# Verificar versiones disponibles
./gradlew dependencyUpdates
 
# Actualizar todo
./gradlew :dependencies --refresh-dependencies
 
# Actualizar específico
# Editar gradle/libs.versions.toml y rebuild

// evitar errores de versión
configurations {
    all {
        exclude group: 'com.google.guava', module: 'guava-jdk5'
    }
}

Ver build-and-deployment.md

[libraries]
# Testing
junit = "4.13.2"
mockito-kotlin = "5.1.0"
robolectric = "4.12.1"

# Build
gradle = "8.1.0"
kotlin-plugin = "2.3.10"
kotlin-kapt = "2.3.10"

# Linting (optional)
ktlint = "0.49.1"
detekt = "1.23.0"

./gradlew :app:dependencies | grep -i conflicting
 
# Resolver versión en conflict
./gradlew :app:dependencies | grep "com.google.guava"

dependencies {
    // Forcing específica
    implementation("com.google.guava:guava:32.1.2-jre") {
        force = true
    }
}

Generar lock file para reproducibilidad:

./gradlew :app:dependencies --write-locks
 
# Verificar locks en ci
./gradlew :app:dependencies --apply-locks

• gradle/libs.versions.toml documentation
• Android Developers Dependency Versions
• Kotlin Release Notes