meminsight-test-demo 1.0.0

package/packages/core/src/shell/DeviceShell.ts

@@ -0,0 +1,179 @@
+import { Shell, ShellArgs } from "./Shell";
+import { AppInfo, DeviceInfo } from "../types/OhosTypes";
+
+/**
+ * DeviceShell
+ */
+export class DeviceShell {
+    private static defaultInstance: DeviceShell = new DeviceShell();
+    private static deviceMap: Map<string, DeviceShell> = new Map();
+    private deviceInfo?: DeviceInfo;
+
+    constructor(deviceId?: string) {
+        this.deviceInfo = new DeviceInfo(deviceId);
+    }
+
+    /**
+     * 获取DeviceShell实例
+     * @param deviceId device id
+     * @returns DeviceShell
+     */
+    public static getDeviceShell(deviceId?: string) : DeviceShell {
+        let shellInst: DeviceShell | undefined = DeviceShell.deviceMap.get(deviceId || '');
+        if (!shellInst) {
+            shellInst = new DeviceShell(deviceId);
+            DeviceShell.deviceMap.set(deviceId || '', shellInst);
+        }
+        return shellInst;
+    }
+
+    /**
+     * clear device shell instances
+     */
+    public static clearDeviceShell() : void {
+        DeviceShell.deviceMap.clear();
+    }
+
+    private getDeviceCmd(): string {
+        let deviceId = this.getDeviceId();
+        return `${deviceId === '' ? '' : `-t ${deviceId}`}`;
+    }
+
+    /**
+     * 默认 DeviceShell 单例
+     * @returns device instance
+     */
+    public static default(): DeviceShell {
+        return this.defaultInstance;
+    }
+
+    /**
+     * 获取设备信息
+     * @returns device info
+     */
+    public getDeviceInfo(): DeviceInfo | undefined {
+        return this.deviceInfo;
+    }
+
+    /**
+     * 获取设备ID
+     * @returns device id
+     */
+    public getDeviceId() : string {
+        return this.deviceInfo?.deviceId || '';
+    }
+
+    /**
+     * 执行设备命令
+     * @param cmd command
+     * @param excludeEmptyLine 输出不包含空行
+     * @param trimLine 输出行去空格
+     * @returns 输出信息
+     */
+    public execSync(cmd: string, excludeEmptyLine: boolean = true, trimLine: boolean = true): string[] {
+        let args: ShellArgs = { 
+            excludeEmptyLine: excludeEmptyLine, 
+            trimLine: trimLine }
+        return Shell.execSync(`hdc ${this.getDeviceCmd()} shell "${cmd}"`, args);
+    }
+
+    /**
+     * 接收文件到本地
+     * @param remoteFile 远程文件路径
+     * @param localFile 本地文件路径
+     */
+    public recvFile(remoteFile: string, localFile: string): void {
+        Shell.execSync(`hdc ${this.getDeviceCmd()} file recv "${remoteFile}" "${localFile}"`);
+    }
+
+    /**
+     * 发送文件到设备
+     * @param localFile 本地文件路径
+     * @param remoteFile 远程文件路径
+     */
+    public sendFile(localFile: string, remoteFile: string): void {
+        Shell.execSync(`hdc ${this.getDeviceCmd()} file send "${localFile}" "${remoteFile}"`);
+    }
+
+    /**
+     * 通过应用名称获取app信息
+     * @param bundleName 应用名称
+     * @returns AppInfo
+     */
+    public getAppInfoByName(bundleName: string) : AppInfo { 
+        const appInfo = new AppInfo();
+        appInfo.name = bundleName;
+        appInfo.pid = this.getAppPid(bundleName);
+        return appInfo;
+    }
+
+    /**
+     * 通过pid获取app信息
+     * @param pid pid
+     * @returns AppInfo
+     */
+    public getAppInfoByPid(pid: number) : AppInfo {
+        const appInfo = new AppInfo();
+        appInfo.pid = pid;
+        appInfo.name = this.getAppName(pid);
+        return appInfo;
+    }
+
+    /**
+     * 应用进程PID
+     * @param bundleName 应用名称
+     * @returns pid | undefined
+     */
+    public getAppPid(bundleName: string) : number | undefined {
+        let strs = this.execSync(`pidof ${bundleName}`);
+        if (strs.length === 1) {
+            return parseInt(strs[0].trim().split(' ')[0]);
+        } else {
+            return undefined;
+        }
+    }
+
+    /**
+     * 获取应用名称
+     * @param pid 进程id
+     * @returns 进程名称
+     */
+    public getAppName(pid: number) : string {
+        // 20008         2940   674 0 12:35:30 ?     00:00:16 com.xxx.yyy.zzz
+        let strs = this.execSync(`ps -ef | grep ${pid} | grep -v grep`);
+        let appName: string | undefined;
+        if (strs.length === 1) {
+            appName = strs[0].split(/\s+/).pop();
+        }
+        return appName || '';
+    }
+
+    /**
+     * 是否是Root镜像设备
+     * @returns true/false
+     */
+    public isRootDevice() : boolean {
+        let strs = this.execSync('ls /system');
+        return strs.findIndex(str => str.indexOf('ls: /system: Permission denied') >= 0) == -1;
+    }
+
+    /**
+     * 指定pid GC
+     * @param pid 进程id
+     */
+    public async forceGC(pid: number) : Promise<void> { 
+        let cmd = `hidumper --mem-jsheap ${pid} --gc`;
+        this.execSync(cmd);
+    }
+
+    /**
+     * 指定包名 GC
+     * @param name 进程名
+     */
+    public async forceGCByName(app: string) : Promise<void> { 
+        let pid = this.getAppPid(app);
+        if (pid) {
+            await this.forceGC(pid);
+        }
+    }
+}

