html2apk 0.2.0 → 0.4.0

package/README.md

@@ -186,6 +186,7 @@ html2apk build --entry-file index.html
 html2apk build --web-root .
 html2apk build --app-name MeuApp
 html2apk build --package-id com.seuapp.meuapp
+html2apk build --theme auto
 html2apk build --android-platform android@15.0.0
 ```
 
@@ -209,9 +210,21 @@ Exemplo completo:
   "orientation": "default",
   "minSdkVersion": 24,
   "themeColor": "#126fff",
+  "themeMode": "fixed",
+  "oneSignalAppId": "",
   "icon": "",
   "splash": "",
-  "permissions": ["INTERNET", "CAMERA", "POST_NOTIFICATIONS", "VIBRATE"],
+  "deepLinks": {
+    "schemes": ["meuapp"],
+    "appLinks": [
+      {
+        "host": "meusite.com",
+        "paths": ["/produto/*", "/pedido/*"],
+        "autoVerify": false
+      }
+    ]
+  },
+  "permissions": ["INTERNET", "CAMERA", "RECORD_AUDIO", "POST_NOTIFICATIONS", "VIBRATE"],
   "plugins": ["cordova-plugin-camera"],
   "release": false,
   "androidPlatform": "android@15.0.0",
@@ -238,7 +251,11 @@ Campos principais:
 | `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`. |
-| `themeColor` | Cor base do tema/splash Android, em hexadecimal. |
+| `themeColor` | Cor base do tema/splash Android, em hexadecimal. Tambem vira fallback do modo automatico. |
+| `icon` | Icone PNG do app. Se ficar vazio, o html2apk usa automaticamente o icone padrao da ferramenta. |
+| `themeMode` | `fixed` usa a cor fixa. `auto` adapta as barras Android a cor visivel na tela do APK. Tambem aceita `theme: "auto"`. |
+| `oneSignalAppId` | Opcional. App ID publico do OneSignal para push remoto. Nao coloque REST API Key no APK. |
+| `deepLinks` | URLs que podem abrir o APK, como `meuapp://rota` ou `https://meusite.com/produto/1`. |
 | `entryFile` | Arquivo HTML inicial. Normalmente `index.html`. |
 | `webRoot` | Pasta onde estao os arquivos web. Normalmente `"."`. |
 | `permissions` | Permissoes Android adicionadas ao app. |
@@ -254,6 +271,33 @@ Prioridade de configuracao:
 2. `app.json` ou `config.json`.
 3. Valores padrao do html2apk.
 
+### Tema Automatico Do APK
+
+Use `themeMode: "auto"` ou `theme: "auto"` para o APK adaptar as barras nativas do Android a cor que esta visivel na tela. O html2apk observa a tela do WebView e ajusta status bar/navigation bar em tempo real.
+
+```json
+{
+  "themeMode": "auto",
+  "themeColor": "#126fff"
+}
+```
+
+`themeColor` continua importante: ela e usada no splash e como fallback quando o app ainda nao conseguiu detectar uma cor visivel.
+
+### OneSignal Opcional
+
+Se quiser receber notificacoes remotas pelo OneSignal, preencha `oneSignalAppId` no `app.json` ou no campo OneSignal App ID da interface grafica:
+
+```json
+{
+  "oneSignalAppId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+}
+```
+
+Quando esse campo esta vazio, nada do OneSignal e instalado no APK. Quando ele esta preenchido, o html2apk instala `onesignal-cordova-plugin`, injeta a inicializacao no HTML e mantem as notificacoes locais existentes (`notificar`, `agendarNotificacao`, loops etc.).
+
+Importante: o App ID do OneSignal pode ficar no APK. A REST API Key nao deve ir no app, porque e segredo de servidor. Envie pushes pelo painel do OneSignal ou por um backend seu.
+
 ## Exemplo Minimo
 
 Este repositorio ja inclui um exemplo em:
@@ -310,19 +354,77 @@ Retorno:
 
 ## Bridge Nativa
 
