@oniroproject/oniro-app 0.6.0

package/dist/oniro-app.js

@@ -0,0 +1,434 @@
+#!/usr/bin/env node
+
+// src/bin/oniro-app.ts
+import { Command as Command2 } from "commander";
+import { OniroError } from "@oniroproject/core";
+
+// src/commands/sdk.ts
+import * as fs from "fs";
+import * as path from "path";
+import {
+  ALL_SDKS,
+  downloadAndInstallSdk,
+  getOsFolder,
+  getSdkRootDir,
+  getSupportedSdksForUi,
+  removeSdk
+} from "@oniroproject/core";
+
+// src/adapters/logger.ts
+function createCliLogger() {
+  const debugEnabled = process.env.ONIRO_DEBUG === "1" || process.env.ONIRO_DEBUG === "true";
+  return {
+    debug(m) {
+      if (debugEnabled) process.stderr.write(`[debug] ${m}
+`);
+    },
+    info(m) {
+      process.stderr.write(`${m}
+`);
+    },
+    warn(m) {
+      process.stderr.write(`[warn] ${m}
+`);
+    },
+    error(m) {
+      process.stderr.write(`[error] ${m}
+`);
+    }
+  };
+}
+
+// src/adapters/progress.ts
+function createCliProgress() {
+  let total = 0;
+  let lastEmitted = -1;
+  let lastMessage = "";
+  return {
+    report({ message, increment }) {
+      if (typeof increment === "number") total = Math.min(100, total + increment);
+      const pct = total > 0 ? Math.round(total) : null;
+      const msg = message ?? lastMessage;
+      if (pct === lastEmitted && msg === lastMessage) return;
+      const prefix = pct === null ? "[progress]" : `[progress ${pct}%]`;
+      process.stderr.write(`${prefix} ${msg}
+`);
+      lastEmitted = pct ?? lastEmitted;
+      if (message) lastMessage = message;
+    }
+  };
+}
+
+// src/adapters/config.ts
+import * as os from "os";
+var ENV_VAR_BY_KEY = {
+  sdkRootDir: "ONIRO_SDK_ROOT_DIR",
+  cmdToolsPath: "ONIRO_CMD_TOOLS_PATH",
+  emulatorDir: "ONIRO_EMULATOR_DIR",
+  hapPath: "ONIRO_HAP_PATH",
+  cmdToolsUrlLinux: "ONIRO_CMD_TOOLS_URL_LINUX",
+  cmdToolsUrlWindows: "ONIRO_CMD_TOOLS_URL_WINDOWS",
+  cmdToolsUrlMac: "ONIRO_CMD_TOOLS_URL_MAC",
+  emulatorUrl: "ONIRO_EMULATOR_URL"
+};
+function createEnvConfig(env = process.env) {
+  return {
+    get(key, fallback) {
+      const envName = ENV_VAR_BY_KEY[key];
+      const raw = env[envName];
+      if (raw === void 0 || raw === "") return fallback;
+      const expanded = raw.includes("${userHome}") ? raw.replace(/\$\{userHome\}/g, os.homedir()) : raw;
+      return expanded;
+    }
+  };
+}
+
+// src/lib/runtime.ts
+var cached = null;
+function getRuntime() {
+  if (!cached) {
+    cached = {
+      logger: createCliLogger(),
+      config: createEnvConfig(),
+      progress: createCliProgress()
+    };
+  }
+  return cached;
+}
+
+// src/commands/sdk.ts
+function registerSdkCommand(program) {
+  const sdk = program.command("sdk").description("Manage OpenHarmony SDK installs.");
+  sdk.command("install <version>").description("Download and install an OpenHarmony SDK. Skips if already installed.").option("--force", "Reinstall even if the SDK is already present.").action(async (version, opts) => {
+    const { config, logger, progress } = getRuntime();
+    const release = ALL_SDKS.find((s) => s.version === version);
+    if (!release) {
+      throw new Error(
+        `Unknown SDK version "${version}". Known: ${ALL_SDKS.map((s) => s.version).join(", ")}`
+      );
+    }
+    const sdkInstallDir = path.join(getSdkRootDir(config), getOsFolder(), release.api);
+    if (fs.existsSync(sdkInstallDir) && !opts.force) {
+      logger.info(
+        `SDK ${release.version} (api ${release.api}) already installed at ${sdkInstallDir}; pass --force to reinstall.`
+      );
+      return;
+    }
+    logger.info(`Installing OpenHarmony SDK ${release.version} (api ${release.api})...`);
+    await downloadAndInstallSdk({ config, version: release.version, api: release.api, progress, logger });
+    logger.info("SDK installed.");
+  });
+  sdk.command("list").description("List known SDK versions and whether they are installed on this machine.").option("--json", "Emit machine-readable JSON instead of a table.").action((opts) => {
+    const { config } = getRuntime();
+    const sdks = getSupportedSdksForUi(config);
+    if (opts.json) {
+      process.stdout.write(`${JSON.stringify(sdks, null, 2)}
+`);
+      return;
+    }
+    const rows = sdks.map((s) => `${s.installed ? "*" : " "}  ${s.version.padEnd(8)} api ${s.api}`);
+    process.stdout.write(`${rows.join("\n")}
+`);
+  });
+  sdk.command("remove <api>").description("Remove an installed SDK by API level (e.g. 18, 20).").action((api) => {
+    const { config, logger } = getRuntime();
+    const removed = removeSdk(config, api);
+    if (!removed) {
+      logger.warn(`No SDK with api ${api} found under the configured SDK root.`);
+      process.exit(1);
+    }
+    logger.info(`Removed SDK api ${api}.`);
+  });
+}
+
+// src/commands/cmdtools.ts
+import { getCmdToolsStatus, installCmdTools, isCmdToolsInstalled, removeCmdTools } from "@oniroproject/core";
+function registerCmdToolsCommand(program) {
+  const cmdtools = program.command("cmdtools").description("Manage OpenHarmony command-line tools.");
+  cmdtools.command("install").description("Install the OpenHarmony command-line tools (hvigorw, ohpm, hdc). Skips if already installed.").option("--from-zip <path>", "Install from a local ZIP instead of downloading.").option("--force", "Reinstall even if the tools are already present.").action(async (opts) => {
+    const { config, logger, progress } = getRuntime();
+    if (isCmdToolsInstalled(config) && !opts.force) {
+      logger.info("Command-line tools already installed; pass --force to reinstall.");
+      return;
+    }
+    logger.info("Installing OpenHarmony command-line tools...");
+    await installCmdTools({ config, progress, logger, localZipPath: opts.fromZip });
+    logger.info("Command-line tools installed.");
+  });
+  cmdtools.command("status").description("Report whether the command-line tools are installed and their version.").option("--json", "Emit machine-readable JSON.").action((opts) => {
+    const { config } = getRuntime();
+    const status = getCmdToolsStatus(config);
+    if (opts.json) {
+      process.stdout.write(`${JSON.stringify(status, null, 2)}
+`);
+      return;
+    }
+    process.stdout.write(`${status.status}
+`);
+    if (!status.installed) process.exit(1);
+  });
+  cmdtools.command("remove").description("Delete the configured command-line tools directory.").action(() => {
+    const { config, logger } = getRuntime();
+    removeCmdTools(config);
+    logger.info("Command-line tools removed.");
+  });
+}
+
+// src/commands/emulator.ts
+import {
+  attemptHdcConnection,
+  installEmulator,
+  isEmulatorInstalled,
+  removeEmulator,
+  startEmulator,
+  stopEmulator
+} from "@oniroproject/core";
+function registerEmulatorCommand(program) {
+  const emu = program.command("emulator").description("Manage the Oniro emulator.");
+  emu.command("install").description("Download and install the Oniro emulator (QEMU-based). Skips if already installed.").option("--force", "Reinstall even if the emulator is already present.").action(async (opts) => {
+    const { config, logger, progress } = getRuntime();
+    if (isEmulatorInstalled(config) && !opts.force) {
+      logger.info("Emulator already installed; pass --force to reinstall.");
+      return;
+    }
+    logger.info("Installing Oniro emulator...");
+    await installEmulator({ config, progress, logger });
+    logger.info("Emulator installed.");
+  });
+  emu.command("start").description("Start the Oniro emulator via the bundled launcher (run.sh / run.bat). Detaches so the CLI can exit while the emulator keeps running.").option("--headless", "Launch headless (VNC + telnet serial, no local window). Required in CI.").option("--log <path>", "Redirect launcher stdout/stderr to this file. Defaults to discarding output.").option("--wait-for-hdc <seconds>", "Wait up to N seconds for hdc to connect. 0 = do not wait.", (v) => parseInt(v, 10), 0).option("--connect <host:port>", "Override the launcher's hdc port-forward bind address. Pass 0.0.0.0:55555 on hosts where QEMU refuses to bind 127.0.0.1 (some CI runners).").action(async (opts) => {
+    const { config, logger } = getRuntime();
+    await startEmulator({
+      config,
+      logger,
+      headless: opts.headless === true,
+      logFile: opts.log,
+      waitForHdcSeconds: opts.waitForHdc,
+      connect: opts.connect
+    });
+    logger.info("Emulator start command complete.");
+  });
+  emu.command("stop").description("Kill running emulator processes.").action(async () => {
+    const { logger } = getRuntime();
+    await stopEmulator(logger);
+    logger.info("Emulator stopped.");
+  });
+  emu.command("connect").description("Attempt to connect hdc to the emulator.").option("--address <addr>", "hdc address to connect to", "127.0.0.1:55555").action(async (opts) => {
+    const { config, logger } = getRuntime();
+    const ok = await attemptHdcConnection(config, opts.address, logger);
+    if (!ok) {
+      logger.error(`Could not connect hdc to ${opts.address}.`);
+      process.exit(1);
+    }
+    logger.info(`hdc connected to ${opts.address}.`);
+  });
+  emu.command("remove").description("Delete the configured emulator directory.").action(() => {
+    const { config, logger } = getRuntime();
+    removeEmulator(config);
+    logger.info("Emulator removed.");
+  });
+}
+
+// src/commands/build.ts
+import * as path2 from "path";
+import { runHvigorw } from "@oniroproject/core";
+function registerBuildCommand(program) {
+  program.command("build [project-dir]").description("Build an OpenHarmony app via hvigorw. Defaults to the current directory.").option("--product <product>", "hvigor product name", "default").option("--module <module>", "restrict the build to a specific module").option("--mode <mode>", "hvigor build mode (e.g. release, debug)").option("--task <task>", "hvigor task to run", "assembleHap").action(async (projectDir, opts) => {
+    const { config, logger } = getRuntime();
+    const dir = path2.resolve(projectDir ?? process.cwd());
+    logger.info(`Building project at ${dir}...`);
+    await runHvigorw({
+      config,
+      projectDir: dir,
+      product: opts.product,
+      module: opts.module,
+      buildMode: opts.mode,
+      task: opts.task,
+      logger,
+      // Forward output as it arrives. We don't double-print since the logger
+      // already echoes spawn output; this hook is for streaming to other UIs.
+      onOutput: () => {
+      }
+    });
+    logger.info("Build complete.");
+  });
+}
+
+// src/commands/sign.ts
+import { Option } from "commander";
+import * as path3 from "path";
+import {
+  APL_VALUES,
+  APP_FEATURE_VALUES,
+  generateSigningConfigs,
+  getOhosBaseSdkHome
+} from "@oniroproject/core";
+function registerSignCommand(program) {
+  program.command("sign [project-dir]").description(
+    [
+      "Generate signing keys, certificates, and signingConfigs for an OpenHarmony project.",
+      "Requires java on PATH. The generated profile uses the SDK's built-in development",
+      "cert (issuer=pki_internal) and its bundled validity window \u2014 dev/local builds only.",
+      "Overwrites the `signingConfigs` block in build-profile.json5 (other keys preserved)."
+    ].join(" ")
+  ).addOption(
+    new Option(
+      "--apl <level>",
+      "Ability Privilege Level written into the profile. Apps that request permissions above `normal` (e.g. ohos.permission.GET_WIFI_INFO_INTERNAL) need system_basic or system_core."
+    ).choices([...APL_VALUES]).default("normal")
+  ).addOption(
+    new Option(
+      "--app-feature <feature>",
+      "App feature written into the profile. Defaults: hos_normal_app for apl=normal; hos_system_app for apl=system_basic/system_core."
+    ).choices([...APP_FEATURE_VALUES])
+  ).action((projectDir, opts) => {
+    const { config, logger } = getRuntime();
+    const dir = path3.resolve(projectDir ?? process.cwd());
+    const sdkHome = getOhosBaseSdkHome(config);
+    logger.info(`Generating signing configs in ${dir} using SDK at ${sdkHome}...`);
+    generateSigningConfigs({
+      projectDir: dir,
+      sdkHome,
+      apl: opts.apl,
+      appFeature: opts.appFeature,
+      logger
+    });
+    logger.info("Signing configs generated.");
+  });
+}
+
+// src/commands/app.ts
+import * as path4 from "path";
+import { installApp, launchApp } from "@oniroproject/core";
+function registerAppCommand(program) {
+  const app = program.command("app").description("Install and launch built apps on a connected device/emulator.");
+  app.command("install [project-dir]").description("Install the signed .hap on the connected device/emulator via hdc.").option("--hap <path>", "Override the .hap path (relative to project-dir or absolute).").action(async (projectDir, opts) => {
+    const { config, logger } = getRuntime();
+    const dir = path4.resolve(projectDir ?? process.cwd());
+    logger.info(`Installing app from ${dir}...`);
+    await installApp({ config, projectDir: dir, hapPath: opts.hap, logger });
+    logger.info("App installed.");
+  });
+  app.command("launch [project-dir]").description("Launch the app on the connected device/emulator via hdc.").option("--module <module>", "Module folder name", "entry").action(async (projectDir, opts) => {
+    const { config, logger } = getRuntime();
+    const dir = path4.resolve(projectDir ?? process.cwd());
+    logger.info(`Launching app from ${dir}...`);
+    await launchApp({ config, projectDir: dir, moduleName: opts.module, logger });
+    logger.info("App launched.");
+  });
+}
+
+// src/commands/create.ts
+import * as path6 from "path";
+import {
+  ALL_SDKS as ALL_SDKS2,
+  createScaffold,
+  isValidBundleName,
+  isValidProjectName
+} from "@oniroproject/core";
+
+// src/lib/templateRoot.ts
+import * as fs2 from "fs";
+import * as path5 from "path";
+import { fileURLToPath } from "url";
+function getBundledTemplateRoot() {
+  const here = path5.dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    path5.resolve(here, "../templates"),
+    // dist/oniro-app.js → ../templates
+    path5.resolve(here, "../../templates")
+    // src/bin/oniro-app.ts → ../../templates
+  ];
+  for (const c of candidates) {
+    if (fs2.existsSync(c)) return c;
+  }
+  return candidates[0];
+}
+
+// src/commands/create.ts
+function registerCreateCommand(program) {
+  program.command("create").description("Scaffold a new Oniro/OpenHarmony app from a template. All flags are required (non-interactive).").requiredOption("--name <name>", "Project folder name (letters, digits, ._- only)").requiredOption("--bundle <bundleName>", "Bundle name in reverse-DNS form, e.g. com.example.myapp").requiredOption("--location <dir>", "Parent directory where the new project folder will be created").requiredOption("--sdk <api>", "Target SDK API level (e.g. 18, 20)").option("--template <id>", "Template id", "EmptyAbility").option("--module <name>", "Module folder name (defaults to the template default, usually `entry`)").option("--overwrite", "Replace the destination if it already exists").action(async (opts) => {
+    const { config, logger } = getRuntime();
+    if (!isValidProjectName(opts.name)) {
+      throw new Error(`Invalid --name '${opts.name}'. Use letters/numbers/._- and no slashes.`);
+    }
+    if (!isValidBundleName(opts.bundle)) {
+      throw new Error(`Invalid --bundle '${opts.bundle}'. Example: com.example.myapp`);
+    }
+    const sdkApi = Number(opts.sdk);
+    if (!Number.isFinite(sdkApi)) {
+      throw new Error(`--sdk must be a numeric api level. Known: ${ALL_SDKS2.map((s) => s.api).join(", ")}`);
+    }
+    const templateRoot = getBundledTemplateRoot();
+    const result = await createScaffold({
+      config,
+      templateId: opts.template,
+      projectName: opts.name,
+      bundleName: opts.bundle,
+      location: path6.resolve(opts.location),
+      sdkApi,
+      moduleName: opts.module,
+      templateRoot,
+      overwrite: opts.overwrite,
+      logger
+    });
+    logger.info(`Project created at ${result.projectDir}`);
+    process.stdout.write(`${result.projectDir}
+`);
+  });
+}
+
+// src/commands/templates.ts
+import { listTemplates } from "@oniroproject/core";
+function registerTemplatesCommand(program) {
+  const templates = program.command("templates").description("Inspect the templates bundled with this CLI.");
+  templates.command("list").description("List available project templates.").option("--json", "Emit machine-readable JSON.").action((opts) => {
+    const root = getBundledTemplateRoot();
+    const list = listTemplates(root);
+    if (opts.json) {
+      process.stdout.write(`${JSON.stringify(list, null, 2)}
+`);
+      return;
+    }
+    if (list.length === 0) {
+      process.stdout.write("No templates available.\n");
+      return;
+    }
+    const rows = list.map((t) => `${t.id.padEnd(20)} ${t.label.padEnd(24)} ${t.description}`);
+    process.stdout.write(`${rows.join("\n")}
+`);
+  });
+}
+
+// src/bin/oniro-app.ts
+var CLI_VERSION = "0.6.0";
+function buildProgram() {
+  const program = new Command2().name("oniro-app").description(
+    "Cross-platform CLI for Oniro/OpenHarmony app development.\n\nDesigned for non-interactive use (CI, scripts, agents): every command\ntakes explicit flags, results go to stdout, progress/logs go to stderr,\nand a non-zero exit code indicates failure."
+  ).version(CLI_VERSION).showHelpAfterError();
+  registerSdkCommand(program);
+  registerCmdToolsCommand(program);
+  registerEmulatorCommand(program);
+  registerBuildCommand(program);
+  registerSignCommand(program);
+  registerAppCommand(program);
+  registerCreateCommand(program);
+  registerTemplatesCommand(program);
+  return program;
+}
+async function main() {
+  const program = buildProgram();
+  try {
+    await program.parseAsync(process.argv);
+  } catch (err) {
+    const message = err instanceof OniroError ? err.message : err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[error] ${message}
+`);
+    if (process.env.ONIRO_DEBUG === "1" && err instanceof Error && err.stack) {
+      process.stderr.write(`${err.stack}
+`);
+    }
+    process.exit(1);
+  }
+}
+void main();
+//# sourceMappingURL=oniro-app.js.map

package/dist/oniro-app.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin/oniro-app.ts","../src/commands/sdk.ts","../src/adapters/logger.ts","../src/adapters/progress.ts","../src/adapters/config.ts","../src/lib/runtime.ts","../src/commands/cmdtools.ts","../src/commands/emulator.ts","../src/commands/build.ts","../src/commands/sign.ts","../src/commands/app.ts","../src/commands/create.ts","../src/lib/templateRoot.ts","../src/commands/templates.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { OniroError } from '@oniroproject/core';\nimport { registerSdkCommand } from '../commands/sdk.js';\nimport { registerCmdToolsCommand } from '../commands/cmdtools.js';\nimport { registerEmulatorCommand } from '../commands/emulator.js';\nimport { registerBuildCommand } from '../commands/build.js';\nimport { registerSignCommand } from '../commands/sign.js';\nimport { registerAppCommand } from '../commands/app.js';\nimport { registerCreateCommand } from '../commands/create.js';\nimport { registerTemplatesCommand } from '../commands/templates.js';\n\ndeclare const __CLI_VERSION__: string;\nconst CLI_VERSION = __CLI_VERSION__;\n\nfunction buildProgram(): Command {\n  const program = new Command()\n    .name('oniro-app')\n    .description(\n      'Cross-platform CLI for Oniro/OpenHarmony app development.\\n\\n' +\n        'Designed for non-interactive use (CI, scripts, agents): every command\\n' +\n        'takes explicit flags, results go to stdout, progress/logs go to stderr,\\n' +\n        'and a non-zero exit code indicates failure.',\n    )\n    .version(CLI_VERSION)\n    .showHelpAfterError();\n\n  registerSdkCommand(program);\n  registerCmdToolsCommand(program);\n  registerEmulatorCommand(program);\n  registerBuildCommand(program);\n  registerSignCommand(program);\n  registerAppCommand(program);\n  registerCreateCommand(program);\n  registerTemplatesCommand(program);\n\n  return program;\n}\n\nasync function main(): Promise<void> {\n  const program = buildProgram();\n  try {\n    await program.parseAsync(process.argv);\n  } catch (err) {\n    const message = err instanceof OniroError ? err.message : err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[error] ${message}\\n`);\n    if (process.env.ONIRO_DEBUG === '1' && err instanceof Error && err.stack) {\n      process.stderr.write(`${err.stack}\\n`);\n    }\n    process.exit(1);\n  }\n}\n\nvoid main();\n","import { Command } from 'commander';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport {\n  ALL_SDKS,\n  downloadAndInstallSdk,\n  getOsFolder,\n  getSdkRootDir,\n  getSupportedSdksForUi,\n  removeSdk,\n} from '@oniroproject/core';\nimport { getRuntime } from '../lib/runtime.js';\n\nexport function registerSdkCommand(program: Command): void {\n  const sdk = program.command('sdk').description('Manage OpenHarmony SDK installs.');\n\n  sdk\n    .command('install <version>')\n    .description('Download and install an OpenHarmony SDK. Skips if already installed.')\n    .option('--force', 'Reinstall even if the SDK is already present.')\n    .action(async (version: string, opts: { force?: boolean }) => {\n      const { config, logger, progress } = getRuntime();\n      const release = ALL_SDKS.find((s) => s.version === version);\n      if (!release) {\n        throw new Error(\n          `Unknown SDK version \"${version}\". Known: ${ALL_SDKS.map((s) => s.version).join(', ')}`,\n        );\n      }\n      const sdkInstallDir = path.join(getSdkRootDir(config), getOsFolder(), release.api);\n      if (fs.existsSync(sdkInstallDir) && !opts.force) {\n        logger.info(\n          `SDK ${release.version} (api ${release.api}) already installed at ${sdkInstallDir}; pass --force to reinstall.`,\n        );\n        return;\n      }\n      logger.info(`Installing OpenHarmony SDK ${release.version} (api ${release.api})...`);\n      await downloadAndInstallSdk({ config, version: release.version, api: release.api, progress, logger });\n      logger.info('SDK installed.');\n    });\n\n  sdk\n    .command('list')\n    .description('List known SDK versions and whether they are installed on this machine.')\n    .option('--json', 'Emit machine-readable JSON instead of a table.')\n    .action((opts: { json?: boolean }) => {\n      const { config } = getRuntime();\n      const sdks = getSupportedSdksForUi(config);\n      if (opts.json) {\n        process.stdout.write(`${JSON.stringify(sdks, null, 2)}\\n`);\n        return;\n      }\n      const rows = sdks.map((s) => `${s.installed ? '*' : ' '}  ${s.version.padEnd(8)} api ${s.api}`);\n      process.stdout.write(`${rows.join('\\n')}\\n`);\n    });\n\n  sdk\n    .command('remove <api>')\n    .description('Remove an installed SDK by API level (e.g. 18, 20).')\n    .action((api: string) => {\n      const { config, logger } = getRuntime();\n      const removed = removeSdk(config, api);\n      if (!removed) {\n        logger.warn(`No SDK with api ${api} found under the configured SDK root.`);\n        process.exit(1);\n      }\n      logger.info(`Removed SDK api ${api}.`);\n    });\n}\n","import type { Logger } from '@oniroproject/core';\n\n/**\n * Stderr-only logger. All diagnostic output goes to stderr so command stdout\n * stays clean for machine consumers (json results, paths, etc.).\n *\n * Debug lines are suppressed unless `ONIRO_DEBUG=1`.\n */\nexport function createCliLogger(): Logger {\n  const debugEnabled = process.env.ONIRO_DEBUG === '1' || process.env.ONIRO_DEBUG === 'true';\n  return {\n    debug(m) {\n      if (debugEnabled) process.stderr.write(`[debug] ${m}\\n`);\n    },\n    info(m) {\n      process.stderr.write(`${m}\\n`);\n    },\n    warn(m) {\n      process.stderr.write(`[warn] ${m}\\n`);\n    },\n    error(m) {\n      process.stderr.write(`[error] ${m}\\n`);\n    },\n  };\n}\n","import type { ProgressReporter } from '@oniroproject/core';\n\n/**\n * Line-per-update progress reporter, designed for machine consumers and log scrapers.\n * Format: `[progress NN%] message` (or `[progress] message` if no percent is known).\n * Updates that don't change the percent and don't carry a message are suppressed\n * to keep output volume reasonable on chatty downloads.\n */\nexport function createCliProgress(): ProgressReporter {\n  let total = 0;\n  let lastEmitted = -1;\n  let lastMessage = '';\n  return {\n    report({ message, increment }) {\n      if (typeof increment === 'number') total = Math.min(100, total + increment);\n      const pct = total > 0 ? Math.round(total) : null;\n      const msg = message ?? lastMessage;\n      // Drop redundant updates: same message, same percent.\n      if (pct === lastEmitted && msg === lastMessage) return;\n      const prefix = pct === null ? '[progress]' : `[progress ${pct}%]`;\n      process.stderr.write(`${prefix} ${msg}\\n`);\n      lastEmitted = pct ?? lastEmitted;\n      if (message) lastMessage = message;\n    },\n  };\n}\n","import * as os from 'node:os';\nimport type { ConfigKey, ConfigProvider } from '@oniroproject/core';\n\n/**\n * Maps a core ConfigKey to its environment variable name.\n * Convention: ONIRO_<UPPER_SNAKE>.\n */\nconst ENV_VAR_BY_KEY: Record<ConfigKey, string> = {\n  sdkRootDir: 'ONIRO_SDK_ROOT_DIR',\n  cmdToolsPath: 'ONIRO_CMD_TOOLS_PATH',\n  emulatorDir: 'ONIRO_EMULATOR_DIR',\n  hapPath: 'ONIRO_HAP_PATH',\n  cmdToolsUrlLinux: 'ONIRO_CMD_TOOLS_URL_LINUX',\n  cmdToolsUrlWindows: 'ONIRO_CMD_TOOLS_URL_WINDOWS',\n  cmdToolsUrlMac: 'ONIRO_CMD_TOOLS_URL_MAC',\n  emulatorUrl: 'ONIRO_EMULATOR_URL',\n};\n\n/**\n * Reads configuration from environment variables (ONIRO_*). Returns the fallback\n * when the variable is unset or empty. Expands `${userHome}` to the user's home\n * directory for parity with the VS Code extension's `${userHome}` expansion.\n */\nexport function createEnvConfig(env: NodeJS.ProcessEnv = process.env): ConfigProvider {\n  return {\n    get<T extends string | number | boolean>(key: ConfigKey, fallback: T): T {\n      const envName = ENV_VAR_BY_KEY[key];\n      const raw = env[envName];\n      if (raw === undefined || raw === '') return fallback;\n      const expanded = raw.includes('${userHome}')\n        ? raw.replace(/\\$\\{userHome\\}/g, os.homedir())\n        : raw;\n      return expanded as unknown as T;\n    },\n  };\n}\n","import type { ConfigProvider, Logger, ProgressReporter } from '@oniroproject/core';\nimport { createCliLogger } from '../adapters/logger.js';\nimport { createCliProgress } from '../adapters/progress.js';\nimport { createEnvConfig } from '../adapters/config.js';\n\nexport interface CliRuntime {\n  logger: Logger;\n  config: ConfigProvider;\n  progress: ProgressReporter;\n}\n\nlet cached: CliRuntime | null = null;\n\n/**\n * Build (and cache) the per-process runtime used by every command. Tests can\n * override the cached runtime via `setRuntime` to inject mocks.\n */\nexport function getRuntime(): CliRuntime {\n  if (!cached) {\n    cached = {\n      logger: createCliLogger(),\n      config: createEnvConfig(),\n      progress: createCliProgress(),\n    };\n  }\n  return cached;\n}\n\nexport function setRuntime(runtime: CliRuntime | null): void {\n  cached = runtime;\n}\n","import { Command } from 'commander';\nimport { getCmdToolsStatus, installCmdTools, isCmdToolsInstalled, removeCmdTools } from '@oniroproject/core';\nimport { getRuntime } from '../lib/runtime.js';\n\nexport function registerCmdToolsCommand(program: Command): void {\n  const cmdtools = program.command('cmdtools').description('Manage OpenHarmony command-line tools.');\n\n  cmdtools\n    .command('install')\n    .description('Install the OpenHarmony command-line tools (hvigorw, ohpm, hdc). Skips if already installed.')\n    .option('--from-zip <path>', 'Install from a local ZIP instead of downloading.')\n    .option('--force', 'Reinstall even if the tools are already present.')\n    .action(async (opts: { fromZip?: string; force?: boolean }) => {\n      const { config, logger, progress } = getRuntime();\n      if (isCmdToolsInstalled(config) && !opts.force) {\n        logger.info('Command-line tools already installed; pass --force to reinstall.');\n        return;\n      }\n      logger.info('Installing OpenHarmony command-line tools...');\n      await installCmdTools({ config, progress, logger, localZipPath: opts.fromZip });\n      logger.info('Command-line tools installed.');\n    });\n\n  cmdtools\n    .command('status')\n    .description('Report whether the command-line tools are installed and their version.')\n    .option('--json', 'Emit machine-readable JSON.')\n    .action((opts: { json?: boolean }) => {\n      const { config } = getRuntime();\n      const status = getCmdToolsStatus(config);\n      if (opts.json) {\n        process.stdout.write(`${JSON.stringify(status, null, 2)}\\n`);\n        return;\n      }\n      process.stdout.write(`${status.status}\\n`);\n      if (!status.installed) process.exit(1);\n    });\n\n  cmdtools\n    .command('remove')\n    .description('Delete the configured command-line tools directory.')\n    .action(() => {\n      const { config, logger } = getRuntime();\n      removeCmdTools(config);\n      logger.info('Command-line tools removed.');\n    });\n}\n","import { Command } from 'commander';\nimport {\n  attemptHdcConnection,\n  installEmulator,\n  isEmulatorInstalled,\n  removeEmulator,\n  startEmulator,\n  stopEmulator,\n} from '@oniroproject/core';\nimport { getRuntime } from '../lib/runtime.js';\n\nexport function registerEmulatorCommand(program: Command): void {\n  const emu = program.command('emulator').description('Manage the Oniro emulator.');\n\n  emu\n    .command('install')\n    .description('Download and install the Oniro emulator (QEMU-based). Skips if already installed.')\n    .option('--force', 'Reinstall even if the emulator is already present.')\n    .action(async (opts: { force?: boolean }) => {\n      const { config, logger, progress } = getRuntime();\n      if (isEmulatorInstalled(config) && !opts.force) {\n        logger.info('Emulator already installed; pass --force to reinstall.');\n        return;\n      }\n      logger.info('Installing Oniro emulator...');\n      await installEmulator({ config, progress, logger });\n      logger.info('Emulator installed.');\n    });\n\n  emu\n    .command('start')\n    .description('Start the Oniro emulator via the bundled launcher (run.sh / run.bat). Detaches so the CLI can exit while the emulator keeps running.')\n    .option('--headless', 'Launch headless (VNC + telnet serial, no local window). Required in CI.')\n    .option('--log <path>', 'Redirect launcher stdout/stderr to this file. Defaults to discarding output.')\n    .option('--wait-for-hdc <seconds>', 'Wait up to N seconds for hdc to connect. 0 = do not wait.', (v) => parseInt(v, 10), 0)\n    .option('--connect <host:port>', 'Override the launcher\\'s hdc port-forward bind address. Pass 0.0.0.0:55555 on hosts where QEMU refuses to bind 127.0.0.1 (some CI runners).')\n    .action(async (opts: { headless?: boolean; log?: string; waitForHdc: number; connect?: string }) => {\n      const { config, logger } = getRuntime();\n      await startEmulator({\n        config,\n        logger,\n        headless: opts.headless === true,\n        logFile: opts.log,\n        waitForHdcSeconds: opts.waitForHdc,\n        connect: opts.connect,\n      });\n      logger.info('Emulator start command complete.');\n    });\n\n  emu\n    .command('stop')\n    .description('Kill running emulator processes.')\n    .action(async () => {\n      const { logger } = getRuntime();\n      await stopEmulator(logger);\n      logger.info('Emulator stopped.');\n    });\n\n  emu\n    .command('connect')\n    .description('Attempt to connect hdc to the emulator.')\n    .option('--address <addr>', 'hdc address to connect to', '127.0.0.1:55555')\n    .action(async (opts: { address: string }) => {\n      const { config, logger } = getRuntime();\n      const ok = await attemptHdcConnection(config, opts.address, logger);\n      if (!ok) {\n        logger.error(`Could not connect hdc to ${opts.address}.`);\n        process.exit(1);\n      }\n      logger.info(`hdc connected to ${opts.address}.`);\n    });\n\n  emu\n    .command('remove')\n    .description('Delete the configured emulator directory.')\n    .action(() => {\n      const { config, logger } = getRuntime();\n      removeEmulator(config);\n      logger.info('Emulator removed.');\n    });\n}\n","import { Command } from 'commander';\nimport * as path from 'node:path';\nimport { runHvigorw } from '@oniroproject/core';\nimport { getRuntime } from '../lib/runtime.js';\n\nexport function registerBuildCommand(program: Command): void {\n  program\n    .command('build [project-dir]')\n    .description('Build an OpenHarmony app via hvigorw. Defaults to the current directory.')\n    .option('--product <product>', 'hvigor product name', 'default')\n    .option('--module <module>', 'restrict the build to a specific module')\n    .option('--mode <mode>', 'hvigor build mode (e.g. release, debug)')\n    .option('--task <task>', 'hvigor task to run', 'assembleHap')\n    .action(async (projectDir: string | undefined, opts: { product: string; module?: string; mode?: string; task: string }) => {\n      const { config, logger } = getRuntime();\n      const dir = path.resolve(projectDir ?? process.cwd());\n      logger.info(`Building project at ${dir}...`);\n      await runHvigorw({\n        config,\n        projectDir: dir,\n        product: opts.product,\n        module: opts.module,\n        buildMode: opts.mode,\n        task: opts.task,\n        logger,\n        // Forward output as it arrives. We don't double-print since the logger\n        // already echoes spawn output; this hook is for streaming to other UIs.\n        onOutput: () => {},\n      });\n      logger.info('Build complete.');\n    });\n}\n","import { Command, Option } from 'commander';\nimport * as path from 'node:path';\nimport {\n  APL_VALUES,\n  APP_FEATURE_VALUES,\n  generateSigningConfigs,\n  getOhosBaseSdkHome,\n  type Apl,\n  type AppFeature,\n} from '@oniroproject/core';\nimport { getRuntime } from '../lib/runtime.js';\n\nexport function registerSignCommand(program: Command): void {\n  program\n    .command('sign [project-dir]')\n    .description(\n      [\n        'Generate signing keys, certificates, and signingConfigs for an OpenHarmony project.',\n        'Requires java on PATH. The generated profile uses the SDK\\'s built-in development',\n        'cert (issuer=pki_internal) and its bundled validity window — dev/local builds only.',\n        'Overwrites the `signingConfigs` block in build-profile.json5 (other keys preserved).',\n      ].join(' '),\n    )\n    .addOption(\n      new Option(\n        '--apl <level>',\n        'Ability Privilege Level written into the profile. Apps that request permissions above `normal` (e.g. ohos.permission.GET_WIFI_INFO_INTERNAL) need system_basic or system_core.',\n      )\n        .choices([...APL_VALUES])\n        .default('normal'),\n    )\n    .addOption(\n      new Option(\n        '--app-feature <feature>',\n        'App feature written into the profile. Defaults: hos_normal_app for apl=normal; hos_system_app for apl=system_basic/system_core.',\n      ).choices([...APP_FEATURE_VALUES]),\n    )\n    .action((projectDir: string | undefined, opts: { apl: Apl; appFeature?: AppFeature }) => {\n      const { config, logger } = getRuntime();\n      const dir = path.resolve(projectDir ?? process.cwd());\n      const sdkHome = getOhosBaseSdkHome(config);\n      logger.info(`Generating signing configs in ${dir} using SDK at ${sdkHome}...`);\n      generateSigningConfigs({\n        projectDir: dir,\n        sdkHome,\n        apl: opts.apl,\n        appFeature: opts.appFeature,\n        logger,\n      });\n      logger.info('Signing configs generated.');\n    });\n}\n","import { Command } from 'commander';\nimport * as path from 'node:path';\nimport { installApp, launchApp } from '@oniroproject/core';\nimport { getRuntime } from '../lib/runtime.js';\n\nexport function registerAppCommand(program: Command): void {\n  const app = program.command('app').description('Install and launch built apps on a connected device/emulator.');\n\n  app\n    .command('install [project-dir]')\n    .description('Install the signed .hap on the connected device/emulator via hdc.')\n    .option('--hap <path>', 'Override the .hap path (relative to project-dir or absolute).')\n    .action(async (projectDir: string | undefined, opts: { hap?: string }) => {\n      const { config, logger } = getRuntime();\n      const dir = path.resolve(projectDir ?? process.cwd());\n      logger.info(`Installing app from ${dir}...`);\n      await installApp({ config, projectDir: dir, hapPath: opts.hap, logger });\n      logger.info('App installed.');\n    });\n\n  app\n    .command('launch [project-dir]')\n    .description('Launch the app on the connected device/emulator via hdc.')\n    .option('--module <module>', 'Module folder name', 'entry')\n    .action(async (projectDir: string | undefined, opts: { module: string }) => {\n      const { config, logger } = getRuntime();\n      const dir = path.resolve(projectDir ?? process.cwd());\n      logger.info(`Launching app from ${dir}...`);\n      await launchApp({ config, projectDir: dir, moduleName: opts.module, logger });\n      logger.info('App launched.');\n    });\n}\n","import { Command } from 'commander';\nimport * as path from 'node:path';\nimport {\n  ALL_SDKS,\n  createScaffold,\n  isValidBundleName,\n  isValidProjectName,\n} from '@oniroproject/core';\nimport { getRuntime } from '../lib/runtime.js';\nimport { getBundledTemplateRoot } from '../lib/templateRoot.js';\n\ninterface CreateOpts {\n  name: string;\n  bundle: string;\n  location: string;\n  sdk: string;\n  template: string;\n  module?: string;\n  overwrite?: boolean;\n}\n\nexport function registerCreateCommand(program: Command): void {\n  program\n    .command('create')\n    .description('Scaffold a new Oniro/OpenHarmony app from a template. All flags are required (non-interactive).')\n    .requiredOption('--name <name>', 'Project folder name (letters, digits, ._- only)')\n    .requiredOption('--bundle <bundleName>', 'Bundle name in reverse-DNS form, e.g. com.example.myapp')\n    .requiredOption('--location <dir>', 'Parent directory where the new project folder will be created')\n    .requiredOption('--sdk <api>', 'Target SDK API level (e.g. 18, 20)')\n    .option('--template <id>', 'Template id', 'EmptyAbility')\n    .option('--module <name>', 'Module folder name (defaults to the template default, usually `entry`)')\n    .option('--overwrite', 'Replace the destination if it already exists')\n    .action(async (opts: CreateOpts) => {\n      const { config, logger } = getRuntime();\n\n      if (!isValidProjectName(opts.name)) {\n        throw new Error(`Invalid --name '${opts.name}'. Use letters/numbers/._- and no slashes.`);\n      }\n      if (!isValidBundleName(opts.bundle)) {\n        throw new Error(`Invalid --bundle '${opts.bundle}'. Example: com.example.myapp`);\n      }\n      const sdkApi = Number(opts.sdk);\n      if (!Number.isFinite(sdkApi)) {\n        throw new Error(`--sdk must be a numeric api level. Known: ${ALL_SDKS.map((s) => s.api).join(', ')}`);\n      }\n\n      const templateRoot = getBundledTemplateRoot();\n      const result = await createScaffold({\n        config,\n        templateId: opts.template,\n        projectName: opts.name,\n        bundleName: opts.bundle,\n        location: path.resolve(opts.location),\n        sdkApi,\n        moduleName: opts.module,\n        templateRoot,\n        overwrite: opts.overwrite,\n        logger,\n      });\n\n      logger.info(`Project created at ${result.projectDir}`);\n      process.stdout.write(`${result.projectDir}\\n`);\n    });\n}\n","import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Resolve the bundled `templates/` directory shipped inside this CLI package.\n *\n * The CLI's `dist/oniro-app.js` lives at `<pkg>/dist/oniro-app.js` after build\n * and the templates ship at `<pkg>/templates/`. During development the entrypoint\n * lives at `<pkg>/src/bin/oniro-app.ts` so we also try `../../templates` from there.\n */\nexport function getBundledTemplateRoot(): string {\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  const candidates = [\n    path.resolve(here, '../templates'), // dist/oniro-app.js → ../templates\n    path.resolve(here, '../../templates'), // src/bin/oniro-app.ts → ../../templates\n  ];\n  for (const c of candidates) {\n    if (fs.existsSync(c)) return c;\n  }\n  // Return the most likely path even if it doesn't exist yet; createScaffold will\n  // surface a clear error from there.\n  return candidates[0]!;\n}\n","import { Command } from 'commander';\nimport { listTemplates } from '@oniroproject/core';\nimport { getBundledTemplateRoot } from '../lib/templateRoot.js';\n\nexport function registerTemplatesCommand(program: Command): void {\n  const templates = program.command('templates').description('Inspect the templates bundled with this CLI.');\n\n  templates\n    .command('list')\n    .description('List available project templates.')\n    .option('--json', 'Emit machine-readable JSON.')\n    .action((opts: { json?: boolean }) => {\n      const root = getBundledTemplateRoot();\n      const list = listTemplates(root);\n      if (opts.json) {\n        process.stdout.write(`${JSON.stringify(list, null, 2)}\\n`);\n        return;\n      }\n      if (list.length === 0) {\n        process.stdout.write('No templates available.\\n');\n        return;\n      }\n      const rows = list.map((t) => `${t.id.padEnd(20)} ${t.label.padEnd(24)} ${t.description}`);\n      process.stdout.write(`${rows.join('\\n')}\\n`);\n    });\n}\n"],"mappings":"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","names":["Command","path","path","path","path","ALL_SDKS","fs","path","ALL_SDKS","Command"]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@oniroproject/oniro-app",
+  "version": "0.6.0",
+  "description": "Cross-platform CLI for Oniro/OpenHarmony application development.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-oniro4openharmony/oniro-app-builder.git",
+    "directory": "packages/cli"
+  },
+  "type": "module",
+  "bin": {
+    "oniro-app": "./dist/oniro-app.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "pretest": "npm run build",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@oniroproject/core": "0.6.0",
+    "commander": "^12.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/templates/EmptyAbility/AppScope/app.json5

@@ -0,0 +1,10 @@
+{
+  "app": {
+    "bundleName": "com.example.myapplication",
+    "vendor": "example",
+    "versionCode": 1000000,
+    "versionName": "1.0.0",
+    "icon": "$media:layered_image",
+    "label": "$string:app_name"
+  }
+}

package/templates/EmptyAbility/AppScope/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "app_name",
+      "value": "MyApplication"
+    }
+  ]
+}

