html2apk 0.4.0 → 0.7.0

package/README.md

@@ -1,8 +1,8 @@
 # html2apk
 
-`html2apk` transforma uma pasta com HTML, CSS, JS e assets em um APK Android usando Cordova.
+`html2apk` transforma uma pasta com HTML, CSS, JS e assets em um APK ou AAB Android usando Cordova.
 
-Use ele quando voce ja tem um app web, por exemplo uma pasta com `index.html`, `style.css`, `app.js` e imagens, e quer gerar um `.apk` instalavel no Android.
+Use ele quando voce ja tem um app web, por exemplo uma pasta com `index.html`, `style.css`, `app.js` e imagens, e quer gerar um `.apk` instalavel no Android ou um `.aab` para loja.
 
 ## O Mais Importante
 
@@ -83,6 +83,21 @@ No Windows, o `html2apk doctor` tenta encontrar automaticamente o SDK em:
 C:\Users\SEU_USUARIO\AppData\Local\Android\Sdk
 ```
 
+## Interface Grafica
+
+A interface desktop permite arrastar a pasta do projeto, preencher as configuracoes obrigatorias em etapas e gerar o arquivo Android sem mexer no terminal.
+
+Recursos principais:
+
+- Escolher idioma, tema claro/escuro e ver logs do processo.
+- Gerar APK normal, APK release ou AAB.
+- Escolher icone PNG, cor de tema, OneSignal App ID e permissoes.
+- Preencher keystore pela interface: arquivo, alias, senha da store e senha da key.
+- Marcar `Console no APK` para o app gerado mostrar um modal de debug no celular.
+- Usar a aba `Arquivos` para abrir arquivos HTML/CSS/JS/JSON do projeto, salvar edicoes, criar novos arquivos e ver uma previa com sintaxe.
+
+Para AAB, a interface pede keystore completo antes de liberar o build.
+
 ## Passo A Passo
 
 Entre na pasta do seu app web:
@@ -177,6 +192,9 @@ Opcoes comuns:
 ```bash
 html2apk build --debug
 html2apk build --release
+html2apk build --apk
+html2apk build --aab
+html2apk build --show-runtime-logs
 html2apk build --mode fullscreen
 html2apk build --mode standalone
 html2apk build --mode floating
@@ -194,6 +212,10 @@ Com `--debug`, a pasta Cordova temporaria fica salva para inspecao caso voce que
 
 Sem `--debug`, a pasta temporaria e limpa no fim do build.
 
+Com `--aab`, o build usa formato AAB e release automaticamente. Para publicar, preencha `keystore`.
+
+Com `--show-runtime-logs`, o APK/AAB gerado recebe um botao `Console` dentro do app. Esse console intercepta erros JavaScript, promises rejeitadas, logs, chamadas das funcoes interpretadas e requisicoes de rede (`fetch`/`XMLHttpRequest`), ajudando o dev a debugar no proprio celular. Se essa opcao ficar desligada, esse console nao aparece no app gerado.
+
 ## Configuracao Com `app.json`
 
 O `app.json` fica na raiz do seu app. Se ele nao existir, `config.json` e usado como fallback.
@@ -206,6 +228,7 @@ Exemplo completo:
   "appName": "MeuApp",
   "packageId": "com.seuapp.meuapp",
   "version": "1.0.0",
+  "buildFormat": "apk",
   "mode": "fullscreen",
   "orientation": "default",
   "minSdkVersion": 24,
@@ -227,6 +250,7 @@ Exemplo completo:
   "permissions": ["INTERNET", "CAMERA", "RECORD_AUDIO", "POST_NOTIFICATIONS", "VIBRATE"],
   "plugins": ["cordova-plugin-camera"],
   "release": false,
