====== Compilación y Deployment de PAE ======

===== Compilación local =====

==== Requisitos previos ====

  * **Android Studio**: 2023.2 o superior
  * **JDK**: 17
  * **SDK**: compileSdk 36, minSdk 27
  * **Gradle**: 8.0+ (incluido en el proyecto)

==== Configuración inicial ====

=== 1. Clonar repo y configurar ===

<code bash>
git clone <repo-url>
cd PAE

# Crear local.properties (si no existe)
echo "sdk.dir=/path/to/Android/sdk" > local.properties
</code>

=== 2. Descargar dependencias ===

<code bash>
./gradlew build --dry-run
# o
./gradlew downloadDependencies
</code>

==== Compilación por módulo ====

=== Compilar Machine ===

<code bash>
# Debug (desarrollo)
./gradlew :Machine:assembleDebug

# Release (producción)
./gradlew :Machine:assembleRelease
</code>

=== Compilar RutaPAE ===

<code bash>
# Debug
./gradlew :RutaPAE:assembleDebug

# Release
./gradlew :RutaPAE:assembleRelease
</code>

=== Compilar librerías ===

<code bash>
./gradlew :MachineDomain:build
./gradlew :MachineData:build
./gradlew :Contract:build
# etc.
</code>

==== Compilación completa ====

<code bash>
# Build de todo el proyecto
./gradlew build

# Build con test
./gradlew build connectedCheck

# Clean + build
./gradlew clean build
</code>

===== Configuración de compilación =====

==== Build.gradle (root) ====

<code kotlin>
plugins {
    id 'com.android.application' version '...'
    kotlin 'org.jetbrains.kotlin.android' version '...'
}

allprojects {
    repositories {
        google()
        mavenCentral()
        jitpack { url "https://jitpack.io" }
    }
}
</code>

==== Build.gradle (Machine) ====

<code kotlin>
android {
    compileSdk 36
    
    defaultConfig {
        applicationId "co.ada.paemachine"
        minSdk 27
        targetSdk 36
        versionCode 9
        versionName "0.9.0"
        
        javaCompileOptions {
            annotationProcessorOptions {
                includeCompileClasspath true
            }
        }
    }
    
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    
    kotlinOptions {
        jvmTarget = '17'
    }
    
    buildFeatures {
        compose = true
        buildConfig = true
    }
    
    packagingOptions {
        resources {
            excludes += '/META-INF/{AL2.0,LGPL2.1}'
        }
    }
}

dependencies {
    implementation project(':MachineDomain')
    implementation project(':MachineData')
    implementation project(':Contract')
    implementation project(':Core')
    // ... más dependencias
}
</code>

===== Firma de aplicación (Release) =====

==== Configuración de keystore ====

=== 1. Crear keystore (primera vez) ===

<code bash>
cd keystore/

# Machine
keytool -genkey -v -keystore machine-release.jks \
    -keyalg RSA -keysize 2048 -validity 10000 \
    -alias machine-key \
    -dname "CN=Ada,O=Ada,L=Bogota,ST=DC,C=CO"

# RutaPAE
keytool -genkey -v -keystore rutapae-release.jks \
    -keyalg RSA -keysize 2048 -validity 10000 \
    -alias rutapae-key \
    -dname "CN=Ada,O=Ada,L=Bogota,ST=DC,C=CO"
</code>

=== 2. Configurar en build.gradle ===

<code kotlin>
android {
    signingConfigs {
        release {
            storeFile file("../keystore/machine-release.jks")
            storePassword System.getenv("KEYSTORE_PASS") ?: ""
            keyAlias "machine-key"
            keyPassword System.getenv("KEY_PASS") ?: ""
        }
    }
    
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}
</code>

=== 3. Variables de entorno ===

<code bash>
export KEYSTORE_PASS="tu_keystore_password"
export KEY_PASS="tu_key_password"

./gradlew :Machine:assembleRelease
</code>

==== Verificar firma ====

<code bash>
# Listar contenido de keystore
keytool -list -v -keystore keystore/machine-release.jks

# Verificar firma de APK
jarsigner -verify -verbose build/outputs/apk/release/Machine-release.apk

# Inspeccionar certificado
zipinfo -1 build/outputs/apk/release/Machine-release.apk | grep META-INF/
</code>

===== Optimización de Release =====

==== ProGuard rules ====

**ProGuard** optimiza y protege el código:

<code>
# machine/proguard-rules.pro

# Serialización Kotlin
-keepclassmembers class co.ada.contract.models.** {
    public <init>(...);
    public <methods>;
}

-keepclasshierarchynames class co.ada.contract.models.**

# Enums
-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

# Room (si se usara)
-keep class **.BuildConfig { *; }

# Composable
-keep @androidx.compose.runtime.Composable class ** { *; }
</code>

==== R8 (reemplazo moderno de ProGuard) ====

<code>
android.enableR8 = true
android.enableR8.fullMode = true  # modo agresivo
</code>

===== Build script automatizado =====

==== build-release.sh (Linux/Mac) ====

<code bash>
#!/bin/bash

set -e

echo "=== Build PAE Release ==="

# Limpiar
./gradlew clean

