@oniroproject/core 0.10.0 → 0.11.0

package/dist/index.d.cts

@@ -28,7 +28,7 @@ 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' | 'hdcPath' | 'emulatorDir' | 'hapPath' | 'cmdToolsUrlLinux' | 'cmdToolsUrlWindows' | 'cmdToolsUrlMac' | 'emulatorUrl' | 'tmpDir' | 'sdkUrlBase' | 'applicationCertPath';
+type ConfigKey = 'sdkRootDir' | 'cmdToolsPath' | 'hdcPath' | 'emulatorDir' | 'hapPath' | 'cmdToolsUrlLinux' | 'cmdToolsUrlWindows' | 'cmdToolsUrlMac' | 'emulatorUrl' | 'tmpDir' | 'sdkUrlBase' | 'applicationCertPath' | 'harmonyosSdkPath' | 'harmonyosAuthDir' | 'harmonyosSigningDir';
 interface ConfigProvider {
     /**
      * Get the configured value for `key`, or `fallback` if unset/empty.
@@ -44,6 +44,8 @@ declare const defaultPaths: {
     readonly sdkRootDir: () => string;
     readonly cmdToolsPath: () => string;
     readonly emulatorDir: () => string;
+    readonly harmonyosAuthDir: () => string;
+    readonly harmonyosSigningDir: () => 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";
@@ -1438,6 +1440,11 @@ interface RunOhpmOptions {
     config: ConfigProvider;
     projectDir: string;
     args: readonly string[];
+    /**
+     * Explicit ohpm binary. HarmonyOS projects pass the one from their own install;
+     * when omitted the OpenHarmony command-line tools' ohpm is used.
+     */
+    ohpmPath?: string;
     timeoutMs?: number;
     abortSignal?: AbortSignal;
     onOutput?: OutputSink;
@@ -1453,6 +1460,8 @@ declare function runOhpm(opts: RunOhpmOptions): Promise<HdcExecResult>;
 declare function ensureOhModules(opts: {
     config: ConfigProvider;
     projectDir: string;
+    /** See {@link RunOhpmOptions.ohpmPath}. */
+    ohpmPath?: string;
     abortSignal?: AbortSignal;
     onOutput?: OutputSink;
     logger?: Logger;
@@ -1758,6 +1767,300 @@ interface ApplyChangesResult {
  */
 declare function applyChanges(opts: ApplyChangesOptions): Promise<ApplyChangesResult>;
 
+/**
+ * Which runtime a project targets. OpenHarmony projects build against the public
+ * OpenHarmony SDK; HarmonyOS projects build against Huawei's HarmonyOS SDK and
+ * need an AGC-issued certificate to sign (see `harmonyos/signing`).
+ */
+type RuntimeOs = 'OpenHarmony' | 'HarmonyOS';
+/**
+ * Detect the runtime a project targets from `build-profile.json5`.
+ *
+ * HarmonyOS only when the product declares `runtimeOS: "HarmonyOS"`, which DevEco
+ * Studio writes for every HarmonyOS project. Anything else — no such field, or a
+ * missing or unreadable profile — is OpenHarmony, so existing projects behave
+ * exactly as they did before HarmonyOS support. Reads the named product, else the
+ * first one.
+ */
+declare function detectRuntimeOs(projectDir: string, productName?: string): RuntimeOs;
+/**
+ * HarmonyOS SDK releases, mapping API level to the release version DevEco writes
+ * into `compileSdkVersion`, for when the installed SDK does not name the requested
+ * level itself. Only releases read from a real `sdk/default/sdk-pkg.json` are listed.
+ */
+declare const HARMONYOS_SDK_VERSIONS: ReadonlyMap<number, string>;
+/**
+ * The `"<version>(<api>)"` label a HarmonyOS product declares for an API level, or
+ * undefined when no HarmonyOS release is known for it.
+ */
+declare function harmonyOsSdkLabelForApi(api: number): string | undefined;
+
+/**
+ * A HarmonyOS SDK install. Unlike the OpenHarmony SDK, which `oniro-app sdk install`
+ * downloads, the HarmonyOS SDK only ships inside DevEco Studio or the login-gated
+ * HarmonyOS command-line tools, so oniro-app locates an existing install.
+ */
+interface HarmonyOsSdk {
+    /** The directory containing `default/`; hvigor receives it as `DEVECO_SDK_HOME`. */
+    sdkPath: string;
+    /** The DevEco Studio or command-line-tools install holding the SDK, its tools and JBR. */
+    installRoot: string;
+    /** From `default/sdk-pkg.json`, e.g. `HarmonyOS 6.1.1`. */
+    displayName?: string;
+    /**
+     * The release as `compileSdkVersion` names it, e.g. `6.1.1(24)`, from
+     * `default/sdk-pkg.json`. hvigor builds only projects that name this release.
+     */
+    version?: string;
+}
+/**
+ * Locate a HarmonyOS SDK, or return null when none is installed.
+ *
+ * Order: `harmonyosSdkPath` (`ONIRO_HARMONYOS_SDK_PATH`, an install root or its
+ * `sdk` directory), then DevEco Studio in its default location, then the
+ * command-line tools at `cmdToolsPath` when they are the HarmonyOS edition.
+ */
+declare function findHarmonyOsSdk(opts: {
+    config: ConfigProvider;
+    logger?: Logger;
+}): HarmonyOsSdk | null;
+/** Like `findHarmonyOsSdk`, but throws an actionable error when none is installed. */
+declare function requireHarmonyOsSdk(opts: {
+    config: ConfigProvider;
+    logger?: Logger;
+}): HarmonyOsSdk;
+
+type HuaweiSiteCode = 'CN' | 'EU' | 'SG' | 'RU';
+interface HuaweiSite {
+    code: HuaweiSiteCode;
+    /** `siteId` as reported by the login callback. */
+    siteId: string;
+    /** The token exchange's `site` parameter. The European site's is `DE`, not `EU`. */
+    siteParam: string;
+    /** Sign-in page and `authrouter` token endpoints. */
+    loginUrl: string;
+    /** AppGallery Connect certificate, device and profile calls. */
+    agcBaseUrl: string;
+    language: string;
+}
+/**
+ * Regional endpoints.
+ *
+ * Upstream hardcodes the Chinese-mainland hosts and refuses any other `siteId`.
+ * DevEco Studio resolves every host through Huawei's Global Routing Service (GRS),
+ * service `com.huawei.devecostudio.region`, by the user's country; these are its
+ * answers for keys `spaceintroduce` (sign-in, token exchange) and `agcsign`
+ * (signing). If a region stops working, diff against
+ *
+ *   POST https://grs.dbankcloud.com/grs/2.0/router?issue_country=<ISO>&app_name=devecostudio
+ *
+ * The `siteId` → `site` mapping is DevEco Studio's own (1 CN, 5 SG, 7 DE, 8 RU).
+ */
+declare const HUAWEI_SITES: Readonly<Record<HuaweiSiteCode, HuaweiSite>>;
+
+/** A signed-in Huawei developer account. */
+interface HuaweiUserInfo {
+    userId: string;
+    userName: string;
+    /** AGC OAuth2 token. Short-lived — minted from the stored JWT on demand. */
+    accessToken: string;
+    countryCode: string;
+    /** Region the account is registered on — decides which hosts to talk to. */
+    siteCode: HuaweiSiteCode;
+    /**
+     * Whether the account completed real-name verification. Accounts that did not
+     * can still sign once they accept the developer agreement.
+     */
+    isRealName: boolean;
+}
+/** Acceptance state of the HUAWEI Developer Basic Service Agreement. */
+interface DeveloperAgreementStatus {
+    /** Some version has been accepted. */
+    signed: boolean;
+    /** The current version has been accepted. */
+    latest: boolean;
+}
+/** An AGC team the signed-in user belongs to. Certificates are issued per team. */
+interface HuaweiTeam {
+    id: string;
+    name: string;
+}
+/** What an AGC call needs: who, which team, a fresh access token, and the regional host. */
+interface AgcAuthInfo {
+    uid: string;
+    teamId: string;
+    accessToken: string;
+    /** Regional AGC signing host, e.g. `https://connect-api-dre.cloud.huawei.com`. */
+    baseUrl: string;
+}
+
+/**
+ * A signed-in account: the durable credential plus its region, since every later
+ * request goes to that region's hosts and only the login callback reports it.
+ */
+interface StoredSession {
+    jwtToken: string;
+    /** `siteId` from the login callback. */
+    siteId: string;
+}
+interface TokenStore {
+    save(session: StoredSession): void;
+    load(): StoredSession | null;
+    clear(): void;
+    /** Where the encrypted token lives — surfaced by `auth status`. */
+    readonly tokenPath: string;
+}
+interface CreateTokenStoreOptions {
+    config: ConfigProvider;
+    logger?: Logger;
+}
+/**
+ * Persist the Huawei account JWT under the configured auth directory
+ * (`ONIRO_HARMONYOS_AUTH_DIR`, default `~/.oniro/harmonyos`).
+ *
+ * The token is encrypted with a random key kept in a *different* directory, so a
+ * stray copy of one of them — a config-dir backup, a synced dotfile repo — does not
+ * yield the token. Both live on the same disk, so this is no defence against a local
+ * attacker who can read the user's whole home. Treat the token as a credential.
+ */
+declare function createTokenStore(opts: CreateTokenStoreOptions): TokenStore;
+
+interface HttpResponse {
+    /** Body as text. Several endpoints send JSON under a non-JSON content type. */
+    data: string;
+    statusCode: number;
+    /** Reason phrase. Some AGC errors are reported only here. Empty over HTTP/2. */
+    statusText: string;
+}
+interface HttpRequestOptions {
+    headers?: Record<string, string>;
+    query?: Record<string, unknown>;
+    /** Sent as JSON. */
+    body?: unknown;
+    timeoutMs?: number;
+}
+/**
+ * `get`, `post` and `delete` resolve for any HTTP status: AGC reports failures
+ * through the status, the reason phrase and the body, so callers read all three.
+ * `getBinary` is for downloads and rejects on a non-2xx status.
+ */
+interface HarmonyOsHttpClient {
+    get(url: string, opts?: HttpRequestOptions): Promise<HttpResponse>;
+    post(url: string, opts?: HttpRequestOptions): Promise<HttpResponse>;
+    delete(url: string, opts?: HttpRequestOptions): Promise<HttpResponse>;
+    getBinary(url: string, opts?: HttpRequestOptions): Promise<Buffer>;
+}
+
+interface HarmonyOsSessionOptions {
+    config: ConfigProvider;
+    logger?: Logger;
+    http?: HarmonyOsHttpClient;
+    tokenStore?: TokenStore;
+    /** Called with the sign-in URL before the browser opens, so a CLI can print it. */
+    onLoginUrl?: (url: string) => void;
+}
+interface HarmonyOsSession {
+    login(opts?: {
+        timeoutMs?: number;
+    }): Promise<HuaweiUserInfo>;
+    /** Resolves false when there was no session to end. */
+    logout(): Promise<boolean>;
+    /** The signed-in account, or null. `refresh` mints a fresh AGC access token. */
+    getUserInfo(opts?: {
+        refresh?: boolean;
+    }): Promise<HuaweiUserInfo | null>;
+    listTeams(): Promise<HuaweiTeam[]>;
+    /** Credentials for AGC calls. Throws when signed out, or when the account may not sign. */
+    resolveAgcAuth(opts?: {
+        teamId?: string;
+    }): Promise<AgcAuthInfo>;
+    /** Whether the account accepted the developer agreement; null when undeterminable. */
+    getDeveloperAgreement(user: HuaweiUserInfo): Promise<DeveloperAgreementStatus | null>;
+    readonly tokenPath: string;
+}
+declare function createHarmonyOsSession(opts: HarmonyOsSessionOptions): HarmonyOsSession;
+
+/** Raised when AppGallery Connect rejects a request, or its output does not check out. */
+declare class AgcError extends OniroError {
+    readonly statusCode?: number | undefined;
+    readonly retCode?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, retCode?: string | undefined);
+}
+/** User-facing messages for the signing failure modes; each says what to do next. */
+declare const SIGNING_ERRORS: {
+    readonly FORBIDDEN: "This account has no AppGallery Connect permission for the selected team. Ask the team administrator for access, or pass --team-id for a team you do have access to (`oniro-app auth team list`).";
+    readonly UNAUTHORIZED: "AppGallery Connect rejected the access token. Run `oniro-app auth login` again.";
+    readonly NETWORK: "Could not reach AppGallery Connect. Check the network connection and any proxy configuration (HTTPS_PROXY / HTTP_PROXY).";
+    readonly USER_NOT_HARMONY: "This Huawei account is not enrolled for HarmonyOS development. Request HarmonyOS access for it in AppGallery Connect.";
+    readonly CERT_REQUEST: "AppGallery Connect did not issue the debug certificate.";
+    readonly CERT_LIMIT: "This team has reached its debug-certificate limit. Delete an unused certificate in AppGallery Connect and retry.";
+    readonly DEVICE_ADD: "AppGallery Connect did not register the device.";
+    readonly DEVICE_LIMIT: "This team has reached its device limit. Remove an unused device in AppGallery Connect and retry.";
+    readonly DEVICE_NAME_REPEAT: "A device with that name is already registered. Retry.";
+    readonly DEVICE_NONE: "No device is connected and none is registered to this team, but a debug profile must name at least one. Connect a device and retry.";
+    readonly PROFILE_ADD: "AppGallery Connect did not issue the provisioning profile.";
+    readonly PROFILE_NAME_REPEAT: "A provisioning profile with that name already exists in AppGallery Connect. Retry.";
+    readonly PROVISION_LIMIT: "This team has reached its debug-profile limit. Delete unused profiles in AppGallery Connect and retry.";
+    readonly CERT_INVALID: "AppGallery Connect returned an unreadable certificate. Retry with --force.";
+    readonly CERT_EXPIRED: "The signing certificate is outside its validity window. Check the system clock, then retry with --force.";
+    readonly CERT_PROFILE_MISMATCH: "The provisioning profile was not issued for the downloaded certificate. Retry with --force.";
+    readonly KEYSTORE_CERT_MISMATCH: "The local keystore does not hold the key the downloaded certificate was issued for. Retry with --force.";
+    readonly BUNDLE_NAME_INVALID: "Invalid bundle name. It must be 7–128 characters, start with a letter, and have at least three dot-separated segments (for example com.example.app).";
+};
+
+/** The four files of a HarmonyOS signing setup. */
+interface SigningMaterialPaths {
+    p12Path: string;
+    csrPath: string;
+    cerPath: string;
+    profilePath: string;
+}
+
+/** The fields of a provisioning profile that decide whether it can be reused. */
+interface ProvisionProfileInfo {
+    bundleName?: string;
+    /** The AGC team the profile was issued to. */
+    developerId?: string;
+    notAfter?: Date;
+    /** Uppercased UDIDs the debug profile is valid for. */
+    deviceIds: string[];
+    aclPermissions: string[];
+    /** PEM of the certificate the profile was issued for. */
+    developmentCertificate?: string;
+}
+/** Read a `.p7b` profile; null when it is missing or unreadable, which means "regenerate". */
+declare function readProvisionProfile(profilePath: string): ProvisionProfileInfo | null;
+
+interface HarmonyOsAutoSignOptions {
+    config: ConfigProvider;
+    session: HarmonyOsSession;
+    projectDir: string;
+    /** Default `default`. */
+    productName?: string;
+    /** AGC team. Defaults to the signed-in account's own id. */
+    teamId?: string;
+    /** Regenerate even when the existing material is still valid. */
+    force?: boolean;
+    http?: HarmonyOsHttpClient;
+    logger?: Logger;
+}
+interface HarmonyOsSigningResult {
+    bundleName: string;
+    teamId: string;
+    paths: SigningMaterialPaths;
+    /** False when still-valid material was reused without asking AGC for anything. */
+    regenerated: boolean;
+    /** UDIDs the profile is valid for. */
+    deviceIds: string[];
+}
+/**
+ * Sign a HarmonyOS project with the signed-in Huawei developer account, the way
+ * DevEco Studio's automatic signing does: generate a keystore and CSR, have AGC
+ * issue a debug certificate, register connected devices, issue a debug profile
+ * naming the team's devices, and write the encrypted signingConfig.
+ */
+declare function harmonyOsAutoSign(opts: HarmonyOsAutoSignOptions): Promise<HarmonyOsSigningResult>;
+
 declare const VERSION: string;
 
-export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, ChecksumMismatchError, CmdToolsNotInstalledError, type CmdToolsStatus, type CmdWrapper, type CodelinterFinding, type CodelinterResult, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type ExtractZipOptions, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, type HapAssetDiff, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, InsufficientSpaceError, type LaunchAppOptions, type LayoutNode, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningPasswords, type StartEmulatorOptions, type StreamHilogOptions, TMP_DIR_HINT, type TemplateOption, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WatchLogOptions, type Waypoint, applyChanges, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, consoleLogger, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, detectAaStartFailure, detectProjectSdkVersion, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findRunningProcess, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, hdcExec, installApp, installCmdTools, installEmulator, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, paramGet, paramSet, parseBounds, parseCodelinterFindings, parseDeviceList, parseHilogLine, parseMainAbilityFromBmDump, parseRemoteExit, pickSigningKind, prepareSigning, pruneLayout, readJson5File, readJsonFile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, resolveTmpRoot, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, shellChecked, spawnCompat, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, toLongPath, toSpaceError, uninstallApp, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, watchLog, waypointsToRawEvents, writeJson5File, writeJsonFile };
+export { ALL_SDKS, APL_VALUES, APP_FEATURE_VALUES, type AbilityInfo, type AgcAuthInfo, AgcError, type Apl, type AppFeature, type ApplyChangesOptions, type ApplyChangesResult, type BuildHapOptions, type BuildHapResult, type BundleOptions, CancelledError, type CaptureBurstOptions, ChecksumMismatchError, CmdToolsNotInstalledError, type CmdToolsStatus, type CmdWrapper, type CodelinterFinding, type CodelinterResult, CommandFailedError, type ConfigKey, type ConfigProvider, type CreateScaffoldOptions, type CreateScaffoldResult, type DeveloperAgreementStatus, type DeviceFullInfo, type DeviceInfo, type DiscoverHapsOptions, type DisplaySize, type DisplaySizeOptions, type DownloadOptions, type DumpLayoutOptions, type DumpLayoutResult, type DumpLogOptions, type ExtractZipOptions, type GenerateSigningConfigsOptions, type GestureUitestOptions, type GetDeviceInfoOptions, HARMONYOS_SDK_VERSIONS, HUAWEI_SITES, type HapAssetDiff, type HarmonyOsAutoSignOptions, type HarmonyOsSdk, type HarmonyOsSession, type HarmonyOsSessionOptions, type HarmonyOsSigningResult, type HdcExecOptions, type HdcExecResult, type HdcShellOptions, type HidumperOptions, type HilogEntry, type HilogLevel, type HuaweiSite, type HuaweiSiteCode, type HuaweiTeam, type HuaweiUserInfo, INSTALL_TMP_DIRNAME, type InputType, type InstallAppOptions, type InstallAppResult, type InstallCmdToolsOptions, type InstallEmulatorOptions, type InstallMethod, type InstallSdkOptions, type InstallTempDir, type InstallTempDirOptions, InsufficientSpaceError, type LaunchAppOptions, type LayoutNode, type Logger, type ModuleHaps, OHOS_URL_BASE, type OniroContext, OniroError, type OsFolder, type OutputSink, type ParamOptions, type PrepareSigningOptions, type PrepareSigningResult, type ProgressReporter, type ProgressUpdate, type ProjectModule, type Prompter, type ProvisionProfileInfo, type RawLayoutNode, type RawTouchEvent, type RebootDecision, type RebootOptions, type RecvFileOptions, type RunCodelinterOptions, type RunHvigorwOptions, type RunHvigorwResult, type RunOhpmOptions, type RunProcessOptions, type RunningProcess, type RuntimeOs, SIGNING_ERRORS, type ScreenDump, type Screenshot, type ScreenshotOptions, type SdkArchiveInfo, type SdkInfo, SdkNotInstalledError, type SdkRelease, type SendFileOptions, type SendGestureOptions, type SendInputOptions, type SendRawTouchOptions, type SetHilogLevelOptions, type SigningKind, type SigningMaterialPaths, type SigningPasswords, type StartEmulatorOptions, type StoredSession, type StreamHilogOptions, TMP_DIR_HINT, type TemplateOption, type TokenStore, UnsupportedPlatformError, VERSION, type WaitForBootOptions, type WaitForBundleOptions, type WaitForConditionOptions, type WaitForLogOptions, type WatchLogOptions, type Waypoint, applyChanges, attemptHdcConnection, buildCmdWrapper, buildGestureCommands, buildGestureUitestCommand, buildHap, buildHvigorwArgs, buildInputCommand, buildRawTouchCommand, captureBurst, consoleLogger, createHarmonyOsSession, createInstallTempDir, createMaterial, createScaffold, createTempWorkDir, createTokenStore, decideInstallMethod, decideReboot, decryptPwd, dedupEntries, defaultContext, defaultPaths, detectAaStartFailure, detectProjectSdkVersion, detectRuntimeOs, detectSigningConfigNames, diffEntryNames, diffHapAssets, discoverHaps, downloadAndInstallSdk, downloadFile, dumpLayout, dumpLog, dumpRenderService, dumpScreen, dumpWindow, encryptPwd, ensureFreeSpace, ensureOhModules, ensureOk, ensureRemoteOk, escapeCmdArgument, escapeCmdCommand, extractTarball, extractZipWithProgress, findAppProcessId, findCmdToolsSourceDir, findHarmonyOsSdk, findRunningProcess, forceStop, formatBytes, generateSigningConfigs, getBundleName, getCmdToolsBin, getCmdToolsDownloadUrl, getCmdToolsPath, getCmdToolsStatus, getDeviceInfo, getDisplaySize, getEmulatorDir, getFreeSpaceBytes, getHdcPath, getHvigorwPath, getInstalledSdks, getKey, getMainAbility, getOhosBaseSdkHome, getOhpmPath, getOsFolder, getSdkFilename, getSdkRootDir, getSupportedSdksForUi, harmonyOsAutoSign, harmonyOsSdkLabelForApi, hdcExec, installApp, installCmdTools, installEmulator, isCmdToolsInstalled, isEmulatorInstalled, isOutOfSpaceError, isRamBackedPath, isValidBundleName, isValidProjectName, killProcessTree, launchApp, listAbilities, listDevices, listModules, listRunningProcesses, listTemplates, needsCmdWrapper, nonInteractivePrompter, noopLogger, noopProgress, paramGet, paramSet, parseBounds, parseCodelinterFindings, parseDeviceList, parseHilogLine, parseMainAbilityFromBmDump, parseRemoteExit, pickSigningKind, prepareSigning, pruneLayout, readJson5File, readJsonFile, readProvisionProfile, reboot, recvFile, removeCmdTools, removeEmulator, removeSdk, removeTempWorkDir, requireHarmonyOsSdk, resolveTmpRoot, runCodelinter, runHvigorw, runOhpm, runProcess, scopedLogger, selectDevice, sendFile, sendGesture, sendInput, sendRawTouch, setHilogLevel, shell, shellChecked, spawnCompat, startEmulator, staticConfig, stopEmulator, streamHilog, takeScreenshot, toLongPath, toSpaceError, uninstallApp, validateTemplateLayout, verifySha256, waitForBoot, waitForBundle, waitForCondition, waitForLog, watchLog, waypointsToRawEvents, writeJson5File, writeJsonFile };