muon-ui 0.25.0 → 0.26.47

package/README.md

@@ -11,6 +11,8 @@ A multi-platform GUI application framework that uses CEF as its backend.
 
 ## What is this?
 
+Android uses WebView and supports debug APKs and signed release APKs containing your web assets. Build on Linux x64 without NDK/CMake for ordinary applications. See [building and distributing Android apps](https://github.com/kekyo/muon-ui/blob/main/docs/en/android.md) for setup, signing, and support limits. The CEF, HMR, and network filtering descriptions below apply to the desktop backend.
+
 Have you ever wanted to update an aging native GUI application into a modern application?
 Application replacement is extremely complex, and it has always been a hard problem.
 
@@ -51,6 +53,10 @@ This lets you build modern local GUI applications with the web technology ecosys
 muon also minimizes the steps required to create a muon application, keeping the barrier to entry low.
 With the minimal setup, installing the NPM package and adding one line to the configuration file is enough to launch your first muon app.
 
+WIP: And once you've created a muon application, you can deploy it directly to Android.
+
+![android](./images/get-started-android.png)
+
 ### Features
 
 - Restricts all network access through a whitelist filter, letting you completely exclude problematic content.
@@ -58,8 +64,10 @@ With the minimal setup, installing the NPM package and adding one line to the co
 - The rendering browser is CEF (Chromium Embedded Framework). From the web application's point of view, this is almost the same as using Chromium or Chrome.
 - Supports the Vite plugin system. It also supports Vite HMR, so previews update in real time during development.
 - Supports Linux (deb) and Windows (NSIS) package generation, and portable distribution.
+- You can also build Android applications (experimental).
 - DevTools can be used. CDP (Chrome DevTools Protocol) is also supported, so remote debugging from external tools is possible.
 - Includes a plugin system. Plugin capabilities can also be restricted by a whitelist filter.
+- An independent SDK supports C/C++ plugin development and distribution as prebuilt NPM packages.
 - Built-in plugins provide access to local files, open dialogs, child process launching, and window operations.
 
 ### Environment
@@ -75,6 +83,8 @@ With the minimal setup, installing the NPM package and adding one line to the co
 
 ## Getting started with muon (Quick version)
 
+This section covers Linux and Windows. For Android SDK/JDK setup, Vite configuration, and APK building and signing, see [building and distributing Android apps](https://github.com/kekyo/muon-ui/blob/main/docs/en/android.md).
+
 Let's get started by creating an application with muon (a muon app).
 Use a [Vite template](https://vite.dev/guide/) to create "my-muon-app" as you normally would:
 

package/android.d.ts

@@ -0,0 +1,61 @@
+// muon - Multi-platform GUI application framework that uses CEF as its backend
+// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)
+// Under MIT.
+// https://github.com/kekyo/muon-ui
+
+/** ABI supported by the prebuilt Muon Android runtime. */
+export type MuonAndroidAbi = "arm64-v8a" | "x86_64";
+
+/** Prebuilt native plugin bundled in the application. */
+export interface MuonAndroidPluginOptions {
+  /** Unique plugin registration name. */
+  name: string;
+  /** ELF soname, including the lib prefix and .so suffix. */
+  soname: string;
+  /** Library path for each ABI selected by android.abis. */
+  libraries: Partial<Record<MuonAndroidAbi, string>>;
+  /** Ordinary shared dependencies by ABI, copied beside the plugin. */
+  dependencies?: Partial<Record<MuonAndroidAbi, readonly string[]>>;
+  /** Producer catalog JSON path, required for validate mode; resolved like libraries. */
+  metadata?: string;
+}
+
+/** Android application options, overriding the muon.json android section. */
+export interface MuonAndroidOptions {
+  /** External keystore and environment variable references used by muon pack. */
+  signing?: MuonAndroidSigningOptions;
+  /** Stable reverse-domain application identifier used for installation and updates. */
+  applicationId?: string;
+  /** Launcher label; defaults to the package name. */
+  label?: string;
+  /** Positive integer update version; defaults to 1. Increase for every release. */
+  versionCode?: number;
+  /** Display version; defaults to package.json version. */
+  versionName?: string;
+  /** Native ABIs to package; defaults to both supported ABIs. */
+  abis?: readonly MuonAndroidAbi[];
+  /** PNG launcher icon; relative to the configuration that supplies it. */
+  icon?: string;
+  /** Android manifest permissions. Runtime permission prompts remain app-specific. */
+  permissions?: readonly string[];
+  /** SDK directory, otherwise detected through the environment. */
+  sdkPath?: string;
+  /** Prebuilt native plugins; no NDK is required when building the app. */
+  plugins?: readonly MuonAndroidPluginOptions[];
+  /** FCM is unavailable in this release. Only false is accepted. */
+  fcm?: false;
+  /** QuickJS is unavailable in this release. Only false is accepted. */
+  quickjs?: false;
+}
+
+/** External release credentials; passwords must not appear in project files. */
+export interface MuonAndroidSigningOptions {
+  /** Path to the application keystore; relative to the supplying configuration. */
+  keystore: string;
+  /** Key alias inside the keystore. */
+  keyAlias: string;
+  /** Environment variable containing the keystore password. */
+  storePasswordEnv: string;
+  /** Environment variable containing the key password; defaults to storePasswordEnv. */
+  keyPasswordEnv?: string;
+}

package/dist/android/lib/index.cjs

@@ -0,0 +1,233 @@
+/*!
+* name: muon-ui
+* version: 0.26.47
+* description: A multi-platform GUI application framework that uses CEF as its backend
+* author: Kouji Matsui (@kekyo@mi.kekyo.net)
+* license: MIT
+* repository.url: https://github.com/kekyo/muon-ui.git
+* git.commit.hash: 95dc2712686873c8a022483fd9abf18598019bd7
+*/
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+let node_url = require("node:url");
+let funcity = require("funcity");
+let node_child_process = require("node:child_process");
+let node_fs = require("node:fs");
+let node_os = require("node:os");
+//#region android/command.ts
+/**
+* Runs a build tool without a shell and awaits process completion.
+* @param command - Executable path.
+* @param args - Literal argument vector.
+* @param cwd - Working directory.
+* @param environment - Child environment, including any external credentials.
+* @param output - Optional progress sink; undefined captures output only.
+* @returns Captured standard output and standard error.
+*/
+var runAndroidCommand = async (command, args, cwd, environment, output) => await new Promise((resolve, reject) => {
+	const child = (0, node_child_process.spawn)(command, args, {
+		cwd,
+		env: environment,
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	});
+	let captured = "";
+	const receive = (chunk) => {
+		const text = chunk.toString();
+		captured += text;
+		output?.(text);
+	};
+	child.stdout.on("data", receive);
+	child.stderr.on("data", receive);
+	child.once("error", reject);
+	child.once("close", (code, signal) => {
+		if (code === 0) resolve(captured);
+		else reject(/* @__PURE__ */ new Error(`${command} failed (${signal ?? code}):\n${captured}`));
+	});
+});
+//#endregion
+//#region android/toolchain.ts
+var accessible = async (path, mode) => {
+	try {
+		await (0, node_fs_promises.access)(path, mode);
+		return true;
+	} catch {
+		return false;
+	}
+};
+var findExecutable = async (name, environment) => {
+	for (const directory of (environment.PATH ?? "").split(node_path.delimiter).filter(Boolean)) {
+		const path = (0, node_path.join)(directory, name);
+		if (await accessible(path, node_fs.constants.X_OK)) return path;
+	}
+};
+/**
+* Diagnoses a Linux x64 SDK/JDK installation and optionally prepares Gradle.
+* @param options - Component location, SDK override and process environment.
+* @returns Validated tool paths and pinned versions.
+* @remarks Does not install SDK packages, accept licenses, or require a device.
+*/
+var prepareAndroid = async (options) => {
+	if (process.platform !== "linux" || process.arch !== "x64") throw new Error("Android builds currently support Linux x64 hosts.");
+	const componentsDirectory = (0, node_path.resolve)(options.componentsDirectory);
+	const toolchain = JSON.parse(await (0, node_fs_promises.readFile)((0, node_path.join)(componentsDirectory, "toolchain.json"), "utf8"));
+	if (toolchain.schemaVersion !== 1) throw new Error("Unsupported Muon Android toolchain schema.");
+	const adb = await findExecutable("adb", options.environment);
+	const candidate = options.sdkPath ?? options.environment.ANDROID_HOME ?? options.environment.ANDROID_SDK_ROOT ?? (adb === void 0 ? void 0 : (0, node_path.dirname)((0, node_path.dirname)(adb)));
+	if (!candidate) throw new Error("Android SDK not found. Set ANDROID_HOME or android.sdkPath.");
+	const sdkPath = (0, node_path.resolve)(candidate);
+	for (const [file, packageName] of [[`platforms/${toolchain.platform}/android.jar`, `platforms;${toolchain.platform}`], ...[
+		"aapt2",
+		"zipalign",
+		"apksigner"
+	].map((name) => [`build-tools/${toolchain.buildTools}/${name}`, `build-tools;${toolchain.buildTools}`])]) if (!await accessible((0, node_path.join)(sdkPath, file), node_fs.constants.R_OK)) throw new Error(`Android SDK ${sdkPath} is missing ${packageName}. Install this package using the Android CLI: android sdk install '${packageName}'. See https://developer.android.com/tools/agents/android-cli/commands/sdk`);
+	const platformProperties = await (0, node_fs_promises.readFile)((0, node_path.join)(sdkPath, "platforms", toolchain.platform, "source.properties"), "utf8");
+	if (Number(/^AndroidVersion.ApiLevel\s*=\s*(\S+)/mu.exec(platformProperties)?.[1]) !== toolchain.compileSdk) throw new Error(`Android SDK platform version differs from the required API ${toolchain.compileSdk}: ${sdkPath}`);
+	const buildProperties = await (0, node_fs_promises.readFile)((0, node_path.join)(sdkPath, "build-tools", toolchain.buildTools, "source.properties"), "utf8");
+	if (/^Pkg.Revision\s*=\s*(\S+)/mu.exec(buildProperties)?.[1] !== toolchain.buildTools) throw new Error(`Android SDK Build Tools version differs from ${toolchain.buildTools}: ${sdkPath}`);
+	const javaPath = options.environment.JAVA_HOME ? (0, node_path.join)(options.environment.JAVA_HOME, "bin/java") : await findExecutable("java", options.environment);
+	if (!javaPath || !await accessible(javaPath, node_fs.constants.X_OK)) throw new Error(`JDK ${toolchain.javaMin}–${toolchain.javaMax} is required. Set JAVA_HOME or add java to PATH.`);
+	const versionText = await runAndroidCommand(javaPath, ["-version"], componentsDirectory, options.environment, void 0);
+	const javaVersion = Number(/(?:openjdk|java) version "(\d+)[."]/u.exec(versionText)?.[1]);
+	if (!Number.isInteger(javaVersion) || javaVersion < toolchain.javaMin || javaVersion > toolchain.javaMax) throw new Error(`JDK ${toolchain.javaMin}–${toolchain.javaMax} is required; detected ${versionText.trim()}.`);
+	if (options.prepareGradle) {
+		const cache = (0, node_path.join)((0, node_os.homedir)(), ".cache/muon/android", toolchain.gradle);
+		await (0, node_fs_promises.mkdir)(cache, { recursive: true });
+		if (!(await runAndroidCommand((0, node_path.join)(componentsDirectory, "templates/gradlew"), ["--version"], cache, options.environment, void 0)).includes(`Gradle ${toolchain.gradle}`)) throw new Error("Gradle Wrapper version differs from the shipped toolchain.");
+	}
+	return {
+		target: "android",
+		sdkPath,
+		javaVersion,
+		javaPath,
+		toolchain,
+		componentsDirectory
+	};
+};
+//#endregion
+//#region android/build.ts
+var xml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+var render = async (template, variables) => {
+	const logs = [];
+	const value = await (0, funcity.runScriptOnceToText)(await (0, node_fs_promises.readFile)(template, "utf8"), {
+		sourceId: template,
+		variables,
+		logs
+	});
+	if (value === void 0 || logs.some((log) => log.type === "error")) throw new Error(`Cannot render Android template ${template}: ${JSON.stringify(logs)}`);
+	return value;
+};
+/**
+* Builds a self-contained APK from the shipped AAR and prebuilt web assets.
+* @param input - Explicit application, artifact and toolchain inputs.
+* @returns The APK path and its actual variant/signing state.
+* @remarks Does not run Vite, compile native code or infer a repository root.
+*/
+var buildAndroidApplication = async (input) => {
+	const tools = await prepareAndroid({
+		componentsDirectory: input.componentsDirectory,
+		sdkPath: input.sdkPath,
+		environment: input.environment,
+		prepareGradle: false
+	});
+	const project = (0, node_path.resolve)(input.projectDirectory);
+	const assetRelative = (0, node_path.relative)((0, node_path.resolve)(input.assetsDirectory), project);
+	if (assetRelative === "" || !assetRelative.startsWith("..") && !(0, node_path.isAbsolute)(assetRelative)) throw new Error("The generated Android project must be outside the web assets directory.");
+	if ((0, node_path.isAbsolute)(input.assetPath) || input.assetPath.split(/[\\/]/u).some((part) => part === ".." || part === "muon")) throw new Error("Android assetPath must be relative and must not use the reserved muon directory.");
+	await (0, node_fs_promises.rm)(project, {
+		recursive: true,
+		force: true
+	});
+	await (0, node_fs_promises.cp)((0, node_path.join)(tools.componentsDirectory, "templates"), project, { recursive: true });
+	await (0, node_fs_promises.chmod)((0, node_path.join)(project, "gradlew"), 493);
+	const assets = (0, node_path.join)(project, "app/src/main/assets");
+	await (0, node_fs_promises.mkdir)(assets, { recursive: true });
+	await (0, node_fs_promises.cp)(input.assetsDirectory, (0, node_path.join)(assets, input.assetPath), {
+		recursive: true,
+		dereference: true
+	});
+	const frameworkAssets = (0, node_path.join)(assets, "muon");
+	try {
+		await (0, node_fs_promises.stat)(frameworkAssets);
+		throw new Error("Web assets must not contain the reserved muon directory.");
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	await (0, node_fs_promises.mkdir)(frameworkAssets, { recursive: true });
+	await (0, node_fs_promises.cp)((0, node_path.join)(tools.componentsDirectory, "licenses"), (0, node_path.join)(frameworkAssets, "licenses"), { recursive: true });
+	await (0, node_fs_promises.copyFile)((0, node_path.join)(tools.componentsDirectory, "renderer/renderer.js"), (0, node_path.join)(frameworkAssets, "renderer.js"));
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(frameworkAssets, "config.json"), JSON.stringify({
+		startPage: input.startPage,
+		values: input.values,
+		plugin: input.pluginAccess
+	}));
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(frameworkAssets, "plugins.json"), JSON.stringify({
+		schemaVersion: 1,
+		plugins: input.plugins.map(({ name, soname, allow, config, expectedFunctions }) => ({
+			name,
+			soname,
+			allow,
+			config,
+			...expectedFunctions === void 0 ? {} : { expectedFunctions }
+		}))
+	}));
+	for (const plugin of input.plugins) for (const abi of input.abis) {
+		const library = plugin.libraries[abi];
+		if (!library) throw new Error(`${plugin.name} is missing its ${abi} library.`);
+		const destination = (0, node_path.join)(project, "app/src/main/jniLibs", abi, plugin.soname);
+		await (0, node_fs_promises.mkdir)((0, node_path.dirname)(destination), { recursive: true });
+		await (0, node_fs_promises.copyFile)(library, destination);
+		for (const dependency of plugin.dependencies?.[abi] ?? []) await (0, node_fs_promises.copyFile)(dependency, (0, node_path.join)((0, node_path.dirname)(destination), (0, node_path.basename)(dependency)));
+	}
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(project, "muon-build.json"), JSON.stringify({
+		...tools.toolchain,
+		applicationId: input.applicationId,
+		versionCode: input.versionCode,
+		versionName: input.versionName,
+		abis: input.abis,
+		maven: (0, node_url.pathToFileURL)((0, node_path.join)(tools.componentsDirectory, "maven")).href
+	}, null, 2));
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(project, "app/src/main/AndroidManifest.xml"), await render((0, node_path.join)(project, "AndroidManifest.xml.fc"), /* @__PURE__ */ new Map([["permissions", input.permissions.map(xml)]])));
+	const resources = (0, node_path.join)(project, "app/src/main/res");
+	await (0, node_fs_promises.mkdir)((0, node_path.join)(resources, "values"), { recursive: true });
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(resources, "values/strings.xml"), await render((0, node_path.join)(project, "strings.xml.fc"), /* @__PURE__ */ new Map([["label", xml(input.label.replaceAll("\\", "\\\\").replaceAll("\"", "\\\""))]])));
+	if (input.icon !== void 0) {
+		await (0, node_fs_promises.rm)((0, node_path.join)(resources, "mipmap/ic_launcher.xml"));
+		await (0, node_fs_promises.copyFile)(input.icon, (0, node_path.join)(resources, "mipmap/ic_launcher.png"));
+	}
+	await runAndroidCommand((0, node_path.join)(project, "gradlew"), [
+		"--no-daemon",
+		"--console=plain",
+		input.variant === "debug" ? ":app:assembleDebug" : ":app:assembleRelease"
+	], project, {
+		...input.environment,
+		ANDROID_HOME: tools.sdkPath,
+		ANDROID_SDK_ROOT: tools.sdkPath
+	}, input.output);
+	const name = input.variant === "debug" ? "app-debug.apk" : "app-release-unsigned.apk";
+	const packagePath = (0, node_path.join)((0, node_path.resolve)(input.outputDirectory), `${input.applicationId}-${input.versionCode}-${input.variant}.apk`);
+	await (0, node_fs_promises.mkdir)((0, node_path.dirname)(packagePath), { recursive: true });
+	await (0, node_fs_promises.copyFile)((0, node_path.join)(project, "app/build/outputs/apk", input.variant, name), packagePath);
+	const result = {
+		target: "android",
+		packagePath,
+		projectDirectory: project,
+		variant: input.variant,
+		abis: input.abis,
+		applicationId: input.applicationId,
+		versionCode: input.versionCode,
+		versionName: input.versionName,
+		signing: input.variant === "debug" ? "debug" : "unsigned"
+	};
+	await (0, node_fs_promises.writeFile)(`${packagePath}.json`, JSON.stringify(result, null, 2) + "\n");
+	return result;
+};
+//#endregion
+exports.buildAndroidApplication = buildAndroidApplication;
+exports.prepareAndroid = prepareAndroid;
+
+//# sourceMappingURL=index.cjs.map

