Skip to main content

2. Manual de Instalación y Configuración

Este manual detalla el proceso paso a paso para instalar, configurar y validar todo el entorno de desarrollo Android con Kotlin para la organización, incluyendo herramientas principales y auxiliares.

2.1 Requisitos previos del sistema​

  • Sistema operativo: Windows 10/11 (64 bits) o macOS Monterey o superior
  • RAM: mínimo 8 GB (16 GB recomendado)
  • Espacio en disco: mínimo 20 GB disponibles
  • Conexión a internet estable

2.2 Instalación paso a paso​

1. Instalar Android Studio​

  • Descargar desde: https://developer.android.com/studio
  • Versión minima necesaria: Android Studio Meerkat | 2024.3.1 Patch 1
  • Durante la instalación seleccionar:
    • SDK de Android
    • SDK Tools (emuladores, build tools, etc.)
    • Aceptar licencias

2. Instalar JDK​

  • Instalar JDK 17 (Amazon Corretto o OpenJDK)
  • Verificar en terminal:
java -version

3. Configurar Gradle​

  • Configurar wrapper local (gradlew) con versión:
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip

4. Kotlin​

  • Confirmar versión en build.gradle.kts:
kotlin("jvm") version "1.9.22"

2.3 Herramientas adicionales obligatorias​

  • Git: https://git-scm.com/
  • GitHub Desktop o Sourcetree
  • Postman o Insomnia para probar APIs
  • SDK Manager para instalar emuladores

2.4 Instalación de herramientas auxiliares (opcional)​

HerramientaDescripciónDescarga
SoapUITesting de servicios SOAPhttps://www.soapui.org
GenymotionEmulador Android profesionalhttps://www.genymotion.com
Sublime TextEditor de texto livianohttps://www.sublimetext.com
HttpCanaryProxy y sniffer HTTP/HTTPS en AndroidGoogle Play

2.5 Configuración del entorno Android Studio​

  • Plugins recomendados:
    • Kotlin
    • JetBrains Theme
    • Rainbow Brackets
    • Android Drawable Preview
  • Ajustes en Settings > Appearance > Code Style
    • Usar indentación de 4 espacios
    • Activar autoimport
    • Ajustar línea guía a 120 caracteres

2.6 Configuración del emulador​

  • Usar Device Manager en Android Studio
  • Crear emulador con:
    • Pixel 5 / 6
    • Android 13 (API 33)
    • 6 GB RAM virtual
  • Activar hardware acceleration

2.7 Validación del entorno​

  1. Ejecutar ./gradlew clean build
  2. Abrir un emulador y ejecutar la app base
  3. Confirmar que se genera correctamente el APK/AAB

2.8 Autoinstalador corporativo (Inno Setup)​

La organización cuenta con un instalador .exe que configura automáticamente todas las herramientas mínimas requeridas en las versiones correctas (JDK, Android Studio, Gradle, variables de entorno, etc.).

Se ejecuta como administrador y deja el entorno listo para usar.

2.9 Automatización post-instalación​

Se recomienda crear un script de configuración del entorno con los siguientes elementos:

  • Variables de entorno (JAVA_HOME, ANDROID_HOME)
  • Alias de comandos (alias gs="git status")
  • Script PowerShell para clonar repositorios base
  • Script para configurar firma de QA

Ejemplo de alias útil en .bashrc o .ps1:

alias gradle="./gradlew"
alias run="adb install -r ./build/app.apk"

Este manual garantiza que todos los desarrolladores configuren sus equipos con el mismo estándar, evitando inconsistencias y errores desde las primeras etapas del proyecto.​

🛠 Instalador automático corporativo (Barnyard.iss)​

tip

La forma más rápida, estandarizada y recomendada de instalar todo el entorno Android en Alpura es mediante el instalador corporativo de escritorio, generado con Inno Setup.

Este instalador:

  • Instala Android Studio Meerkat | 2024.3.1 Patch 1
  • Configura Git, Postman, SourceTree
  • Descarga automáticamente las configuraciones necesarias para empezar a desarrollar con el arquetipo oficial

🔗 Repositorio del instalador: barnyard-builder

📂 Ubicación del script principal​

En el directorio: mobile-installer/Barnyard.iss

🧪 ¿Qué instala exactamente?​

HerramientaVersión recomendada
Android StudioMeerkat 2024.3.1 Patch 1
Git2.43.0 o superior
PostmanÚltima estable
SourceTree3.4.13 o superior

▶️ Cómo ejecutar el instalador​

  1. Clona el repositorio en tu equipo (requiere acceso interno):
git clone https://hub-gitlab.alpura.com/Arquitectura/alpura-arq-artefactos/barnyard-builder.git
  1. Navega al directorio del script:
cd barnyard-builder/mobile-installer

  1. Abre el archivo Barnyard.iss con Inno Setup Compiler (debe estar instalado)

  2. Haz clic en "Compile" para generar el .exe

  3. Ejecuta el instalador generado como administrador

✅ Verificación de instalación​

  1. Abre Android Studio
  2. Selecciona el proyecto de referencia AlpuraMobileArchetype
  3. Verifica que compila y sincroniza sin errores
  4. Ejecuta en un emulador físico o virtual