package/templates/EmptyAbility/AppScope/resources/base/media/layered_image.json

@@ -0,0 +1,7 @@
+{
+  "layered-image":
+  {
+    "background" : "$media:background",
+    "foreground" : "$media:foreground"
+  }
+}

package/templates/EmptyAbility/build-profile.json5

@@ -0,0 +1,35 @@
+{
+  "app": {
+    "products": [
+      {
+        "name": "default",
+        "signingConfig": "default",
+        "compileSdkVersion": 20,
+        "compatibleSdkVersion": 20,
+        "runtimeOS": "OpenHarmony"
+      }
+    ],
+    "buildModeSet": [
+      {
+        "name": "debug"
+      },
+      {
+        "name": "release"
+      }
+    ]
+  },
+  "modules": [
+    {
+      "name": "entry",
+      "srcPath": "./entry",
+      "targets": [
+        {
+          "name": "default",
+          "applyToProducts": [
+            "default"
+          ]
+        }
+      ]
+    }
+  ]
+}

package/templates/EmptyAbility/entry/build-profile.json5

@@ -0,0 +1,33 @@
+{
+  "apiType": "stageMode",
+  "buildOption": {
+    "resOptions": {
+      "copyCodeResource": {
+        "enable": false
+      }
+    }
+  },
+  "buildOptionSet": [
+    {
+      "name": "release",
+      "arkOptions": {
+        "obfuscation": {
+          "ruleOptions": {
+            "enable": false,
+            "files": [
+              "./obfuscation-rules.txt"
+            ]
+          }
+        }
+      }
+    },
+  ],
+  "targets": [
+    {
+      "name": "default"
+    },
+    {
+      "name": "ohosTest",
+    }
+  ]
+}