package/dist/android/lib/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["spawn","access","delimiter","join","constants","resolve","readFile","dirname","homedir","mkdir","runScriptOnceToText","readFile","resolve","relative","isAbsolute","rm","cp","join","chmod","mkdir","stat","copyFile","writeFile","dirname","basename","pathToFileURL"],"sources":["../../android/command.ts","../../android/toolchain.ts","../../android/build.ts"],"sourcesContent":["// muon - Multi-platform GUI application framework that uses CEF as its backend\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/muon-ui\n\nimport { spawn } from \"node:child_process\";\n\n/**\n * Runs a build tool without a shell and awaits process completion.\n * @param command - Executable path.\n * @param args - Literal argument vector.\n * @param cwd - Working directory.\n * @param environment - Child environment, including any external credentials.\n * @param output - Optional progress sink; undefined captures output only.\n * @returns Captured standard output and standard error.\n */\nexport const runAndroidCommand = async (\n  command: string,\n  args: readonly string[],\n  cwd: string,\n  environment: NodeJS.ProcessEnv,\n  output: ((text: string) => void) | undefined,\n): Promise<string> =>\n  await new Promise<string>((resolve, reject) => {\n    const child = spawn(command, args, {\n      cwd,\n      env: environment,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    let captured = \"\";\n    const receive = (chunk: Buffer) => {\n      const text = chunk.toString();\n      captured += text;\n      output?.(text);\n    };\n    child.stdout.on(\"data\", receive);\n    child.stderr.on(\"data\", receive);\n    child.once(\"error\", reject);\n    child.once(\"close\", (code, signal) => {\n      if (code === 0) resolve(captured);\n      else\n        reject(\n          new Error(`${command} failed (${signal ?? code}):\\n${captured}`),\n        );\n    });\n  });\n","// muon - Multi-platform GUI application framework that uses CEF as its backend\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/muon-ui\n\nimport { constants } from \"node:fs\";\nimport { access, mkdir, readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { delimiter, dirname, join, resolve } from \"node:path\";\nimport { runAndroidCommand } from \"./command.js\";\n\n/** Versions fixed by the shipped Android component set. */\nexport interface MuonAndroidToolchain {\n  /** Exact Android SDK platform package directory. */ readonly platform: string;\n  /** Component schema. */ readonly schemaVersion: 1;\n  /** Android Gradle plugin version. */ readonly agp: string;\n  /** Wrapper version. */ readonly gradle: string;\n  /** API used for compilation. */ readonly compileSdk: number;\n  /** API targeted by generated applications. */ readonly targetSdk: number;\n  /** Minimum installation API; see documented verification range. */ readonly minSdk: number;\n  /** Required SDK Build Tools version. */ readonly buildTools: string;\n  /** Minimum JDK runtime version. */ readonly javaMin: number;\n  /** Highest supported JDK runtime version. */ readonly javaMax: number;\n  /** Version of dev.muon:runtime. */ readonly runtimeVersion: string;\n  /** ABIs included in the standard runtime. */ readonly abis: readonly string[];\n}\n\n/** Inputs for the Android environment diagnostic. */\nexport interface MuonAndroidPrepareOptions {\n  /** Directory containing templates, maven, renderer and toolchain.json. */ componentsDirectory: string;\n  /** Explicit SDK location, otherwise resolved from the environment or adb. */ sdkPath:\n    string | undefined;\n  /** Child environment. */ environment: NodeJS.ProcessEnv;\n  /** Whether to download/verify the pinned Gradle distribution using its Wrapper. */ prepareGradle: boolean;\n}\n\n/** Validated tools for an Android build; no NDK or CMake is needed. */\nexport interface MuonAndroidPrepareResult {\n  /** Discriminates Android from desktop preparation. */ readonly target: \"android\";\n  /** Absolute SDK directory. */ readonly sdkPath: string;\n  /** Detected JDK major version. */ readonly javaVersion: number;\n  /** Absolute Java executable. */ readonly javaPath: string;\n  /** Shipped version requirements. */ readonly toolchain: MuonAndroidToolchain;\n  /** Component directory used for this build. */ readonly componentsDirectory: string;\n}\n\nconst accessible = async (path: string, mode: number): Promise<boolean> => {\n  try {\n    await access(path, mode);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst findExecutable = async (\n  name: string,\n  environment: NodeJS.ProcessEnv,\n): Promise<string | undefined> => {\n  for (const directory of (environment.PATH ?? \"\")\n    .split(delimiter)\n    .filter(Boolean)) {\n    const path = join(directory, name);\n    if (await accessible(path, constants.X_OK)) return path;\n  }\n  return undefined;\n};\n\n/**\n * Diagnoses a Linux x64 SDK/JDK installation and optionally prepares Gradle.\n * @param options - Component location, SDK override and process environment.\n * @returns Validated tool paths and pinned versions.\n * @remarks Does not install SDK packages, accept licenses, or require a device.\n */\nexport const prepareAndroid = async (\n  options: MuonAndroidPrepareOptions,\n): Promise<MuonAndroidPrepareResult> => {\n  if (process.platform !== \"linux\" || process.arch !== \"x64\") {\n    throw new Error(\"Android builds currently support Linux x64 hosts.\");\n  }\n  const componentsDirectory = resolve(options.componentsDirectory);\n  const toolchain = JSON.parse(\n    await readFile(join(componentsDirectory, \"toolchain.json\"), \"utf8\"),\n  ) as MuonAndroidToolchain;\n  if (toolchain.schemaVersion !== 1)\n    throw new Error(\"Unsupported Muon Android toolchain schema.\");\n  const adb = await findExecutable(\"adb\", options.environment);\n  const candidate =\n    options.sdkPath ??\n    options.environment.ANDROID_HOME ??\n    options.environment.ANDROID_SDK_ROOT ??\n    (adb === undefined ? undefined : dirname(dirname(adb)));\n  if (!candidate)\n    throw new Error(\n      \"Android SDK not found. Set ANDROID_HOME or android.sdkPath.\",\n    );\n  const sdkPath = resolve(candidate);\n  for (const [file, packageName] of [\n    [\n      `platforms/${toolchain.platform}/android.jar`,\n      `platforms;${toolchain.platform}`,\n    ],\n    ...[\"aapt2\", \"zipalign\", \"apksigner\"].map((name) => [\n      `build-tools/${toolchain.buildTools}/${name}`,\n      `build-tools;${toolchain.buildTools}`,\n    ]),\n  ]) {\n    if (!(await accessible(join(sdkPath, file!), constants.R_OK))) {\n      throw new Error(\n        `Android SDK ${sdkPath} is missing ${packageName}. Install this package using the Android CLI: android sdk install '${packageName}'. See https://developer.android.com/tools/agents/android-cli/commands/sdk`,\n      );\n    }\n  }\n  const platformProperties = await readFile(\n    join(sdkPath, \"platforms\", toolchain.platform, \"source.properties\"),\n    \"utf8\",\n  );\n  if (\n    Number(\n      /^AndroidVersion.ApiLevel\\s*=\\s*(\\S+)/mu.exec(platformProperties)?.[1],\n    ) !== toolchain.compileSdk\n  ) {\n    throw new Error(\n      `Android SDK platform version differs from the required API ${toolchain.compileSdk}: ${sdkPath}`,\n    );\n  }\n  const buildProperties = await readFile(\n    join(sdkPath, \"build-tools\", toolchain.buildTools, \"source.properties\"),\n    \"utf8\",\n  );\n  if (\n    /^Pkg.Revision\\s*=\\s*(\\S+)/mu.exec(buildProperties)?.[1] !==\n    toolchain.buildTools\n  ) {\n    throw new Error(\n      `Android SDK Build Tools version differs from ${toolchain.buildTools}: ${sdkPath}`,\n    );\n  }\n  const javaPath = options.environment.JAVA_HOME\n    ? join(options.environment.JAVA_HOME, \"bin/java\")\n    : await findExecutable(\"java\", options.environment);\n  if (!javaPath || !(await accessible(javaPath, constants.X_OK))) {\n    throw new Error(\n      `JDK ${toolchain.javaMin}–${toolchain.javaMax} is required. Set JAVA_HOME or add java to PATH.`,\n    );\n  }\n  const versionText = await runAndroidCommand(\n    javaPath,\n    [\"-version\"],\n    componentsDirectory,\n    options.environment,\n    undefined,\n  );\n  const javaVersion = Number(\n    /(?:openjdk|java) version \"(\\d+)[.\"]/u.exec(versionText)?.[1],\n  );\n  if (\n    !Number.isInteger(javaVersion) ||\n    javaVersion < toolchain.javaMin ||\n    javaVersion > toolchain.javaMax\n  ) {\n    throw new Error(\n      `JDK ${toolchain.javaMin}–${toolchain.javaMax} is required; detected ${versionText.trim()}.`,\n    );\n  }\n  if (options.prepareGradle) {\n    const cache = join(homedir(), \".cache/muon/android\", toolchain.gradle);\n    await mkdir(cache, { recursive: true });\n    const result = await runAndroidCommand(\n      join(componentsDirectory, \"templates/gradlew\"),\n      [\"--version\"],\n      cache,\n      options.environment,\n      undefined,\n    );\n    if (!result.includes(`Gradle ${toolchain.gradle}`))\n      throw new Error(\n        \"Gradle Wrapper version differs from the shipped toolchain.\",\n      );\n  }\n  return {\n    target: \"android\",\n    sdkPath,\n    javaVersion,\n    javaPath,\n    toolchain,\n    componentsDirectory,\n  };\n};\n","// muon - Multi-platform GUI application framework that uses CEF as its backend\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/muon-ui\n\nimport {\n  chmod,\n  copyFile,\n  cp,\n  mkdir,\n  readFile,\n  rm,\n  stat,\n  writeFile,\n} from \"node:fs/promises\";\nimport {\n  basename,\n  dirname,\n  isAbsolute,\n  join,\n  relative,\n  resolve,\n} from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { runScriptOnceToText, type FunCityLogEntry } from \"funcity\";\nimport { runAndroidCommand } from \"./command.js\";\nimport { prepareAndroid } from \"./toolchain.js\";\n\n/** ABI shipped by the Muon Android runtime. */\nexport type MuonAndroidAbi = \"arm64-v8a\" | \"x86_64\";\n\n/** Package-owned plugin exposure and built-in function policy. */\nexport type MuonAndroidPluginAccess = {\n  /** Whether the trusted main frame may use the bridge. */ readonly enabled: boolean;\n  /** Allowed built-in public function paths. */ readonly internalAllow: readonly string[];\n} & (\n  | { /** Global API exposure mode. */ readonly mode: \"simple\" }\n  | {\n      /** Virtual-module exposure mode. */ readonly mode: \"validate\";\n      /** Capabilities generated by the same build as the application bundle. */ readonly capabilities: readonly {\n        /** Opaque capability id. */ readonly id: string;\n        /** Allowed public function paths. */ readonly allow: readonly string[];\n      }[];\n    }\n);\n\n/** Normalized package-owned plugin entry. */\nexport interface MuonAndroidPackagedPlugin {\n  /** Ordinary shared libraries copied beside the plugin for each ABI. */ readonly dependencies?: Readonly<\n    Partial<Record<MuonAndroidAbi, readonly string[]>>\n  >;\n  /** Logical capability name. */ readonly name: string;\n  /** Packaged ELF soname. */ readonly soname: string;\n  /** Explicitly allowed public function patterns. */ readonly allow: readonly string[];\n  /** Producer catalog after applying the allow policy, checked when loading. */ readonly expectedFunctions?: readonly string[];\n  /** Application-owned plugin configuration. */ readonly config: readonly {\n    readonly key: string;\n    readonly value: string;\n  }[];\n  /** Absolute prebuilt library path for each selected ABI. */ readonly libraries: Readonly<\n    Partial<Record<MuonAndroidAbi, string>>\n  >;\n}\n\n/** Explicit inputs used by the Android package builder. */\nexport interface MuonAndroidApplicationInput {\n  /** Packaged Muon Android components. */ componentsDirectory: string;\n  /** Directory containing previously built web assets. */ assetsDirectory: string;\n  /** Relative URL path prefix under the trusted asset host. */ assetPath: string;\n  /** Trusted HTTPS entry URL. */ startPage: string;\n  /** Application identifier independent of Muon's Java namespace. */ applicationId: string;\n  /** Launcher label. */ label: string;\n  /** Monotonic Android update number. */ versionCode: number;\n  /** User-facing version. */ versionName: string;\n  /** Selected runtime ABIs. */ abis: readonly MuonAndroidAbi[];\n  /** Manifest permissions, already normalized by the public build boundary. */ permissions: readonly string[];\n  /** Values returned by muon.environments.getConfigValues. */ values: Readonly<\n    Record<string, string>\n  >;\n  /** Explicit prebuilt plugins; an empty array builds a standard app. */ plugins: readonly MuonAndroidPackagedPlugin[];\n  /** Validated common plugin access settings. */ pluginAccess: MuonAndroidPluginAccess;\n  /** Optional PNG icon already converted by the public build boundary. */ icon:\n    string | undefined;\n  /** Owned directory for generated Gradle sources and intermediates. */ projectDirectory: string;\n  /** Destination for APKs and result metadata. */ outputDirectory: string;\n  /** SDK override. */ sdkPath: string | undefined;\n  /** Debug package or unsigned release package. */ variant:\n    \"debug\" | \"release\";\n  /** Process environment. */ environment: NodeJS.ProcessEnv;\n  /** Progress sink, or undefined for a quiet build. */ output:\n    ((text: string) => void) | undefined;\n}\n\n/** Android APK result, without desktop launcher or CEF fields. */\nexport interface MuonAndroidApplicationResult {\n  /** Target discriminator. */ readonly target: \"android\";\n  /** Absolute APK path. */ readonly packagePath: string;\n  /** Generated Gradle project for diagnostics. */ readonly projectDirectory: string;\n  /** Android variant. */ readonly variant: \"debug\" | \"release\";\n  /** Included native ABIs. */ readonly abis: readonly MuonAndroidAbi[];\n  /** Application identifier. */ readonly applicationId: string;\n  /** Update version. */ readonly versionCode: number;\n  /** Display version. */ readonly versionName: string;\n  /** Actual signing state. */ readonly signing:\n    \"debug\" | \"unsigned\" | \"release\";\n}\n\nconst xml = (value: string): string =>\n  value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&apos;\");\n\nconst render = async (\n  template: string,\n  variables: ReadonlyMap<string, unknown>,\n): Promise<string> => {\n  const logs: FunCityLogEntry[] = [];\n  const value = await runScriptOnceToText(await readFile(template, \"utf8\"), {\n    sourceId: template,\n    variables,\n    logs,\n  });\n  if (value === undefined || logs.some((log) => log.type === \"error\")) {\n    throw new Error(\n      `Cannot render Android template ${template}: ${JSON.stringify(logs)}`,\n    );\n  }\n  return value;\n};\n\n/**\n * Builds a self-contained APK from the shipped AAR and prebuilt web assets.\n * @param input - Explicit application, artifact and toolchain inputs.\n * @returns The APK path and its actual variant/signing state.\n * @remarks Does not run Vite, compile native code or infer a repository root.\n */\nexport const buildAndroidApplication = async (\n  input: MuonAndroidApplicationInput,\n): Promise<MuonAndroidApplicationResult> => {\n  const tools = await prepareAndroid({\n    componentsDirectory: input.componentsDirectory,\n    sdkPath: input.sdkPath,\n    environment: input.environment,\n    prepareGradle: false,\n  });\n  const project = resolve(input.projectDirectory);\n  const assetRelative = relative(resolve(input.assetsDirectory), project);\n  if (\n    assetRelative === \"\" ||\n    (!assetRelative.startsWith(\"..\") && !isAbsolute(assetRelative))\n  ) {\n    throw new Error(\n      \"The generated Android project must be outside the web assets directory.\",\n    );\n  }\n  if (\n    isAbsolute(input.assetPath) ||\n    input.assetPath\n      .split(/[\\\\/]/u)\n      .some((part) => part === \"..\" || part === \"muon\")\n  ) {\n    throw new Error(\n      \"Android assetPath must be relative and must not use the reserved muon directory.\",\n    );\n  }\n  await rm(project, { recursive: true, force: true });\n  await cp(join(tools.componentsDirectory, \"templates\"), project, {\n    recursive: true,\n  });\n  await chmod(join(project, \"gradlew\"), 0o755);\n  const assets = join(project, \"app/src/main/assets\");\n  await mkdir(assets, { recursive: true });\n  await cp(input.assetsDirectory, join(assets, input.assetPath), {\n    recursive: true,\n    dereference: true,\n  });\n  const frameworkAssets = join(assets, \"muon\");\n  try {\n    await stat(frameworkAssets);\n    throw new Error(\"Web assets must not contain the reserved muon directory.\");\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n  }\n  await mkdir(frameworkAssets, { recursive: true });\n  await cp(\n    join(tools.componentsDirectory, \"licenses\"),\n    join(frameworkAssets, \"licenses\"),\n    { recursive: true },\n  );\n  await copyFile(\n    join(tools.componentsDirectory, \"renderer/renderer.js\"),\n    join(frameworkAssets, \"renderer.js\"),\n  );\n  await writeFile(\n    join(frameworkAssets, \"config.json\"),\n    JSON.stringify({\n      startPage: input.startPage,\n      values: input.values,\n      plugin: input.pluginAccess,\n    }),\n  );\n  await writeFile(\n    join(frameworkAssets, \"plugins.json\"),\n    JSON.stringify({\n      schemaVersion: 1,\n      plugins: input.plugins.map(\n        ({ name, soname, allow, config, expectedFunctions }) => ({\n          name,\n          soname,\n          allow,\n          config,\n          ...(expectedFunctions === undefined ? {} : { expectedFunctions }),\n        }),\n      ),\n    }),\n  );\n  for (const plugin of input.plugins) {\n    for (const abi of input.abis) {\n      const library = plugin.libraries[abi];\n      if (!library)\n        throw new Error(`${plugin.name} is missing its ${abi} library.`);\n      const destination = join(\n        project,\n        \"app/src/main/jniLibs\",\n        abi,\n        plugin.soname,\n      );\n      await mkdir(dirname(destination), { recursive: true });\n      await copyFile(library, destination);\n      for (const dependency of plugin.dependencies?.[abi] ?? [])\n        await copyFile(\n          dependency,\n          join(dirname(destination), basename(dependency)),\n        );\n    }\n  }\n  await writeFile(\n    join(project, \"muon-build.json\"),\n    JSON.stringify(\n      {\n        ...tools.toolchain,\n        applicationId: input.applicationId,\n        versionCode: input.versionCode,\n        versionName: input.versionName,\n        abis: input.abis,\n        maven: pathToFileURL(join(tools.componentsDirectory, \"maven\")).href,\n      },\n      null,\n      2,\n    ),\n  );\n  await writeFile(\n    join(project, \"app/src/main/AndroidManifest.xml\"),\n    await render(\n      join(project, \"AndroidManifest.xml.fc\"),\n      new Map([[\"permissions\", input.permissions.map(xml)]]),\n    ),\n  );\n  const resources = join(project, \"app/src/main/res\");\n  await mkdir(join(resources, \"values\"), { recursive: true });\n  await writeFile(\n    join(resources, \"values/strings.xml\"),\n    await render(\n      join(project, \"strings.xml.fc\"),\n      new Map([\n        [\n          \"label\",\n          xml(input.label.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll('\"', '\\\\\"')),\n        ],\n      ]),\n    ),\n  );\n  if (input.icon !== undefined) {\n    await rm(join(resources, \"mipmap/ic_launcher.xml\"));\n    await copyFile(input.icon, join(resources, \"mipmap/ic_launcher.png\"));\n  }\n  await runAndroidCommand(\n    join(project, \"gradlew\"),\n    [\n      \"--no-daemon\",\n      \"--console=plain\",\n      input.variant === \"debug\" ? \":app:assembleDebug\" : \":app:assembleRelease\",\n    ],\n    project,\n    {\n      ...input.environment,\n      ANDROID_HOME: tools.sdkPath,\n      ANDROID_SDK_ROOT: tools.sdkPath,\n    },\n    input.output,\n  );\n  const name =\n    input.variant === \"debug\" ? \"app-debug.apk\" : \"app-release-unsigned.apk\";\n  const packagePath = join(\n    resolve(input.outputDirectory),\n    `${input.applicationId}-${input.versionCode}-${input.variant}.apk`,\n  );\n  await mkdir(dirname(packagePath), { recursive: true });\n  await copyFile(\n    join(project, \"app/build/outputs/apk\", input.variant, name),\n    packagePath,\n  );\n  const result: MuonAndroidApplicationResult = {\n    target: \"android\",\n    packagePath,\n    projectDirectory: project,\n    variant: input.variant,\n    abis: input.abis,\n    applicationId: input.applicationId,\n    versionCode: input.versionCode,\n    versionName: input.versionName,\n    signing: input.variant === \"debug\" ? \"debug\" : \"unsigned\",\n  };\n  await writeFile(\n    `${packagePath}.json`,\n    JSON.stringify(result, null, 2) + \"\\n\",\n  );\n  return result;\n};\n"],"mappings":"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"}