-A v0.1 instala um plugin Cordova local com uma API global simples para recursos Android.
+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.
+
+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.
+
+Exemplos de aliases:
+
+| PT-BR | English |
+| --- | --- |
+| `notificar()` | `notify()` |
+| `agendarNotificacao()` | `scheduleNotification()` |
+| `agendarNotificacoes()` | `scheduleNotifications()` |
+| `agendarLoopNotificacoes()` | `scheduleNotificationLoop()` |
+| `cancelarNotificacao()` | `cancelNotification()` |
+| `solicitarPermissaoNotificacoes()` | `requestNotificationPermission()` |
+| `solicitarPermissaoPush()` | `requestPushPermission()` |
+| `aoClicarPush()` | `onPushClick()` |
+| `identificarUsuarioPush()` | `loginPushUser()` |
+| `adicionarTagPush()` | `addPushTag()` |
+| `solicitarPermissaoMicrofone()` | `requestMicrophonePermission()` |
+| `statusMicrofone()` | `microphoneStatus()` |
+| `ouvirMic()` | `listenMic()` / `startMic()` |
+| `pararMic()` | `stopMic()` |
+| `lanterna()` | `flashlight()` |
+| `alternarLanterna()` | `toggleFlashlight()` |
+| `escolherArquivo()` | `pickFile()` |
+| `escolherImagem()` | `pickImage()` |
+| `salvarArquivo()` | `saveFile()` |
+| `compartilhar()` | `share()` |
+| `copiarTexto()` | `copyText()` |
+| `lerTextoCopiado()` | `readText()` |
+| `abrirNoApp()` | `openInApp()` |
+| `abrirForaDoApp()` | `openOutsideApp()` |
+| `abrirUrlExterno()` | `openExternalUrl()` |
+| `manterTelaLigada()` | `keepScreenOn()` |
+| `brilhoTela()` | `setScreenBrightness()` |
+| `definirCorTema()` | `setThemeColor()` |
+| `infoMemoria()` | `memoryInfo()` |
+| `infoArmazenamento()` | `storageInfo()` |
+| `infoDesempenho()` | `performanceInfo()` |
+| `appsAbertos()` | `openAppsMemory()` |
+| `aoEvento()` | `onEvent()` |
+| `aoMinimizar()` | `onMinimize()` |
+| `obterLinkInicial()` | `getInitialLink()` |
+
+Os eventos tambem aceitam aliases em ingles em `onEvent()`: `app:ready`, `app:background`, `app:resumed`, `back:button`, `link:opened`, `network:changed`, `battery:changed`, `notification:received` e `notification:clicked`.
+
+Como tratar retornos:
+
+- Use `await` dentro de `try/catch` quando a acao depender de Android, permissao ou outro app instalado.
+- Seletores de arquivo podem retornar `null`, array vazio ou objeto vazio quando o usuario cancela.
+- Funcoes que precisam de permissao pedem automaticamente quando sao chamadas, como `lanterna()`, `notificar()` e `ouvirMic()`.
+- Se o Android nao puder mostrar o pop-up de permissao, o html2apk abre a tela correta de configuracoes e retorna `settingsOpened: true`.
+- APIs manuais de permissao continuam existindo para quem quer explicar antes; elas retornam objetos com `granted`, `requiresSettings` e `settingsOpened`.
+- Eventos retornam uma funcao de cancelamento; guarde essa funcao e chame quando a tela/componente sair.
+- Medidas de memoria, armazenamento e apps abertos sao diagnosticas. Android moderno pode limitar dados de outros apps por privacidade.
 
 No seu JavaScript do app:
 
 ```js
-await solicitarPermissaoNotificacoes();
-
 toast("Mensagem");
 vibrar(250);
 
 notificar({
   titulo: "Pedido aprovado",
   texto: "Toque para abrir os detalhes",
+  acoes: [
+    { id: "abrir", titulo: "Abrir" },
+    { id: "cancelar", titulo: "Cancelar" }
+  ],
   aoClicar: {
     acao: "abrir-rota",
     rota: "/pedido/123",
@@ -340,9 +442,216 @@ agendarNotificacao({
   }
 });
 
+await agendarNotificacoes([
+  { titulo: "Primeiro aviso", texto: "Daqui 1 minuto", quando: Date.now() + 60000 },
+  { titulo: "Segundo aviso", texto: "Daqui 2 minutos", quando: Date.now() + 120000 }
+]);
+
+const loop = await agendarLoopNotificacoes({
+  aCada: "12h",
+  notificacoes: [
+    {
+      titulo: "Hidrate-se",
+      texto: "Beba agua agora",
+      aoClicar: { acao: "abrir-hidratacao" }
+    },
+    {
+      titulo: "Alongamento",
+      texto: "Pausa rapida para alongar",
+      aoClicar: { acao: "abrir-alongamento" }
+    }
+  ]
+});
+
 fullscreen(true);
 ```
 