package/templates/EmptyAbility/entry/hvigorfile.ts

@@ -0,0 +1,6 @@
+import { hapTasks } from '@ohos/hvigor-ohos-plugin';
+
+export default {
+  system: hapTasks, /* Built-in plugin of Hvigor. It cannot be modified. */
+  plugins: []       /* Custom plugin to extend the functionality of Hvigor. */
+}

package/templates/EmptyAbility/entry/obfuscation-rules.txt

@@ -0,0 +1,23 @@
+# Define project specific obfuscation rules here.
+# You can include the obfuscation configuration files in the current module's build-profile.json5.
+#
+# For more details, see
+#   https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/source-obfuscation-V5
+
+# Obfuscation options:
+# -disable-obfuscation: disable all obfuscations
+# -enable-property-obfuscation: obfuscate the property names
+# -enable-toplevel-obfuscation: obfuscate the names in the global scope
+# -compact: remove unnecessary blank spaces and all line feeds
+# -remove-log: remove all console.* statements
+# -print-namecache: print the name cache that contains the mapping from the old names to new names
+# -apply-namecache: reuse the given cache file
+
+# Keep options:
+# -keep-property-name: specifies property names that you want to keep
+# -keep-global-name: specifies names that you want to keep in the global scope
+
+-enable-property-obfuscation
+-enable-toplevel-obfuscation
+-enable-filename-obfuscation
+-enable-export-obfuscation