package/dist/android/lib/index.mjs

@@ -0,0 +1,231 @@
+/*!
+* name: muon-ui
+* version: 0.26.47
+* description: A multi-platform GUI application framework that uses CEF as its backend
+* author: Kouji Matsui (@kekyo@mi.kekyo.net)
+* license: MIT
+* repository.url: https://github.com/kekyo/muon-ui.git
+* git.commit.hash: 95dc2712686873c8a022483fd9abf18598019bd7
+*/
+import { access, chmod, copyFile, cp, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { basename, delimiter, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { runScriptOnceToText } from "funcity";
+import { spawn } from "node:child_process";
+import { constants } from "node:fs";
+import { homedir } from "node:os";
+//#region android/command.ts
+/**
+* Runs a build tool without a shell and awaits process completion.
+* @param command - Executable path.
+* @param args - Literal argument vector.
+* @param cwd - Working directory.
+* @param environment - Child environment, including any external credentials.
+* @param output - Optional progress sink; undefined captures output only.
+* @returns Captured standard output and standard error.
+*/
+var runAndroidCommand = async (command, args, cwd, environment, output) => await new Promise((resolve, reject) => {
+	const child = spawn(command, args, {
+		cwd,
+		env: environment,
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	});
+	let captured = "";
+	const receive = (chunk) => {
+		const text = chunk.toString();
+		captured += text;
+		output?.(text);
+	};
+	child.stdout.on("data", receive);
+	child.stderr.on("data", receive);
+	child.once("error", reject);
+	child.once("close", (code, signal) => {
+		if (code === 0) resolve(captured);
+		else reject(/* @__PURE__ */ new Error(`${command} failed (${signal ?? code}):\n${captured}`));
+	});
+});
+//#endregion
+//#region android/toolchain.ts
+var accessible = async (path, mode) => {
+	try {
+		await access(path, mode);
+		return true;
+	} catch {
+		return false;
+	}
+};
+var findExecutable = async (name, environment) => {
+	for (const directory of (environment.PATH ?? "").split(delimiter).filter(Boolean)) {
+		const path = join(directory, name);
+		if (await accessible(path, constants.X_OK)) return path;
+	}
+};
+/**
+* Diagnoses a Linux x64 SDK/JDK installation and optionally prepares Gradle.
+* @param options - Component location, SDK override and process environment.
+* @returns Validated tool paths and pinned versions.
+* @remarks Does not install SDK packages, accept licenses, or require a device.
+*/
+var prepareAndroid = async (options) => {
+	if (process.platform !== "linux" || process.arch !== "x64") throw new Error("Android builds currently support Linux x64 hosts.");
+	const componentsDirectory = resolve(options.componentsDirectory);
+	const toolchain = JSON.parse(await readFile(join(componentsDirectory, "toolchain.json"), "utf8"));
+	if (toolchain.schemaVersion !== 1) throw new Error("Unsupported Muon Android toolchain schema.");
+	const adb = await findExecutable("adb", options.environment);
+	const candidate = options.sdkPath ?? options.environment.ANDROID_HOME ?? options.environment.ANDROID_SDK_ROOT ?? (adb === void 0 ? void 0 : dirname(dirname(adb)));
+	if (!candidate) throw new Error("Android SDK not found. Set ANDROID_HOME or android.sdkPath.");
+	const sdkPath = resolve(candidate);
+	for (const [file, packageName] of [[`platforms/${toolchain.platform}/android.jar`, `platforms;${toolchain.platform}`], ...[
+		"aapt2",
+		"zipalign",
+		"apksigner"
+	].map((name) => [`build-tools/${toolchain.buildTools}/${name}`, `build-tools;${toolchain.buildTools}`])]) if (!await accessible(join(sdkPath, file), constants.R_OK)) throw new Error(`Android SDK ${sdkPath} is missing ${packageName}. Install this package using the Android CLI: android sdk install '${packageName}'. See https://developer.android.com/tools/agents/android-cli/commands/sdk`);
+	const platformProperties = await readFile(join(sdkPath, "platforms", toolchain.platform, "source.properties"), "utf8");
+	if (Number(/^AndroidVersion.ApiLevel\s*=\s*(\S+)/mu.exec(platformProperties)?.[1]) !== toolchain.compileSdk) throw new Error(`Android SDK platform version differs from the required API ${toolchain.compileSdk}: ${sdkPath}`);
+	const buildProperties = await readFile(join(sdkPath, "build-tools", toolchain.buildTools, "source.properties"), "utf8");
+	if (/^Pkg.Revision\s*=\s*(\S+)/mu.exec(buildProperties)?.[1] !== toolchain.buildTools) throw new Error(`Android SDK Build Tools version differs from ${toolchain.buildTools}: ${sdkPath}`);
+	const javaPath = options.environment.JAVA_HOME ? join(options.environment.JAVA_HOME, "bin/java") : await findExecutable("java", options.environment);
+	if (!javaPath || !await accessible(javaPath, constants.X_OK)) throw new Error(`JDK ${toolchain.javaMin}–${toolchain.javaMax} is required. Set JAVA_HOME or add java to PATH.`);
+	const versionText = await runAndroidCommand(javaPath, ["-version"], componentsDirectory, options.environment, void 0);
+	const javaVersion = Number(/(?:openjdk|java) version "(\d+)[."]/u.exec(versionText)?.[1]);
+	if (!Number.isInteger(javaVersion) || javaVersion < toolchain.javaMin || javaVersion > toolchain.javaMax) throw new Error(`JDK ${toolchain.javaMin}–${toolchain.javaMax} is required; detected ${versionText.trim()}.`);
+	if (options.prepareGradle) {
+		const cache = join(homedir(), ".cache/muon/android", toolchain.gradle);
+		await mkdir(cache, { recursive: true });
+		if (!(await runAndroidCommand(join(componentsDirectory, "templates/gradlew"), ["--version"], cache, options.environment, void 0)).includes(`Gradle ${toolchain.gradle}`)) throw new Error("Gradle Wrapper version differs from the shipped toolchain.");
+	}
+	return {
+		target: "android",
+		sdkPath,
+		javaVersion,
+		javaPath,
+		toolchain,
+		componentsDirectory
+	};
+};
+//#endregion
+//#region android/build.ts
+var xml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+var render = async (template, variables) => {
+	const logs = [];
+	const value = await runScriptOnceToText(await readFile(template, "utf8"), {
+		sourceId: template,
+		variables,
+		logs
+	});
+	if (value === void 0 || logs.some((log) => log.type === "error")) throw new Error(`Cannot render Android template ${template}: ${JSON.stringify(logs)}`);
+	return value;
+};
+/**
+* Builds a self-contained APK from the shipped AAR and prebuilt web assets.
+* @param input - Explicit application, artifact and toolchain inputs.
+* @returns The APK path and its actual variant/signing state.
+* @remarks Does not run Vite, compile native code or infer a repository root.
+*/
+var buildAndroidApplication = async (input) => {
+	const tools = await prepareAndroid({
+		componentsDirectory: input.componentsDirectory,
+		sdkPath: input.sdkPath,
+		environment: input.environment,
+		prepareGradle: false
+	});
+	const project = resolve(input.projectDirectory);
+	const assetRelative = relative(resolve(input.assetsDirectory), project);
+	if (assetRelative === "" || !assetRelative.startsWith("..") && !isAbsolute(assetRelative)) throw new Error("The generated Android project must be outside the web assets directory.");
+	if (isAbsolute(input.assetPath) || input.assetPath.split(/[\\/]/u).some((part) => part === ".." || part === "muon")) throw new Error("Android assetPath must be relative and must not use the reserved muon directory.");
+	await rm(project, {
+		recursive: true,
+		force: true
+	});
+	await cp(join(tools.componentsDirectory, "templates"), project, { recursive: true });
+	await chmod(join(project, "gradlew"), 493);
+	const assets = join(project, "app/src/main/assets");
+	await mkdir(assets, { recursive: true });
+	await cp(input.assetsDirectory, join(assets, input.assetPath), {
+		recursive: true,
+		dereference: true
+	});
+	const frameworkAssets = join(assets, "muon");
+	try {
+		await stat(frameworkAssets);
+		throw new Error("Web assets must not contain the reserved muon directory.");
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+	}
+	await mkdir(frameworkAssets, { recursive: true });
+	await cp(join(tools.componentsDirectory, "licenses"), join(frameworkAssets, "licenses"), { recursive: true });
+	await copyFile(join(tools.componentsDirectory, "renderer/renderer.js"), join(frameworkAssets, "renderer.js"));
+	await writeFile(join(frameworkAssets, "config.json"), JSON.stringify({
+		startPage: input.startPage,
+		values: input.values,
+		plugin: input.pluginAccess
+	}));
+	await writeFile(join(frameworkAssets, "plugins.json"), JSON.stringify({
+		schemaVersion: 1,
+		plugins: input.plugins.map(({ name, soname, allow, config, expectedFunctions }) => ({
+			name,
+			soname,
+			allow,
+			config,
+			...expectedFunctions === void 0 ? {} : { expectedFunctions }
+		}))
+	}));
+	for (const plugin of input.plugins) for (const abi of input.abis) {
+		const library = plugin.libraries[abi];
+		if (!library) throw new Error(`${plugin.name} is missing its ${abi} library.`);
+		const destination = join(project, "app/src/main/jniLibs", abi, plugin.soname);
+		await mkdir(dirname(destination), { recursive: true });
+		await copyFile(library, destination);
+		for (const dependency of plugin.dependencies?.[abi] ?? []) await copyFile(dependency, join(dirname(destination), basename(dependency)));
+	}
+	await writeFile(join(project, "muon-build.json"), JSON.stringify({
+		...tools.toolchain,
+		applicationId: input.applicationId,
+		versionCode: input.versionCode,
+		versionName: input.versionName,
+		abis: input.abis,
+		maven: pathToFileURL(join(tools.componentsDirectory, "maven")).href
+	}, null, 2));
+	await writeFile(join(project, "app/src/main/AndroidManifest.xml"), await render(join(project, "AndroidManifest.xml.fc"), /* @__PURE__ */ new Map([["permissions", input.permissions.map(xml)]])));
+	const resources = join(project, "app/src/main/res");
+	await mkdir(join(resources, "values"), { recursive: true });
+	await writeFile(join(resources, "values/strings.xml"), await render(join(project, "strings.xml.fc"), /* @__PURE__ */ new Map([["label", xml(input.label.replaceAll("\\", "\\\\").replaceAll("\"", "\\\""))]])));
+	if (input.icon !== void 0) {
+		await rm(join(resources, "mipmap/ic_launcher.xml"));
+		await copyFile(input.icon, join(resources, "mipmap/ic_launcher.png"));
+	}
+	await runAndroidCommand(join(project, "gradlew"), [
+		"--no-daemon",
+		"--console=plain",
+		input.variant === "debug" ? ":app:assembleDebug" : ":app:assembleRelease"
+	], project, {
+		...input.environment,
+		ANDROID_HOME: tools.sdkPath,
+		ANDROID_SDK_ROOT: tools.sdkPath
+	}, input.output);
+	const name = input.variant === "debug" ? "app-debug.apk" : "app-release-unsigned.apk";
+	const packagePath = join(resolve(input.outputDirectory), `${input.applicationId}-${input.versionCode}-${input.variant}.apk`);
+	await mkdir(dirname(packagePath), { recursive: true });
+	await copyFile(join(project, "app/build/outputs/apk", input.variant, name), packagePath);
+	const result = {
+		target: "android",
+		packagePath,
+		projectDirectory: project,
+		variant: input.variant,
+		abis: input.abis,
+		applicationId: input.applicationId,
+		versionCode: input.versionCode,
+		versionName: input.versionName,
+		signing: input.variant === "debug" ? "debug" : "unsigned"
+	};
+	await writeFile(`${packagePath}.json`, JSON.stringify(result, null, 2) + "\n");
+	return result;
+};
+//#endregion
+export { buildAndroidApplication, prepareAndroid };
+
+//# sourceMappingURL=index.mjs.map