+`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.
+
+`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
+await cancelarNotificacao(loop.id);
+```
+
+Cliques continuam chegando normalmente:
+
+```js
+aoClicarNotificacao((evento) => {
+  if ((evento.aoClicar || evento.onClick).acao === "abrir-hidratacao") {
+    abrirNoApp("#/hidratacao");
+  }
+});
+```
+
+As notificacoes usam o icone do APK gerado como icone nativo. No Android, esse icone pode aparecer monocromatico na barra de notificacoes por regra do sistema.
+
+OneSignal, quando `oneSignalAppId` esta preenchido:
+
+```js
+const permitido = await solicitarPermissaoPush();
+
+identificarUsuarioPush("user-123");
+adicionarTagPush("plano", "premium");
+
+const pararPush = aoClicarPush((evento) => {
+  console.log("Push clicado", evento);
+  abrirNoApp("#/notificacoes");
+});
+```
+
+Use OneSignal para pushes enviados remotamente pelo painel/API do OneSignal. Use `notificar()` e `agendarNotificacao()` para notificacoes locais criadas dentro do APK.
+
+Arquivos, galeria e compartilhamento:
+
+```js
+const imagem = await escolherImagem();
+const imagens = await escolherImagens({ multiplo: true });
+const pdf = await escolherArquivo({ tipos: ["application/pdf"] });
+const arquivos = await escolherArquivos({ multiplo: true });
+
+await salvarArquivo({
+  nome: "relatorio.txt",
+  mimeType: "text/plain",
+  conteudo: "Conteudo salvo pelo app"
+});
+
+await compartilhar({ texto: "Veja isso", url: "https://exemplo.com" });
+```
+
+O retorno de arquivos tem este formato:
+
+```json
+{
+  "uri": "content://...",
+  "name": "foto.png",
+  "nome": "foto.png",
+  "size": 12345,
+  "tamanho": 12345,
+  "mimeType": "image/png"
+}
+```
+
+Microfone:
+
+```js
+const inicio = await ouvirMic();
+if (inicio.settingsOpened) {
+  console.log("Libere Microfone nas configuracoes e tente novamente");
+} else {
+  // ... depois, quando quiser parar
+  const audio = await pararMic();
+  const audioUrl = `data:${audio.mimeType};base64,${audio.base64}`;
+
+  const player = new Audio(audioUrl);
+  player.play();
+}
+```
+
+`ouvirMic()` comeca a gravar e tambem pede permissao se ela ainda nao foi concedida. Se a permissao estiver bloqueada pelo Android, a tela de configuracoes do app e aberta automaticamente e o retorno traz `settingsOpened: true`.
+
+`pararMic()` encerra a gravacao e retorna:
+
+```json
+{
+  "base64": "AAAA...",
+  "mimeType": "audio/mp4",
+  "extension": "m4a",
+  "size": 12345,
+  "durationMs": 3200
+}
+```
+
+Para tratar o retorno, use `mimeType` e `base64` juntos em um Data URL quando quiser tocar, baixar ou enviar o audio. Se `pararMic()` for chamado rapido demais, o Android pode nao conseguir finalizar o arquivo; aguarde alguns instantes apos `ouvirMic()`.
+
+Lanterna, tela, clipboard e intents:
+
+```js
+const lanternaStatus = await lanterna(true);
+await alternarLanterna();
+
+await manterTelaLigada(true);
+await brilhoTela(0.8);
+
+await copiarTexto("codigo123");
+const texto = await lerTextoCopiado();
+
+await abrirNoApp("/sobre.html");
+await abrirNoApp("#/pedido/123", { substituir: true });
+await abrirForaDoApp("https://exemplo.com");
+await abrirWhatsapp("559999999999", "Oi");
+await discar("11999999999");
+await abrirMapa("Avenida Paulista, Sao Paulo");
+```
+
+Use `abrirNoApp()`/`openInApp()` quando a navegacao deve acontecer dentro do proprio APK/WebView. Use `abrirForaDoApp()`/`openOutsideApp()` ou `abrirUrlExterno()`/`openExternalUrl()` quando quer mandar o usuario para navegador, WhatsApp, Maps ou outro app Android.
+
+Informacoes e desempenho:
+
+```js
+const aparelho = await infoDispositivo();
+const rede = await infoRede();
+const bateria = await infoBateria();
+const memoria = await infoMemoria();
+const armazenamento = await infoArmazenamento();
+const desempenho = await infoDesempenho();
+const abertos = await appsAbertos();
+```
+
+`infoDesempenho()` agrupa memoria, armazenamento, bateria, rede e `timestamp`. Valores de memoria e armazenamento retornam bytes.
+
+`appsAbertos()` retorna os processos/apps que o Android permite o APK enxergar:
+
+```json
+{
+  "apps": [
+    {
+      "name": "MeuApp",
+      "packageName": "com.seuapp.meuapp",
+      "ramBytes": 12345678,
+      "ramMb": 11.77,
+      "importanceName": "foreground"
+    }
+  ],
+  "porNome": {
+    "MeuApp": {
+      "ramBytes": 12345678,
+      "ramMb": 11.77
+    }
+  },
+  "limited": true
+}
+```
+
+Por privacidade, Android moderno pode limitar essa lista ao proprio app e alguns processos visiveis ao APK. Entao essa funcao nao deve ser tratada como gerenciador completo de tarefas do sistema.
+
+Eventos nativos:
+
+```js
+const parar = aoEvento("app:background", (evento) => {
+  console.log("App saiu da frente", evento.timestamp);
+});
+
+aoEvento("app:voltou", console.log);
+aoEvento("botao:voltar", console.log);
+aoEvento("link:aberto", (evento) => console.log(evento.url));
+aoEvento("rede:mudou", console.log);
+aoEvento("bateria:mudou", console.log);
+aoEvento("notificacao:clicada", console.log);
+
+parar();
+```
+
+Deep links:
+
+```js
+const linkInicial = await obterLinkInicial();
+
+aoAbrirLink((evento) => {
+  console.log(evento.url, evento.path, evento.query);
+});
+```
+
 Clique em notificacao:
 
 ```js