package/packages/core/src/shell/Shell.ts

@@ -0,0 +1,99 @@
+import { execSync, execFileSync, ExecFileSyncOptions } from 'child_process';
+
+/**
+ * execute args
+ */
+export class ShellArgs {
+    /**
+     * exclude empty line
+     */
+    excludeEmptyLine: boolean = true;
+
+    /**
+     * trim line start and end
+     */
+    trimLine: boolean = true;
+}
+
+/**
+ * shell interface
+ */
+export interface IShell {
+    /**
+     * execute command
+     * @param command command
+     * @param ExecuteArgs execute args
+     */
+    execSync(command: string, args?: ShellArgs): string[];
+
+    /**
+     * execute target
+     * @param target target path
+     * @param ExecuteArgs execute args
+     * @param options options
+     */
+    execSyncTarget(target: string, args?: ShellArgs, options?: ExecFileSyncOptions): string[];
+}
+
+/**
+ * shell implementation
+ */
+class ShellImpl implements IShell {
+    /**
+     * 执行同步命令
+     * @param command 命令
+     * @param args 执行参数
+     * @returns 输出字符串数组
+     */
+    execSync(command: string, args?: ShellArgs): string[] {
+        let lines = execSync(command).toString("utf-8").split(/\r?\n/);
+        if (args) {
+            if (args.excludeEmptyLine) {
+                lines = lines.filter(line => !!line);
+            }
+            if (args.trimLine) {
+                lines = lines.map(lines => lines.trim())
+            }
+        }
+        return lines;
+    }
+
+    execSyncTarget(target: string, args?: ShellArgs, options?: ExecFileSyncOptions): string[] {
+        let lines = execFileSync(target, options).toString('utf-8').split(/\r?\n/);
+        if (args) {
+            if (args.excludeEmptyLine) {
+                lines = lines.filter(line => !!line);
+            }
+            if (args.trimLine) {
+                lines = lines.map(lines => lines.trim())
+            }
+        }
+        return lines;
+    }
+}
+
+/**
+ * shell wrapper
+ */
+export class Shell {
+    private static _impl: IShell = new ShellImpl();
+
+    /**
+     * execute command
+     * @param command commanda
+     * @param formatArgs output format args
+     */
+    public static execSync(command: string, args?: ShellArgs): string[] {
+        return this._impl.execSync(command, args);
+    }
+
+    /**
+     * execute target
+     * @param target target path
+     * @param args args
+     * @param options options
+     */
+    public static execSyncTarget(target: string, args?: ShellArgs, options?: ExecFileSyncOptions): string[] {
+        return this._impl.execSyncTarget(target, args, options);
+    }
+}

package/packages/core/src/types/Constants.ts

@@ -0,0 +1,16 @@
+/**
+ * strings enum
+ */
+export enum STRINGS {
+    IS_DELETING = 'isDeleting_',
+    BOOLEAN_TRUE = 'Boolean:true',
+
+    OBJECT = '(object)',
+    CLOSURE = '(closure)',
+    FUNCTION = '(function)',
+    ARRAY = '(array)',
+    STRING = '(string)',
+
+    CONSTRUCTOR = 'constructor',
+    PROTO = '__proto__',
+}

package/packages/core/src/types/LeakTypes.ts