package/templates/EmptyAbility/entry/oh-package.json5

@@ -0,0 +1,10 @@
+{
+  "name": "entry",
+  "version": "1.0.0",
+  "description": "Please describe the basic information.",
+  "main": "",
+  "author": "",
+  "license": "",
+  "dependencies": {}
+}
+

package/templates/EmptyAbility/entry/src/main/ets/entryability/EntryAbility.ets

@@ -0,0 +1,48 @@
+import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { window } from '@kit.ArkUI';
+
+const DOMAIN = 0x0000;
+
+export default class EntryAbility extends UIAbility {
+  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+    try {
+      this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
+    } catch (err) {
+      hilog.error(DOMAIN, 'testTag', 'Failed to set colorMode. Cause: %{public}s', JSON.stringify(err));
+    }
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
+  }
+
+  onDestroy(): void {
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    // Main window is created, set main page for this ability
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
+
+    windowStage.loadContent('pages/Index', (err) => {
+      if (err.code) {
+        hilog.error(DOMAIN, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err));
+        return;
+      }
+      hilog.info(DOMAIN, 'testTag', 'Succeeded in loading the content.');
+    });
+  }
+
+  onWindowStageDestroy(): void {
+    // Main window is destroyed, release UI related resources
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
+  }
+
+  onForeground(): void {
+    // Ability has brought to foreground
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
+  }
+
+  onBackground(): void {
+    // Ability has back to background
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
+  }
+}

