@atomicservice/ascf-base 1.0.14 → 1.0.16

package/dist/index.d.mts

@@ -22,29 +22,27 @@ declare class Logger {
 }
 declare function getLogger(categories: any): Logger;
 
-declare const qsHostPkg = "com.enjoy.now.hmos";
-declare const LEGACY_PKG_NAME = "com.huawei.fastapp.dev/com.huawei.ascf.main.AscfActivity";
+declare const FASTAPP_LOADER_PKG_NAME = "com.huawei.fastapp.dev";
 declare const LEGACY_DEVICE = "legacy";
 declare const HOS_DEVICE = "hos";
 declare const DEBUG_TYPE_VIEW = "view";
 declare const DEBUG_TYPE_SERVICE = "service";
-declare const BUILD_TARGET_QS = "quickapp";
-declare const BUILD_TARGET_AS = "atomicservice";
+declare const HARMONY_OS = "HarmonyOS";
+declare const HDC_CONNECTOR = "hdc";
+declare const ADB_CONNECTOR = "adb";
+declare const V8_PORT = "9229";
 
 type BuildModeType = 'debug' | 'release';
-type BuildTargetType = typeof BUILD_TARGET_AS | typeof BUILD_TARGET_QS;
 type BuildDeviceType = typeof HOS_DEVICE | typeof LEGACY_DEVICE;
 type BuilderOptions = {
     projectRoot?: string;
     deviceId?: string;
     buildMode?: BuildModeType;
-    targets?: BuildTargetType;
     deviceType?: BuildDeviceType;
     subCmd: string;
 };
 type DebuggerOptions = {
     open?: '' | 'default' | 'chrome' | 'edge';
-    targets?: BuildTargetType;
     deviceType?: BuildDeviceType;
     deviceId?: string;
     bundleName?: string;
@@ -53,13 +51,11 @@ interface IInstallSpkShared {
     logger: any;
     projectRoot: any;
     deviceId: any;
-    getSpkInfo: any;
-    buildMode: any;
-    startServer: any;
-    tryAdbPortReversing: any;
-    startHostPkgUrl: any;
-    rportRmCmd: any;
-    legacyPkg?: string;
+}
+interface IImageData {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
 }
 
 declare function getDebugees(localPort: string | number): Promise<never[]>;
@@ -77,8 +73,9 @@ declare abstract class DebuggerProcess {
     abstract stopService(): any;
     abstract checkAndGetBundleName(): Promise<string | boolean | undefined>;
     openBrowser(type: any, localPort: any, fallback?: string): Promise<void>;
-    startDebugServer(url: any): Promise<void>;
+    startDebugServer(url: String, v8WsUrl: string): Promise<void>;
     stopDebugServer(): void;
+    reversePort(port: number): Promise<boolean>;
 }
 
 declare class AscfDebugger extends DebuggerProcess {
@@ -114,8 +111,6 @@ declare abstract class BuildProcess {
     installDeps(): Promise<void>;
     prepareAssemble(projectRoot: string, args?: string[]): Promise<void>;
     abstract start(): void;
-    abstract assembleHap(): void;
-    abstract assembleApp(): void;
     abstract installHap(): void;
     abstract assembleAndInstallHap(): void;
     abstract uninstall(): void;
@@ -126,14 +121,14 @@ declare abstract class BuildProcess {
     init(): void;
     runCmdAsync(cmd: any, args?: string[], options?: any): Promise<any>;
     clean(): Promise<void>;
+    assembleHap(): Promise<void>;
+    assembleApp(): Promise<void>;
 }
 
 declare class AscfBuilder extends BuildProcess {
     constructor(options: BuilderOptions);
     runHdcCmdAsync(args?: string[], options?: any): Promise<any>;
     start(): Promise<void>;
-    assembleHap(): Promise<void>;
-    assembleApp(): Promise<void>;
     usingTmpDir(deviceId: any, cb: any): Promise<void>;
     installHap(): Promise<void>;
     assembleAndInstallHap(): Promise<void>;
@@ -147,6 +142,11 @@ declare function isMpProject(path: any): boolean;
 
 declare const IS_WIN32: boolean;
 declare const IS_MACOS: boolean;
+declare const IS_OPENHARMONY: boolean;
+declare const TOOLS_DIR_OSX = "/Applications/DevEco-Studio.app/Contents/tools";
+declare const TOOLS_DIR_WIN = "C:\\Program Files\\Huawei\\DevEco Studio\\tools";
+declare const TOOLS_DIR_OPENHARMONY = "/data/app";
+declare const DEFAULT_TOOLS_DIR: string;
 declare function getDevEcoToolsDir(): string;
 declare function getPath(...args: any[]): string;
 declare function getNodePath(): string;
@@ -156,6 +156,7 @@ declare function getHvigorwPath(): string;
 declare function getDevEcoSdkHome(): string;
 declare function getHdcPath(): string;
 declare function getNodeBinPath(): string;
+declare function getNodeDirPath(): string;
 declare function getJavaBinPath(): string;
 
 declare class AsyncResult<T> {
@@ -196,7 +197,7 @@ declare function ascfCompile(projectRoot: any, options?: any, onCp?: any): Promi
 declare function ascfConvert(input: any, projectRoot: any, options?: any): Promise<void>;
 declare function ascfGenCert(projectRoot: any, options: any): Promise<void>;
 declare function ascfGenP12(projectRoot: any, options: any): Promise<void>;
-declare function startDebugServerCmd(projectRoot: any, opts: any): Promise<unknown>;
+declare function startDebugServerCmd(projectRoot: any, opts: any, progressObj: any): Promise<unknown>;
 declare function stopDebugServer(): void;
 declare function getDebugServerInfo(localPort: string | number, path: string): Promise<any>;
 declare function getAscfDebuggerPidFile(pid: any): string | undefined;
@@ -209,6 +210,41 @@ declare function parseJsonSafe<T>(jsonStr: any, def: T): T;
 declare function parseJsonFile<T>(filepath: any, def: T): T;
 declare function mergeJson(oldJson: any, newJson: any): any;
 
+declare const FAIL = "FAIL";
+declare class AtomicServiceAppIconChecker {
+    private iconImgData;
+    private templateIconImgData;
+    private width;
+    private height;
+    constructor(iconImageData: IImageData, templateIconImageData: IImageData);
+    static imageDataInit(iconUrl: string): Promise<{
+        iconImageData: IImageData;
+        templateIconImageData: IImageData;
+    }>;
+    private static loadImageToCanvas;
+    bgraToHsv(bgraData: Uint8ClampedArray): Uint8Array;
+    inRange(hsvData: Uint8ClampedArray): Uint8Array;
+    argwhere(mask: Uint8Array): number[][];
+    extractNonTransparentHSB(hsvData: Uint8Array, coordinates: number[][]): any;
+    hsvToHsb(h: number, s: number, v: number): [number, number, number];
+    isColorInBlackOrWhite(h: number, s: number, b: number): string | null;
+    isCompare(): string;
+    /**
+     * 计算图片的锯齿度百分比
+     * @returns 锯齿度百分比
+     */
+    calculateJaggednessByImageData(): number;
+    checkImgSize(): "FAIL: The atomic-service icon size does not meet the requirements(512px*512px)." | "The atomic-service icon size meets the requirements(512px*512px).";
+    /**
+     * 统计两张图中相同像素位置一个不透明而另一个透明的像素数量
+     * @returns 差异透明像素的数量
+     */
+    compareTransparency(): number;
+    isFeatures(): "FAIL: The outer circle line of the atomic-service icon does not comply with the specifications, or the center circle of the icon is incomplete and independent." | "The outer line of the atomic-service icon meets the specification requirements.";
+    isSharpness(): "FAIL: The atomic-service icon is not clear." | "The atomic-service icon is clear.";
+    check(): Promise<string[]>;
+}
+
 /**
  * 获取ADB工具的路径。
  * 根据不同的操作系统平台（Windows, macOS, Linux），返回对应的ADB可执行文件路径。
@@ -219,9 +255,8 @@ declare function getAdbPath(): Promise<string>;
 declare function runAdbCmdAsync(args?: string[], options?: any): Promise<any>;
 declare const listTargets: () => Promise<any>;
 declare const getDeviceName: (deviceId: string) => Promise<string>;
-declare const tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number | undefined>;
+declare const tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number>;
 declare const startHostPkg: (deviceId: string, bundleName: string) => Promise<string>;
-declare const startHostPkgUrl: (deviceId: string, bundleName: string, reqUrl: string, legacyPkg: string) => Promise<string>;
 declare const fportListCmd: (deviceId: string) => Promise<string>;
 declare const fportRmCmd: (deviceId: string, localnode: string) => Promise<string>;
 declare const fportCmd: (deviceId: string, localnode: string, remotenode: string) => Promise<string>;
@@ -229,16 +264,59 @@ declare const rportCmd: (deviceId: string, localnode: string, remotenode: string
 declare const rportRmCmd: (deviceId: string, devicenode: string) => Promise<string>;
 declare const getDevicesCmd: () => Promise<string>;
 declare const getLegacyDeviceName: (deviceId: any) => Promise<string>;
-declare const getLegacyProcess: (deviceId: any, bundleName: any) => Promise<string>;
+declare const getLegacyProcess: (deviceId: any, hostPkg: any) => Promise<string>;
+declare const getLegacyHosVersion: (deviceId: any) => Promise<string>;
 /**
  * 查找包安装信息
  *
  * @param deviceId 设备id
  * @param bundleName 包名
  */
-declare function getLegacyPackInfo(deviceId: any, bundleName: any): Promise<string>;
+declare function getLegacyPackInfo(deviceId: any): Promise<string>;
 declare function getPid(deviceId: string, bundleName: string): Promise<string>;
 
+type TemplateEngineOptions = {
+    force?: boolean;
+    dryRun?: boolean;
+    ejsOptions?: any;
+    webview?: any;
+};
+type TemplateContext = {
+    rootOut: string;
+    data: any;
+};
+type TemplateFile = {
+    type: 'template' | 'file' | 'modify' | 'delete' | 'copy' | 'rename';
+    tpl: string;
+    excludes?: string[];
+    path: string;
+    force?: boolean;
+    onModify?: (old: any, data?: any) => boolean;
+};
+type TemplateInfo = {
+    templateDir: string;
+    files: TemplateFile[];
+};
+declare class TemplateEngine {
+    private options;
+    constructor(options: TemplateEngineOptions);
+    mkdirSync(path: any): void;
+    copyFileSync(src: any, dest: any): void;
+    copyDirSync(src: any, dest: any, filter?: (sourceFullPath: string, destination: string) => boolean): void;
+    writeFileSync(filepath: any, content: any, encoding: any, force?: boolean): void;
+    fileRename(filePath: any): any;
+    generateByTemplateFile(templateInfo: TemplateInfo, ctx: TemplateContext, tplFile: TemplateFile): Promise<void>;
+    generate(templateInfo: TemplateInfo, ctx: TemplateContext): Promise<void[]>;
+}
+declare function createAscfProject(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void>;
+declare function createAscfPage(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void[]>;
+declare function createAscfComponent(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void[]>;
+declare function createServiceWidget(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void[]>;
+
+declare function fetchJson(url: string, options: any): Promise<any>;
+declare function fetchHttpsJson(url: string, options: any): Promise<any>;
+declare function downloadApk(url: string, outputDir: string, vscodeProgress: any, options: any): Promise<string>;
+
 declare function installAscfTools(): Promise<string>;
 
 /**
@@ -261,12 +339,13 @@ declare function hdcShared({ logger, getDevEcoSdkHome, getPath, getHdcPath }: {
     getPath: any;
     getHdcPath: any;
 }): {
-    runCmd: (cmd: any, args?: string[], cb?: any, options?: any, onCp?: any) => child_process.ChildProcessWithoutNullStreams;
+    runCmd: (cmd: any, args?: string[], cb?: any, options?: any, onCp?: any, progressObj?: any) => child_process.ChildProcessWithoutNullStreams;
     runCmdAsync: (cmd: any, args?: string[], options?: any, onCp?: any) => Promise<any>;
     runExecAsync: (cmd: any, args?: string[], options?: any) => Promise<any>;
     runHdcCmd: (args?: string[], cb?: any, options?: any) => child_process.ChildProcessWithoutNullStreams;
     runHdcCmdAsync: (args?: string[], options?: any) => Promise<any>;
     getDeviceName: (deviceId: string) => Promise<string>;
+    getHosVersion: (deviceId: string) => Promise<string>;
 };
 type deviceType = typeof LEGACY_DEVICE | typeof HOS_DEVICE;
 declare class DeviceInfo {
@@ -310,7 +389,7 @@ declare class BuildProcessFactory {
     static create(options: BuilderOptions): Promise<BuildProcess>;
 }
 declare class DebuggerProcessFactory {
-    static create(options: BuilderOptions): Promise<DebuggerProcess>;
+    static create(options: DebuggerOptions): Promise<DebuggerProcess>;
 }
 
 declare function devicesLegacyShared({ logger, runAdbCmdAsync }: {
@@ -319,9 +398,8 @@ declare function devicesLegacyShared({ logger, runAdbCmdAsync }: {
 }): {
     listTargets: () => Promise<any>;
     getDeviceName: (deviceId: string) => Promise<string>;
-    tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number | undefined>;
+    tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number>;
     startHostPkg: (deviceId: string, bundleName: string) => Promise<string>;
-    startHostPkgUrl: (deviceId: string, bundleName: string, reqUrl: string, legacyPkg: string) => Promise<string>;
     fportListCmd: (deviceId: string) => Promise<string>;
     fportRmCmd: (deviceId: string, localnode: string) => Promise<string>;
     fportCmd: (deviceId: string, localnode: string, remotenode: string) => Promise<string>;
@@ -329,7 +407,8 @@ declare function devicesLegacyShared({ logger, runAdbCmdAsync }: {
     rportRmCmd: (deviceId: string, devicenode: string) => Promise<string>;
     getDevicesCmd: () => Promise<string>;
     getLegacyDeviceName: (deviceId: any) => Promise<string>;
-    getLegacyProcess: (deviceId: any, bundleName: any) => Promise<string>;
+    getLegacyProcess: (deviceId: any, hostPkg: any) => Promise<string>;
+    getLegacyHosVersion: (deviceId: any) => Promise<string>;
 };
 
 declare const ERROR_MSG: string;
@@ -341,6 +420,15 @@ declare function portManagerShared({ logger, fportListCmd, fportRmCmd, isPortRea
 
 declare function tryHdcPortReversing(deviceId: any, localPort: any, times?: number): Promise<number | undefined>;
 
-declare function installSpkShared({ logger, projectRoot, deviceId, getSpkInfo, buildMode, startServer, tryAdbPortReversing, startHostPkgUrl, rportRmCmd, legacyPkg }: IInstallSpkShared): Promise<void>;
+declare function installSpkShared({ logger, projectRoot, deviceId }: IInstallSpkShared): Promise<void>;
+
+declare class DebugPort {
+    port: number;
+    private static instance;
+    private constructor();
+    static getInstance(): DebugPort;
+    getPort(): number;
+}
+declare const debugPort: DebugPort;
 
-export { $async, ASCF_LOG_FILE, AscfBuilder, AscfDebugger, AsyncResult, BUILD_MODE_DEBUG, BUILD_MODE_RELEASE, BUILD_TARGET_AS, BUILD_TARGET_QS, BuildProcessFactory, DEBUG_TYPE_SERVICE, DEBUG_TYPE_VIEW, DebuggerProcessFactory, ERROR_MSG, HOS_DEVICE, IS_MACOS, IS_WIN32, LEGACY_DEVICE, LEGACY_PKG_NAME, ascfCompile, ascfConvert, ascfGenCert, ascfGenP12, ascfRun, clearAscfDepDirCache, configureLogger, copyDirectory, type deviceType, devicesLegacyShared, execSafe, findAvailablePort, fixHvigorPath, fportCmd, fportListCmd, fportRmCmd, getAdbPath, getAscfDebuggerPidFile, getAscfDepDir, getBuildProfile, getBundleInfo, getCmdAndArgs, getDebugServerInfo, getDebugees, getDevEcoSdkHome, getDevEcoToolsDir, getDeviceName, getDevicesCmd, getHdcPath, getHvigorwPath, getJavaBinPath, getLegacyDeviceName, getLegacyPackInfo, getLegacyProcess, getLogLevelGetter, getLogger, getNodeBinPath, getNodePath, getNpmPath, getOhpmPath, getPath, getPid, getProjectConfig, getSpkInfo, hasHvigor, hdcDeviceShared, hdcShared, installAscfTools, installSpkShared, isAscfProject, isDirectoryExists, isMpProject, isPortReachable, listTargets, maskLast4, mergeJson, normalizeBuildMode, openInBrowser, optArgIf, parseJsonFile, parseJsonSafe, portManagerShared, qsHostPkg, rportCmd, rportRmCmd, runAdbCmdAsync, setLogLevelGetter, setLoggerConfig, startDebugServerCmd, startHostPkg, startHostPkgUrl, startServer, stopDebugServer, tryAdbPortReversing, tryHdcPortReversing };
+export { $async, ADB_CONNECTOR, ASCF_LOG_FILE, AscfBuilder, AscfDebugger, AsyncResult, AtomicServiceAppIconChecker, BUILD_MODE_DEBUG, BUILD_MODE_RELEASE, BuildProcessFactory, DEBUG_TYPE_SERVICE, DEBUG_TYPE_VIEW, DEFAULT_TOOLS_DIR, DebuggerProcessFactory, ERROR_MSG, FAIL, FASTAPP_LOADER_PKG_NAME, HARMONY_OS, HDC_CONNECTOR, HOS_DEVICE, IS_MACOS, IS_OPENHARMONY, IS_WIN32, LEGACY_DEVICE, TOOLS_DIR_OPENHARMONY, TOOLS_DIR_OSX, TOOLS_DIR_WIN, type TemplateContext, TemplateEngine, type TemplateEngineOptions, type TemplateFile, type TemplateInfo, V8_PORT, ascfCompile, ascfConvert, ascfGenCert, ascfGenP12, ascfRun, clearAscfDepDirCache, configureLogger, copyDirectory, createAscfComponent, createAscfPage, createAscfProject, createServiceWidget, debugPort, type deviceType, devicesLegacyShared, downloadApk, execSafe, fetchHttpsJson, fetchJson, findAvailablePort, fixHvigorPath, fportCmd, fportListCmd, fportRmCmd, getAdbPath, getAscfDebuggerPidFile, getAscfDepDir, getBuildProfile, getBundleInfo, getCmdAndArgs, getDebugServerInfo, getDebugees, getDevEcoSdkHome, getDevEcoToolsDir, getDeviceName, getDevicesCmd, getHdcPath, getHvigorwPath, getJavaBinPath, getLegacyDeviceName, getLegacyHosVersion, getLegacyPackInfo, getLegacyProcess, getLogLevelGetter, getLogger, getNodeBinPath, getNodeDirPath, getNodePath, getNpmPath, getOhpmPath, getPath, getPid, getProjectConfig, getSpkInfo, hasHvigor, hdcDeviceShared, hdcShared, installAscfTools, installSpkShared, isAscfProject, isDirectoryExists, isMpProject, isPortReachable, listTargets, maskLast4, mergeJson, normalizeBuildMode, openInBrowser, optArgIf, parseJsonFile, parseJsonSafe, portManagerShared, rportCmd, rportRmCmd, runAdbCmdAsync, setLogLevelGetter, setLoggerConfig, startDebugServerCmd, startHostPkg, startServer, stopDebugServer, tryAdbPortReversing, tryHdcPortReversing };

package/dist/index.d.ts

@@ -22,29 +22,27 @@ declare class Logger {
 }
 declare function getLogger(categories: any): Logger;
 
-declare const qsHostPkg = "com.enjoy.now.hmos";
-declare const LEGACY_PKG_NAME = "com.huawei.fastapp.dev/com.huawei.ascf.main.AscfActivity";
+declare const FASTAPP_LOADER_PKG_NAME = "com.huawei.fastapp.dev";
 declare const LEGACY_DEVICE = "legacy";
 declare const HOS_DEVICE = "hos";
 declare const DEBUG_TYPE_VIEW = "view";
 declare const DEBUG_TYPE_SERVICE = "service";
-declare const BUILD_TARGET_QS = "quickapp";
-declare const BUILD_TARGET_AS = "atomicservice";
+declare const HARMONY_OS = "HarmonyOS";
+declare const HDC_CONNECTOR = "hdc";
+declare const ADB_CONNECTOR = "adb";
+declare const V8_PORT = "9229";
 
 type BuildModeType = 'debug' | 'release';
-type BuildTargetType = typeof BUILD_TARGET_AS | typeof BUILD_TARGET_QS;
 type BuildDeviceType = typeof HOS_DEVICE | typeof LEGACY_DEVICE;
 type BuilderOptions = {
     projectRoot?: string;
     deviceId?: string;
     buildMode?: BuildModeType;
-    targets?: BuildTargetType;
     deviceType?: BuildDeviceType;
     subCmd: string;
 };
 type DebuggerOptions = {
     open?: '' | 'default' | 'chrome' | 'edge';
-    targets?: BuildTargetType;
     deviceType?: BuildDeviceType;
     deviceId?: string;
     bundleName?: string;
@@ -53,13 +51,11 @@ interface IInstallSpkShared {
     logger: any;
     projectRoot: any;
     deviceId: any;
-    getSpkInfo: any;
-    buildMode: any;
-    startServer: any;
-    tryAdbPortReversing: any;
-    startHostPkgUrl: any;
-    rportRmCmd: any;
-    legacyPkg?: string;
+}
+interface IImageData {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
 }
 
 declare function getDebugees(localPort: string | number): Promise<never[]>;
@@ -77,8 +73,9 @@ declare abstract class DebuggerProcess {
     abstract stopService(): any;
     abstract checkAndGetBundleName(): Promise<string | boolean | undefined>;
     openBrowser(type: any, localPort: any, fallback?: string): Promise<void>;
-    startDebugServer(url: any): Promise<void>;
+    startDebugServer(url: String, v8WsUrl: string): Promise<void>;
     stopDebugServer(): void;
+    reversePort(port: number): Promise<boolean>;
 }
 
 declare class AscfDebugger extends DebuggerProcess {
@@ -114,8 +111,6 @@ declare abstract class BuildProcess {
     installDeps(): Promise<void>;
     prepareAssemble(projectRoot: string, args?: string[]): Promise<void>;
     abstract start(): void;
-    abstract assembleHap(): void;
-    abstract assembleApp(): void;
     abstract installHap(): void;
     abstract assembleAndInstallHap(): void;
     abstract uninstall(): void;
@@ -126,14 +121,14 @@ declare abstract class BuildProcess {
     init(): void;
     runCmdAsync(cmd: any, args?: string[], options?: any): Promise<any>;
     clean(): Promise<void>;
+    assembleHap(): Promise<void>;
+    assembleApp(): Promise<void>;
 }
 
 declare class AscfBuilder extends BuildProcess {
     constructor(options: BuilderOptions);
     runHdcCmdAsync(args?: string[], options?: any): Promise<any>;
     start(): Promise<void>;
-    assembleHap(): Promise<void>;
-    assembleApp(): Promise<void>;
     usingTmpDir(deviceId: any, cb: any): Promise<void>;
     installHap(): Promise<void>;
     assembleAndInstallHap(): Promise<void>;
@@ -147,6 +142,11 @@ declare function isMpProject(path: any): boolean;
 
 declare const IS_WIN32: boolean;
 declare const IS_MACOS: boolean;
+declare const IS_OPENHARMONY: boolean;
+declare const TOOLS_DIR_OSX = "/Applications/DevEco-Studio.app/Contents/tools";
+declare const TOOLS_DIR_WIN = "C:\\Program Files\\Huawei\\DevEco Studio\\tools";
+declare const TOOLS_DIR_OPENHARMONY = "/data/app";
+declare const DEFAULT_TOOLS_DIR: string;
 declare function getDevEcoToolsDir(): string;
 declare function getPath(...args: any[]): string;
 declare function getNodePath(): string;
@@ -156,6 +156,7 @@ declare function getHvigorwPath(): string;
 declare function getDevEcoSdkHome(): string;
 declare function getHdcPath(): string;
 declare function getNodeBinPath(): string;
+declare function getNodeDirPath(): string;
 declare function getJavaBinPath(): string;
 
 declare class AsyncResult<T> {
@@ -196,7 +197,7 @@ declare function ascfCompile(projectRoot: any, options?: any, onCp?: any): Promi
 declare function ascfConvert(input: any, projectRoot: any, options?: any): Promise<void>;
 declare function ascfGenCert(projectRoot: any, options: any): Promise<void>;
 declare function ascfGenP12(projectRoot: any, options: any): Promise<void>;
-declare function startDebugServerCmd(projectRoot: any, opts: any): Promise<unknown>;
+declare function startDebugServerCmd(projectRoot: any, opts: any, progressObj: any): Promise<unknown>;
 declare function stopDebugServer(): void;
 declare function getDebugServerInfo(localPort: string | number, path: string): Promise<any>;
 declare function getAscfDebuggerPidFile(pid: any): string | undefined;
@@ -209,6 +210,41 @@ declare function parseJsonSafe<T>(jsonStr: any, def: T): T;
 declare function parseJsonFile<T>(filepath: any, def: T): T;
 declare function mergeJson(oldJson: any, newJson: any): any;
 
+declare const FAIL = "FAIL";
+declare class AtomicServiceAppIconChecker {
+    private iconImgData;
+    private templateIconImgData;
+    private width;
+    private height;
+    constructor(iconImageData: IImageData, templateIconImageData: IImageData);
+    static imageDataInit(iconUrl: string): Promise<{
+        iconImageData: IImageData;
+        templateIconImageData: IImageData;
+    }>;
+    private static loadImageToCanvas;
+    bgraToHsv(bgraData: Uint8ClampedArray): Uint8Array;
+    inRange(hsvData: Uint8ClampedArray): Uint8Array;
+    argwhere(mask: Uint8Array): number[][];
+    extractNonTransparentHSB(hsvData: Uint8Array, coordinates: number[][]): any;
+    hsvToHsb(h: number, s: number, v: number): [number, number, number];
+    isColorInBlackOrWhite(h: number, s: number, b: number): string | null;
+    isCompare(): string;
+    /**
+     * 计算图片的锯齿度百分比
+     * @returns 锯齿度百分比
+     */
+    calculateJaggednessByImageData(): number;
+    checkImgSize(): "FAIL: The atomic-service icon size does not meet the requirements(512px*512px)." | "The atomic-service icon size meets the requirements(512px*512px).";
+    /**
+     * 统计两张图中相同像素位置一个不透明而另一个透明的像素数量
+     * @returns 差异透明像素的数量
+     */
+    compareTransparency(): number;
+    isFeatures(): "FAIL: The outer circle line of the atomic-service icon does not comply with the specifications, or the center circle of the icon is incomplete and independent." | "The outer line of the atomic-service icon meets the specification requirements.";
+    isSharpness(): "FAIL: The atomic-service icon is not clear." | "The atomic-service icon is clear.";
+    check(): Promise<string[]>;
+}
+
 /**
  * 获取ADB工具的路径。
  * 根据不同的操作系统平台（Windows, macOS, Linux），返回对应的ADB可执行文件路径。
@@ -219,9 +255,8 @@ declare function getAdbPath(): Promise<string>;
 declare function runAdbCmdAsync(args?: string[], options?: any): Promise<any>;
 declare const listTargets: () => Promise<any>;
 declare const getDeviceName: (deviceId: string) => Promise<string>;
-declare const tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number | undefined>;
+declare const tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number>;
 declare const startHostPkg: (deviceId: string, bundleName: string) => Promise<string>;
-declare const startHostPkgUrl: (deviceId: string, bundleName: string, reqUrl: string, legacyPkg: string) => Promise<string>;
 declare const fportListCmd: (deviceId: string) => Promise<string>;
 declare const fportRmCmd: (deviceId: string, localnode: string) => Promise<string>;
 declare const fportCmd: (deviceId: string, localnode: string, remotenode: string) => Promise<string>;
@@ -229,16 +264,59 @@ declare const rportCmd: (deviceId: string, localnode: string, remotenode: string
 declare const rportRmCmd: (deviceId: string, devicenode: string) => Promise<string>;
 declare const getDevicesCmd: () => Promise<string>;
 declare const getLegacyDeviceName: (deviceId: any) => Promise<string>;
-declare const getLegacyProcess: (deviceId: any, bundleName: any) => Promise<string>;
+declare const getLegacyProcess: (deviceId: any, hostPkg: any) => Promise<string>;
+declare const getLegacyHosVersion: (deviceId: any) => Promise<string>;
 /**
  * 查找包安装信息
  *
  * @param deviceId 设备id
  * @param bundleName 包名
  */
-declare function getLegacyPackInfo(deviceId: any, bundleName: any): Promise<string>;
+declare function getLegacyPackInfo(deviceId: any): Promise<string>;
 declare function getPid(deviceId: string, bundleName: string): Promise<string>;
 
+type TemplateEngineOptions = {
+    force?: boolean;
+    dryRun?: boolean;
+    ejsOptions?: any;
+    webview?: any;
+};
+type TemplateContext = {
+    rootOut: string;
+    data: any;
+};
+type TemplateFile = {
+    type: 'template' | 'file' | 'modify' | 'delete' | 'copy' | 'rename';
+    tpl: string;
+    excludes?: string[];
+    path: string;
+    force?: boolean;
+    onModify?: (old: any, data?: any) => boolean;
+};
+type TemplateInfo = {
+    templateDir: string;
+    files: TemplateFile[];
+};
+declare class TemplateEngine {
+    private options;
+    constructor(options: TemplateEngineOptions);
+    mkdirSync(path: any): void;
+    copyFileSync(src: any, dest: any): void;
+    copyDirSync(src: any, dest: any, filter?: (sourceFullPath: string, destination: string) => boolean): void;
+    writeFileSync(filepath: any, content: any, encoding: any, force?: boolean): void;
+    fileRename(filePath: any): any;
+    generateByTemplateFile(templateInfo: TemplateInfo, ctx: TemplateContext, tplFile: TemplateFile): Promise<void>;
+    generate(templateInfo: TemplateInfo, ctx: TemplateContext): Promise<void[]>;
+}
+declare function createAscfProject(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void>;
+declare function createAscfPage(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void[]>;
+declare function createAscfComponent(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void[]>;
+declare function createServiceWidget(templatesDir: string, ctx: TemplateContext, options?: TemplateEngineOptions): Promise<void[]>;
+
+declare function fetchJson(url: string, options: any): Promise<any>;
+declare function fetchHttpsJson(url: string, options: any): Promise<any>;
+declare function downloadApk(url: string, outputDir: string, vscodeProgress: any, options: any): Promise<string>;
+
 declare function installAscfTools(): Promise<string>;
 
 /**
@@ -261,12 +339,13 @@ declare function hdcShared({ logger, getDevEcoSdkHome, getPath, getHdcPath }: {
     getPath: any;
     getHdcPath: any;
 }): {
-    runCmd: (cmd: any, args?: string[], cb?: any, options?: any, onCp?: any) => child_process.ChildProcessWithoutNullStreams;
+    runCmd: (cmd: any, args?: string[], cb?: any, options?: any, onCp?: any, progressObj?: any) => child_process.ChildProcessWithoutNullStreams;
     runCmdAsync: (cmd: any, args?: string[], options?: any, onCp?: any) => Promise<any>;
     runExecAsync: (cmd: any, args?: string[], options?: any) => Promise<any>;
     runHdcCmd: (args?: string[], cb?: any, options?: any) => child_process.ChildProcessWithoutNullStreams;
     runHdcCmdAsync: (args?: string[], options?: any) => Promise<any>;
     getDeviceName: (deviceId: string) => Promise<string>;
+    getHosVersion: (deviceId: string) => Promise<string>;
 };
 type deviceType = typeof LEGACY_DEVICE | typeof HOS_DEVICE;
 declare class DeviceInfo {
@@ -310,7 +389,7 @@ declare class BuildProcessFactory {
     static create(options: BuilderOptions): Promise<BuildProcess>;
 }
 declare class DebuggerProcessFactory {
-    static create(options: BuilderOptions): Promise<DebuggerProcess>;
+    static create(options: DebuggerOptions): Promise<DebuggerProcess>;
 }
 
 declare function devicesLegacyShared({ logger, runAdbCmdAsync }: {
@@ -319,9 +398,8 @@ declare function devicesLegacyShared({ logger, runAdbCmdAsync }: {
 }): {
     listTargets: () => Promise<any>;
     getDeviceName: (deviceId: string) => Promise<string>;
-    tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number | undefined>;
+    tryAdbPortReversing: (deviceId: any, localPort: any, times?: number) => Promise<number>;
     startHostPkg: (deviceId: string, bundleName: string) => Promise<string>;
-    startHostPkgUrl: (deviceId: string, bundleName: string, reqUrl: string, legacyPkg: string) => Promise<string>;
     fportListCmd: (deviceId: string) => Promise<string>;
     fportRmCmd: (deviceId: string, localnode: string) => Promise<string>;
     fportCmd: (deviceId: string, localnode: string, remotenode: string) => Promise<string>;
@@ -329,7 +407,8 @@ declare function devicesLegacyShared({ logger, runAdbCmdAsync }: {
     rportRmCmd: (deviceId: string, devicenode: string) => Promise<string>;
     getDevicesCmd: () => Promise<string>;
     getLegacyDeviceName: (deviceId: any) => Promise<string>;
-    getLegacyProcess: (deviceId: any, bundleName: any) => Promise<string>;
+    getLegacyProcess: (deviceId: any, hostPkg: any) => Promise<string>;
+    getLegacyHosVersion: (deviceId: any) => Promise<string>;
 };
 
 declare const ERROR_MSG: string;
@@ -341,6 +420,15 @@ declare function portManagerShared({ logger, fportListCmd, fportRmCmd, isPortRea
 
 declare function tryHdcPortReversing(deviceId: any, localPort: any, times?: number): Promise<number | undefined>;
 
-declare function installSpkShared({ logger, projectRoot, deviceId, getSpkInfo, buildMode, startServer, tryAdbPortReversing, startHostPkgUrl, rportRmCmd, legacyPkg }: IInstallSpkShared): Promise<void>;
+declare function installSpkShared({ logger, projectRoot, deviceId }: IInstallSpkShared): Promise<void>;
+
+declare class DebugPort {
+    port: number;
+    private static instance;
+    private constructor();
+    static getInstance(): DebugPort;
+    getPort(): number;
+}
+declare const debugPort: DebugPort;
 
-export { $async, ASCF_LOG_FILE, AscfBuilder, AscfDebugger, AsyncResult, BUILD_MODE_DEBUG, BUILD_MODE_RELEASE, BUILD_TARGET_AS, BUILD_TARGET_QS, BuildProcessFactory, DEBUG_TYPE_SERVICE, DEBUG_TYPE_VIEW, DebuggerProcessFactory, ERROR_MSG, HOS_DEVICE, IS_MACOS, IS_WIN32, LEGACY_DEVICE, LEGACY_PKG_NAME, ascfCompile, ascfConvert, ascfGenCert, ascfGenP12, ascfRun, clearAscfDepDirCache, configureLogger, copyDirectory, type deviceType, devicesLegacyShared, execSafe, findAvailablePort, fixHvigorPath, fportCmd, fportListCmd, fportRmCmd, getAdbPath, getAscfDebuggerPidFile, getAscfDepDir, getBuildProfile, getBundleInfo, getCmdAndArgs, getDebugServerInfo, getDebugees, getDevEcoSdkHome, getDevEcoToolsDir, getDeviceName, getDevicesCmd, getHdcPath, getHvigorwPath, getJavaBinPath, getLegacyDeviceName, getLegacyPackInfo, getLegacyProcess, getLogLevelGetter, getLogger, getNodeBinPath, getNodePath, getNpmPath, getOhpmPath, getPath, getPid, getProjectConfig, getSpkInfo, hasHvigor, hdcDeviceShared, hdcShared, installAscfTools, installSpkShared, isAscfProject, isDirectoryExists, isMpProject, isPortReachable, listTargets, maskLast4, mergeJson, normalizeBuildMode, openInBrowser, optArgIf, parseJsonFile, parseJsonSafe, portManagerShared, qsHostPkg, rportCmd, rportRmCmd, runAdbCmdAsync, setLogLevelGetter, setLoggerConfig, startDebugServerCmd, startHostPkg, startHostPkgUrl, startServer, stopDebugServer, tryAdbPortReversing, tryHdcPortReversing };
+export { $async, ADB_CONNECTOR, ASCF_LOG_FILE, AscfBuilder, AscfDebugger, AsyncResult, AtomicServiceAppIconChecker, BUILD_MODE_DEBUG, BUILD_MODE_RELEASE, BuildProcessFactory, DEBUG_TYPE_SERVICE, DEBUG_TYPE_VIEW, DEFAULT_TOOLS_DIR, DebuggerProcessFactory, ERROR_MSG, FAIL, FASTAPP_LOADER_PKG_NAME, HARMONY_OS, HDC_CONNECTOR, HOS_DEVICE, IS_MACOS, IS_OPENHARMONY, IS_WIN32, LEGACY_DEVICE, TOOLS_DIR_OPENHARMONY, TOOLS_DIR_OSX, TOOLS_DIR_WIN, type TemplateContext, TemplateEngine, type TemplateEngineOptions, type TemplateFile, type TemplateInfo, V8_PORT, ascfCompile, ascfConvert, ascfGenCert, ascfGenP12, ascfRun, clearAscfDepDirCache, configureLogger, copyDirectory, createAscfComponent, createAscfPage, createAscfProject, createServiceWidget, debugPort, type deviceType, devicesLegacyShared, downloadApk, execSafe, fetchHttpsJson, fetchJson, findAvailablePort, fixHvigorPath, fportCmd, fportListCmd, fportRmCmd, getAdbPath, getAscfDebuggerPidFile, getAscfDepDir, getBuildProfile, getBundleInfo, getCmdAndArgs, getDebugServerInfo, getDebugees, getDevEcoSdkHome, getDevEcoToolsDir, getDeviceName, getDevicesCmd, getHdcPath, getHvigorwPath, getJavaBinPath, getLegacyDeviceName, getLegacyHosVersion, getLegacyPackInfo, getLegacyProcess, getLogLevelGetter, getLogger, getNodeBinPath, getNodeDirPath, getNodePath, getNpmPath, getOhpmPath, getPath, getPid, getProjectConfig, getSpkInfo, hasHvigor, hdcDeviceShared, hdcShared, installAscfTools, installSpkShared, isAscfProject, isDirectoryExists, isMpProject, isPortReachable, listTargets, maskLast4, mergeJson, normalizeBuildMode, openInBrowser, optArgIf, parseJsonFile, parseJsonSafe, portManagerShared, rportCmd, rportRmCmd, runAdbCmdAsync, setLogLevelGetter, setLoggerConfig, startDebugServerCmd, startHostPkg, startServer, stopDebugServer, tryAdbPortReversing, tryHdcPortReversing };