@hot-updater/android-helper 0.25.4

package/LICENSE

@@ -0,0 +1,33 @@
+MIT License
+
+Copyright (c) 2023 Sungyu Kang 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+ADDITIONAL DISCLAIMER
+
+The authors of this software shall not be held responsible for any legal issues,
+regulatory violations, policy violations, or disputes arising from the use,
+distribution, or integration of this software.
+
+Users are solely responsible for ensuring compliance with all applicable laws,
+regulations, and third-party policies (including but not limited to app store
+policies).

package/dist/index.cjs

@@ -0,0 +1,626 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __hot_updater_cli_tools = require("@hot-updater/cli-tools");
+__hot_updater_cli_tools = __toESM(__hot_updater_cli_tools);
+let __hot_updater_plugin_core = require("@hot-updater/plugin-core");
+__hot_updater_plugin_core = __toESM(__hot_updater_plugin_core);
+let path = require("path");
+path = __toESM(path);
+let execa = require("execa");
+execa = __toESM(execa);
+let fs = require("fs");
+fs = __toESM(fs);
+let node_os = require("node:os");
+node_os = __toESM(node_os);
+
+//#region src/utils/createGradleLogger.ts
+const createGradleLogger = () => new __hot_updater_cli_tools.BuildLogger({
+	failurePatterns: ["BUILD FAILED"],
+	importantLogPatterns: [
+		"error:",
+		"Error:",
+		"ERROR:",
+		"> Task :",
+		"BUILD FAILED",
+		"BUILD SUCCESSFUL",
+		"FAILURE: Build failed with an exception.",
+		"* What went wrong:",
+		"Execution failed for task",
+		"Could not resolve",
+		"Failed to",
+		"Unable to load script",
+		"Metro encountered an error",
+		"React Native CLI",
+		"Android resource compilation failed",
+		"Duplicate class",
+		"Program type already present",
+		"actionable tasks:"
+	],
+	progressMapping: [
+		[[
+			"buildKotlinToolingMetadata",
+			"generateAutolinkingNewArchitectureFiles",
+			"generateCodegenSchemaFromJavaScript"
+		], 5],
+		[[
+			"createBundleReleaseJsAndAssets",
+			"bundleReleaseJsAndAssets",
+			"bundleDebugJsAndAssets"
+		], 15],
+		[[
+			"generateReleaseResValues",
+			"generateReleaseResources",
+			"mergeReleaseResources"
+		], 25],
+		[[
+			"processReleaseResources",
+			"processReleaseManifest",
+			"parseReleaseLocalResources"
+		], 35],
+		[["compileReleaseKotlin", "compileDebugKotlin"], 50],
+		[["compileReleaseJavaWithJavac", "compileDebugJavaWithJavac"], 60],
+		[[
+			"dexBuilderRelease",
+			"mergeDexRelease",
+			"transformClassesWithDex"
+		], 75],
+		[[
+			"compressReleaseAssets",
+			"optimizeReleaseResources",
+			"mergeReleaseAssets"
+		], 85],
+		[[
+			"packageRelease",
+			"packageDebug",
+			"assembleRelease",
+			"assembleDebug"
+		], 90],
+		[["bundleRelease", "bundleDebug"], 95],
+		[[/\d+ actionable tasks:/], 100]
+	]
+});
+
+//#endregion
+//#region src/builder/runGradle.ts
+/**
+* Clean up gradle error message by removing common noise
+*/
+const getCleanedErrorMessage = (error) => {
+	const gradleLinesToRemove = [
+		"FAILURE: Build failed with an exception.",
+		"* Try:",
+		"> Run with --stacktrace option to get the stack trace.",
+		"> Run with --info or --debug option to get more log output.",
+		"> Run with --scan to get full insights.",
+		"> Get more help at [undefined](https://help.gradle.org).",
+		"> Get more help at https://help.gradle.org.",
+		"BUILD FAILED"
+	];
+	return error.message.split("\n").filter((line) => !gradleLinesToRemove.some((l) => line.includes(l))).join("\n").trim();
+};
+/**
+* Generate gradle task names with module prefix
+*/
+function getTaskNames(moduleName, tasks) {
+	return tasks.map((task) => `${moduleName}:${task}`);
+}
+/**
+* Get gradle wrapper command based on platform
+*/
+const getGradleWrapper = () => process.platform.startsWith("win") ? "gradlew.bat" : "./gradlew";
+/**
+* Run gradle build with specified tasks and arguments
+*/
+async function runGradle({ tasks, args, androidProjectPath, appModuleName }) {
+	const gradleArgs = getTaskNames(appModuleName, tasks);
+	gradleArgs.push("-x", "lint");
+	if (args.extraParams) gradleArgs.push(...args.extraParams);
+	__hot_updater_cli_tools.p.log.info(`Run Gradle Settings: 
+Project    ${androidProjectPath}
+App Moudle ${appModuleName}
+Tasks      ${tasks.join(", ")}
+Args       ${gradleArgs.join(" ")}
+`);
+	if ("port" in args && args.port != null) gradleArgs.push(`-PreactNativeDevServerPort=${args.port}`);
+	const logger = createGradleLogger();
+	logger.start(`${appModuleName}`);
+	try {
+		const process$1 = (0, execa.execa)(getGradleWrapper(), gradleArgs, { cwd: androidProjectPath });
+		for await (const line of process$1) if (line) logger.processLine(line);
+		logger.stop();
+	} catch (e) {
+		logger.stop("Build failed", false);
+		if (e instanceof execa.ExecaError) __hot_updater_cli_tools.p.log.error(getCleanedErrorMessage(e));
+		else if (e instanceof Error) __hot_updater_cli_tools.p.log.error(e.message);
+		throw new Error("Failed to build the app. See the error above for details from Gradle.");
+	}
+	return findBuildDirectory({
+		androidProjectPath,
+		moduleName: appModuleName,
+		tasks
+	});
+}
+/**
+* Find the build output directory and artifact path
+*/
+async function findBuildDirectory({ moduleName, tasks, androidProjectPath }) {
+	const selectedTask = tasks.find((t) => t.startsWith("install") || t.startsWith("assemble") || t.startsWith("bundle"));
+	if (!selectedTask) throw new Error(`Not supported gradle task: ${tasks.join(", ")}`);
+	const variantFromSelectedTask = selectedTask?.replace("install", "")?.replace("assemble", "")?.replace("bundle", "").split(/(?=[A-Z])/);
+	const variantPath = variantFromSelectedTask?.join("/")?.toLowerCase();
+	const variant = variantFromSelectedTask?.join("-")?.toLowerCase();
+	const isAabOutput = selectedTask?.includes("bundle") === true;
+	const buildDirectory = `${androidProjectPath}/${moduleName}/build/outputs/${isAabOutput ? "bundle" : "apk"}/${variantPath}`;
+	if (!buildDirectory) throw new Error("Failed to find Android gradle build directory.");
+	return {
+		buildDirectory,
+		buildArtifactPath: await getBuildOutputFilePath({
+			aab: isAabOutput,
+			appModuleName: moduleName,
+			buildDirectory,
+			variant
+		})
+	};
+}
+/**
+* Get the path to the build output file (APK or AAB)
+*/
+async function getBuildOutputFilePath({ aab, appModuleName, buildDirectory, variant }) {
+	const outputFile = `${appModuleName}-${variant}.${aab ? "aab" : "apk"}`;
+	const outputFilePath = path.default.join(buildDirectory, outputFile);
+	if (fs.default.existsSync(outputFilePath)) return outputFilePath;
+	__hot_updater_cli_tools.p.log.error(`Failed to find the output file for ${outputFilePath}`);
+	process.exit(1);
+}
+
+//#endregion
+//#region src/utils/enrichNativeBuildAndroidScheme.ts
+const enrichNativeBuildAndroidScheme = async ({ schemeConfig }) => {
+	return {
+		aab: true,
+		variant: "Release",
+		appModuleName: "app",
+		applicationId: schemeConfig.packageName,
+		...schemeConfig
+	};
+};
+
+//#endregion
+//#region src/buildAndroid.ts
+const buildAndroid = async ({ schemeConfig: _schemeConfig }) => {
+	const androidProjectPath = path.default.join((0, __hot_updater_cli_tools.getCwd)(), "android");
+	const minBundleId = (0, __hot_updater_plugin_core.generateMinBundleId)();
+	const schemeConfig = await enrichNativeBuildAndroidScheme({ schemeConfig: _schemeConfig });
+	return runGradle({
+		args: { extraParams: [`-PMIN_BUNDLE_ID=${minBundleId}`] },
+		appModuleName: schemeConfig.appModuleName,
+		tasks: schemeConfig.aab ? [`bundle${schemeConfig.variant}`] : [`assemble${schemeConfig.variant}`],
+		androidProjectPath
+	});
+};
+
+//#endregion
+//#region src/utils/device.ts
+/**
+* Get the path to adb executable from ANDROID_HOME or use system adb
+*/
+const getAdbPath = () => {
+	return process.env["ANDROID_HOME"] ? path.default.join(process.env["ANDROID_HOME"], "platform-tools", "adb") : "adb";
+};
+/**
+* Parses the output of the 'adb devices' command
+*/
+const parseDevicesResult = ({ result }) => {
+	if (!result) return [];
+	const devices = [];
+	const lines = result.trim().split(/\r?\n/);
+	for (const line of lines) {
+		const [device, state] = line.split(/[ ,\t]+/).filter((w) => w !== "");
+		if (device && state === "device") devices.push(device);
+	}
+	return devices;
+};
+/**
+* Executes the commands needed to get a list of devices from ADB
+*/
+const getConnectedDevices = async () => {
+	const adbPath = getAdbPath();
+	try {
+		const { stdout } = await (0, execa.execa)(adbPath, ["devices"]);
+		return parseDevicesResult({ result: stdout });
+	} catch {
+		return [];
+	}
+};
+/**
+* Runs ADB reverse tcp:8081 tcp:8081 to allow loading the jsbundle from the packager
+* Set up port forwarding from device to development server using adb reverse
+*/
+async function tryRunAdbReverse({ port = 8081, deviceId }) {
+	try {
+		const adbPath = getAdbPath();
+		const adbArgs = [
+			"-s",
+			deviceId,
+			"reverse",
+			`tcp:${port}`,
+			`tcp:${port}`
+		];
+		__hot_updater_cli_tools.p.log.info(`Connecting "${deviceId}" to the development server`);
+		await (0, execa.execa)(adbPath, adbArgs);
+	} catch (_error) {
+		throw new Error(`Failed to connect "${deviceId}" to development server using "adb reverse"`);
+	}
+}
+/**
+* Get name of Android emulator
+*/
+const getEmulatorName = async (deviceId) => {
+	const { stdout } = await (0, execa.execa)(getAdbPath(), [
+		"-s",
+		deviceId,
+		"emu",
+		"avd",
+		"name"
+	], { stdio: "pipe" });
+	if (!stdout) return "";
+	return stdout.split(node_os.default.EOL)[0].replace(/(\r\n|\n|\r)/gm, "").trim();
+};
+/**
+* Get Android device name in readable format
+*/
+const getPhoneName = async (deviceId) => {
+	const { stdout } = await (0, execa.execa)(getAdbPath(), [
+		"-s",
+		deviceId,
+		"shell",
+		"getprop",
+		"ro.product.model"
+	], { stdio: "pipe" });
+	return stdout.replace(/\[ro\.product\.model\]:\s*\[(.*)\]/, "$1").trim();
+};
+/**
+* Check if emulator has finished booting
+*/
+const isEmulatorBooted = async (device) => {
+	const adbPath = getAdbPath();
+	const adbArgs = [
+		"-s",
+		device,
+		"shell",
+		"getprop",
+		"sys.boot_completed"
+	];
+	try {
+		const { stdout } = await (0, execa.execa)(adbPath, adbArgs, { stdio: "pipe" });
+		return stdout.trim() === "1";
+	} catch {
+		return false;
+	}
+};
+const emulatorCommand = process.env["ANDROID_HOME"] ? `${process.env["ANDROID_HOME"]}/emulator/emulator` : "emulator";
+/**
+* Get a list of available Android emulators
+*/
+const getEmulatorNames = async () => {
+	try {
+		const { stdout } = await (0, execa.execa)(emulatorCommand, ["-list-avds"], { stdio: "pipe" });
+		return stdout.split(node_os.default.EOL).filter((name) => name !== "" && !name.includes(" "));
+	} catch {
+		return [];
+	}
+};
+const checkEmulatorBootStatus = async ({ port, emulatorName, loader, onBooted }) => {
+	const connected = (await getConnectedDevices()).find((d) => d.includes(`${port}`));
+	if (connected) {
+		loader.message(`Emulator "${emulatorName}" is connected. Waiting for boot`);
+		if (await isEmulatorBooted(connected)) onBooted(connected);
+	}
+};
+/**
+* Launch the Android emulator and wait for it to boot
+*/
+const launchEmulator = async (emulatorName, port, loader) => {
+	const manualCommand = `${emulatorCommand} -avd ${emulatorName}`;
+	const timeout = 120;
+	const cp = (0, execa.execa)(emulatorCommand, [
+		"-avd",
+		emulatorName,
+		"-port",
+		`${port}`
+	], {
+		detached: true,
+		stdio: "ignore"
+	});
+	cp.unref();
+	return new Promise((resolve, reject) => {
+		let bootCheckInterval;
+		let rejectTimeout;
+		const cleanup = () => {
+			clearTimeout(rejectTimeout);
+			clearInterval(bootCheckInterval);
+		};
+		const handleError = (message) => {
+			cleanup();
+			reject(new Error(message));
+		};
+		bootCheckInterval = setInterval(async () => {
+			await checkEmulatorBootStatus({
+				port,
+				emulatorName,
+				loader,
+				onBooted: (deviceId) => {
+					cleanup();
+					resolve(deviceId);
+				}
+			});
+		}, 1e3);
+		rejectTimeout = setTimeout(() => {
+			handleError(`It took too long to start and connect with Android emulator: ${emulatorName}. You can try starting the emulator manually from the terminal with: ${manualCommand}`);
+		}, timeout * 1e3);
+		cp.catch((error) => {
+			handleError(error);
+		});
+	});
+};
+const defaultPort = 5554;
+const maxPort = 5682;
+/**
+* Find an available port for emulator (starting from 5554)
+*/
+const getAvailableDevicePort = async (startPort = defaultPort) => {
+	/**
+	* The default value is 5554 for the first virtual device instance running on your machine.
+	* A virtual device normally occupies a pair of adjacent ports: a console port and an adb port.
+	* The console of the first virtual device running on a particular machine uses console port 5554 and adb port 5555.
+	* Subsequent instances use port numbers increasing by two.
+	* For example, 5556/5557, 5558/5559, and so on. The range is 5554 to 5682, allowing for 64 concurrent virtual devices.
+	*/
+	const devices = await getConnectedDevices();
+	for (let port = startPort; port <= maxPort; port += 2) if (!devices.some((d) => d.includes(port.toString()))) return port;
+	throw new Error("Failed to launch emulator: no available ports");
+};
+/**
+* Try to launch an emulator (or find the first available one)
+*/
+const tryLaunchEmulator = async (name) => {
+	const port = await getAvailableDevicePort();
+	const loader = __hot_updater_cli_tools.p.spinner();
+	loader.start("Looking for available emulators");
+	const emulators = await getEmulatorNames();
+	const emulatorName = name ?? emulators[0];
+	let deviceId;
+	if (emulators.length > 0) try {
+		loader.message(`Launching emulator "${emulatorName}"`);
+		deviceId = await launchEmulator(emulatorName, port, loader);
+		loader.stop(`Launched ${emulatorName} emulator.`);
+	} catch (error) {
+		loader.stop(`Failed to launch ${emulatorName} emulator. ${error.message}`, 1);
+	}
+	else loader.stop("No emulators found as an output of `emulator -list-avds`. Please launch an emulator manually or connect a device", 1);
+	return deviceId;
+};
+/**
+* List all Android devices and emulators (connected and available)
+*/
+const listDevices = async () => {
+	const devices = await getConnectedDevices();
+	const allDevices = [];
+	for (const deviceId of devices) if (deviceId.includes("emulator")) {
+		const emulatorData = {
+			deviceId,
+			readableName: await getEmulatorName(deviceId),
+			connected: true,
+			type: "emulator"
+		};
+		allDevices.push(emulatorData);
+	} else {
+		const phoneData = {
+			deviceId,
+			readableName: await getPhoneName(deviceId),
+			type: "phone",
+			connected: true
+		};
+		allDevices.push(phoneData);
+	}
+	const emulatorNames = await getEmulatorNames();
+	for (const emulatorName of emulatorNames) {
+		if (allDevices.some((device) => device.readableName === emulatorName)) continue;
+		const emulatorData = {
+			deviceId: void 0,
+			readableName: emulatorName,
+			type: "emulator",
+			connected: false
+		};
+		allDevices.push(emulatorData);
+	}
+	return allDevices.sort((a, b) => {
+		if (a.type === "phone" && b.type === "emulator") return -1;
+		if (a.type === "emulator" && b.type === "phone") return 1;
+		return 0;
+	});
+};
+const matchingDevice = (devices, deviceArg) => {
+	const deviceByName = devices.find((device) => device.readableName === deviceArg);
+	const deviceById = devices.find((d) => d.deviceId === deviceArg);
+	return deviceByName || deviceById;
+};
+const selectTargetDevice = async ({ interactive, deviceOption }) => {
+	const availableDevices = await listDevices();
+	if (deviceOption === true && !interactive) {
+		__hot_updater_cli_tools.p.log.error("you can't select device manually with non-interactive cli mode(without -i option).");
+		process.exit(1);
+	}
+	if (typeof deviceOption === "string") {
+		const matchedDevice = matchingDevice(availableDevices, deviceOption);
+		if (!matchedDevice) {
+			__hot_updater_cli_tools.p.log.error(`device '${deviceOption}' isn't included in the attached devices.`);
+			process.exit(1);
+		}
+		return matchedDevice;
+	}
+	if (interactive) {
+		if (!availableDevices.length) {
+			__hot_updater_cli_tools.p.log.error("you passed -d option but there is no attached adb devices.");
+			process.exit(1);
+		}
+		const device = await __hot_updater_cli_tools.p.select({
+			message: "Target Device",
+			options: availableDevices.map((d) => ({
+				value: d,
+				label: d.readableName
+			}))
+		});
+		if (__hot_updater_cli_tools.p.isCancel(device)) process.exit(1);
+		return device;
+	}
+};
+const Device = {
+	getAdbPath,
+	getConnectedDevices,
+	tryRunAdbReverse,
+	tryLaunchEmulator,
+	listDevices,
+	selectTargetDevice
+};
+
+//#endregion
+//#region src/runner/tryInstallAppOnDevice.ts
+const tryInstallAppOnDevice = async ({ device, apkPath }) => {
+	if (!device.deviceId) {
+		__hot_updater_cli_tools.p.log.warn(`No device with id "${device.deviceId}", skipping launching the app.`);
+		return;
+	}
+	const deviceId = device.deviceId;
+	const adbArgs = [
+		"-s",
+		deviceId,
+		"install",
+		"-r",
+		"-d"
+	];
+	adbArgs.push(apkPath);
+	const adbPath = Device.getAdbPath();
+	const loader = __hot_updater_cli_tools.p.spinner();
+	loader.start(`Installing the app on ${device.readableName} (id: ${deviceId})`);
+	try {
+		await (0, execa.execa)(adbPath, adbArgs);
+		loader.stop(`Installed the app on ${device.readableName} (id: ${deviceId}).`);
+	} catch (error) {
+		const errorMessage = error.stdout || error.stderr || "Unknown error";
+		if (typeof errorMessage === "string" && errorMessage.includes("INSTALL_FAILED_INSUFFICIENT_STORAGE")) loader.message("Installation failed due to insufficient storage");
+		loader.stop(`Failed: Installing the app on ${device.readableName} (id: ${deviceId})`, 1);
+		throw new Error(typeof errorMessage === "string" ? errorMessage : "Installation failed");
+	}
+};
+
+//#endregion
+//#region src/runner/tryLaunchAppOnDevice.ts
+async function tryLaunchAppOnDevice({ device, port, mainActivity, applicationId, packageName }) {
+	if (!device.deviceId) {
+		__hot_updater_cli_tools.p.log.warn(`No device with id "${device.deviceId}", skipping launching the app.`);
+		return;
+	}
+	const deviceId = device.deviceId;
+	await Device.tryRunAdbReverse({
+		deviceId,
+		port
+	});
+	const activity = mainActivity || ".MainActivity";
+	const adbArgs = [
+		"shell",
+		"am",
+		"start",
+		"-n",
+		`${applicationId}/${activity.startsWith(packageName) || !activity.startsWith(".") && activity.includes(".") ? activity : activity.startsWith(".") ? [packageName, activity].join("") : [packageName, activity].filter(Boolean).join(".")}`,
+		"-a",
+		"android.intent.action.MAIN",
+		"-c",
+		"android.intent.category.LAUNCHER"
+	];
+	adbArgs.unshift("-s", deviceId);
+	const adbPath = Device.getAdbPath();
+	console.debug(`Running ${adbPath} ${adbArgs.join(" ")}.`);
+	const loader = __hot_updater_cli_tools.p.spinner();
+	loader.start(`Launching the app on ${device.readableName} (id: ${deviceId})`);
+	try {
+		await (0, execa.execa)(adbPath, adbArgs);
+		loader.stop(`Launched the app on ${device.readableName} (id: ${deviceId}) and listening on port ${port}.`);
+	} catch (_error) {
+		loader.stop("Failed to launch the app.", 1);
+		throw new Error(`Failed to launch the app on ${device.readableName}`);
+	}
+}
+
+//#endregion
+//#region src/runAndroid.ts
+const runAndroid = async ({ schemeConfig: _schemeConfig, runOption }) => {
+	const { interactive, device: deviceOption } = runOption;
+	const androidProjectPath = path.default.join((0, __hot_updater_cli_tools.getCwd)(), "android");
+	const schemeConfig = await enrichNativeBuildAndroidScheme({ schemeConfig: _schemeConfig });
+	if (schemeConfig.aab) {
+		__hot_updater_cli_tools.p.log.error("aab scheme can't not be run");
+		process.exit(1);
+	}
+	const device = await Device.selectTargetDevice({
+		deviceOption,
+		interactive
+	});
+	if (device) {
+		if (!(await Device.getConnectedDevices()).includes(device.deviceId || "")) {
+			if (device.type === "emulator") device.deviceId = await Device.tryLaunchEmulator(device.readableName);
+		}
+		if (!device.deviceId) throw new Error("Failed to run on any device");
+	} else if ((await Device.getConnectedDevices()).length === 0) {
+		__hot_updater_cli_tools.p.log.info("No devices found. Launching first available emulator.");
+		await Device.tryLaunchEmulator();
+	}
+	const task = `assemble${schemeConfig.variant}`;
+	const result = await runGradle({
+		args: { extraParams: [`-PMIN_BUNDLE_ID=${(0, __hot_updater_plugin_core.generateMinBundleId)()}`] },
+		appModuleName: schemeConfig.appModuleName,
+		tasks: [task],
+		androidProjectPath
+	});
+	const targetDevices = device ? [device] : (await Device.listDevices()).filter((d) => d.connected);
+	for (const targetDevice of targetDevices) {
+		await tryInstallAppOnDevice({
+			apkPath: result.buildArtifactPath,
+			device: targetDevice
+		});
+		await tryLaunchAppOnDevice({
+			applicationId: schemeConfig.applicationId,
+			device: targetDevice,
+			mainActivity: runOption.mainActivity,
+			packageName: schemeConfig.packageName,
+			port: runOption.port
+		});
+	}
+	__hot_updater_cli_tools.p.outro("Success 🎉");
+	return result;
+};
+
+//#endregion
+exports.buildAndroid = buildAndroid;
+exports.runAndroid = runAndroid;

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+import { NativeBuildAndroidScheme, NativeBuildOptions } from "@hot-updater/plugin-core";
+
+//#region src/buildAndroid.d.ts
+declare const buildAndroid: ({
+  schemeConfig: _schemeConfig
+}: {
+  schemeConfig: NativeBuildAndroidScheme;
+}) => Promise<{
+  buildDirectory: string;
+  buildArtifactPath: string;
+}>;
+//#endregion
+//#region src/types.d.ts
+interface AndroidNativeRunOptions extends NativeBuildOptions {
+  device?: string | boolean;
+  port?: string;
+  mainActivity?: string;
+  user?: string;
+}
+//#endregion
+//#region src/runAndroid.d.ts
+declare const runAndroid: ({
+  schemeConfig: _schemeConfig,
+  runOption
+}: {
+  schemeConfig: NativeBuildAndroidScheme;
+  runOption: AndroidNativeRunOptions;
+}) => Promise<{
+  buildDirectory: string;
+  buildArtifactPath: string;
+}>;
+//#endregion
+export { type AndroidNativeRunOptions, buildAndroid, runAndroid };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { NativeBuildAndroidScheme, NativeBuildOptions } from "@hot-updater/plugin-core";
+
+//#region src/buildAndroid.d.ts
+declare const buildAndroid: ({
+  schemeConfig: _schemeConfig
+}: {
+  schemeConfig: NativeBuildAndroidScheme;
+}) => Promise<{
+  buildDirectory: string;
+  buildArtifactPath: string;
+}>;
+//#endregion
+//#region src/types.d.ts
+interface AndroidNativeRunOptions extends NativeBuildOptions {
+  device?: string | boolean;
+  port?: string;
+  mainActivity?: string;
+  user?: string;
+}
+//#endregion
+//#region src/runAndroid.d.ts
+declare const runAndroid: ({
+  schemeConfig: _schemeConfig,
+  runOption
+}: {
+  schemeConfig: NativeBuildAndroidScheme;
+  runOption: AndroidNativeRunOptions;
+}) => Promise<{
+  buildDirectory: string;
+  buildArtifactPath: string;
+}>;
+//#endregion
+export { type AndroidNativeRunOptions, buildAndroid, runAndroid };

