How-to

Montar Android Studio y correr BLANK en un Moto G15

Sigue esto de principio a fin. Son pasos literales. Al final tendrás la app BLANK (todavía vacía) corriendo como launcher en un Moto G15 real.

Qué vas a conseguir

Android Studio instalado y funcionando en tu Mac.
El proyecto android/launcher compilando sin errores.
Moto G15 preparado para desarrollo (USB debugging, ADB).
APK de BLANK instalado en el Moto G15 y seleccionado como launcher.

Tiempo estimado la primera vez: 2-3 horas (la descarga del SDK tarda bastante). A la segunda: 10 minutos.

Pre-requisitos

Hardware

Mac con macOS 12 o superior
Un Motorola Moto G15 (~€279)
Cable USB-C de datos (no solo de carga)
10 GB libres en disco

Software

Homebrew instalado (brew --version)
Git instalado
Navegador para descargar cosas
El repositorio blank-phone clonado en local

Instalar Android Studio

Descarga Android Studio desde developer.android.com/studio. Coge la versión para Apple Silicon si tu Mac es M1/M2/M3, o Intel si no.
Abre el .dmg y arrastra Android Studio a Aplicaciones.
Abre Android Studio desde Aplicaciones. El primer arranque te preguntará si importar configuración previa: elige Do not import settings.
En el Setup Wizard inicial, elige Standard. Acepta las licencias. Va a descargar ~3 GB (SDK, emulador, herramientas). Tarda un rato.
Cuando termine y veas la pantalla Welcome to Android Studio, cierra esta ventana un momento.

Verifica: abre ~/Library/Android/sdk en Finder. Debe existir con subcarpetas. Esa es tu SDK raíz.

Preparar el proyecto en terminal

Antes de abrir el proyecto en Android Studio hay que generar el gradle wrapper y colocar las fuentes Inter. Sin esto, el build falla.

2.1. Instalar Gradle (solo para generar el wrapper)

Instala Gradle global vía Homebrew.

brew install gradle

Verifica que funcione. Debe mostrar Gradle 8.x.

gradle --version

2.2. Generar el gradle wrapper

El wrapper es el script ./gradlew que vas a usar siempre para compilar — así todos usamos la misma versión de Gradle aunque en cada Mac esté instalada una diferente.

cd /Users/asiergonzalezgomez/Development/amaren-ventures-apps/blank-phone/android/launcher

gradle wrapper --gradle-version 8.5

Verás que aparecen los archivos gradlew, gradlew.bat y gradle/wrapper/gradle-wrapper.jar.

2.3. Descargar las fuentes Inter

Ve a fonts.google.com/specimen/Inter y pulsa Download family.
Descomprime el ZIP. Busca dentro de static/ estos tres archivos:
- Inter_18pt-Regular.ttf → renombra a inter_regular.ttf
- Inter_18pt-Medium.ttf → renombra a inter_medium.ttf
- Inter_18pt-SemiBold.ttf → renombra a inter_semibold.ttf
Copia los tres a esta carpeta:

open /Users/asiergonzalezgomez/Development/amaren-ventures-apps/blank-phone/android/launcher/app/src/main/res/font

2.4. Descomentar las entries en inter.xml

Abre android/launcher/app/src/main/res/font/inter.xml y quita los comentarios  que envuelven las tres entries <font>. Guarda.

Abrir el proyecto en Android Studio

Abre Android Studio.
Pulsa Open (no New Project, no Get from VCS).
Navega hasta y selecciona:
/Users/asiergonzalezgomez/Development/amaren-ventures-apps/blank-phone/android/launcher
Android Studio detecta el settings.gradle.kts y empieza Gradle Sync. La primera vez tarda entre 5 y 15 minutos (descarga dependencias, indexa). Abajo a la derecha ves el progreso.
Cuando termine, deberías ver BUILD SUCCESSFUL en la pestaña Build. Si aparece algún error, ve a la sección de Troubleshooting al final.

Tip: en File → Project Structure → SDK Location confirma que el JDK sea la versión 17 (Android Studio trae uno embebido llamado jbr-17). Si está en 11 o 8, el build fallará.

Preparar el Moto G15

El Moto G15 viene bloqueado para desarrollo de fábrica. Tenemos que activar Opciones de Desarrollador y USB Debugging.

Enciende el Moto G15, completa la configuración inicial (WiFi, cuenta Google, etc.).
Abre Ajustes → Acerca del teléfono.
Busca Número de compilación (al final). Tócalo 7 veces seguidas. Te pedirá el PIN y aparecerá un mensaje: "Ahora eres desarrollador".
Vuelve atrás a Ajustes → Sistema → Opciones de desarrollador.
Activa Depuración por USB.
Activa también Permanecer activo (la pantalla no se apaga al estar enchufado — útil para desarrollo).