@@ -361,9 +670,7 @@ Permissoes e alarmes:
 
 ```js
 const status = await statusPermissaoNotificacoes();
-if (!status.granted) {
-  await solicitarPermissaoNotificacoes();
-}
+console.log(status.granted);
 
 const podeUsarAlarmeExato = await podeAgendarNotificacaoExata();
 if (!podeUsarAlarmeExato) {
@@ -371,7 +678,7 @@ if (!podeUsarAlarmeExato) {
 }
 ```
 
-A bridge cria canal de notificacao, solicita/consulta `POST_NOTIFICATIONS` no Android 13+, abre o app com payload quando a notificacao e clicada, persiste notificacoes agendadas e tenta reagendar apos reboot ou update do app.
+A bridge cria canal de notificacao, solicita `POST_NOTIFICATIONS` automaticamente quando `notificar()`/`agendarNotificacao()` precisam, abre configuracoes se o Android bloquear o pop-up, abre o app com payload quando a notificacao e clicada, persiste notificacoes agendadas e tenta reagendar apos reboot ou update do app. Se voce usar `exato: true`/`exact: true` em uma notificacao agendada e o Android exigir liberacao manual de alarme exato, o html2apk abre essa tela automaticamente.
 
 ## Problemas Comuns
 
@@ -442,11 +749,15 @@ Fluxo da interface:
 1. Arraste ou escolha a pasta do projeto.
 2. O app mostra `verificando ambiente` antes de liberar as proximas etapas.
 3. Se faltarem pacotes do Android SDK, ele pede permissao e tenta baixar/instalar mostrando logs.
