# Cómo compilar el APK de Full Dominoes

Config lista:
- **appId:** com.soluciondigital.fulldominoes
- **appName:** Full Dominoes
- **URL que carga:** https://soluciondigital.pro/fullDomino/
- **Orientación:** horizontal (landscape) forzada por config nativa

IMPORTANTE: el APK abre la web desde el servidor. Antes de probarlo, el juego
debe estar subido y accesible en https://soluciondigital.pro/fullDomino/.

---

## ⚠️ Sobre el error 404 que te salió antes

El error era por el plugin `capacitor-plugin-screen-protector`, que NO existe
en npm. Ya lo cambié por el correcto: `@capacitor-community/privacy-screen`.
También actualicé todo a Capacitor 7 (compatible con tu Node v24).

Usa el `package.json` corregido que viene en esta carpeta. NO corras
`npm init -y` (eso lo sobrescribe).

---

## Requisitos (una sola vez)
1. Node.js 18+ (tú tienes v24 ✓)
2. Android Studio: https://developer.android.com/studio
   (incluye el Android SDK al instalar)
3. JDK 17 (viene con Android Studio)

---

## Pasos (en orden, dentro de la carpeta capacitor/)

### 1. Instalar TODAS las dependencias del package.json
```bash
npm install
```
(Esto ya instala core, cli, android, ios, app, haptics y privacy-screen.
NO necesitas instalarlos uno por uno.)

### 2. Agregar la plataforma Android
```bash
npx cap add android
```

### 3. Sincronizar
```bash
npx cap sync
```

### 4. Abrir en Android Studio
```bash
npx cap open android
```

### 5. Compilar el APK (dentro de Android Studio)
- Espera el "Gradle sync" (barra de progreso abajo).
- Menú: Build → Build Bundle(s) / APK(s) → Build APK(s)
- Al terminar, clic en "locate" para hallar el archivo.
- Ruta: android/app/build/outputs/apk/debug/app-debug.apk

Ese app-debug.apk se instala directo en tu celular para probar.

---

## Si algo falla

- **"could not determine executable to run"** al correr `npx cap`:
  significa que `npm install` no terminó bien. Borra node_modules y
  package-lock.json y vuelve a `npm install`:
  ```bash
  rmdir /s /q node_modules
  del package-lock.json
  npm install
  ```
- **Error 404 de algún paquete:** revisa que el package.json sea el de esta
  carpeta (con @capacitor-community/privacy-screen), no uno generado por
  `npm init`.

---

## Para publicar en Google Play (más adelante)
1. Build → Generate Signed Bundle / APK
2. Elige Android App Bundle (.aab)
3. Crea una keystore y GUÁRDALA (sin ella no puedes actualizar la app nunca).
4. Sube el .aab a Google Play Console.

---

## Notas
- El diseño (HTML/CSS/JS) se actualiza subiendo al servidor; NO hay que
  recompilar el APK salvo que cambies config nativa (icono, orientación,
  plugins, permisos).
- Cada cambio de config nativa: vuelve a correr `npx cap sync`.
- El permiso de internet ya viene por defecto.

---

## Compilar el APK directo desde CMD (sin abrir Android Studio)

Una vez que ya corriste `npm install`, `npx cap add android` y `npx cap sync`,
puedes generar el APK sin abrir Android Studio:

```bash
cd android
gradlew assembleDebug
```

El APK queda en: `android/app/build/outputs/apk/debug/app-debug.apk`

Para la versión de release (optimizada):
```bash
cd android
gradlew assembleRelease
```
(La de release necesita configurar la firma/keystore primero.)

NOTA: la primera vez que corras `gradlew` descargará Gradle y dependencias
(puede tardar varios minutos). Necesitas tener configurada la variable de
entorno JAVA_HOME apuntando al JDK 17.