Skip to content

outputs.md

Latest commit

 

History

History
66 lines (40 loc) · 7.63 KB

outputs.md

File metadata and controls

66 lines (40 loc) · 7.63 KB
Raw

Salidas de una compilación

El outputType clásico sigue aceptando tres valores: apk, aab y both. Encima está outputs, una lista (también acepta texto con comas) que manda sobre él: apk, aab, xapk, apks, ipa, exe, msi, dmg, appimage. El workflow tiene un paso por formato condicionado a la lista, así que sólo corre el que pediste, y el campo platform (android, ios o both) decide si se lanzan los jobs de Android, los de iOS o los dos. Cuando platform es ios o both, el package.json del ZIP incluye @capacitor/ios para que el paso npx cap add ios no falle con "Could not find the ios platform". El campo GET /api/v1/build/:id devuelve outputs y formats, el segundo con lo que el artefacto confirma que existe de verdad.

Lo que descargas cuando el build termina

Cada formato tiene su ruta en GET /api/download/:id/:fmt; sin sufijo se asume APK.

  • APK — GET /api/download/:id (o .../apk). Instalable directamente en un dispositivo. Con provider flutter lo compone el job flutter-build; con provider cordova el job cordova-build; no el de Capacitor.
  • AAB — GET /api/download/:id/aab. Lo que sube Play Console. Sólo aparece si lo pediste en outputs. Con provider flutter sale del job flutter-build; con cordova se intenta con --packageType=bundle (si la versión de cordova-android no lo soporta en debug, el paso no bloquea y no hay AAB).
  • XAPK — GET /api/download/:id/xapk. APK base más AndroidManifest.json con paquete, versión y permisos. Sólo si pediste xapk.
  • APKS — GET /api/download/:id/apks. Bundletool en modo universal, generado desde el AAB. Sólo si pediste apks.
  • IPA — GET /api/download/:id/ipa. Sólo existe si el build corrió en macos-latest con .p12, .mobileprovision y contraseña enviados en el paso de firma iOS. Si no, no hay artefacto y el endpoint devuelve error.
  • EXE y MSI — GET /api/download/:id/exe y .../msi. EXE de Electron: job de windows-latest con electron-builder, sólo corre si pediste ese formato y el ZIP trae desktop/. EXE de Tauri: si el provider es tauri, el job tauri-build sube el binario de Cargo con el artefacto -exe aunque no pidas formato de escritorio. MSI: sólo de Electron.
  • DMG — GET /api/download/:id/dmg. Job de macos-latest, mismas condiciones que el EXE.
  • AppImage — GET /api/download/:id/appimage. Job de ubuntu-latest, mismas condiciones.

Un formato que no esté en la lista de arriba devuelve 404 con los formatos soportados. Los artefactos viven en GitHub Actions y caducan a los 30 minutos; el servidor los borra también en su limpieza automática. El historial (GET /api/history) conserva el enlace mientras dure la entrada local.

Además, el ZIP del proyecto está disponible sin compilar con POST /api/project, y con cualquier configuración: incluye build-config.json, main-manifest.xml, el código Java generado, los scripts de patch y el workflow.

Lo que sólo es código fuente en el ZIP

  • Desktop — si activas desktopEnabled o pides exe, msi, dmg o appimage en outputs (el motor autoactiva desktopEnabled en ese caso), aparece desktop/ con un proyecto Electron (package.json, main.js, README) y el selector "Desktop .EXE/.APP" del estudio escribe esa carpeta. Para que salga un binario hay que pedir exe, msi, dmg o appimage en outputs: entonces el workflow lanza electron-builder en Windows, macOS o Linux según el formato. desktopPlatform (win, mac, both) se valida, se guarda en build-config.json y lo usa el generador de desktop/package.json para fijar los targets de electron-builder.
  • TWA — twa-manifest.json, assetlinks.json y un README con el comando de bubblewrap. La Trusted Web Activity real se construye fuera, con tus herramientas.
  • react-native e ionic — no generan nada más allá de provider.json; el APK que sale es el de Capacitor.

Flutter, Tauri y Cordova en la CI

  • Flutter (provider: flutter) — el job flutter-build en ubuntu-latest ejecuta flutter create para generar el host Android, encima coloca tu manifiesto, corrige applicationId/namespace a tu paquete, mueve MainActivity.kt y compila con flutter build apk --release (más appbundle si pediste aab). Artefactos: -apk y opcional -aab. El job compile de Capacitor se salta con este provider, así que no hay doble APK.

  • Tauri (provider: tauri) — el job tauri-build en windows-latest corre cargo build --release --manifest-path tauri/src-tauri/Cargo.toml y sube el binario como artefacto -exe. El proyecto Electron (desktop/) queda fuera con este provider para no pisarse el nombre de artefacto, y el APK Android lo sigue poniendo el job compile (sigue siendo Capacitor por debajo).

  • Cordova (provider: cordova) — el job cordova-build en ubuntu-latest corre cordova platform add android sobre tu config.xml real, inyecta los permisos de main-manifest.xml en el manifiesto de Cordova, copia el icono a los mipmap-* y ejecuta cordova build android (artefacto -apk debug; -aab opcional con continue-on-error; -release-apk si subiste keystore, vía build.json). El job compile de Capacitor se salta con este provider: el APK es de Cordova puro.

El workflow recibe el provider como input (provider), que el servidor manda en el workflow_dispatch junto a id, platform y outputs.

PWA dentro del proyecto

Con pwaEnabled activado (viene activado por defecto) el ZIP incluye www/manifest.webmanifest con nombre, colores e icono, y www/sw.js con caché offline y fallback a index.html. El registro del service worker y la etiqueta manifest se inyectan en tu index.html si no estaban.

No necesitas alojar nada en InteeBuild para esto: sube la carpeta www/ a tu hosting y la web queda instalable como PWA por sí sola. Desactívalo con pwaEnabled: false si tu sitio ya trae su propio manifest.

Ficha de Play Store

POST /api/listing devuelve texto listo para pegar en Play Console, generado con reglas locales y sin servicios externos:

curl -X POST /api/listing -H "Content-Type: application/json" \
  -d '{"appName":"Mi Radio","url":"https://mi-radio.com","packageName":"com.miempresa.radio","permissions":{"foreground":true}}'

La respuesta trae title (recortado a 30 caracteres), shortDescription (80), fullDescription (hasta 4000, con las características derivadas de tus permisos y flags de UI), keywords (100), category (Herramientas), packageName y version. Es un borrador: conviene reescribirlo antes de publicar.

También están POST /api/security-audit (puntuación textual con incidencias GDPR y de permisos) y GET /api/privacy-policy?appName=&package= (política genérica rellenada con tus datos).

QR de descarga

GET /api/qr/:id devuelve una imagen PNG con el QR del enlace de descarga. La imagen la genera un servicio externo (api.qrserver.com); si no responde en 8 segundos, el endpoint devuelve 502 con el enlace de descarga en texto para que puedas mostrarlo tú.

Minificado

La opción minify (o minify: true en la API) quita comentarios HTML y espacios sobrantes del código que se inyecta. No toca tu JavaScript y no es un minificador de producción: sirve para que el HTML embebido pese menos.

Lo que no hay

No hay build de iOS sin certificados de Apple (el job sólo valida en simulador; con .p12 y .mobileprovision sí exporta IPA), no hay tienda ni distribución propia, ni ningún plan de pago detrás de todo esto. Lo que sí hay son límites de uso del servidor: 10 builds por hora por IP y los tamaños de entrada detallados en production.md.