package/dist/index.js

@@ -0,0 +1,596 @@
+import { BuildLogger, getCwd, p } from "@hot-updater/cli-tools";
+import { generateMinBundleId } from "@hot-updater/plugin-core";
+import path from "path";
+import { ExecaError, execa } from "execa";
+import fs from "fs";
+import os from "node:os";
+
+//#region src/utils/createGradleLogger.ts
+const createGradleLogger = () => new BuildLogger({
+	failurePatterns: ["BUILD FAILED"],
+	importantLogPatterns: [
+		"error:",
+		"Error:",
+		"ERROR:",
+		"> Task :",
+		"BUILD FAILED",
+		"BUILD SUCCESSFUL",
+		"FAILURE: Build failed with an exception.",
+		"* What went wrong:",
+		"Execution failed for task",
+		"Could not resolve",
+		"Failed to",
+		"Unable to load script",
+		"Metro encountered an error",
+		"React Native CLI",
+		"Android resource compilation failed",
+		"Duplicate class",
+		"Program type already present",
+		"actionable tasks:"
+	],
+	progressMapping: [
+		[[
+			"buildKotlinToolingMetadata",
+			"generateAutolinkingNewArchitectureFiles",
+			"generateCodegenSchemaFromJavaScript"
+		], 5],
+		[[
+			"createBundleReleaseJsAndAssets",
+			"bundleReleaseJsAndAssets",
+			"bundleDebugJsAndAssets"
+		], 15],
+		[[
+			"generateReleaseResValues",
+			"generateReleaseResources",
+			"mergeReleaseResources"
+		], 25],
+		[[
+			"processReleaseResources",
+			"processReleaseManifest",
+			"parseReleaseLocalResources"
+		], 35],
+		[["compileReleaseKotlin", "compileDebugKotlin"], 50],
+		[["compileReleaseJavaWithJavac", "compileDebugJavaWithJavac"], 60],
+		[[
+			"dexBuilderRelease",
+			"mergeDexRelease",
+			"transformClassesWithDex"
+		], 75],
+		[[
+			"compressReleaseAssets",
+			"optimizeReleaseResources",
+			"mergeReleaseAssets"
+		], 85],
+		[[
+			"packageRelease",
+			"packageDebug",
+			"assembleRelease",
+			"assembleDebug"
+		], 90],
+		[["bundleRelease", "bundleDebug"], 95],
+		[[/\d+ actionable tasks:/], 100]
+	]
+});
+
+//#endregion
+//#region src/builder/runGradle.ts
+/**
+* Clean up gradle error message by removing common noise
+*/
+const getCleanedErrorMessage = (error) => {
+	const gradleLinesToRemove = [
+		"FAILURE: Build failed with an exception.",
+		"* Try:",
+		"> Run with --stacktrace option to get the stack trace.",
+		"> Run with --info or --debug option to get more log output.",
+		"> Run with --scan to get full insights.",
+		"> Get more help at [undefined](https://help.gradle.org).",
+		"> Get more help at https://help.gradle.org.",
+		"BUILD FAILED"
+	];
+	return error.message.split("\n").filter((line) => !gradleLinesToRemove.some((l) => line.includes(l))).join("\n").trim();
+};
+/**
+* Generate gradle task names with module prefix
+*/
+function getTaskNames(moduleName, tasks) {
+	return tasks.map((task) => `${moduleName}:${task}`);
+}
+/**
+* Get gradle wrapper command based on platform
+*/
+const getGradleWrapper = () => process.platform.startsWith("win") ? "gradlew.bat" : "./gradlew";
+/**
+* Run gradle build with specified tasks and arguments
+*/
+async function runGradle({ tasks, args, androidProjectPath, appModuleName }) {
+	const gradleArgs = getTaskNames(appModuleName, tasks);
+	gradleArgs.push("-x", "lint");
+	if (args.extraParams) gradleArgs.push(...args.extraParams);
+	p.log.info(`Run Gradle Settings: 
+Project    ${androidProjectPath}
+App Moudle ${appModuleName}
+Tasks      ${tasks.join(", ")}
+Args       ${gradleArgs.join(" ")}
+`);
+	if ("port" in args && args.port != null) gradleArgs.push(`-PreactNativeDevServerPort=${args.port}`);
+	const logger = createGradleLogger();
+	logger.start(`${appModuleName}`);
+	try {
+		const process$1 = execa(getGradleWrapper(), gradleArgs, { cwd: androidProjectPath });
+		for await (const line of process$1) if (line) logger.processLine(line);
+		logger.stop();
+	} catch (e) {
+		logger.stop("Build failed", false);
+		if (e instanceof ExecaError) p.log.error(getCleanedErrorMessage(e));
+		else if (e instanceof Error) p.log.error(e.message);
+		throw new Error("Failed to build the app. See the error above for details from Gradle.");
+	}
+	return findBuildDirectory({
+		androidProjectPath,
+		moduleName: appModuleName,
+		tasks
+	});
+}
+/**
+* Find the build output directory and artifact path
+*/
+async function findBuildDirectory({ moduleName, tasks, androidProjectPath }) {
+	const selectedTask = tasks.find((t) => t.startsWith("install") || t.startsWith("assemble") || t.startsWith("bundle"));
+	if (!selectedTask) throw new Error(`Not supported gradle task: ${tasks.join(", ")}`);
+	const variantFromSelectedTask = selectedTask?.replace("install", "")?.replace("assemble", "")?.replace("bundle", "").split(/(?=[A-Z])/);
+	const variantPath = variantFromSelectedTask?.join("/")?.toLowerCase();
+	const variant = variantFromSelectedTask?.join("-")?.toLowerCase();
+	const isAabOutput = selectedTask?.includes("bundle") === true;
+	const buildDirectory = `${androidProjectPath}/${moduleName}/build/outputs/${isAabOutput ? "bundle" : "apk"}/${variantPath}`;
+	if (!buildDirectory) throw new Error("Failed to find Android gradle build directory.");
+	return {
+		buildDirectory,
+		buildArtifactPath: await getBuildOutputFilePath({
+			aab: isAabOutput,
+			appModuleName: moduleName,
+			buildDirectory,
+			variant
+		})
+	};
+}
+/**
+* Get the path to the build output file (APK or AAB)
+*/
+async function getBuildOutputFilePath({ aab, appModuleName, buildDirectory, variant }) {
+	const outputFile = `${appModuleName}-${variant}.${aab ? "aab" : "apk"}`;
+	const outputFilePath = path.join(buildDirectory, outputFile);
+	if (fs.existsSync(outputFilePath)) return outputFilePath;
+	p.log.error(`Failed to find the output file for ${outputFilePath}`);
+	process.exit(1);
+}
+
+//#endregion
+//#region src/utils/enrichNativeBuildAndroidScheme.ts
+const enrichNativeBuildAndroidScheme = async ({ schemeConfig }) => {
+	return {
+		aab: true,
+		variant: "Release",
+		appModuleName: "app",
+		applicationId: schemeConfig.packageName,
+		...schemeConfig
+	};
+};
+
+//#endregion
+//#region src/buildAndroid.ts
+const buildAndroid = async ({ schemeConfig: _schemeConfig }) => {
+	const androidProjectPath = path.join(getCwd(), "android");
+	const minBundleId = generateMinBundleId();
+	const schemeConfig = await enrichNativeBuildAndroidScheme({ schemeConfig: _schemeConfig });
+	return runGradle({
+		args: { extraParams: [`-PMIN_BUNDLE_ID=${minBundleId}`] },
+		appModuleName: schemeConfig.appModuleName,
+		tasks: schemeConfig.aab ? [`bundle${schemeConfig.variant}`] : [`assemble${schemeConfig.variant}`],
+		androidProjectPath
+	});
+};
+
+//#endregion
+//#region src/utils/device.ts
+/**
+* Get the path to adb executable from ANDROID_HOME or use system adb
+*/
+const getAdbPath = () => {
+	return process.env["ANDROID_HOME"] ? path.join(process.env["ANDROID_HOME"], "platform-tools", "adb") : "adb";
+};
+/**
+* Parses the output of the 'adb devices' command
+*/
+const parseDevicesResult = ({ result }) => {
+	if (!result) return [];
+	const devices = [];
+	const lines = result.trim().split(/\r?\n/);
+	for (const line of lines) {
+		const [device, state] = line.split(/[ ,\t]+/).filter((w) => w !== "");
+		if (device && state === "device") devices.push(device);
+	}
+	return devices;
+};
+/**
+* Executes the commands needed to get a list of devices from ADB
+*/
+const getConnectedDevices = async () => {
+	const adbPath = getAdbPath();
+	try {
+		const { stdout } = await execa(adbPath, ["devices"]);
+		return parseDevicesResult({ result: stdout });
+	} catch {
+		return [];
+	}
+};
+/**
+* Runs ADB reverse tcp:8081 tcp:8081 to allow loading the jsbundle from the packager
+* Set up port forwarding from device to development server using adb reverse
+*/
+async function tryRunAdbReverse({ port = 8081, deviceId }) {
+	try {
+		const adbPath = getAdbPath();
+		const adbArgs = [
+			"-s",
+			deviceId,
+			"reverse",
+			`tcp:${port}`,
+			`tcp:${port}`
+		];
+		p.log.info(`Connecting "${deviceId}" to the development server`);
+		await execa(adbPath, adbArgs);
+	} catch (_error) {
+		throw new Error(`Failed to connect "${deviceId}" to development server using "adb reverse"`);
+	}
+}
+/**
+* Get name of Android emulator
+*/
+const getEmulatorName = async (deviceId) => {
+	const { stdout } = await execa(getAdbPath(), [
+		"-s",
+		deviceId,
+		"emu",
+		"avd",
+		"name"
+	], { stdio: "pipe" });
+	if (!stdout) return "";
+	return stdout.split(os.EOL)[0].replace(/(\r\n|\n|\r)/gm, "").trim();
+};
+/**
+* Get Android device name in readable format
+*/
+const getPhoneName = async (deviceId) => {
+	const { stdout } = await execa(getAdbPath(), [
+		"-s",
+		deviceId,
+		"shell",
+		"getprop",
+		"ro.product.model"
+	], { stdio: "pipe" });
+	return stdout.replace(/\[ro\.product\.model\]:\s*\[(.*)\]/, "$1").trim();
+};
+/**
+* Check if emulator has finished booting
+*/
+const isEmulatorBooted = async (device) => {
+	const adbPath = getAdbPath();
+	const adbArgs = [
+		"-s",
+		device,
+		"shell",
+		"getprop",
+		"sys.boot_completed"
+	];
+	try {
+		const { stdout } = await execa(adbPath, adbArgs, { stdio: "pipe" });
+		return stdout.trim() === "1";
+	} catch {
+		return false;
+	}
+};
+const emulatorCommand = process.env["ANDROID_HOME"] ? `${process.env["ANDROID_HOME"]}/emulator/emulator` : "emulator";
+/**
+* Get a list of available Android emulators
+*/
+const getEmulatorNames = async () => {
+	try {
+		const { stdout } = await execa(emulatorCommand, ["-list-avds"], { stdio: "pipe" });
+		return stdout.split(os.EOL).filter((name) => name !== "" && !name.includes(" "));
+	} catch {
+		return [];
+	}
+};
+const checkEmulatorBootStatus = async ({ port, emulatorName, loader, onBooted }) => {
+	const connected = (await getConnectedDevices()).find((d) => d.includes(`${port}`));
+	if (connected) {
+		loader.message(`Emulator "${emulatorName}" is connected. Waiting for boot`);
+		if (await isEmulatorBooted(connected)) onBooted(connected);
+	}
+};
+/**
+* Launch the Android emulator and wait for it to boot
+*/
+const launchEmulator = async (emulatorName, port, loader) => {
+	const manualCommand = `${emulatorCommand} -avd ${emulatorName}`;
+	const timeout = 120;
+	const cp = execa(emulatorCommand, [
+		"-avd",
+		emulatorName,
+		"-port",
+		`${port}`
+	], {
+		detached: true,
+		stdio: "ignore"
+	});
+	cp.unref();
+	return new Promise((resolve, reject) => {
+		let bootCheckInterval;
+		let rejectTimeout;
+		const cleanup = () => {
+			clearTimeout(rejectTimeout);
+			clearInterval(bootCheckInterval);
+		};
+		const handleError = (message) => {
+			cleanup();
+			reject(new Error(message));
+		};
+		bootCheckInterval = setInterval(async () => {
+			await checkEmulatorBootStatus({
+				port,
+				emulatorName,
+				loader,
+				onBooted: (deviceId) => {
+					cleanup();
+					resolve(deviceId);
+				}
+			});
+		}, 1e3);
+		rejectTimeout = setTimeout(() => {
+			handleError(`It took too long to start and connect with Android emulator: ${emulatorName}. You can try starting the emulator manually from the terminal with: ${manualCommand}`);
+		}, timeout * 1e3);
+		cp.catch((error) => {
+			handleError(error);
+		});
+	});
+};
+const defaultPort = 5554;
+const maxPort = 5682;
+/**
+* Find an available port for emulator (starting from 5554)
+*/
+const getAvailableDevicePort = async (startPort = defaultPort) => {
+	/**
+	* The default value is 5554 for the first virtual device instance running on your machine.
+	* A virtual device normally occupies a pair of adjacent ports: a console port and an adb port.
+	* The console of the first virtual device running on a particular machine uses console port 5554 and adb port 5555.
+	* Subsequent instances use port numbers increasing by two.
+	* For example, 5556/5557, 5558/5559, and so on. The range is 5554 to 5682, allowing for 64 concurrent virtual devices.
+	*/
+	const devices = await getConnectedDevices();
+	for (let port = startPort; port <= maxPort; port += 2) if (!devices.some((d) => d.includes(port.toString()))) return port;
+	throw new Error("Failed to launch emulator: no available ports");
+};
+/**
+* Try to launch an emulator (or find the first available one)
+*/
+const tryLaunchEmulator = async (name) => {
+	const port = await getAvailableDevicePort();
+	const loader = p.spinner();
+	loader.start("Looking for available emulators");
+	const emulators = await getEmulatorNames();
+	const emulatorName = name ?? emulators[0];
+	let deviceId;
+	if (emulators.length > 0) try {
+		loader.message(`Launching emulator "${emulatorName}"`);
+		deviceId = await launchEmulator(emulatorName, port, loader);
+		loader.stop(`Launched ${emulatorName} emulator.`);
+	} catch (error) {
+		loader.stop(`Failed to launch ${emulatorName} emulator. ${error.message}`, 1);
+	}
+	else loader.stop("No emulators found as an output of `emulator -list-avds`. Please launch an emulator manually or connect a device", 1);
+	return deviceId;
+};
+/**
+* List all Android devices and emulators (connected and available)
+*/
+const listDevices = async () => {
+	const devices = await getConnectedDevices();
+	const allDevices = [];
+	for (const deviceId of devices) if (deviceId.includes("emulator")) {
+		const emulatorData = {
+			deviceId,
+			readableName: await getEmulatorName(deviceId),
+			connected: true,
+			type: "emulator"
+		};
+		allDevices.push(emulatorData);
+	} else {
+		const phoneData = {
+			deviceId,
+			readableName: await getPhoneName(deviceId),
+			type: "phone",
+			connected: true
+		};
+		allDevices.push(phoneData);
+	}
+	const emulatorNames = await getEmulatorNames();
+	for (const emulatorName of emulatorNames) {
+		if (allDevices.some((device) => device.readableName === emulatorName)) continue;
+		const emulatorData = {
+			deviceId: void 0,
+			readableName: emulatorName,
+			type: "emulator",
+			connected: false
+		};
+		allDevices.push(emulatorData);
+	}
+	return allDevices.sort((a, b) => {
+		if (a.type === "phone" && b.type === "emulator") return -1;
+		if (a.type === "emulator" && b.type === "phone") return 1;
+		return 0;
+	});
+};
+const matchingDevice = (devices, deviceArg) => {
+	const deviceByName = devices.find((device) => device.readableName === deviceArg);
+	const deviceById = devices.find((d) => d.deviceId === deviceArg);
+	return deviceByName || deviceById;
+};
+const selectTargetDevice = async ({ interactive, deviceOption }) => {
+	const availableDevices = await listDevices();
+	if (deviceOption === true && !interactive) {
+		p.log.error("you can't select device manually with non-interactive cli mode(without -i option).");
+		process.exit(1);
+	}
+	if (typeof deviceOption === "string") {
+		const matchedDevice = matchingDevice(availableDevices, deviceOption);
+		if (!matchedDevice) {
+			p.log.error(`device '${deviceOption}' isn't included in the attached devices.`);
+			process.exit(1);
+		}
+		return matchedDevice;
+	}
+	if (interactive) {
+		if (!availableDevices.length) {
+			p.log.error("you passed -d option but there is no attached adb devices.");
+			process.exit(1);
+		}
+		const device = await p.select({
+			message: "Target Device",
+			options: availableDevices.map((d) => ({
+				value: d,
+				label: d.readableName
+			}))
+		});
+		if (p.isCancel(device)) process.exit(1);
+		return device;
+	}
+};
+const Device = {
+	getAdbPath,
+	getConnectedDevices,
+	tryRunAdbReverse,
+	tryLaunchEmulator,
+	listDevices,
+	selectTargetDevice
+};
+
+//#endregion
+//#region src/runner/tryInstallAppOnDevice.ts
+const tryInstallAppOnDevice = async ({ device, apkPath }) => {
+	if (!device.deviceId) {
+		p.log.warn(`No device with id "${device.deviceId}", skipping launching the app.`);
+		return;
+	}
+	const deviceId = device.deviceId;
+	const adbArgs = [
+		"-s",
+		deviceId,
+		"install",
+		"-r",
+		"-d"
+	];
+	adbArgs.push(apkPath);
+	const adbPath = Device.getAdbPath();
+	const loader = p.spinner();
+	loader.start(`Installing the app on ${device.readableName} (id: ${deviceId})`);
+	try {
+		await execa(adbPath, adbArgs);
+		loader.stop(`Installed the app on ${device.readableName} (id: ${deviceId}).`);
+	} catch (error) {
+		const errorMessage = error.stdout || error.stderr || "Unknown error";
+		if (typeof errorMessage === "string" && errorMessage.includes("INSTALL_FAILED_INSUFFICIENT_STORAGE")) loader.message("Installation failed due to insufficient storage");
+		loader.stop(`Failed: Installing the app on ${device.readableName} (id: ${deviceId})`, 1);
+		throw new Error(typeof errorMessage === "string" ? errorMessage : "Installation failed");
+	}
+};
+
+//#endregion
+//#region src/runner/tryLaunchAppOnDevice.ts
+async function tryLaunchAppOnDevice({ device, port, mainActivity, applicationId, packageName }) {
+	if (!device.deviceId) {
+		p.log.warn(`No device with id "${device.deviceId}", skipping launching the app.`);
+		return;
+	}
+	const deviceId = device.deviceId;
+	await Device.tryRunAdbReverse({
+		deviceId,
+		port
+	});
+	const activity = mainActivity || ".MainActivity";
+	const adbArgs = [
+		"shell",
+		"am",
+		"start",
+		"-n",
+		`${applicationId}/${activity.startsWith(packageName) || !activity.startsWith(".") && activity.includes(".") ? activity : activity.startsWith(".") ? [packageName, activity].join("") : [packageName, activity].filter(Boolean).join(".")}`,
+		"-a",
+		"android.intent.action.MAIN",
+		"-c",
+		"android.intent.category.LAUNCHER"
+	];
+	adbArgs.unshift("-s", deviceId);
+	const adbPath = Device.getAdbPath();
+	console.debug(`Running ${adbPath} ${adbArgs.join(" ")}.`);
+	const loader = p.spinner();
+	loader.start(`Launching the app on ${device.readableName} (id: ${deviceId})`);
+	try {
+		await execa(adbPath, adbArgs);
+		loader.stop(`Launched the app on ${device.readableName} (id: ${deviceId}) and listening on port ${port}.`);
+	} catch (_error) {
+		loader.stop("Failed to launch the app.", 1);
+		throw new Error(`Failed to launch the app on ${device.readableName}`);
+	}
+}
+
+//#endregion
+//#region src/runAndroid.ts
+const runAndroid = async ({ schemeConfig: _schemeConfig, runOption }) => {
+	const { interactive, device: deviceOption } = runOption;
+	const androidProjectPath = path.join(getCwd(), "android");
+	const schemeConfig = await enrichNativeBuildAndroidScheme({ schemeConfig: _schemeConfig });
+	if (schemeConfig.aab) {
+		p.log.error("aab scheme can't not be run");
+		process.exit(1);
+	}
+	const device = await Device.selectTargetDevice({
+		deviceOption,
+		interactive
+	});
+	if (device) {
+		if (!(await Device.getConnectedDevices()).includes(device.deviceId || "")) {
+			if (device.type === "emulator") device.deviceId = await Device.tryLaunchEmulator(device.readableName);
+		}
+		if (!device.deviceId) throw new Error("Failed to run on any device");
+	} else if ((await Device.getConnectedDevices()).length === 0) {
+		p.log.info("No devices found. Launching first available emulator.");
+		await Device.tryLaunchEmulator();
+	}
+	const task = `assemble${schemeConfig.variant}`;
+	const result = await runGradle({
+		args: { extraParams: [`-PMIN_BUNDLE_ID=${generateMinBundleId()}`] },
+		appModuleName: schemeConfig.appModuleName,
+		tasks: [task],
+		androidProjectPath
+	});
+	const targetDevices = device ? [device] : (await Device.listDevices()).filter((d) => d.connected);
+	for (const targetDevice of targetDevices) {
+		await tryInstallAppOnDevice({
+			apkPath: result.buildArtifactPath,
+			device: targetDevice
+		});
+		await tryLaunchAppOnDevice({
+			applicationId: schemeConfig.applicationId,
+			device: targetDevice,
+			mainActivity: runOption.mainActivity,
+			packageName: schemeConfig.packageName,
+			port: runOption.port
+		});
+	}
+	p.outro("Success 🎉");
+	return result;
+};
+
+//#endregion
+export { buildAndroid, runAndroid };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hot-updater/android-helper",
+  "version": "0.25.4",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "description": "Android development helper utilities for hot-updater",
+  "license": "MIT",
+  "repository": "https://github.com/gronxb/hot-updater",
+  "author": "gronxb <gron1gh1@gmail.com> (https://github.com/gronxb)",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "execa": "9.5.2",
+    "@hot-updater/core": "0.25.4",
+    "@hot-updater/cli-tools": "0.25.4",
+    "@hot-updater/plugin-core": "0.25.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test:type": "tsc --noEmit"
+  }
+}