@@ -0,0 +1,21 @@
+import { LeakTracePathItem } from '@memlab/core'
+
+export interface ILeakBase {
+    nodeId: number;
+    startTime: number;
+    endTime: number;
+    duration?: number;  // leaked duration
+}
+
+export interface ILeakTrace extends ILeakBase {
+    trace: LeakTracePathItem,
+}
+
+export interface ILeakUnit extends ILeakBase {
+    trace: string[];
+}
+
+export interface ILeakResult {
+    related: Map<any, any>;
+    leaks: ILeakUnit[];
+}

package/packages/core/src/types/OhosTypes.ts

@@ -0,0 +1,115 @@
+/**
+ * interface for data info
+ */
+export interface IDataInfo {
+    type: string;
+    toString(): string;
+}
+
+/**
+ * os info
+ */
+export class OsInfo implements IDataInfo {
+    public type: string = "os";
+    public name: string;
+    public version?: string;
+
+    constructor(name?: string, version?: string) {
+        this.name = name || "ohos";
+        this.version = version;
+    }
+
+    public toString(): string {
+        return `${this.type} ${this.name} ${this.version}`;
+    }
+}
+
+/**
+ * device info
+ */
+export class DeviceInfo implements IDataInfo {
+    public type: string = 'ohos-device';
+    public deviceId: string;
+    public deviceName?: string;
+    public version?: string;
+
+    constructor(deviceId?: string) {
+        this.deviceId = deviceId || '';
+    }
+
+    public toString(): string {
+        return `${this.deviceId}`;
+    }
+}
+
+/**
+ * app info
+ */
+export class AppInfo implements IDataInfo {
+    public type: string = 'app';
+    public name: string;
+    public pid?: number;
+    public version?: string;
+ 
+    constructor(name?: string, pid?: number, version?: string) { 
+        this.name = name || '';
+        this.pid = pid;
+        this.version = version;
+    }
+
+    public toString(): string {
+        return `${this.name}`;
+    }
+}
+
+/**
+ * url info
+ */
+export class UrlInfo implements IDataInfo {
+    public type: string = 'url';
+    public url: string;
+    public mappingUrl?: string;
+ 
+    public toString(): string {
+        return `${this.url}`;
+    }
+}
+
+/**
+ * heap file info
+ */
+export class HeapFileInfo implements IDataInfo {
+    public type: string = 'heap';
+    public name: string;
+    public path: string;
+    public size?: number;
+    public region?: string;
+    public scene?: string;
+    public url?: UrlInfo;
+    public createTime?: number = 0;  // create time
+
+    constructor(path: string) {
+        this.path = path;
+    }
+
+    public toString(): string {
+        return `${this.name}:${this.path}`;
+    }
+}
+
+/**
+ * heap infos
+ */
+export class HeapInfos {
+    public osInfo?: OsInfo;
+    public deviceInfo?: DeviceInfo;
+    public appInfo?: AppInfo;
+    public heapFileInfo?: HeapFileInfo;
+    
+    constructor(os?: OsInfo, device?: DeviceInfo, app?: AppInfo, heapFile?: HeapFileInfo) {
+        this.osInfo = os;
+        this.deviceInfo = device;
+        this.appInfo = app;
+        this.heapFileInfo = heapFile;
+    }
+}

package/packages/core/src/utils/Common.ts

@@ -0,0 +1,37 @@
+/**
+ * T != null
+ * @param value T instance
+ * @returns true if T instance is not null or undefined
+ */
+export function isDefined<T>(value: T | null | undefined): value is T {
+    return value != null;
+}
+
+/**
+ * 格式化 Date 为指定字符串
+ * @param date 要格式化的日期（默认当前时间）
+ * @param format 格式模板：YYYY=年, MM=月, DD=日, HH=时, mm=分, ss=秒, SSS=毫秒
+ * @returns 格式化后的字符串
+ */
+export function formatDate(date: Date, format: string = 'YYYYMMDDHHmmss'): string {
+  // 补零函数：确保数字为两位数（如 9 → 09）
+  const padZero = (num: number, length = 2): string => num.toString().padStart(length, '0');
+
+  const year = date.getFullYear();
+  const month = padZero(date.getMonth() + 1); // 月份从 0 开始，需 +1
+  const day = padZero(date.getDate());
+  const hour = padZero(date.getHours());
+  const minute = padZero(date.getMinutes());
+  const second = padZero(date.getSeconds());
+  const millisecond = padZero(date.getMilliseconds(), 3); // 三位数毫秒
+
+  // 替换格式模板
+  return format
+    .replace('YYYY', year.toString())
+    .replace('MM', month)
+    .replace('DD', day)
+    .replace('HH', hour)
+    .replace('mm', minute)
+    .replace('ss', second)
+    .replace('SSS', millisecond);
+}