package/templates/EmptyAbility/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets

@@ -0,0 +1,16 @@
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { BackupExtensionAbility, BundleVersion } from '@kit.CoreFileKit';
+
+const DOMAIN = 0x0000;
+
+export default class EntryBackupAbility extends BackupExtensionAbility {
+  async onBackup() {
+    hilog.info(DOMAIN, 'testTag', 'onBackup ok');
+    await Promise.resolve();
+  }
+
+  async onRestore(bundleVersion: BundleVersion) {
+    hilog.info(DOMAIN, 'testTag', 'onRestore ok %{public}s', JSON.stringify(bundleVersion));
+    await Promise.resolve();
+  }
+}

package/templates/EmptyAbility/entry/src/main/ets/pages/Index.ets

@@ -0,0 +1,23 @@
+@Entry
+@Component
+struct Index {
+  @State message: string = 'Hello World';
+
+  build() {
+    RelativeContainer() {
+      Text(this.message)
+        .id('HelloWorld')
+        .fontSize($r('app.float.page_text_font_size'))
+        .fontWeight(FontWeight.Bold)
+        .alignRules({
+          center: { anchor: '__container__', align: VerticalAlign.Center },
+          middle: { anchor: '__container__', align: HorizontalAlign.Center }
+        })
+        .onClick(() => {
+          this.message = 'Welcome';
+        })
+    }
+    .height('100%')
+    .width('100%')
+  }
+}

