kolbiota

CLI para publicar updates OTA a un servidor KölbiOTA (compatible con Expo Updates).

Instalacion

npm install -g kolbiota

O ejecutar directamente con npx:

npx kolbiota --canal production --key <upload-key>

Uso

kolbiota --canal <channel> [opciones]

Parametros

| Parametro | Requerido | Default | Descripcion | |-----------|-----------|---------|-------------| | --canal <channel> | Si | — | Canal de release (production, staging, beta, etc.) | | --message <msg> | No | commit message de git | Nombre o descripcion del release | | --servidor <url> | No | https://qa-avworkflows-ms.cn.ice.go.cr/ota | URL del servidor OTA | | --key <key> | No | env KOLBIOTA_UPLOAD_KEY | Upload key para autenticacion | | --skip-export | No | false | Salta expo export (asume que dist/ ya existe) | | --dir <path> | No | . | Directorio del proyecto Expo |

Ejemplos

Publicar al canal production:

npx kolbiota --canal production --key mi-upload-key

Publicar con un nombre descriptivo:

npx kolbiota --canal staging --message "Hotfix login v2.1" --key mi-upload-key

Apuntar a otro servidor:

npx kolbiota --canal production --servidor http://localhost:3000 --key abc123

Usar un directorio diferente:

npx kolbiota --canal beta --dir ./mi-app-expo --key mi-upload-key

Saltar expo export (si ya corriste npx expo export manualmente):

npx kolbiota --canal production --skip-export --key mi-upload-key

Upload Key

La upload key se puede pasar de dos formas:

1. Por parametro: --key mi-upload-key
2. Por variable de entorno: export KOLBIOTA_UPLOAD_KEY=mi-upload-key

Que hace

1. Lee runtimeVersion de app.json
2. Obtiene el commit hash y message de git
3. Ejecuta npx expo export para generar el bundle
4. Crea un zip compatible con el servidor OTA
5. Sube el zip al servidor con los metadatos del release
6. Limpia archivos temporales

Requisitos

• Node.js >= 18
• Un proyecto Expo con app.json que tenga runtimeVersion
• Expo CLI instalado (npx expo debe funcionar)
• Acceso al servidor KolbiOTA con una upload key valida

Compilar a .exe

npm run build
npx pkg dist/index.js --targets node18-win-x64 --output kolbiota.exe

Genera un ejecutable standalone de ~44MB para Windows.