Conectar el Moto G15 al Mac

Conecta el Moto G15 al Mac con un cable USB-C de datos.
En el Moto G15 aparecerá un diálogo Permitir depuración USB. Marca Permitir siempre desde este ordenador y pulsa OK.
En el Mac, abre terminal y verifica que el ADB lo ve:

~/Library/Android/sdk/platform-tools/adb devices

Deberías ver algo como:

List of devices attached
ZY227xxxxx  device

Si aparece unauthorized, desbloquea el teléfono y confirma el diálogo. Si no aparece nada, prueba otro cable o puerto USB.

Atajo: añade adb al PATH

Para no tener que teclear la ruta completa cada vez:

echo 'export PATH=$PATH:$HOME/Library/Android/sdk/platform-tools' >> ~/.zshrc

source ~/.zshrc

A partir de ahora puedes usar adb devices directamente.

Compilar e instalar el APK

Opción A: desde Android Studio

En la barra superior, al lado del botón verde ▶, abre el dropdown de dispositivos target.
Selecciona tu Moto G15 (aparecerá por su nombre de modelo).
Pulsa ▶ Run 'app'. Android Studio compila, genera el APK, lo instala y lo abre. Primera vez: 3-5 minutos.

Opción B: desde terminal

Más rápido una vez te acostumbras:

cd /Users/asiergonzalezgomez/Development/amaren-ventures-apps/blank-phone/android/launcher

Compila e instala en el único dispositivo conectado.

./gradlew :app:installDebug

Si ves BUILD SUCCESSFUL y una línea tipo Installed on 1 device, ya está.

Poner BLANK como launcher

En el Moto G15, la primera vez que pulses el botón Home tras instalar:

Android preguntará "Elegir aplicación de inicio".
Selecciona Blank Launcher.
Elige Siempre (no Solo una vez).
Ya estás en BLANK. La pantalla de inicio está vacía porque el HomeScreen.kt todavía no tiene lógica implementada. Pero ahí está corriendo tu app, en un Moto G15 real, compilada por ti.

Cambiar de launcher después: si quieres volver al launcher de Motorola, ve a Ajustes → Apps → Aplicaciones predeterminadas → App de Inicio y elige el otro launcher.

Checklist de todo el proceso

Marca cada paso según lo completes. Se guarda en el navegador automáticamente.

0 de 19 completados

Alta Media Baja

Troubleshooting — problemas comunes

gradle: command not found

Homebrew no está en el PATH. Ejecuta:

eval $(/opt/homebrew/bin/brew shellenv)

Y reintenta brew install gradle.

Gradle Sync falla: "SDK location not found"

Crea el archivo android/launcher/local.properties con esta línea (sustituye tu usuario):

sdk.dir=/Users/asiergonzalezgomez/Library/Android/sdk

Error: "Unsupported class file major version 65"

Tu JDK es demasiado nuevo (Java 21+) o demasiado antiguo. Cambia a JDK 17 en File → Project Structure → SDK Location → Gradle JDK y elige jbr-17.

adb devices muestra el teléfono como "unauthorized"

Desbloquea el Moto G15. Aparecerá un diálogo "Permitir depuración USB desde este ordenador". Acepta. Si no aparece, en el Moto G15 ve a Ajustes → Opciones de desarrollador → Revocar autorizaciones de depuración USB, desconecta y vuelve a conectar.

adb devices no muestra nada

Suele ser el cable. Los cables USB-C baratos son solo de carga. Prueba otro cable, preferiblemente el que venía con el Moto G15. Si sigue sin aparecer:

adb kill-server && adb start-server

Error: "resource font/inter not found"

No copiaste las 3 TTF o no descomentaste las entries en res/font/inter.xml. Vuelve a la sección 2.3 y 2.4.

La app se instala pero no aparece el diálogo de launcher

Manualmente: Ajustes → Apps → Aplicaciones predeterminadas → App de Inicio y selecciona Blank.

Qué sigue después

Si has llegado hasta aquí, tienes la infraestructura mínima para empezar a programar. El siguiente paso es implementar la pantalla de inicio real. En orden:

Módulo Android — abrir el checklist priorizado
Implementar HomeScreen.kt con reloj + nombre del usuario (~1 día)
Implementar AppFilterManager.kt con whitelist hardcoded (~1 día)
Implementar AppDrawerScreen.kt grid de apps filtradas (~1 día)
Ver el roadmap completo de la Fase 1