package/templates/EmptyAbility/entry/src/main/module.json5

@@ -0,0 +1,50 @@
+{
+  "module": {
+    "name": "entry",
+    "type": "entry",
+    "description": "$string:module_desc",
+    "mainElement": "EntryAbility",
+    "deviceTypes": [
+      "default"
+    ],
+    "deliveryWithInstall": true,
+    "installationFree": false,
+    "pages": "$profile:main_pages",
+    "abilities": [
+      {
+        "name": "EntryAbility",
+        "srcEntry": "./ets/entryability/EntryAbility.ets",
+        "description": "$string:EntryAbility_desc",
+        "icon": "$media:layered_image",
+        "label": "$string:EntryAbility_label",
+        "startWindowIcon": "$media:startIcon",
+        "startWindowBackground": "$color:start_window_background",
+        "exported": true,
+        "skills": [
+          {
+            "entities": [
+              "entity.system.home"
+            ],
+            "actions": [
+              "ohos.want.action.home"
+            ]
+          }
+        ]
+      }
+    ],
+    "extensionAbilities": [
+      {
+        "name": "EntryBackupAbility",
+        "srcEntry": "./ets/entrybackupability/EntryBackupAbility.ets",
+        "type": "backup",
+        "exported": false,
+        "metadata": [
+          {
+            "name": "ohos.extension.backup",
+            "resource": "$profile:backup_config"
+          }
+        ],
+      }
+    ]
+  }
+}

