arkanalyzer 1.0.5

package/lib/Config.js

@@ -0,0 +1,128 @@
+"use strict";
+/*
+ * Copyright (c) 2024 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneConfig = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = __importStar(require("./utils/logger"));
+const getAllFiles_1 = require("./utils/getAllFiles");
+const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'Config');
+class SceneConfig {
+    constructor() {
+        this.targetProjectName = "";
+        this.targetProjectDirectory = "";
+        this.etsSdkPath = "";
+        this.sdksObj = [];
+        this.sdkFiles = [];
+        this.sdkFilesMap = new Map();
+        this.projectFiles = [];
+    }
+    buildConfig(targetProjectName, targetProjectDirectory, sdks, fullFilePath) {
+        this.targetProjectName = targetProjectName;
+        this.targetProjectDirectory = targetProjectDirectory;
+        this.sdksObj = sdks;
+        if (fullFilePath) {
+            this.projectFiles.push(...fullFilePath);
+        }
+    }
+    buildFromProjectDir(targetProjectDirectory) {
+        this.targetProjectDirectory = targetProjectDirectory;
+        this.targetProjectName = path_1.default.basename(targetProjectDirectory);
+        this.projectFiles = (0, getAllFiles_1.getAllFiles)(targetProjectDirectory, ['.ets', '.ts']);
+    }
+    buildFromJson(configJsonPath) {
+        if (fs_1.default.existsSync(configJsonPath)) {
+            let configurationsText;
+            try {
+                configurationsText = fs_1.default.readFileSync(configJsonPath, 'utf-8');
+            }
+            catch (error) {
+                logger.error(`Error reading file: ${error}`);
+                return;
+            }
+            logger.info(configurationsText);
+            let configurations;
+            try {
+                configurations = JSON.parse(configurationsText);
+            }
+            catch (error) {
+                logger.error(`Error parsing JSON: ${error}`);
+                return;
+            }
+            const targetProjectName = configurations.targetProjectName
+                ? configurations.targetProjectName
+                : '';
+            const targetProjectDirectory = configurations.targetProjectDirectory
+                ? configurations.targetProjectDirectory
+                : '';
+            const sdks = configurations.sdks
+                ? configurations.sdks
+                : [];
+            this.buildConfig(targetProjectName, targetProjectDirectory, sdks);
+        }
+        else {
+            logger.error(`Your configJsonPath: "${configJsonPath}" is not exist.`);
+        }
+    }
+    getTargetProjectName() {
+        return this.targetProjectName;
+    }
+    getTargetProjectDirectory() {
+        return this.targetProjectDirectory;
+    }
+    getProjectFiles() {
+        return this.projectFiles;
+    }
+    getSdkFiles() {
+        return this.sdkFiles;
+    }
+    getSdkFilesMap() {
+        return this.sdkFilesMap;
+    }
+    getEtsSdkPath() {
+        return this.etsSdkPath;
+    }
+    getSdksObj() {
+        return this.sdksObj;
+    }
+}
+exports.SceneConfig = SceneConfig;

package/lib/Scene.d.ts

@@ -0,0 +1,125 @@
+import { SceneConfig, Sdk } from './Config';
+import { VisibleValue } from './core/common/VisibleValue';
+import { ArkClass } from './core/model/ArkClass';
+import { ArkFile } from './core/model/ArkFile';
+import { ArkMethod } from './core/model/ArkMethod';
+import { ArkNamespace } from './core/model/ArkNamespace';
+import { ClassSignature, FileSignature, MethodSignature, NamespaceSignature } from './core/model/ArkSignature';
+import { Local } from './core/base/Local';
+import { ArkExport } from './core/model/ArkExport';
+import { CallGraph } from './callgraph/model/CallGraph';
+declare enum SceneBuildStage {
+    BUILD_INIT = 0,
+    CLASS_DONE = 1,
+    METHOD_DONE = 2
+}
+/**
+ * The Scene class includes everything in the analyzed project.
+ * We should be able to re-generate the project's code based on this class.
+ */
+export declare class Scene {
+    private projectName;
+    private projectFiles;
+    private realProjectDir;
+    private moduleScenesMap;
+    private modulePath2NameMap;
+    private globalImportInfos;
+    private moduleSdkMap;
+    private projectSdkMap;
+    private visibleValue;
+    private filesMap;
+    private namespacesMap;
+    private classesMap;
+    private methodsMap;
+    private sdkArkFilesMap;
+    private sdkGlobalMap;
+    private ohPkgContentMap;
+    private ohPkgFilePath;
+    private ohPkgContent;
+    private buildStage;
+    constructor();
+    getStage(): SceneBuildStage;
+    buildSceneFromProjectDir(sceneConfig: SceneConfig): void;
+    buildBasicInfo(sceneConfig: SceneConfig): void;
+    private addDefaultConstructors;
+    private buildAllMethodBody;
+    private genArkFiles;
+    private buildSdk;
+    buildScene4HarmonyProject(): void;
+    buildModuleScene(moduleName: string, modulePath: string): void;
+    getRealProjectDir(): string;
+    getProjectName(): string;
+    getProjectFiles(): string[];
+    getSdkGlobal(globalName: string): ArkExport | null;
+    getFile(fileSignature: FileSignature): ArkFile | null;
+    getFiles(): ArkFile[];
+    getSdkArkFilesMap(): Map<string, ArkFile>;
+    getModuleSdkMap(): Map<string, Sdk[]>;
+    getProjectSdkMap(): Map<string, Sdk>;
+    getFilesMap(): Map<string, ArkFile>;
+    getNamespace(namespaceSignature: NamespaceSignature): ArkNamespace | null;
+    private getNamespacesMap;
+    getNamespaces(): ArkNamespace[];
+    getClass(classSignature: ClassSignature, refresh?: boolean): ArkClass | null;
+    private getClassesMap;
+    getClasses(refresh?: boolean): ArkClass[];
+    getMethod(methodSignature: MethodSignature, refresh?: boolean): ArkMethod | null;
+    private getMethodsMap;
+    getMethods(refresh?: boolean): ArkMethod[];
+    addToMethodsMap(method: ArkMethod): void;
+    hasMainMethod(): boolean;
+    getEntryPoints(): never[];
+    /** get values that is visible in curr scope */
+    getVisibleValue(): VisibleValue;
+    getOhPkgContent(): {
+        [k: string]: unknown;
+    };
+    getOhPkgContentMap(): Map<string, {
+        [k: string]: unknown;
+    }>;
+    getOhPkgFilePath(): string;
+    makeCallGraphCHA(entryPoints: MethodSignature[]): CallGraph;
+    makeCallGraphRTA(entryPoints: MethodSignature[]): CallGraph;
+    /**
+     * inference type for each non-default method
+     * because default and generated method was finished
+     */
+    inferTypes(): void;
+    /**
+     * @Deprecated
+     */
+    inferSimpleTypes(): void;
+    collectProjectImportInfos(): void;
+    getClassMap(): Map<FileSignature | NamespaceSignature, ArkClass[]>;
+    getGlobalVariableMap(): Map<FileSignature | NamespaceSignature, Local[]>;
+    getStaticInitMethods(): ArkMethod[];
+    buildClassDone(): boolean;
+    getModuleScene(moduleName: string): ModuleScene | undefined;
+    getModuleSceneMap(): Map<string, ModuleScene>;
+}
+export declare class ModuleScene {
+    private projectScene;
+    private moduleName;
+    private modulePath;
+    private moduleOhPkgFilePath;
+    private ohPkgContent;
+    constructor();
+    ModuleScenBuilder(moduleName: string, modulePath: string, projectScene: Scene, recursively?: boolean): void;
+    /**
+     * get oh-package.json5
+     */
+    private getModuleOhPkgFilePath;
+    /**
+     * get nodule name
+     * @returns return module name
+     */
+    getModuleName(): string;
+    getModulePath(): string;
+    getOhPkgFilePath(): string;
+    getOhPkgContent(): {
+        [k: string]: unknown;
+    };
+    private genArkFiles;
+}
+export {};
+//# sourceMappingURL=Scene.d.ts.map

package/lib/Scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../src/Scene.ts"],"names":[],"mappings":"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"}