html2apk 0.1.0 → 0.3.0

package/src/core/build-apk.js

@@ -8,11 +8,15 @@ const { validateEntryFile, validateRequiredOptions } = require("./validation");
 const { createCordovaProject, addAndroidPlatform, buildAndroid, addCordovaPlugin } = require("../cordova/project");
 const { writeConfigXml } = require("../cordova/config-xml");
 const { findApk } = require("../cordova/apk-finder");
-const { copyWebAssets, ensureDir, removePath, copyFile } = require("../utils/fs-extra");
+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 ONESIGNAL_SCRIPT_NAME = "html2apk-onesignal.js";
+const ONESIGNAL_PLUGIN_PACKAGE = "onesignal-cordova-plugin";
+
 function isRemoteAsset(assetPath) {
   return /^https?:\/\//i.test(String(assetPath || ""));
 }
@@ -34,6 +38,141 @@ function toCordovaPath(value) {
   return String(value).replace(/\\/g, "/");
 }
 
+function isAutoTheme(options) {
+  return String(options.themeMode || options.theme || "").toLowerCase() === "auto";
+}
+
+function oneSignalAppId(options) {
+  return String(options.oneSignalAppId || options.onesignalAppId || options.oneSignal?.appId || options.onesignal?.appId || "").trim();
+}
+
+function hasOneSignal(options) {
+  return oneSignalAppId(options).length > 0;
+}
+
+function scriptTag(scriptPath) {
+  return `<script src="${scriptPath}"></script>`;
+}
+
+async function injectScriptIntoHtml(htmlPath, scriptPath) {
+  let html = await fs.readFile(htmlPath, "utf8");
+  if (html.includes(scriptPath)) {
+    return;
+  }
+
+  const tag = scriptTag(scriptPath);
+  if (/<\/body>/i.test(html)) {
+    html = html.replace(/<\/body>/i, `  ${tag}\n</body>`);
+  } else {
+    html = `${html}\n${tag}\n`;
+  }
+
+  await fs.writeFile(htmlPath, html, "utf8");
+}
+
+async function installAutoThemeScript(buildDir, options) {
+  if (!isAutoTheme(options)) {
+    return false;
+  }
+
+  const wwwDir = path.join(buildDir, "www");
+  const source = path.resolve(__dirname, "..", "templates", AUTO_THEME_SCRIPT_NAME);
+  const target = path.join(wwwDir, AUTO_THEME_SCRIPT_NAME);
+  const entryHtmlPath = path.resolve(wwwDir, options.entryFile || "index.html");
+  const scriptPath = toCordovaPath(path.relative(path.dirname(entryHtmlPath), target));
+
+  if (!isInside(wwwDir, entryHtmlPath)) {
+    throw new Error(`Entry file must stay inside the Cordova www folder: ${options.entryFile}`);
+  }
+
+  await copyFile(source, target);
+  await injectScriptIntoHtml(entryHtmlPath, scriptPath || AUTO_THEME_SCRIPT_NAME);
+  return true;
+}
+
+function jsString(value) {
+  return JSON.stringify(String(value || ""));
+}
+
+async function installOneSignalScript(buildDir, options) {
+  const appId = oneSignalAppId(options);
+  if (!appId) {
+    return false;
+  }
+
+  const wwwDir = path.join(buildDir, "www");
+  const source = path.resolve(__dirname, "..", "templates", ONESIGNAL_SCRIPT_NAME);
+  const target = path.join(wwwDir, ONESIGNAL_SCRIPT_NAME);
+  const entryHtmlPath = path.resolve(wwwDir, options.entryFile || "index.html");
+  const scriptPath = toCordovaPath(path.relative(path.dirname(entryHtmlPath), target));
+  const template = await fs.readFile(source, "utf8");
+
+  if (!isInside(wwwDir, entryHtmlPath)) {
+    throw new Error(`Entry file must stay inside the Cordova www folder: ${options.entryFile}`);
+  }
+
+  await fs.writeFile(
+    target,
+    template.replace("__HTML2APK_ONESIGNAL_APP_ID__", jsString(appId)),
+    "utf8"
+  );
+  await injectScriptIntoHtml(entryHtmlPath, scriptPath || ONESIGNAL_SCRIPT_NAME);
+  return true;
+}
+
+function removePluginPlatform(pluginXml, platformName) {
+  const pattern = new RegExp(`\\n?\\s*<platform name="${platformName}">[\\s\\S]*?\\n\\s*</platform>`, "i");
+  return pluginXml.replace(pattern, "");
+}
+
+async function prepareBundledPlugin(buildDir, packageName) {
+  const localPath = path.resolve(__dirname, "..", "..", "node_modules", packageName);
+  try {
+    await fs.access(path.join(localPath, "plugin.xml"));
+  } catch {
+    return packageName;
+  }
+
+  const destination = path.join(buildDir, `${packageName}-android`);
+  await removePath(destination);
+  await copyDirectory(localPath, destination, () => false);
+
+  const packageJsonPath = path.join(destination, "package.json");
+  const sourcePackage = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  const pluginPackage = {
+    name: sourcePackage.name,
+    version: sourcePackage.version,
+    description: sourcePackage.description,
+    license: sourcePackage.license,
+    main: sourcePackage.main || "dist/index.cjs",
+    types: sourcePackage.types,
+    cordova: {
+      id: sourcePackage.cordova?.id || packageName,
+      platforms: ["android"]
+    }
+  };
+  Object.keys(pluginPackage).forEach((key) => {
+    if (pluginPackage[key] === undefined) {
+      delete pluginPackage[key];
+    }
+  });
+  await fs.writeFile(packageJsonPath, `${JSON.stringify(pluginPackage, null, 2)}\n`, "utf8");
+
+  const pluginXmlPath = path.join(destination, "plugin.xml");
+  let pluginXml = await fs.readFile(pluginXmlPath, "utf8");
+  pluginXml = removePluginPlatform(pluginXml, "ios");
+  await fs.writeFile(pluginXmlPath, pluginXml, "utf8");
+
+  return destination;
+}
+
+function hasPlugin(plugins, packageName) {
+  return (plugins || []).some((plugin) => {
+    const text = String(plugin || "").replace(/\\/g, "/").toLowerCase();
+    return text === packageName || text.endsWith(`/node_modules/${packageName}`) || text.endsWith(`/${packageName}`);
+  });
+}
+
 async function copyCordovaAsset(projectRoot, buildDir, assetPath, assetName) {
   if (!assetPath || isRemoteAsset(assetPath)) {
     return assetPath;
@@ -136,10 +275,20 @@ async function buildApk(overrides = {}) {
     cordovaOptions.androidSplashScreenAnimatedIcon = toBuildAssetPath(buildDir, cordovaOptions.splash);
     await writeConfigXml(path.join(buildDir, "config.xml"), cordovaOptions);
     await copyWebAssets(webRoot, path.join(buildDir, "www"), options, projectRoot);
+    if (await installAutoThemeScript(buildDir, options)) {
+      log("Theme mode: auto (system bars follow the visible screen color).");
+    }
+    if (await installOneSignalScript(buildDir, options)) {
+      log("OneSignal: enabled for remote push notifications.");
+    }
 
     const bridgePluginPath = await installBridgePlugin(buildDir);
     await addCordovaPlugin(buildDir, bridgePluginPath, runner);
 
+    if (hasOneSignal(options) && !hasPlugin(options.plugins, ONESIGNAL_PLUGIN_PACKAGE)) {
+      await addCordovaPlugin(buildDir, await prepareBundledPlugin(buildDir, ONESIGNAL_PLUGIN_PACKAGE), runner);
+    }
+
     for (const plugin of options.plugins) {
       await addCordovaPlugin(buildDir, plugin, runner);
     }

package/src/core/config.js

@@ -2,7 +2,11 @@
 
 const fs = require("fs/promises");
 const path = require("path");
-const { createDefaultOptions } = require("./defaults");
+const {
+  DEFAULT_ANDROID_MIN_SDK_VERSION,
+  MAX_ANDROID_MIN_SDK_VERSION,
+  createDefaultOptions
+} = require("./defaults");
 
 const CONFIG_FILES = ["app.json", "config.json"];
 
@@ -58,24 +62,85 @@ function mergeDeep(base, next) {
   return output;
 }
 
+function normalizeMinSdkVersion(value) {
+  const parsed = Number.parseInt(value, 10);
+  return Number.isInteger(parsed)
+    && parsed >= DEFAULT_ANDROID_MIN_SDK_VERSION
+    && parsed <= MAX_ANDROID_MIN_SDK_VERSION
+    ? parsed
+    : DEFAULT_ANDROID_MIN_SDK_VERSION;
+}
+
+function normalizeThemeMode(value) {
+  return String(value || "").trim().toLowerCase() === "auto" ? "auto" : "fixed";
+}
+
+function normalizeThemeColor(value) {
+  const color = String(value || "").trim();
+  return /^#[0-9a-fA-F]{6}$/.test(color) ? color : "#126fff";
+}
+
 function normalizeOptions(options) {
   const normalized = { ...options };
 
-  normalized.mode = normalized.mode === "fullscreen" ? "fullscreen" : "standalone";
+  normalized.mode = ["fullscreen", "floating"].includes(normalized.mode) ? normalized.mode : "standalone";
+  if (normalized.orientation === "vertical") {
+    normalized.orientation = "portrait";
+  } else if (normalized.orientation === "horizontal") {
+    normalized.orientation = "landscape";
+  }
+  normalized.orientation = ["portrait", "landscape"].includes(normalized.orientation)
+    ? normalized.orientation
+    : "default";
   normalized.debug = Boolean(normalized.debug);
   normalized.release = Boolean(normalized.release);
+  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.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)
-    ? normalized.permissions.filter(Boolean)
+    ? normalized.permissions.map((permission) => String(permission).trim()).filter(Boolean)
     : [];
   normalized.plugins = Array.isArray(normalized.plugins)
-    ? normalized.plugins.filter(Boolean)
+    ? normalized.plugins.map((plugin) => String(plugin).trim()).filter(Boolean)
     : [];
+  normalized.deepLinks = normalizeDeepLinks(normalized.deepLinks);
   normalized.entryFile = normalized.entryFile || "index.html";
   normalized.webRoot = normalized.webRoot || ".";
 
   return normalized;
 }
 
+function normalizeOneSignalAppId(value) {
+  return String(value || "").trim();
+}
+
+function normalizeDeepLinks(value) {
+  const input = value && typeof value === "object" ? value : {};
+  const schemes = Array.isArray(input.schemes)
+    ? input.schemes.map((scheme) => String(scheme).trim()).filter(Boolean)
+    : [];
+  const appLinks = Array.isArray(input.appLinks)
+    ? input.appLinks
+      .filter((item) => item && typeof item === "object" && item.host)
+      .map((item) => ({
+        scheme: item.scheme || "https",
+        host: String(item.host).trim(),
+        paths: Array.isArray(item.paths) ? item.paths.map((pathItem) => String(pathItem).trim()).filter(Boolean) : [],
+        autoVerify: Boolean(item.autoVerify)
+      }))
+    : [];
+
+  return {
+    schemes,
+    appLinks
+  };
+}
+
 async function resolveBuildOptions(overrides = {}) {
   const projectRoot = path.resolve(overrides.projectRoot || process.cwd());
   const { config, configPath } = await loadProjectConfig(projectRoot);
@@ -95,5 +160,9 @@ module.exports = {
   loadProjectConfig,
   resolveBuildOptions,
   mergeDeep,
-  normalizeOptions
+  normalizeOptions,
+  normalizeMinSdkVersion,
+  normalizeThemeMode,
+  normalizeOneSignalAppId,
+  normalizeDeepLinks
 };

package/src/core/defaults.js

@@ -2,6 +2,9 @@
 
 const path = require("path");
 
+const DEFAULT_ANDROID_MIN_SDK_VERSION = 24;
+const MAX_ANDROID_MIN_SDK_VERSION = 36;
+
 function toPackageSegment(value) {
   return String(value || "app")
     .toLowerCase()
@@ -17,14 +20,23 @@ function createDefaultOptions(projectRoot) {
     packageId: `com.html2apk.${toPackageSegment(appName)}`,
     version: "1.0.0",
     mode: "standalone",
+    orientation: "default",
     debug: false,
     icon: null,
     splash: null,
-    permissions: ["INTERNET"],
+    permissions: ["INTERNET", "POST_NOTIFICATIONS", "VIBRATE"],
     plugins: [],
     release: false,
     keystore: null,
     androidPlatform: "android@15.0.0",
+    minSdkVersion: DEFAULT_ANDROID_MIN_SDK_VERSION,
+    themeColor: "#126fff",
+    themeMode: "fixed",
+    oneSignalAppId: "",
+    deepLinks: {
+      schemes: [],
+      appLinks: []
+    },
     files: null,
     entryFile: "index.html",
     webRoot: ".",
@@ -33,5 +45,7 @@ function createDefaultOptions(projectRoot) {
 }
 
 module.exports = {
+  DEFAULT_ANDROID_MIN_SDK_VERSION,
+  MAX_ANDROID_MIN_SDK_VERSION,
   createDefaultOptions
 };

package/src/desktop/main.js

@@ -14,12 +14,20 @@ const { runDoctor, formatDoctorReport } = require("../runtime-manager/doctor");
 
 let mainWindow = null;
 const smokeTest = process.env.HTML2APK_DESKTOP_SMOKE === "1";
+const APP_ID = "dev.caiomultiversando.html2apk";
+const APP_NAME = "html2apk";
 const WINDOW_BACKGROUNDS = {
   light: "#f7fbff",
   dark: "#10141b"
 };
 
 app.commandLine.appendSwitch("disable-crash-reporter");
+process.title = APP_NAME;
+app.setName(APP_NAME);
+
+if (process.platform === "win32") {
+  app.setAppUserModelId(APP_ID);
+}
 
 function rootPath(...parts) {
   return path.resolve(__dirname, "..", "..", ...parts);
@@ -57,7 +65,7 @@ function createWindow() {
     center: true,
     show: false,
     frame: false,
-    title: "html2apk",
+    title: APP_NAME,
     icon: iconPath(),
     backgroundColor: WINDOW_BACKGROUNDS.light,
     webPreferences: {
@@ -134,8 +142,8 @@ function cleanBuildOptions(options = {}) {
     release: Boolean(options.release)
   };
 
-  for (const key of ["mode", "appName", "packageId", "version", "icon", "androidPlatform"]) {
-    if (options[key]) {
+  for (const key of ["mode", "appName", "packageId", "version", "icon", "androidPlatform", "minSdkVersion", "themeColor", "themeMode", "theme", "oneSignalAppId", "orientation", "permissions", "deepLinks"]) {
+    if (Array.isArray(options[key]) || options[key]) {
       output[key] = options[key];
     }
   }
@@ -343,6 +351,10 @@ async function installWithWingetAndroidCli(sender) {
 }
 
 app.whenReady().then(() => {
+  app.setName(APP_NAME);
+  if (process.platform === "win32") {
+    app.setAppUserModelId(APP_ID);
+  }
   createWindow();
 
   app.on("activate", () => {
@@ -359,7 +371,7 @@ app.on("window-all-closed", () => {
 });
 
 ipcMain.handle("app:info", () => ({
-  name: "html2apk",
+  name: APP_NAME,
   version: app.getVersion(),
   credit: "Dev Caio Multiversando",
   iconPath: iconPath()
@@ -520,3 +532,17 @@ ipcMain.handle("shell:show-item", async (_event, targetPath) => {
   shell.showItemInFolder(targetPath);
   return true;
 });
+
+ipcMain.handle("shell:open-external", async (_event, targetUrl) => {
+  if (!targetUrl) {
+    return false;
+  }
+
+  const url = new URL(String(targetUrl));
+  if (!["https:", "http:"].includes(url.protocol)) {
+    return false;
+  }
+
+  await shell.openExternal(url.toString());
+  return true;
+});

package/src/desktop/preload.js

@@ -12,6 +12,7 @@ contextBridge.exposeInMainWorld("html2apkDesktop", {
   runBuild: (options) => ipcRenderer.invoke("build:run", options),
   openPath: (targetPath) => ipcRenderer.invoke("shell:open-path", targetPath),
   showItem: (targetPath) => ipcRenderer.invoke("shell:show-item", targetPath),
+  openExternalUrl: (targetUrl) => ipcRenderer.invoke("shell:open-external", targetUrl),
   minimizeWindow: () => ipcRenderer.invoke("window:minimize"),
   toggleMaximizeWindow: () => ipcRenderer.invoke("window:toggle-maximize"),
   closeWindow: () => ipcRenderer.invoke("window:close"),

package/src/desktop/renderer/index.html

@@ -58,6 +58,7 @@
         <button class="nav-item" data-view="settings"><span class="nav-icon">C</span><span data-i18n="navSettings">Configuracoes</span></button>
         <button class="nav-item" data-view="appearance"><span class="nav-icon">A</span><span data-i18n="navAppearance">Aparencia</span></button>
         <button class="nav-item" data-view="build"><span class="nav-icon">B</span><span data-i18n="navBuild">Build</span></button>
+        <button class="nav-item" data-view="codes"><span class="nav-icon">J</span><span data-i18n="navCodes">Codigos</span></button>
         <button class="nav-item" data-view="logs"><span class="nav-icon">L</span><span data-i18n="navLogs">Logs</span></button>
       </nav>
 
@@ -140,14 +141,60 @@
             <span data-i18n="mode">Modo</span>
             <select id="modeInput">
               <option value="" data-i18n="chooseMode">Escolha o modo</option>
-              <option value="fullscreen">fullscreen</option>
-              <option value="standalone">standalone</option>
+              <option value="fullscreen" data-i18n="modeFullscreen">Tela cheia</option>
+              <option value="standalone" data-i18n="modeStandalone">Normal</option>
+              <option value="floating" data-i18n="modeFloating">Flutuante</option>
+            </select>
+          </label>
+          <label class="field">
+            <span data-i18n="orientation">Orientacao</span>
+            <select id="orientationInput">
+              <option value="default" data-i18n="orientationDefault">Automatico</option>
+              <option value="portrait" data-i18n="orientationPortrait">Vertical</option>
+              <option value="landscape" data-i18n="orientationLandscape">Horizontal</option>
+            </select>
+          </label>
+          <label class="field">
+            <span data-i18n="minSdkVersion">Android minimo</span>
+            <select id="minSdkVersionInput">
+              <option value="24">Android 7.0 (API 24)</option>
+              <option value="25">Android 7.1 (API 25)</option>
+              <option value="26">Android 8.0 (API 26)</option>
+              <option value="27">Android 8.1 (API 27)</option>
+              <option value="28">Android 9 (API 28)</option>
+              <option value="29">Android 10 (API 29)</option>
+              <option value="30">Android 11 (API 30)</option>
+              <option value="31">Android 12 (API 31)</option>
+              <option value="32">Android 12L (API 32)</option>
+              <option value="33">Android 13 (API 33)</option>
+              <option value="34">Android 14 (API 34)</option>
+              <option value="35">Android 15 (API 35)</option>
+              <option value="36">Android 16 (API 36)</option>
             </select>
           </label>
           <label class="field">
             <span>cordova-android</span>
             <input id="androidPlatformInput" type="text" placeholder="android@15.0.0">
           </label>
+          <label class="field">
+            <span data-i18n="themeMode">Tema do APK</span>
+            <select id="themeModeInput">
+              <option value="fixed" data-i18n="themeModeFixed">Cor fixa</option>
+              <option value="auto" data-i18n="themeModeAuto">Automatico pela tela</option>
+            </select>
+          </label>
+          <label class="field color-field">
+            <span data-i18n="appThemeColor">Cor do tema do app</span>
+            <div class="color-picker">
+              <input id="themeColorInput" type="color" value="#126fff">
+              <input id="themeColorTextInput" type="text" value="#126fff" maxlength="7">
+            </div>
+          </label>
+          <label class="field onesignal-field">
+            <span data-i18n="oneSignalAppId">OneSignal App ID</span>
+            <input id="oneSignalAppIdInput" type="text" placeholder="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx">
+            <small data-i18n="oneSignalAppIdHint">Opcional. Use o App ID do OneSignal, nao a REST API Key.</small>
+          </label>
           <div class="field icon-field">
             <span data-i18n="appIcon">Icone do app</span>
             <div class="icon-picker">
@@ -158,6 +205,10 @@
               </div>
             </div>
           </div>
+          <div class="field permissions-field">
+            <span data-i18n="androidPermissions">Permissoes Android</span>
+            <div id="permissionGrid" class="permission-grid"></div>
+          </div>
         </div>
 
         <div class="toggle-grid">
@@ -275,6 +326,17 @@
         <div id="logConsole" class="log-console"></div>
       </section>
 
+      <section id="view-codes" class="view">
+        <header class="view-header compact">
+          <div>
+            <p class="eyebrow" data-i18n="codesEyebrow">Bridge nativa</p>
+            <h1 data-i18n="codesTitle">Codigos interpretados</h1>
+          </div>
+        </header>
+        <p class="view-intro" data-i18n="codesIntro">Estas funcoes chamadas no JavaScript do app sao interpretadas pelo plugin Cordova e executadas no Java Android.</p>
+        <div id="nativeCodeGrid" class="code-grid"></div>
+      </section>
+
       <section id="view-help" class="view">
         <header class="view-header compact">
           <div>
@@ -295,6 +357,11 @@
             <strong data-i18n="helpDepsTitle">Dependencias no EXE</strong>
             <p data-i18n="helpDeps">O executavel empacota html2apk, a interface e dependencias Node/Cordova. JDK e Android SDK ainda precisam existir na maquina por tamanho e licenca.</p>
           </article>
+          <article class="creator-card">
+            <strong data-i18n="helpCreatorTitle">Criador</strong>
+            <p data-i18n="helpCreatorText">Conheca o Dev Caio Multiversando, criador desta linda aplicacao html2apk.</p>
+            <button id="devInstagramButton" class="secondary-action instagram-action" type="button" data-i18n="openInstagram">Conhecer o dev</button>
+          </article>
         </div>
       </section>
     </main>