+  "showRuntimeLogs": false,
   "androidPlatform": "android@15.0.0",
   "keystore": {
     "path": "",
@@ -248,6 +272,7 @@ Campos principais:
 | `appName` | Nome visivel do app. |
 | `packageId` | Identificador Android. Precisa ter formato como `com.empresa.app`. |
 | `version` | Versao do app. |
+| `buildFormat` | `apk` para instalar direto ou `aab` para loja. |
 | `mode` | `fullscreen` para tela cheia, `standalone` para modo normal ou `floating` para icone flutuante. |
 | `orientation` | `default`, `vertical`, `horizontal`, `portrait` ou `landscape`. |
 | `minSdkVersion` | Versao minima do Android em API level. Padrao: `24`. |
@@ -263,6 +288,7 @@ Campos principais:
 | `androidPlatform` | Versao da plataforma Cordova Android. Padrao: `android@15.0.0`. |
 | `debug` | Se `true`, preserva a pasta temporaria de build. |
 | `release` | Se `true`, gera build release. |
+| `showRuntimeLogs` | Se `true`, mostra um modal `Console` no app gerado para depurar erros e funcoes interpretadas. |
 | `keystore` | Dados de assinatura para build release. |
 
 Prioridade de configuracao:
@@ -356,7 +382,7 @@ Retorno:
 
 A v0.1 instala um plugin Cordova local com uma API global simples para recursos Android. Todas as funcoes retornam `Promise`, exceto os ouvintes `aoEvento`/atalhos, que retornam uma funcao para cancelar a escuta.
 
-O html2apk injeta `cordova.js` automaticamente no HTML inicial do APK. Se uma funcao nativa for chamada antes do `deviceready`, a bridge espera o Android ficar pronto antes de executar.
+O html2apk injeta `html2apk-early-bridge.js` e `cordova.js` automaticamente no HTML inicial do APK. A bridge inicial cria as funcoes interpretadas antes dos scripts do seu projeto; se uma funcao nativa for chamada antes do `deviceready`, ela espera o Android ficar pronto antes de executar.
 
 Cada funcao em portugues tambem tem alias em ingles. A interface grafica mostra a sintaxe PT-BR quando o idioma esta em portugues e mostra a sintaxe em ingles quando o usuario troca o idioma para English.
 
@@ -418,18 +444,29 @@ No seu JavaScript do app:
 toast("Mensagem");
 vibrar(250);
 
+await notificar({
+  titulo: "Pedido aprovado",
+  texto: "Toque para abrir o app"
+});
+
 notificar({
   titulo: "Pedido aprovado",
   texto: "Toque para abrir os detalhes",
   acoes: [
-    { id: "abrir", titulo: "Abrir" },
-    { id: "cancelar", titulo: "Cancelar" }
+    {
+      id: "abrir",
+      titulo: "Abrir",
+      open: true,
+      aoClicar: { funcao: "abrirNoApp", argumentos: ["#/pedido/123"] }
+    },
+    {
+      id: "site",
+      titulo: "Ver site",
+      open: false,
+      aoClicar: { funcao: "abrirForaDoApp", argumentos: ["https://exemplo.com/pedido/123"], open: false }
+    }
   ],
-  aoClicar: {
-    acao: "abrir-rota",
-    rota: "/pedido/123",
-    dados: { id: 123 }
-  }
+  aoClicar: () => abrirForaDoApp("https://exemplo.com/pedido/123")
 });
 
 agendarNotificacao({
@@ -437,8 +474,8 @@ agendarNotificacao({
   texto: "Hora de abrir o app",
   quando: Date.now() + 60000,
   aoClicar: {
-    acao: "abrir-rota",
-    rota: "/lembretes"
+    funcao: "abrirNoApp",
+    argumentos: ["#/lembretes"]
   }
 });
 
@@ -466,8 +503,75 @@ const loop = await agendarLoopNotificacoes({
 fullscreen(true);
 ```
 
+`notificar()` nao obriga clique, botao nem funcao. So `titulo` e `texto` ja geram uma notificacao normal. `aoClicar`, `acoes`/`actions` e `open` sao opcionais.
+
 `agendarNotificacao()` agenda uma notificacao. Se voce passar um array para ela, ou usar `agendarNotificacoes()`, o html2apk agenda varias em sequencia. Cada item recebe `id` automatico se voce nao informar um.
 
+Em `aoClicar`, voce pode passar uma funcao diretamente:
+
+```js
+await notificar({
+  titulo: "Pedido aprovado",
+  texto: "Toque para abrir os detalhes",
+  aoClicar: () => abrirForaDoApp("https://exemplo.com/pedido/123")
+});
+```
+
+Nao use `aoClicar: { acao: abrirForaDoApp("https://...") }`, porque os parenteses executam a funcao na hora em que a notificacao e criada. Para notificacao agendada, loop ou app fechado, prefira o formato serializavel:
+
+```js
+await agendarNotificacao({
+  titulo: "Pedido aprovado",
+  texto: "Toque para abrir os detalhes",
+  quando: Date.now() + 60000,
+  aoClicar: {
+    funcao: "abrirForaDoApp",
+    argumentos: ["https://exemplo.com/pedido/123"]
+  }
+});
+```
+
+Esse formato tambem aceita funcoes suas, desde que elas existam em `window` quando o app abrir:
+
+```js
+window.abrirPedido = (id) => abrirNoApp("#/pedido/" + id);
+
+await notificar({
+  titulo: "Pedido aprovado",
+  texto: "Toque para abrir os detalhes",
+  aoClicar: { funcao: "abrirPedido", argumentos: [123] }
+});
+```
+
+Para botoes na notificacao, use `acoes` ou `actions`. Cada botao tambem aceita `aoClicar`/`onClick`:
+
+```js
+window.marcarPedidoLido = (id) => {
+  localStorage.setItem("pedido:" + id, "lido");
+};
+
+await notificar({
+  titulo: "Pedido aprovado",
+  texto: "Escolha uma acao",
+  acoes: [
+    {
+      id: "abrir",
+      titulo: "Abrir",
+      open: true,
+      aoClicar: { funcao: "abrirNoApp", argumentos: ["#/pedido/123"] }
+    },
+    {
+      id: "lido",
+      titulo: "Marcar lido",
+      open: false,
+      aoClicar: { funcao: "marcarPedidoLido", argumentos: [123], open: false }
+    }
+  ]
+});
+```
+
+`open: false` evita trazer a tela do app para frente. Se o app ainda estiver vivo em segundo plano, o html2apk dispara o evento e executa a funcao JavaScript. Se o Android tiver matado o app, JavaScript de WebView nao consegue rodar sem abrir o app; nesse caso, acoes externas como `{ funcao: "abrirForaDoApp", argumentos: ["https://..."], open: false }` ainda funcionam por fallback nativo.
+
 `agendarLoopNotificacoes()` cria um loop recorrente que funciona com o app fechado. Use `aCada`, `intervalo`, `every` ou `interval` em milissegundos ou como texto (`"30min"`, `"12h"`, `"1d"`). A cada disparo, o Android mostra a proxima notificacao da lista. Para parar:
 
 ```js

package/examples/minimal/app.json

@@ -3,6 +3,7 @@
   "appName": "MeuApp",
   "packageId": "com.seuapp.meuapp",
   "version": "1.0.0",
+  "buildFormat": "apk",
   "mode": "fullscreen",
   "orientation": "default",
   "minSdkVersion": 24,
@@ -18,6 +19,7 @@
   ],
   "plugins": [],
   "release": false,
+  "showRuntimeLogs": false,
   "androidPlatform": "android@15.0.0",
   "keystore": {
     "path": "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html2apk",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "Node CLI and library to turn an HTML/CSS/JS folder into an Android APK through Cordova.",
   "main": "index.js",
   "bin": {

package/src/cli/index.js

@@ -10,7 +10,7 @@ function printHelp() {
 
 Usage:
   html2apk init
-  html2apk build [--release] [--debug] [--mode fullscreen|standalone|floating] [--theme fixed|auto] [--orientation vertical|horizontal] [--min-sdk 24] [--android-platform android@15.0.0]
+  html2apk build [--release] [--debug] [--apk|--aab] [--show-runtime-logs] [--mode fullscreen|standalone|floating] [--theme fixed|auto] [--orientation vertical|horizontal] [--min-sdk 24] [--android-platform android@15.0.0]
   html2apk doctor
 
 The current working directory is always treated as the user app root.`);
@@ -25,6 +25,15 @@ function parseBuildArgs(args) {
       options.release = true;
     } else if (arg === "--debug") {
       options.debug = true;
+    } else if (arg === "--aab") {
+      options.buildFormat = "aab";
+    } else if (arg === "--apk") {
+      options.buildFormat = "apk";
+    } else if (arg === "--show-runtime-logs" || arg === "--runtime-logs" || arg === "--mostrar-logs") {
+      options.showRuntimeLogs = true;
+    } else if (arg === "--build-format" || arg === "--output-format" || arg === "--format") {
+      options.buildFormat = args[index + 1];
+      index += 1;
     } else if (arg === "--mode") {
       options.mode = args[index + 1];
       index += 1;
@@ -94,6 +103,8 @@ function createPlaceholderConfig(projectName = "MeuApp") {
     ],
     plugins: [],
     release: false,
+    buildFormat: "apk",
+    showRuntimeLogs: false,
     androidPlatform: "android@15.0.0",
     keystore: {
       path: "",

package/src/cordova/apk-finder.js

@@ -3,7 +3,7 @@
 const fs = require("fs/promises");
 const path = require("path");
 
-async function walk(dirPath, results = []) {
+async function walk(dirPath, extension, results = []) {
   let entries = [];
   try {
     entries = await fs.readdir(dirPath, { withFileTypes: true });
@@ -14,8 +14,8 @@ async function walk(dirPath, results = []) {
   for (const entry of entries) {
     const fullPath = path.join(dirPath, entry.name);
     if (entry.isDirectory()) {
-      await walk(fullPath, results);
-    } else if (entry.isFile() && entry.name.endsWith(".apk")) {
+      await walk(fullPath, extension, results);
+    } else if (entry.isFile() && entry.name.toLowerCase().endsWith(extension)) {
       const stat = await fs.stat(fullPath);
       results.push({ path: fullPath, mtimeMs: stat.mtimeMs });
     }
@@ -24,22 +24,34 @@ async function walk(dirPath, results = []) {
   return results;
 }
 
-async function findApk(buildDir, options) {
-  const outputRoot = path.join(buildDir, "platforms", "android", "app", "build", "outputs", "apk");
-  const apks = await walk(outputRoot);
+function artifactFormat(options = {}) {
+  return String(options.buildFormat || options.outputFormat || options.packageType || "").toLowerCase() === "aab" ? "aab" : "apk";
+}
+
+async function findAndroidArtifact(buildDir, options) {
+  const format = artifactFormat(options);
+  const outputRoot = path.join(buildDir, "platforms", "android", "app", "build", "outputs", format === "aab" ? "bundle" : "apk");
+  const extension = `.${format}`;
+  const artifacts = await walk(outputRoot, extension);
 
-  if (apks.length === 0) {
-    throw new Error("Cordova build finished, but no APK was found.");
+  if (artifacts.length === 0) {
+    throw new Error(`Cordova build finished, but no ${format.toUpperCase()} was found.`);
   }
 
   const expectedFlavor = options.release ? "release" : "debug";
-  const preferred = apks
+  const preferred = artifacts
     .filter((item) => item.path.toLowerCase().includes(expectedFlavor))
     .sort((a, b) => b.mtimeMs - a.mtimeMs)[0];
 
-  return (preferred || apks.sort((a, b) => b.mtimeMs - a.mtimeMs)[0]).path;
+  return (preferred || artifacts.sort((a, b) => b.mtimeMs - a.mtimeMs)[0]).path;
+}
+
+async function findApk(buildDir, options) {
+  return findAndroidArtifact(buildDir, { ...options, buildFormat: "apk" });
 }
 
 module.exports = {
+  artifactFormat,
+  findAndroidArtifact,
   findApk
 };

package/src/cordova/project.js

@@ -30,6 +30,7 @@ async function addAndroidPlatform(buildDir, options, runner) {
 
 async function buildAndroid(buildDir, options, buildJsonPath, runner) {
   const args = ["build", "android", "--no-telemetry"];
+  const wantsBundle = String(options.buildFormat || options.outputFormat || options.packageType || "").toLowerCase() === "aab";
 
   if (options.release) {
     args.push("--release");
@@ -41,6 +42,10 @@ async function buildAndroid(buildDir, options, buildJsonPath, runner) {
     args.push("--buildConfig", buildJsonPath);
   }
 
+  if (wantsBundle) {
+    args.push("--", "--packageType=bundle");
+  }
+
   await runner.run("cordova", args, {
     cwd: buildDir,
     pipeOutput: options.debug

package/src/core/build-apk.js

@@ -7,16 +7,20 @@ const { resolveBuildOptions } = require("./config");
 const { validateEntryFile, validateRequiredOptions } = require("./validation");
 const { createCordovaProject, addAndroidPlatform, buildAndroid, runAndroidDevice, addCordovaPlugin } = require("../cordova/project");
 const { writeConfigXml } = require("../cordova/config-xml");
-const { findApk } = require("../cordova/apk-finder");
+const { artifactFormat, findAndroidArtifact, findApk } = require("../cordova/apk-finder");
 const { copyWebAssets, ensureDir, removePath, copyFile, copyDirectory } = require("../utils/fs-extra");
 const { createCommandRunner } = require("../utils/command-runner");
 const { installBridgePlugin } = require("../bridge/install-bridge");
 const { getRuntimeEnvironment } = require("../runtime-manager");
 
 const AUTO_THEME_SCRIPT_NAME = "html2apk-auto-theme.js";
+const EARLY_BRIDGE_SCRIPT_NAME = "html2apk-early-bridge.js";
+const RUNTIME_CONSOLE_SCRIPT_NAME = "html2apk-runtime-console.js";
+const RUNTIME_CONSOLE_ICON_NAME = "html2apk-console.png";
 const ONESIGNAL_SCRIPT_NAME = "html2apk-onesignal.js";
 const ONESIGNAL_PLUGIN_PACKAGE = "onesignal-cordova-plugin";
 const DEFAULT_APP_ICON_NAME = "html2apk.png";
+const DEFAULT_CONSOLE_ICON_NAME = "console.png";
 
 function defaultAppIconPath() {
   return path.resolve(__dirname, "..", "..", DEFAULT_APP_ICON_NAME);
@@ -59,23 +63,64 @@ function hasOneSignal(options) {
   return oneSignalAppId(options).length > 0;
 }
 
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function scriptTag(scriptPath) {
   return `<script src="${scriptPath}"></script>`;
 }
 
-async function injectCordovaRuntimeIntoHtml(htmlPath, scriptPath = "cordova.js") {
+async function findHtmlFiles(dirPath, results = []) {
+  let entries = [];
+  try {
+    entries = await fs.readdir(dirPath, { withFileTypes: true });
+  } catch {
+    return results;
+  }
+
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      await findHtmlFiles(fullPath, results);
+    } else if (entry.isFile() && /\.html?$/i.test(entry.name)) {
+      results.push(fullPath);
+    }
+  }
+
+  return results;
+}
+
+async function injectCordovaRuntimeIntoHtml(htmlPath, scriptPath = "cordova.js", earlyBridgePath = EARLY_BRIDGE_SCRIPT_NAME, runtimeConsolePath = null) {
   let html = await fs.readFile(htmlPath, "utf8");
-  if (/<script\b[^>]*\bsrc=["'][^"']*cordova\.js["'][^>]*>/i.test(html)) {
+  const hasCordova = /<script\b[^>]*\bsrc=["'][^"']*cordova\.js["'][^>]*>/i.test(html);
+  const hasEarlyBridge = /<script\b[^>]*\bsrc=["'][^"']*html2apk-early-bridge\.js["'][^>]*>/i.test(html);
+  const hasRuntimeConsole = /<script\b[^>]*\bsrc=["'][^"']*html2apk-runtime-console\.js["'][^>]*>/i.test(html);
+  if (hasCordova && hasEarlyBridge && (!runtimeConsolePath || hasRuntimeConsole)) {
+    return false;
+  }
+
+  const tags = [
+    hasEarlyBridge ? null : scriptTag(earlyBridgePath),
+    runtimeConsolePath && !hasRuntimeConsole ? scriptTag(runtimeConsolePath) : null,
+    hasCordova ? null : scriptTag(scriptPath)
+  ].filter(Boolean).join("\n  ");
+
+  if (!tags) {
     return false;
   }
 
-  const tag = scriptTag(scriptPath);
   if (/<head\b[^>]*>/i.test(html)) {
-    html = html.replace(/<head\b[^>]*>/i, (match) => `${match}\n  ${tag}`);
+    html = html.replace(/<head\b[^>]*>/i, (match) => `${match}\n  ${tags}`);
   } else if (/<html\b[^>]*>/i.test(html)) {
-    html = html.replace(/<html\b[^>]*>/i, (match) => `${match}\n  ${tag}`);
+    html = html.replace(/<html\b[^>]*>/i, (match) => `${match}\n  ${tags}`);
   } else {
-    html = `${tag}\n${html}`;
+    html = `${tags}\n${html}`;
   }
 
   await fs.writeFile(htmlPath, html, "utf8");
@@ -85,13 +130,39 @@ async function injectCordovaRuntimeIntoHtml(htmlPath, scriptPath = "cordova.js")
 async function installCordovaRuntimeScript(buildDir, options) {
   const wwwDir = path.join(buildDir, "www");
   const entryHtmlPath = path.resolve(wwwDir, options.entryFile || "index.html");
-  const scriptPath = toCordovaPath(path.relative(path.dirname(entryHtmlPath), path.join(wwwDir, "cordova.js"))) || "cordova.js";
+  const earlyBridgeSource = path.resolve(__dirname, "..", "templates", EARLY_BRIDGE_SCRIPT_NAME);
+  const earlyBridgeTarget = path.join(wwwDir, EARLY_BRIDGE_SCRIPT_NAME);
+  const runtimeConsoleSource = path.resolve(__dirname, "..", "templates", RUNTIME_CONSOLE_SCRIPT_NAME);
+  const runtimeConsoleTarget = path.join(wwwDir, RUNTIME_CONSOLE_SCRIPT_NAME);
+  const runtimeConsoleIconSource = path.resolve(__dirname, "..", "..", DEFAULT_CONSOLE_ICON_NAME);
+  const runtimeConsoleIconTarget = path.join(wwwDir, RUNTIME_CONSOLE_ICON_NAME);
+  const htmlFiles = await findHtmlFiles(wwwDir);
+  let injectedCount = 0;
 
   if (!isInside(wwwDir, entryHtmlPath)) {
     throw new Error(`Entry file must stay inside the Cordova www folder: ${options.entryFile}`);
   }
 
-  return injectCordovaRuntimeIntoHtml(entryHtmlPath, scriptPath);
+  await copyFile(earlyBridgeSource, earlyBridgeTarget);
+  if (options.showRuntimeLogs) {
+    await copyFile(runtimeConsoleSource, runtimeConsoleTarget);
+    if (await pathExists(runtimeConsoleIconSource)) {
+      await copyFile(runtimeConsoleIconSource, runtimeConsoleIconTarget);
+    }
+  }
+
+  for (const htmlPath of htmlFiles) {
+    const scriptPath = toCordovaPath(path.relative(path.dirname(htmlPath), path.join(wwwDir, "cordova.js"))) || "cordova.js";
+    const earlyBridgePath = toCordovaPath(path.relative(path.dirname(htmlPath), earlyBridgeTarget)) || EARLY_BRIDGE_SCRIPT_NAME;
+    const runtimeConsolePath = options.showRuntimeLogs
+      ? (toCordovaPath(path.relative(path.dirname(htmlPath), runtimeConsoleTarget)) || RUNTIME_CONSOLE_SCRIPT_NAME)
+      : null;
+    if (await injectCordovaRuntimeIntoHtml(htmlPath, scriptPath, earlyBridgePath, runtimeConsolePath)) {
+      injectedCount += 1;
+    }
+  }
+
+  return injectedCount;
 }
 
 async function injectScriptIntoHtml(htmlPath, scriptPath) {
@@ -254,7 +325,7 @@ async function createBuildJson(buildDir, options, projectRoot) {
   const storeFile = path.resolve(projectRoot, options.keystore.path);
   const buildJsonPath = path.join(buildDir, "build.json");
   const release = {
-    packageType: "apk",
+    packageType: artifactFormat(options) === "aab" ? "bundle" : "apk",
     keystore: storeFile,
     storePassword: options.keystore.storePassword || options.keystore.password,
     alias: options.keystore.alias,
@@ -272,10 +343,11 @@ async function createBuildJson(buildDir, options, projectRoot) {
   return buildJsonPath;
 }
 
-function outputApkName(options) {
+function outputAndroidName(options) {
   const safeName = String(options.appName || "app").replace(/[^a-zA-Z0-9._-]+/g, "-");
   const flavor = options.release ? "release" : "debug";
-  return `${safeName}-${options.version}-${flavor}.apk`;
+  const extension = artifactFormat(options);
+  return `${safeName}-${options.version}-${flavor}.${extension}`;
 }
 
 function parseAdbDevices(output) {
@@ -339,8 +411,12 @@ async function prepareCordovaProject(projectRoot, buildDir, options, runner, log
   cordovaOptions.androidSplashScreenAnimatedIcon = toBuildAssetPath(buildDir, cordovaOptions.splash);
   await writeConfigXml(path.join(buildDir, "config.xml"), cordovaOptions);
   await copyWebAssets(path.resolve(projectRoot, options.webRoot || "."), path.join(buildDir, "www"), options, projectRoot);
-  if (await installCordovaRuntimeScript(buildDir, options)) {
-    log("Cordova runtime: injected cordova.js into the entry HTML.");
+  const injectedRuntimePages = await installCordovaRuntimeScript(buildDir, options);
+  if (injectedRuntimePages) {
+    log(`Cordova runtime: injected scripts into ${injectedRuntimePages} HTML page(s).`);
+  }
+  if (options.showRuntimeLogs) {
+    log("Runtime console: enabled inside the generated APK.");
   }
   if (await installAutoThemeScript(buildDir, options)) {
     log("Theme mode: auto (system bars follow the visible screen color).");
@@ -363,14 +439,14 @@ async function prepareCordovaProject(projectRoot, buildDir, options, runner, log
   await addAndroidPlatform(buildDir, options, runner);
 }
 
-async function copyBuiltApk(projectRoot, buildDir, options) {
-  const apkPathInBuild = await findApk(buildDir, options);
+async function copyBuiltArtifact(projectRoot, buildDir, options) {
+  const artifactPathInBuild = await findAndroidArtifact(buildDir, options);
   const outputDir = path.resolve(projectRoot, options.outputDir || "dist");
   await ensureDir(outputDir);
 
-  const apkPath = path.join(outputDir, outputApkName(options));
-  await copyFile(apkPathInBuild, apkPath);
-  return apkPath;
+  const artifactPath = path.join(outputDir, outputAndroidName(options));
+  await copyFile(artifactPathInBuild, artifactPath);
+  return artifactPath;
 }
 
 async function ensureBuiltDebugApk(buildDir, options, runner, log) {
@@ -448,7 +524,8 @@ async function buildApk(overrides = {}) {
     const buildJsonPath = await createBuildJson(buildDir, options, projectRoot);
     await buildAndroid(buildDir, options, buildJsonPath, runner);
 
-    const apkPath = await copyBuiltApk(projectRoot, buildDir, options);
+    const artifactPath = await copyBuiltArtifact(projectRoot, buildDir, options);
+    const artifactType = artifactFormat(options);
 
     if (!options.debug) {
       await removePath(tempRoot);
@@ -456,7 +533,9 @@ async function buildApk(overrides = {}) {
     }
 
     return {
-      apkPath,
+      apkPath: artifactPath,
+      artifactPath,
+      artifactType,
       buildDir: options.debug ? buildDir : null,
       logs,
       status: "success",
@@ -523,7 +602,7 @@ async function runDebugUsb(overrides = {}) {
       await installDebugApkWithAdb(buildDir, options, runner, device, log);
     }
 
-    const apkPath = await copyBuiltApk(projectRoot, buildDir, options);
+    const apkPath = await copyBuiltArtifact(projectRoot, buildDir, { ...options, buildFormat: "apk" });
 
     if (!options.debug) {
       await removePath(tempRoot);
@@ -560,6 +639,7 @@ module.exports = {
   buildApk,
   defaultAppIconPath,
   injectCordovaRuntimeIntoHtml,
+  installCordovaRuntimeScript,
   parseAdbDevices,
   runDebugUsb
 };

package/src/core/config.js

@@ -94,12 +94,23 @@ function normalizeOptions(options) {
     : "default";
   normalized.debug = Boolean(normalized.debug);
   normalized.release = Boolean(normalized.release);
+  normalized.buildFormat = normalizeBuildFormat(normalized.buildFormat || normalized.outputFormat || normalized.artifactType || normalized.packageType);
+  if (normalized.buildFormat === "aab") {
+    normalized.release = true;
+  }
   const themeColorText = String(normalized.themeColor || "").trim().toLowerCase();
   const themeModeText = String(normalized.themeMode || "").trim().toLowerCase();
   const themeText = String(normalized.theme || "").trim().toLowerCase();
   normalized.themeMode = themeModeText === "auto" || themeText === "auto" || themeColorText === "auto" ? "auto" : "fixed";
   normalized.theme = normalized.themeMode;
   normalized.themeColor = normalizeThemeColor(themeColorText === "auto" ? normalized.backgroundColor : normalized.themeColor);
+  normalized.showRuntimeLogs = Boolean(
+    normalized.showRuntimeLogs ||
+    normalized.mostrarLogs ||
+    normalized.runtimeLogs ||
+    normalized.debugConsole ||
+    normalized.console
+  );
   normalized.oneSignalAppId = normalizeOneSignalAppId(normalized.oneSignalAppId || normalized.onesignalAppId || normalized.oneSignal?.appId || normalized.onesignal?.appId);
   normalized.minSdkVersion = normalizeMinSdkVersion(normalized.minSdkVersion || normalized.androidMinSdkVersion);
   normalized.permissions = Array.isArray(normalized.permissions)
@@ -119,6 +130,10 @@ function normalizeOneSignalAppId(value) {
   return String(value || "").trim();
 }
 
+function normalizeBuildFormat(value) {
+  return String(value || "").trim().toLowerCase() === "aab" ? "aab" : "apk";
+}
+
 function normalizeDeepLinks(value) {
   const input = value && typeof value === "object" ? value : {};
   const schemes = Array.isArray(input.schemes)
@@ -164,5 +179,6 @@ module.exports = {
   normalizeMinSdkVersion,
   normalizeThemeMode,
   normalizeOneSignalAppId,
+  normalizeBuildFormat,
   normalizeDeepLinks
 };

package/src/core/defaults.js

@@ -27,11 +27,13 @@ function createDefaultOptions(projectRoot) {
     permissions: ["INTERNET", "POST_NOTIFICATIONS", "VIBRATE"],
     plugins: [],
     release: false,
+    buildFormat: "apk",
     keystore: null,
     androidPlatform: "android@15.0.0",
     minSdkVersion: DEFAULT_ANDROID_MIN_SDK_VERSION,
     themeColor: "#126fff",
     themeMode: "fixed",
+    showRuntimeLogs: false,
     oneSignalAppId: "",
     deepLinks: {
       schemes: [],