package/templates/EmptyAbility/entry/src/main/resources/base/element/color.json

@@ -0,0 +1,8 @@
+{
+  "color": [
+    {
+      "name": "start_window_background",
+      "value": "#FFFFFF"
+    }
+  ]
+}

package/templates/EmptyAbility/entry/src/main/resources/base/element/float.json

@@ -0,0 +1,8 @@
+{
+  "float": [
+    {
+      "name": "page_text_font_size",
+      "value": "50fp"
+    }
+  ]
+}

package/templates/EmptyAbility/entry/src/main/resources/base/element/string.json

@@ -0,0 +1,16 @@
+{
+  "string": [
+    {
+      "name": "module_desc",
+      "value": "module description"
+    },
+    {
+      "name": "EntryAbility_desc",
+      "value": "description"
+    },
+    {
+      "name": "EntryAbility_label",
+      "value": "label"
+    }
+  ]
+}

package/templates/EmptyAbility/entry/src/main/resources/base/media/layered_image.json

@@ -0,0 +1,7 @@
+{
+  "layered-image":
+  {
+    "background" : "$media:background",
+    "foreground" : "$media:foreground"
+  }
+}

package/templates/EmptyAbility/entry/src/main/resources/base/profile/backup_config.json

@@ -0,0 +1,3 @@
+{
+  "allowToBackupRestore": true
+}