# Compilar Machine
echo "Building Machine..."
./gradlew :Machine:assembleRelease

# Compilar RutaPAE
echo "Building RutaPAE..."
./gradlew :RutaPAE:assembleRelease

# Generar APKs con alineación
./gradlew :Machine:alignRelease
./gradlew :RutaPAE:alignRelease

echo "=== Build completado ==="
echo "Machine: build/outputs/apk/release/Machine-release.apk"
echo "RutaPAE: build/outputs/apk/release/RutaPAE-release.apk"
</code>

==== build-release.ps1 (Windows) ====

<code powershell>
Write-Host "=== Build PAE Release ==="

# Limpiar
& .\gradlew.bat clean

# Machine
Write-Host "Building Machine..."
& .\gradlew.bat :Machine:assembleRelease

# RutaPAE
Write-Host "Building RutaPAE..."
& .\gradlew.bat :RutaPAE:assembleRelease

Write-Host "=== Build completado ==="
</code>

===== Deployment =====

==== Instalación en dispositivo ====

=== Debug APK ===

<code bash>
adb install build/outputs/apk/debug/Machine-debug.apk
adb install build/outputs/apk/debug/RutaPAE-debug.apk
</code>

=== Release APK ===

<code bash>
adb install build/outputs/apk/release/Machine-release.apk
adb install build/outputs/apk/release/RutaPAE-release.apk
</code>

=== Reinstalar ===

<code bash>
adb install -r build/outputs/apk/release/Machine-release.apk
</code>

==== Desinstalar ====

<code bash>
adb uninstall co.ada.paemachine
adb uninstall co.ada.rutapae
</code>

==== Ver logs de instalación ====

<code bash>
adb logcat -s PackageManager
</code>

===== CI/CD (Integración continua) =====

==== GitHub Actions (ejemplo) ====

<code yaml>
# .github/workflows/build.yml
name: Build PAE

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v3
    
    - name: Set up JDK 17
      uses: actions/setup-java@v3
      with:
        java-version: '17'
        distribution: 'temurin'
    
    - name: Build Machine
      run: ./gradlew :Machine:assembleRelease
    
    - name: Build RutaPAE
      run: ./gradlew :RutaPAE:assembleRelease
    
    - name: Upload artifacts
      uses: actions/upload-artifact@v3
      with:
        name: apks
        path: build/outputs/apk/release/
</code>

===== Testing en CI/CD =====

<code bash>
# Unit tests
./gradlew test

# Android tests (requiere emulador)
./gradlew connectedAndroidTest

# Lint
./gradlew lint

# Lint + tests + build
./gradlew build connectedCheck
</code>

===== Versionado =====

==== Versión de Machine ====

  * **Pattern**: ''MAJOR.MINOR.PATCH'' (e.g., 0.9.0)
  * **Current**: 0.9.0 (versión pre-release)
  * **versionCode**: incremental (9)

==== Versión de RutaPAE ====

  * **Pattern**: ''MAJOR.MINOR.PATCH'' (e.g., 0.4.0)
  * **Current**: 0.4.0 (versión pre-release)
  * **versionCode**: incremental (4)

==== Actualizar versión ====

<code kotlin>
// Machine/build.gradle.kts
android {
    defaultConfig {
        versionCode 10
        versionName "0.10.0"
    }
}
</code>

===== Troubleshooting de build =====

==== Problema: "org.gradle.api.GradleException: org.gradle.workers.internal.DefaultWorkerExecutor$WorkerExecutionException" ====

**Solución**:
<code bash>
./gradlew clean --build-cache
./gradlew build
</code>

==== Problema: "Duplicate class kotlin.concurrent.LockedWrapper" ====

**Solución**: eliminar dependencias duplicadas de Kotlin
<code gradle>
configurations {
    all*.exclude module: 'kotlin-stdlib'
}
</code>

==== Problema: "Could not resolve <dependency>" ====

**Solución**: actualizar repositorios
<code bash>
./gradlew :dependencies
./gradlew clean build --refresh-dependencies
</code>

==== Problema: "Task :app:linDebugJavaWithJavac FAILED" ====

**Solución**: versión de JDK incorrecta
<code bash>
java -version
# debe ser 17+
</code>

===== Cache y performance =====

==== Limpiar cache ====

<code bash>
# Gradle cache
rm -rf ~/.gradle/caches

# Build cache
./gradlew cleanBuildCache

# Android Studio cache
rm -rf ~/.android/cache
</code>

==== Compilación paralela ====

<code bash>
# build.gradle
org.gradle.parallel=true
org.gradle.workers.max=8
</code>

==== Daemon gradle ====

<code bash>
# Habilitar daemon
org.gradle.daemon=true

# Desabilitar si hay problemas
./gradlew --no-daemon build
</code>

===== Monitoreo de build =====

==== Análisis de tiempos ====

<code bash>
./gradlew build --profile

# Genera HTML en build/reports/profile/
</code>

==== Lint report ====

<code bash>
./gradlew lint

# Report en build/reports/lint-results.html
</code>

==== Dependency report ====

<code bash>
./gradlew dependencies

# Genera árbol de dependencias
</code>