@oniroproject/core 0.6.0

package/dist/index.d.cts

@@ -0,0 +1,593 @@
+import { ChildProcessWithoutNullStreams } from 'node:child_process';
+
+interface Logger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+declare const noopLogger: Logger;
+declare const consoleLogger: Logger;
+
+interface ProgressUpdate {
+    message?: string;
+    increment?: number;
+}
+interface ProgressReporter {
+    report(update: ProgressUpdate): void;
+}
+declare const noopProgress: ProgressReporter;
+
+/**
+ * Keys read from the ConfigProvider by core. Frontends (CLI, VS Code extension)
+ * implement the provider however they like (env vars, settings.json, etc.).
+ */
+type ConfigKey = 'sdkRootDir' | 'cmdToolsPath' | 'emulatorDir' | 'hapPath' | 'cmdToolsUrlLinux' | 'cmdToolsUrlWindows' | 'cmdToolsUrlMac' | 'emulatorUrl';
+interface ConfigProvider {
+    /**
+     * Get the configured value for `key`, or `fallback` if unset/empty.
+     * Implementations should expand the literal `${userHome}` to the user's home dir.
+     */
+    get<T extends string | number | boolean>(key: ConfigKey, fallback: T): T;
+}
+/**
+ * Default config values used when a ConfigProvider returns the fallback.
+ * These match the historical paths used by the bash CLI and the extension.
+ */
+declare const defaultPaths: {
+    readonly sdkRootDir: () => string;
+    readonly cmdToolsPath: () => string;
+    readonly emulatorDir: () => string;
+    readonly hapPath: "entry/build/default/outputs/default/entry-default-signed.hap";
+    readonly emulatorUrl: "https://github.com/eclipse-oniro4openharmony/device_board_oniro/releases/latest/download/oniro_emulator.zip";
+    readonly cmdToolsUrlLinux: "https://repo.huaweicloud.com/harmonyos/ohpm/5.1.0/commandline-tools-linux-x64-5.1.0.840.zip";
+};
+/**
+ * A simple in-memory ConfigProvider, useful for tests and as a base for CLI/extension impls.
+ */
+declare function staticConfig(values?: Partial<Record<ConfigKey, string>>): ConfigProvider;
+
+/**
+ * Interactive prompts. Frontends implement these — CLI uses @inquirer/prompts,
+ * the extension uses `vscode.window.show*`. Core never assumes a TTY.
+ */
+interface Prompter {
+    /** Ask the user to confirm an action. */
+    confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+    /** Ask the user for a single line of text. */
+    input(message: string, defaultValue?: string): Promise<string>;
+    /** Ask the user to pick a directory on disk; resolves to an absolute path or null if cancelled. */
+    selectDirectory(message: string, defaultPath?: string): Promise<string | null>;
+    /** Ask the user to pick a file on disk; resolves to an absolute path or null if cancelled. */
+    selectFile(message: string, filters?: {
+        extensions?: string[];
+    }): Promise<string | null>;
+}
+/**
+ * Throws on any prompt — used in non-interactive contexts where all answers must come from flags.
+ */
+declare const nonInteractivePrompter: Prompter;
+
+declare class OniroError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+declare class SdkNotInstalledError extends OniroError {
+    readonly api: string;
+    readonly expectedPath: string;
+    constructor(api: string, expectedPath: string);
+}
+declare class CmdToolsNotInstalledError extends OniroError {
+    readonly expectedPath: string;
+    constructor(expectedPath: string);
+}
+declare class UnsupportedPlatformError extends OniroError {
+    readonly platform: string;
+    constructor(platform: string);
+}
+declare class ChecksumMismatchError extends OniroError {
+    readonly expected: string;
+    readonly actual: string;
+    constructor(expected: string, actual: string);
+}
+declare class CancelledError extends OniroError {
+    constructor(message?: string);
+}
+
+/**
+ * Carries the cross-cutting dependencies most core functions need: a Logger and a ConfigProvider.
+ * Functions that report progress or prompt the user take those as additional parameters.
+ */
+interface OniroContext {
+    logger: Logger;
+    config: ConfigProvider;
+}
+declare function defaultContext(overrides?: Partial<OniroContext>): OniroContext;
+
+interface SdkRelease {
+    version: string;
+    api: string;
+}
+/**
+ * Known OpenHarmony SDK releases. Kept in sync with the bash CLI / extension.
+ * Update when a new SDK ships.
+ */
+declare const ALL_SDKS: readonly SdkRelease[];
+declare const OHOS_URL_BASE = "https://repo.huaweicloud.com/openharmony/os";
+
+type OsFolder = 'linux' | 'darwin' | 'windows';
+/**
+ * Map Node's `os.platform()` to the OS folder name used in the SDK install layout
+ * and the SDK release tarballs.
+ */
+declare function getOsFolder(): OsFolder;
+interface SdkArchiveInfo {
+    filename: string;
+    osFolder: OsFolder;
+    /** Number of leading path components to strip when extracting the tarball. */
+    strip: number;
+}
+/**
+ * Resolve the SDK archive filename, OS folder, and tar strip count for the current platform.
+ *
+ * The Huawei mirror packages Linux and Windows together in one tarball with `linux/` and
+ * `windows/` subfolders. For 5.0.0/5.0.1/6.0 the tarball has no extra top-level wrapper
+ * (strip=0); newer/older releases wrap the OS folders in a single top-level directory (strip=1).
+ * macOS tarballs have a deeper layout (strip=3).
+ */
+declare function getSdkFilename(version?: string): SdkArchiveInfo;
+
+declare function getSdkRootDir(config: ConfigProvider): string;
+/**
+ * Base SDK home for the current OS: `<sdkRootDir>/<linux|darwin|windows>`.
+ * SDK API folders (e.g. `12`, `18`, `20`) live inside this directory.
+ */
+declare function getOhosBaseSdkHome(config: ConfigProvider): string;
+declare function getCmdToolsPath(config: ConfigProvider): string;
+declare function getEmulatorDir(config: ConfigProvider): string;
+/**
+ * Resolve the OHPM binary path inside the command-line tools install.
+ * On Windows tries common executable suffixes (.exe, .cmd, .bat) before the POSIX name.
+ */
+declare function getCmdToolsBin(config: ConfigProvider): string;
+/**
+ * Resolve the hdc binary path inside the SDK toolchains tree.
+ */
+declare function getHdcPath(config: ConfigProvider): string;
+/**
+ * Resolve the hvigorw wrapper for a project, preferring the project-local copy
+ * (which carries the project's pinned hvigor version) and falling back to the
+ * one shipped with the command-line tools.
+ */
+declare function getHvigorwPath(config: ConfigProvider, projectDir: string): string;
+
+/**
+ * Detect the SDK API a project targets by reading `build-profile.json5`.
+ * Returns the `compileSdkVersion` of the first declared product, or undefined
+ * if the file is missing/malformed or no product declares one.
+ */
+declare function detectProjectSdkVersion(projectRoot: string, logger?: Logger): number | undefined;
+
+interface DownloadOptions {
+    url: string;
+    dest: string;
+    progress?: ProgressReporter;
+    abortSignal?: AbortSignal;
+    /** Overall progress start offset (0..100). Default 0. */
+    start?: number;
+    /** Overall progress range to consume (0..100). Default 100. */
+    range?: number;
+}
+/**
+ * Stream a remote file to disk with optional progress reporting and cancellation.
+ * Follows redirects via the `follow-redirects` library.
+ */
+declare function downloadFile(opts: DownloadOptions): Promise<void>;
+/**
+ * Verify the SHA-256 checksum of a file against an on-disk .sha256 file.
+ * The .sha256 file is expected to contain the hex digest as its first whitespace-delimited token.
+ */
+declare function verifySha256(filePath: string, sha256Path: string): Promise<void>;
+
+interface ExtractZipOptions {
+    zipPath: string;
+    dest: string;
+    progress?: ProgressReporter;
+    /** Overall progress start offset (0..100). Default 0. */
+    start?: number;
+    /** Overall progress range to consume (0..100). Default 100. */
+    range?: number;
+    logger?: Logger;
+}
+/**
+ * Extract a ZIP to a destination directory, preserving file permissions and following
+ * symlinks defensively. Protects against Zip Slip (entries whose paths escape `dest`).
+ */
+declare function extractZipWithProgress(opts: ExtractZipOptions): Promise<void>;
+/**
+ * Extract a tar/tar.gz/tar.bz2 archive. Wraps `tar.x`.
+ */
+declare function extractTarball(tarPath: string, dest: string, strip?: number): Promise<void>;
+
+interface SdkInfo {
+    version: string;
+    api: string;
+    installed: boolean;
+}
+/**
+ * List supported SDKs annotated with whether they are installed for the current OS.
+ * Sorted by API descending (newest first).
+ */
+declare function getSupportedSdksForUi(config: ConfigProvider): SdkInfo[];
+/**
+ * Return the SDK versions that have at least one OS-folder install in `sdkRootDir`.
+ * Scans `linux`, `darwin`, `windows` so the list is consistent across machines that
+ * share an SDK root over a network mount.
+ */
+declare function getInstalledSdks(config: ConfigProvider): string[];
+
+/**
+ * Remove an installed SDK for a given API level, across all OS folders.
+ * Returns true if at least one folder was deleted.
+ */
+declare function removeSdk(config: ConfigProvider, api: string): boolean;
+
+interface InstallSdkOptions {
+    config: ConfigProvider;
+    version: string;
+    api: string;
+    progress?: ProgressReporter;
+    abortSignal?: AbortSignal;
+    logger?: Logger;
+}
+/**
+ * Download and install an OpenHarmony SDK release into `<sdkRootDir>/<osFolder>/<api>`.
+ *
+ * Progress budget (overall 0..100):
+ *   0..35  SDK archive download
+ *   35..45 Checksum download
+ *   45..50 Checksum verify
+ *   50..60 Tarball extract
+ *   60..95 Component ZIP extracts
+ *   95..100 Finalize + cleanup
+ */
+declare function downloadAndInstallSdk(opts: InstallSdkOptions): Promise<void>;
+
+/**
+ * Resolve the per-platform download URL for the OpenHarmony command-line tools.
+ *
+ * Only Linux has a public download URL on the Huawei mirror. Windows and macOS
+ * builds are gated behind the Huawei developer portal: users must download the
+ * ZIP manually and pass it via `--from-zip`, or self-host the archive and point
+ * `cmdToolsUrlWindows` / `cmdToolsUrlMac` at it.
+ *
+ * @param platform Defaults to the current host. Override for testing.
+ */
+declare function getCmdToolsDownloadUrl(config: ConfigProvider, platform?: NodeJS.Platform): string;
+/**
+ * Locate the extracted command-line tools' source root within a temp extraction folder.
+ * Tries known top-level names, then any subdirectory containing a `bin/` folder.
+ */
+declare function findCmdToolsSourceDir(extractPath: string): string;
+interface InstallCmdToolsOptions {
+    config: ConfigProvider;
+    progress?: ProgressReporter;
+    abortSignal?: AbortSignal;
+    logger?: Logger;
+    /** Skip download and install from a local zip the caller already has. */
+    localZipPath?: string;
+}
+/**
+ * Install the OpenHarmony command-line tools into `<cmdToolsPath>`.
+ * Either downloads from the platform-specific URL or installs from a caller-supplied ZIP.
+ */
+declare function installCmdTools(opts: InstallCmdToolsOptions): Promise<void>;
+interface CmdToolsStatus {
+    installed: boolean;
+    status: string;
+}
+/**
+ * Reports whether ohpm is present at the configured path, and if so its version.
+ * Prefers reading `version.txt` (`# Version: x.y.z`) before falling back to executing
+ * the binary with `-v`.
+ */
+declare function getCmdToolsStatus(config: ConfigProvider): CmdToolsStatus;
+declare function isCmdToolsInstalled(config: ConfigProvider): boolean;
+declare function removeCmdTools(config: ConfigProvider): void;
+
+/**
+ * Generates the signing-material directory tree: fd/{0,1,2}, ac, ce.
+ * Each subfolder contains a randomly-named keyfile derived as described in
+ * the OpenHarmony hap-sign-tool reference implementation.
+ */
+declare function createMaterial(materialPath: string): void;
+/**
+ * Re-derives the work key from an existing material directory.
+ */
+declare function getKey(materialPath: string): Buffer;
+/**
+ * Encrypts a password using the work key derived from `materialPath`.
+ * Returns the encrypted blob as a hex string (the format expected in build-profile.json5).
+ */
+declare function encryptPwd(password: string, materialPath: string): string;
+/**
+ * Inverse of `encryptPwd`. Exposed for parity with the original CLI.
+ */
+declare function decryptPwd(encryptedHex: string, materialPath: string): string;
+
+/** Ability Privilege Level written into the profile's `bundle-info.apl`. */
+type Apl = 'normal' | 'system_basic' | 'system_core';
+/** App feature written into the profile's `bundle-info.app-feature`. */
+type AppFeature = 'hos_normal_app' | 'hos_system_app';
+declare const APL_VALUES: readonly Apl[];
+declare const APP_FEATURE_VALUES: readonly AppFeature[];
+interface GenerateSigningConfigsOptions {
+    /** Absolute path to the OpenHarmony project (the folder containing build-profile.json5). */
+    projectDir: string;
+    /** Absolute path to the OS-specific SDK home (the folder containing API-version subfolders). */
+    sdkHome: string;
+    /**
+     * APL level to write into the profile's `bundle-info.apl`. Defaults to `'normal'`.
+     * Apps requesting permissions above `normal` (e.g. `ohos.permission.GET_WIFI_INFO_INTERNAL`)
+     * need `system_basic` or `system_core` — otherwise `bm install` fails with
+     * `grant request permissions failed`.
+     */
+    apl?: Apl;
+    /**
+     * App feature to write into `bundle-info.app-feature`. Defaults to `'hos_normal_app'`
+     * when `apl='normal'`, otherwise `'hos_system_app'`.
+     */
+    appFeature?: AppFeature;
+    /** Optional logger; defaults to no-op. */
+    logger?: Logger;
+}
+/**
+ * Generate signing configs for an OpenHarmony project: copies certs, signs the profile,
+ * generates the signing material, and writes the resulting `signingConfigs` entry into
+ * `build-profile.json5`.
+ *
+ * Requires `java` on PATH (the OpenHarmony hap-sign-tool ships as a .jar).
+ */
+declare function generateSigningConfigs(options: GenerateSigningConfigsOptions): void;
+
+interface InstallEmulatorOptions {
+    config: ConfigProvider;
+    progress?: ProgressReporter;
+    abortSignal?: AbortSignal;
+    logger?: Logger;
+}
+/**
+ * Download and extract the Oniro emulator into the configured `emulatorDir`.
+ */
+declare function installEmulator(opts: InstallEmulatorOptions): Promise<void>;
+/**
+ * Heuristic: emulator is considered installed if `images/run.sh` is present.
+ * On Windows-only emulator builds (when they exist) this may not apply.
+ */
+declare function isEmulatorInstalled(config: ConfigProvider): boolean;
+declare function removeEmulator(config: ConfigProvider): void;
+
+/**
+ * Try to connect hdc to the emulator. Resolves true on success, false otherwise.
+ */
+declare function attemptHdcConnection(config: ConfigProvider, address?: string, logger?: Logger): Promise<boolean>;
+interface StartEmulatorOptions {
+    config: ConfigProvider;
+    logger?: Logger;
+    /** Pass --headless to the bundled launcher (VNC + telnet serial, no local window). */
+    headless?: boolean;
+    /**
+     * Override the launcher's host:port for hdc port forwarding. Defaults to the
+     * launcher's own default (typically `127.0.0.1:55555`). Use `0.0.0.0:55555`
+     * on hosts where QEMU refuses to bind the hostfwd to 127.0.0.1 (e.g. some
+     * CI runners with restricted loopback bindings).
+     */
+    connect?: string;
+    /**
+     * Redirect launcher stdout/stderr to this file. Default: discard
+     * (/dev/null on POSIX, NUL on Windows). Use a real path in CI so you can
+     * surface qemu output on failure.
+     */
+    logFile?: string;
+    /**
+     * If > 0, block until hdc connects to the running emulator, up to this many
+     * seconds. 0 (default) returns as soon as the launcher process is spawned.
+     */
+    waitForHdcSeconds?: number;
+    /** Poll interval for the hdc wait, ms. Default 5000. */
+    hdcPollIntervalMs?: number;
+    abortSignal?: AbortSignal;
+}
+/**
+ * Launch the Oniro emulator in the background via the bundled run.sh/run.bat.
+ *
+ * The launcher process is detached + unref'd so callers can exit while the
+ * emulator keeps running. A PID file is written to the OS temp dir so
+ * `stopEmulator` and rerun-detection logic can find the process later.
+ */
+declare function startEmulator(opts: StartEmulatorOptions): Promise<void>;
+declare function stopEmulator(logger?: Logger): Promise<void>;
+
+/**
+ * Read the project's bundle name from `AppScope/app.json5`.
+ */
+declare function getBundleName(projectDir: string): string;
+/**
+ * Read the main ability from `<module>/src/main/module.json5`. Defaults to `entry`
+ * for the module folder name if not provided — projects with custom module names
+ * should pass it explicitly.
+ */
+declare function getMainAbility(projectDir: string, moduleName?: string): string;
+
+interface InstallAppOptions {
+    config: ConfigProvider;
+    projectDir: string;
+    /**
+     * Explicit path (absolute, or relative to projectDir) to the signed `.hap`.
+     * Falls back to the `hapPath` config key, then to the well-known default.
+     */
+    hapPath?: string;
+    logger?: Logger;
+}
+declare function installApp(opts: InstallAppOptions): Promise<void>;
+interface LaunchAppOptions {
+    config: ConfigProvider;
+    projectDir: string;
+    /** Override the module name if it isn't the default `entry`. */
+    moduleName?: string;
+    logger?: Logger;
+}
+declare function launchApp(opts: LaunchAppOptions): Promise<void>;
+interface RunningProcess {
+    pid: string;
+    name: string;
+}
+/**
+ * List running processes via `hdc track-jpid`. Times out after `timeoutMs`.
+ * When `targetProcessName` is set, resolves to that process's PID early; otherwise
+ * resolves to the full list collected within the timeout window.
+ */
+declare function listRunningProcesses(config: ConfigProvider, options?: {
+    targetProcessName?: string;
+    timeoutMs?: number;
+    logger?: Logger;
+}): Promise<RunningProcess[] | string>;
+declare function findAppProcessId(config: ConfigProvider, projectDir: string, logger?: Logger): Promise<string>;
+
+type HilogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'FATAL';
+/** A parsed line of `hdc shell hilog` output. */
+interface HilogEntry {
+    /** "MM-DD HH:MM:SS.mmm". The device timestamp; no year. */
+    time: string;
+    pid: string;
+    tid: string;
+    /** Short level letter as printed by hilog: D, I, W, E (F is rare). */
+    level: 'D' | 'I' | 'W' | 'E' | 'F';
+    tag: string;
+    message: string;
+}
+interface SetHilogLevelOptions {
+    config: ConfigProvider;
+    level: HilogLevel;
+    logger?: Logger;
+}
+/**
+ * Set the hilog buffer level on the connected device. Resolves when the
+ * underlying `hdc shell hilog -b <LEVEL>` exits successfully; rejects with
+ * the stderr text if the command fails.
+ */
+declare function setHilogLevel(opts: SetHilogLevelOptions): Promise<void>;
+interface StreamHilogOptions {
+    config: ConfigProvider;
+    /** Restrict the stream to a single process id (passed as `-P <pid>`). */
+    processId?: string;
+}
+/**
+ * Spawn `hdc shell hilog [-P <pid>]` and return the child process. The caller
+ * owns the stdout/stderr streams (typically wired through `parseHilogLine`) and
+ * is responsible for killing the process when streaming should stop.
+ */
+declare function streamHilog(opts: StreamHilogOptions): ChildProcessWithoutNullStreams;
+/**
+ * Parse a single line of `hdc shell hilog` output into structured fields.
+ * Returns null when the line doesn't match the expected hilog format (e.g.
+ * banners, blank lines, or partial chunks).
+ */
+declare function parseHilogLine(line: string): HilogEntry | null;
+
+interface RunHvigorwOptions {
+    config: ConfigProvider;
+    projectDir: string;
+    /** Forwarded as `-p product=<product>`. Default `default`. */
+    product?: string;
+    /** Forwarded as `-p module=<module>` when set. */
+    module?: string;
+    /** Forwarded as `-p buildMode=<mode>` when set. */
+    buildMode?: string;
+    /** hvigor task to run. Default `assembleHap`. */
+    task?: string;
+    /** Extra raw args appended after the standard ones. */
+    extraArgs?: readonly string[];
+    logger?: Logger;
+    /**
+     * Optional callback for each stdout/stderr chunk, lets callers stream output
+     * to a terminal or webview without buffering. Lines also flow through `logger`.
+     */
+    onOutput?: (chunk: string, stream: 'stdout' | 'stderr') => void;
+}
+interface RunHvigorwResult {
+    exitCode: number;
+}
+/**
+ * Run the project's `hvigorw` wrapper. Replaces the extension's vscode-tasks indirection
+ * and the bash CLI's chained `clean` + `assembleHap` calls with a single direct spawn.
+ */
+declare function runHvigorw(opts: RunHvigorwOptions): Promise<RunHvigorwResult>;
+
+/**
+ * Conservative project-folder-name validator (no path separators, conservative charset).
+ */
+declare function isValidProjectName(name: string): boolean;
+/**
+ * Bundle-name validator. Allows reverse-DNS style identifiers like `com.example.myapp`.
+ */
+declare function isValidBundleName(bundleName: string): boolean;
+
+interface TemplateOption {
+    id: string;
+    label: string;
+    description: string;
+    defaultModuleName: string;
+}
+/**
+ * Enumerate templates inside `templateRoot`. Each direct subfolder is a template;
+ * per-template metadata (label/description/defaultModuleName) may live in a
+ * `template.json` file alongside the template content.
+ *
+ * Callers own the template root — the CLI ships its own under
+ * `<cli-package>/templates/`, the VS Code extension uses `extensionPath/template`.
+ */
+declare function listTemplates(templateRoot: string): TemplateOption[];
+/**
+ * Verify that a template directory contains the files required by the scaffold pipeline.
+ * Returns the list of missing relative paths, or [] if the template is complete.
+ */
+declare function validateTemplateLayout(templateDir: string, defaultModuleName: string): string[];
+
+interface CreateScaffoldOptions {
+    config: ConfigProvider;
+    templateId: string;
+    projectName: string;
+    bundleName: string;
+    /** Parent directory that will contain the new project folder. */
+    location: string;
+    sdkApi: number;
+    /** Module folder name. Defaults to the template's `defaultModuleName`. */
+    moduleName?: string;
+    /** Absolute path to the directory containing template subfolders. */
+    templateRoot: string;
+    /** If the destination exists, remove it before scaffolding instead of throwing. */
+    overwrite?: boolean;
+    logger?: Logger;
+}
+interface CreateScaffoldResult {
+    projectDir: string;
+}
+/**
+ * Scaffold a new Oniro/OpenHarmony project from a template. Returns the absolute path
+ * to the created project directory.
+ */
+declare function createScaffold(opts: CreateScaffoldOptions): Promise<CreateScaffoldResult>;
+
+declare function readJson5File<T>(filePath: string): T;
+/**
+ * Write strict JSON content (quoted keys) to a `.json5` file. Keeps the file
+ * compatible with VS Code's JSON parser while remaining valid JSON5.
+ */
+declare function writeJson5File(filePath: string, value: unknown): void;
+declare function readJsonFile<T>(filePath: string): T;
+declare function writeJsonFile(filePath: string, value: unknown): void;
+
+declare const VERSION: string;
+
+export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type Apl, type AppFeature, CancelledError, ChecksumMismatchError, CmdToolsNotInstalledError, type CmdToolsStatus, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DownloadOptions, type ExtractZipOptions, type GenerateSigningConfigsOptions, type HilogEntry, type HilogLevel, type InstallAppOptions, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallSdkOptions, type LaunchAppOptions, type Logger, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type ProgressReporter, type ProgressUpdate, type Prompter, type RunHvigorwOptions, type RunHvigorwResult, type RunningProcess, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SetHilogLevelOptions, type StartEmulatorOptions, type StreamHilogOptions, type TemplateOption, UnsupportedPlatformError, VERSION, attemptHdcConnection, consoleLogger, createMaterial, createScaffold, decryptPwd, defaultContext, defaultPaths, detectProjectSdkVersion, downloadAndInstallSdk, downloadFile, encryptPwd, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getEmulatorDir, getHdcPath, getHvigorwPath, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, installApp, installCmdTools, installEmulator, isCmdToolsInstalled, isEmulatorInstalled, isValidBundleName, isValidProjectName, launchApp, listRunningProcesses, listTemplates, nonInteractivePrompter, noopLogger, noopProgress, parseHilogLine, readJson5File, readJsonFile, removeCmdTools, removeEmulator, removeSdk, runHvigorw, setHilogLevel, startEmulator, staticConfig, stopEmulator, streamHilog, validateTemplateLayout, verifySha256, writeJson5File, writeJsonFile };