package/templates/EmptyAbility/entry/src/main/resources/base/profile/main_pages.json

@@ -0,0 +1,5 @@
+{
+  "src": [
+    "pages/Index"
+  ]
+}

package/templates/EmptyAbility/entry/src/main/resources/dark/element/color.json

@@ -0,0 +1,8 @@
+{
+  "color": [
+    {
+      "name": "start_window_background",
+      "value": "#000000"
+    }
+  ]
+}

package/templates/EmptyAbility/entry/src/mock/mock-config.json5

@@ -0,0 +1,2 @@
+{
+}

package/templates/EmptyAbility/entry/src/ohosTest/ets/test/Ability.test.ets

@@ -0,0 +1,35 @@
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium';
+
+export default function abilityTest() {
+  describe('ActsAbilityTest', () => {
+    // Defines a test suite. Two parameters are supported: test suite name and test suite function.
+    beforeAll(() => {
+      // Presets an action, which is performed only once before all test cases of the test suite start.
+      // This API supports only one parameter: preset action function.
+    })
+    beforeEach(() => {
+      // Presets an action, which is performed before each unit test case starts.
+      // The number of execution times is the same as the number of test cases defined by **it**.
+      // This API supports only one parameter: preset action function.
+    })
+    afterEach(() => {
+      // Presets a clear action, which is performed after each unit test case ends.
+      // The number of execution times is the same as the number of test cases defined by **it**.
+      // This API supports only one parameter: clear action function.
+    })
+    afterAll(() => {
+      // Presets a clear action, which is performed after all test cases of the test suite end.
+      // This API supports only one parameter: clear action function.
+    })
+    it('assertContain', 0, () => {
+      // Defines a test case. This API supports three parameters: test case name, filter parameter, and test case function.
+      hilog.info(0x0000, 'testTag', '%{public}s', 'it begin');
+      let a = 'abc';
+      let b = 'b';
+      // Defines a variety of assertion methods, which are used to declare expected boolean conditions.
+      expect(a).assertContain(b);
+      expect(a).assertEqual(a);
+    })
+  })
+}

package/templates/EmptyAbility/entry/src/ohosTest/ets/test/List.test.ets

@@ -0,0 +1,5 @@
+import abilityTest from './Ability.test';
+
+export default function testsuite() {
+  abilityTest();
+}

package/templates/EmptyAbility/entry/src/ohosTest/module.json5

@@ -0,0 +1,11 @@
+{
+  "module": {
+    "name": "entry_test",
+    "type": "feature",
+    "deviceTypes": [
+      "phone"
+    ],
+    "deliveryWithInstall": true,
+    "installationFree": false
+  }
+}

package/templates/EmptyAbility/entry/src/test/List.test.ets

@@ -0,0 +1,5 @@
+import localUnitTest from './LocalUnit.test';
+
+export default function testsuite() {
+  localUnitTest();
+}

package/templates/EmptyAbility/entry/src/test/LocalUnit.test.ets

@@ -0,0 +1,33 @@
+import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium';
+
+export default function localUnitTest() {
+  describe('localUnitTest', () => {
+    // Defines a test suite. Two parameters are supported: test suite name and test suite function.
+    beforeAll(() => {
+      // Presets an action, which is performed only once before all test cases of the test suite start.
+      // This API supports only one parameter: preset action function.
+    });
+    beforeEach(() => {
+      // Presets an action, which is performed before each unit test case starts.
+      // The number of execution times is the same as the number of test cases defined by **it**.
+      // This API supports only one parameter: preset action function.
+    });
+    afterEach(() => {
+      // Presets a clear action, which is performed after each unit test case ends.
+      // The number of execution times is the same as the number of test cases defined by **it**.
+      // This API supports only one parameter: clear action function.
+    });
+    afterAll(() => {
+      // Presets a clear action, which is performed after all test cases of the test suite end.
+      // This API supports only one parameter: clear action function.
+    });
+    it('assertContain', 0, () => {
+      // Defines a test case. This API supports three parameters: test case name, filter parameter, and test case function.
+      let a = 'abc';
+      let b = 'b';
+      // Defines a variety of assertion methods, which are used to declare expected boolean conditions.
+      expect(a).assertContain(b);
+      expect(a).assertEqual(a);
+    });
+  });
+}

package/templates/EmptyAbility/hvigor/hvigor-config.json5

@@ -0,0 +1,23 @@
+{
+  "modelVersion": "5.1.0",
+  "dependencies": {
+  },
+  "execution": {
+    // "analyze": "normal",                     /* Define the build analyze mode. Value: [ "normal" | "advanced" | "ultrafine" | false ]. Default: "normal" */
+    // "daemon": true,                          /* Enable daemon compilation. Value: [ true | false ]. Default: true */
+    // "incremental": true,                     /* Enable incremental compilation. Value: [ true | false ]. Default: true */
+    // "parallel": true,                        /* Enable parallel compilation. Value: [ true | false ]. Default: true */
+    // "typeCheck": false,                      /* Enable typeCheck. Value: [ true | false ]. Default: false */
+    // "optimizationStrategy": "memory"         /* Define the optimization strategy. Value: [ "memory" | "performance" ]. Default: "memory" */
+  },
+  "logging": {
+    // "level": "info"                          /* Define the log level. Value: [ "debug" | "info" | "warn" | "error" ]. Default: "info" */
+  },
+  "debugging": {
+    // "stacktrace": false                      /* Disable stacktrace compilation. Value: [ true | false ]. Default: false */
+  },
+  "nodeOptions": {
+    // "maxOldSpaceSize": 8192                  /* Enable nodeOptions maxOldSpaceSize compilation. Unit M. Used for the daemon process. Default: 8192*/
+    // "exposeGC": true                         /* Enable to trigger garbage collection explicitly. Default: true*/
+  }
+}

package/templates/EmptyAbility/hvigorfile.ts

@@ -0,0 +1,6 @@
+import { appTasks } from '@ohos/hvigor-ohos-plugin';
+
+export default {
+  system: appTasks, /* Built-in plugin of Hvigor. It cannot be modified. */
+  plugins: []       /* Custom plugin to extend the functionality of Hvigor. */
+}

package/templates/EmptyAbility/oh-package.json5

@@ -0,0 +1,10 @@
+{
+  "modelVersion": "5.1.0",
+  "description": "Please describe the basic information.",
+  "dependencies": {
+  },
+  "devDependencies": {
+    "@ohos/hypium": "1.0.24",
+    "@ohos/hamock": "1.0.0"
+  }
+}

package/templates/EmptyAbility/template.json

@@ -0,0 +1,6 @@
+{
+  "id": "EmptyAbility",
+  "label": "Empty Ability",
+  "description": "Minimal OpenHarmony (ArkTS/ArkUI) application with a single entry ability (HelloWorld-style starter).",
+  "defaultModuleName": "entry"
+}