-4. Preencha as configuracoes obrigatorias: nome do app, Package ID, versao, modo e icone PNG.
-5. Revise, clique em `Gerar APK` e acompanhe a barra de progresso.
+4. Preencha as configuracoes obrigatorias: nome do app, Package ID, versao e modo. Se voce nao escolher icone, o html2apk usa o icone padrao da ferramenta.
+5. Revise e clique em `Gerar APK` para salvar o APK em `dist`, ou `Testar no USB` para gerar debug, instalar e abrir direto em um celular conectado.
 6. Ao concluir, a tela final mostra o APK gerado e botoes para abrir a pasta `dist` ou localizar o arquivo.
 
-O PNG escolhido e usado como icone do aplicativo e tambem como imagem da tela inicial do Android, evitando o splash padrao do Cordova.
+O PNG escolhido e usado como icone do aplicativo e tambem como imagem da tela inicial do Android, evitando o splash padrao do Cordova. Quando nenhum PNG e escolhido, o `html2apk.png` da propria ferramenta entra como fallback.
+
+Depois que a pasta foi escolhida, a interface acompanha mudancas nela automaticamente. Edicoes em HTML, CSS, JS e assets entram no proximo build sem arrastar a pasta de novo. Se `app.json` ou `config.json` mudar, os campos da tela de configuracoes sao recarregados.
+
+Para `Testar no USB`, o celular precisa estar com `Opcoes do desenvolvedor > Depuracao USB` ativa. Ao conectar, desbloqueie o aparelho e aceite a chave RSA. Se o Android aparecer como `unauthorized` ou `offline`, a interface mostra o que fazer nos logs.
 
 Os logs podem ser abertos em uma barra inferior durante qualquer etapa pelo botao `Mostrar logs`. Se atrapalhar a visualizacao, use `Ocultar logs` e a area principal volta a ocupar a altura da janela.
 

package/examples/minimal/app.json

@@ -7,6 +7,8 @@
   "orientation": "default",
   "minSdkVersion": 24,
   "themeColor": "#126fff",
+  "themeMode": "fixed",
+  "oneSignalAppId": "",
   "icon": "",
   "splash": "",
   "permissions": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html2apk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Node CLI and library to turn an HTML/CSS/JS folder into an Android APK through Cordova.",
   "main": "index.js",
   "bin": {
@@ -71,6 +71,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "cordova": "^13.0.0"
+    "cordova": "^13.0.0",
+    "onesignal-cordova-plugin": "^5.3.10"
   }
 }

package/src/cli/index.js

@@ -10,7 +10,7 @@ function printHelp() {
 
 Usage:
   html2apk init
-  html2apk build [--release] [--debug] [--mode fullscreen|standalone|floating] [--orientation vertical|horizontal] [--min-sdk 24] [--android-platform android@15.0.0]
+  html2apk build [--release] [--debug] [--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.`);
@@ -34,6 +34,9 @@ function parseBuildArgs(args) {
     } else if (arg === "--theme-color") {
       options.themeColor = args[index + 1];
       index += 1;
+    } else if (arg === "--theme" || arg === "--theme-mode") {
+      options.themeMode = args[index + 1];
+      index += 1;
     } else if (arg === "--min-sdk" || arg === "--min-sdk-version" || arg === "--minSdkVersion") {
       options.minSdkVersion = args[index + 1];
       index += 1;
@@ -76,6 +79,12 @@ function createPlaceholderConfig(projectName = "MeuApp") {
     orientation: "default",
     minSdkVersion: 24,
     themeColor: "#126fff",
+    themeMode: "fixed",
+    oneSignalAppId: "",
+    deepLinks: {
+      schemes: [],
+      appLinks: []
+    },
     icon: "",
     splash: "",
     permissions: [

package/src/cordova/config-xml.js

@@ -77,6 +77,59 @@ function renderAndroidSplashPreferences(options) {
   ].filter(Boolean).join("\n");
 }
 
+function renderDeepLinkData(pathItem) {
+  if (!pathItem || pathItem === "*" || pathItem === "/*") {
+    return "";
+  }
+
+  if (pathItem.includes("*")) {
+    return ` android:pathPattern="${xmlEscape(pathItem.replace(/\*/g, ".*"))}"`;
+  }
+
+  return ` android:pathPrefix="${xmlEscape(pathItem)}"`;
+}
+
+function renderDeepLinkIntentFilters(deepLinks = {}) {
+  const filters = [];
+  const schemes = Array.isArray(deepLinks.schemes) ? deepLinks.schemes : [];
+  const appLinks = Array.isArray(deepLinks.appLinks) ? deepLinks.appLinks : [];
+
+  for (const scheme of schemes) {
+    filters.push(`    <config-file target="AndroidManifest.xml" parent="/manifest/application/activity">
+      <intent-filter>
+        <action android:name="android.intent.action.VIEW" />
+        <category android:name="android.intent.category.DEFAULT" />
+        <category android:name="android.intent.category.BROWSABLE" />
+        <data android:scheme="${xmlEscape(scheme)}" />
+      </intent-filter>
+    </config-file>`);
+  }
+
+  for (const link of appLinks) {
+    if (!link || !link.host) {
+      continue;
+    }
+
+    const scheme = link.scheme || "https";
+    const paths = Array.isArray(link.paths) && link.paths.length ? link.paths : [""];
+    const dataItems = paths
+      .map((pathItem) => `        <data android:scheme="${xmlEscape(scheme)}" android:host="${xmlEscape(link.host)}"${renderDeepLinkData(pathItem)} />`)
+      .join("\n");
+    const verify = link.autoVerify ? " android:autoVerify=\"true\"" : "";
+
+    filters.push(`    <config-file target="AndroidManifest.xml" parent="/manifest/application/activity">
+      <intent-filter${verify}>
+        <action android:name="android.intent.action.VIEW" />
+        <category android:name="android.intent.category.DEFAULT" />
+        <category android:name="android.intent.category.BROWSABLE" />
+${dataItems}
+      </intent-filter>
+    </config-file>`);
+  }
+
+  return filters.join("\n");
+}
+
 function renderConfigXml(options) {
   const fullscreen = options.mode === "fullscreen" ? "true" : "false";
   const permissionsList = options.mode === "floating"
@@ -85,8 +138,11 @@ function renderConfigXml(options) {
   const permissions = renderPermissions(permissionsList);
   const icon = renderIcon(options.icon);
   const splashPreferences = renderAndroidSplashPreferences(options);
-  const platformItems = [permissions, icon, splashPreferences].filter(Boolean).join("\n");
+  const deepLinkIntentFilters = renderDeepLinkIntentFilters(options.deepLinks);
+  const platformItems = [permissions, deepLinkIntentFilters, icon, splashPreferences].filter(Boolean).join("\n");
   const backgroundPreference = renderPreference("BackgroundColor", options.themeColor || options.backgroundColor);
+  const themeModePreference = renderPreference("Html2ApkThemeMode", options.themeMode || options.theme || "fixed");
+  const oneSignalPreference = renderPreference("Html2ApkOneSignalAppId", options.oneSignalAppId);
   const modePreference = renderPreference("Html2ApkMode", options.mode || "standalone");
   const minSdkPreference = renderPreference(
     "android-minSdkVersion",
@@ -124,6 +180,8 @@ function renderConfigXml(options) {
   <preference name="GradlePluginKotlinEnabled" value="true" />
 ${minSdkPreference}
 ${modePreference}
+${themeModePreference}
+${oneSignalPreference}
 ${orientationPreference ? `${orientationPreference}\n` : ""}${backgroundPreference ? `${backgroundPreference}\n` : ""}
 
   <platform name="android">

package/src/cordova/project.js

@@ -47,10 +47,28 @@ async function buildAndroid(buildDir, options, buildJsonPath, runner) {
   });
 }
 
+async function runAndroidDevice(buildDir, options, buildJsonPath, runner, deviceId) {
+  const args = ["run", "android", "--device", "--debug", "--no-telemetry"];
+
+  if (deviceId) {
+    args.push(`--target=${deviceId}`);
+  }
+
+  if (buildJsonPath) {
+    args.push("--buildConfig", buildJsonPath);
+  }
+
+  await runner.run("cordova", args, {
+    cwd: buildDir,
+    pipeOutput: options.debug
+  });
+}
+
 module.exports = {
   DEFAULT_ANDROID_PLATFORM,
   createCordovaProject,
   addCordovaPlugin,
   addAndroidPlatform,
-  buildAndroid
+  buildAndroid,
+  runAndroidDevice
 };