@hadss/hmrouter-plugin 1.1.0-beta.0 → 1.1.1-alpha.0

package/dist/hmrouter_extension/processor/ObfuscationProcessor.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObfuscationProcessor = void 0;
+const framework_1 = require("../../framework");
+const constants_1 = require("../constants");
+class ObfuscationProcessor {
+    constructor(context) {
+        this.context = context;
+    }
+    execute() {
+        framework_1.Logger.debug(this.context.node.getNodeName(), `Start to obfuscation...`);
+        if (!this.checkObfuscationEnabled()) {
+            framework_1.Logger.info(this.context.node.getNodeName(), 'This compilation does not turn on code obfuscation, skip hmrouter_obfuscation_rules.txt file generation');
+            return;
+        }
+        const obfuscationString = this.generateObfuscationRuleFile();
+        this.handleHarPackageLogic(obfuscationString);
+    }
+    checkObfuscationEnabled() {
+        return this.isEnableObfuscation();
+    }
+    generateObfuscationRuleFile() {
+        const obfuscationFilePath = framework_1.PluginFileUtil.pathResolve(this.context.config.modulePath, constants_1.FilePathConstants.OBFUSCATION_FILE_NAME);
+        const routerMap = JSON.parse(framework_1.PluginFileUtil.readFileSync(this.context.config.getRouterMapDir()).toString()).routerMap;
+        const obfuscationString = this.buildObfuscatedStrings(routerMap);
+        framework_1.PluginFileUtil.ensureFileSync(obfuscationFilePath);
+        framework_1.PluginFileUtil.writeFileSync(obfuscationFilePath, obfuscationString);
+        framework_1.Logger.info(this.context.node.getNodeName(), `Generate obfuscation rule file successfully, filePath: ${obfuscationFilePath}`);
+        return obfuscationString;
+    }
+    handleHarPackageLogic(obfuscationString) {
+        if (this.context.moduleContext.getModuleType() === constants_1.PluginConstants.HAR_MODULE_NAME) {
+            const consumerRulesPath = framework_1.PluginFileUtil.pathResolve(this.context.config.modulePath, constants_1.FilePathConstants.CONSUMER_FILE_NAME);
+            framework_1.PluginFileUtil.ensureFileSync(consumerRulesPath);
+            framework_1.PluginFileUtil.writeFileSync(consumerRulesPath, obfuscationString);
+        }
+    }
+    isEnableObfuscation() {
+        const currentBuildMode = framework_1.PluginStore.getInstance().get('buildMode');
+        const buildOption = this.context.moduleContext
+            ?.getBuildProfileOpt()
+            .buildOptionSet?.find((item) => item.name === currentBuildMode);
+        if (!buildOption) {
+            return false;
+        }
+        const arkOptions = framework_1.ObjectUtils.ensureNestedObject(buildOption, ['arkOptions']);
+        const obfuscationOptions = framework_1.ObjectUtils.ensureNestedObject(arkOptions, ['obfuscation']);
+        const ruleOptions = framework_1.ObjectUtils.ensureNestedObject(obfuscationOptions, ['ruleOptions']);
+        const isObfuscationEnabled = !!ruleOptions.enable;
+        if (!isObfuscationEnabled) {
+            return false;
+        }
+        if (this.context.config?.autoObfuscation) {
+            this.addHMRouterObfuscationRules(ruleOptions, obfuscationOptions);
+        }
+        return true;
+    }
+    addHMRouterObfuscationRules(ruleOptions, obfuscationOptions) {
+        const obfuscationFilePath = constants_1.FilePathConstants.CURRENT_DELIMITER + constants_1.FilePathConstants.OBFUSCATION_FILE_NAME;
+        ruleOptions.files = this.appendFilePathSafely(ruleOptions.files, obfuscationFilePath);
+        if (this.context.moduleContext.getModuleType() === constants_1.PluginConstants.HAR_MODULE_NAME) {
+            const consumerRulesPath = constants_1.FilePathConstants.CURRENT_DELIMITER + constants_1.FilePathConstants.CONSUMER_FILE_NAME;
+            obfuscationOptions.consumerFiles = this.appendFilePathSafely(obfuscationOptions.consumerFiles, consumerRulesPath);
+        }
+    }
+    appendFilePathSafely(target, filePath) {
+        if (typeof target === 'string') {
+            return target === filePath ? [target] : [target, filePath];
+        }
+        else if (Array.isArray(target)) {
+            if (!target.includes(filePath)) {
+                target.push(filePath);
+            }
+            return target;
+        }
+        else {
+            return [filePath];
+        }
+    }
+    buildObfuscatedStrings(routerMap) {
+        let srcPathArr = [
+            ...new Set(routerMap.map((routerInfo) => {
+                return constants_1.FilePathConstants.CURRENT_DELIMITER + routerInfo.pageSourceFile;
+            })),
+        ];
+        let classNameArr = [
+            ...new Set(routerMap
+                .filter((routerInfo) => {
+                return routerInfo.name.includes('__');
+            })
+                .map((routerInfo) => {
+                return routerInfo.customData.className;
+            })),
+        ];
+        let functionName = [
+            ...new Set(routerMap
+                .filter((routerInfo) => {
+                return routerInfo.name.includes(constants_1.PrefixConstants.SERVICE_PREFIX);
+            })
+                .map((routerInfo) => {
+                return routerInfo.customData.functionName;
+            })),
+        ];
+        let watchFunctionName = [
+            ...new Set(routerMap
+                .filter((routerInfo) => {
+                return routerInfo.buildFunction;
+            })
+                .map((routerInfo) => {
+                return routerInfo.buildFunction + constants_1.TemplateConstants.WARP_BUILDER;
+            })),
+        ];
+        return (constants_1.ObfuscationConstants.KEEP_FILE_NAME +
+            constants_1.FilePathConstants.LINE_BREAK +
+            srcPathArr
+                .concat(constants_1.ObfuscationConstants.KEEP_PROPERTY_NAME, functionName)
+                .concat(constants_1.ObfuscationConstants.KEEP_GLOBAL_NAME, classNameArr, watchFunctionName)
+                .join(constants_1.FilePathConstants.LINE_BREAK));
+    }
+}
+exports.ObfuscationProcessor = ObfuscationProcessor;

package/dist/hmrouter_extension/processor/ResourceProcessor.d.ts

@@ -0,0 +1,9 @@
+import { HMRouterExtensionContext } from '../HMRouterExtensionContext';
+export declare class ResourceProcessProcessor {
+    private context;
+    constructor(context: HMRouterExtensionContext);
+    execute(): void;
+    private copyRouterMapToRawFile;
+    private processHspModuleName;
+    private getRemoteHspModuleNames;
+}

package/dist/hmrouter_extension/processor/ResourceProcessor.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceProcessProcessor = void 0;
+const framework_1 = require("../../framework");
+const constants_1 = require("../constants");
+class ResourceProcessProcessor {
+    constructor(context) {
+        this.context = context;
+    }
+    execute() {
+        framework_1.Logger.debug(this.context.node.getNodeName(), `Start to copy router map to raw file...`);
+        this.copyRouterMapToRawFile();
+        this.processHspModuleName();
+    }
+    copyRouterMapToRawFile() {
+        let routerMapFilePath = framework_1.PluginFileUtil.pathResolve(this.context.currentTarget?.getBuildTargetOutputPath(), constants_1.FilePathConstants.TEMP_ROUTER_MAP_PATH, this.context.currentTarget?.getTargetName(), constants_1.RouterMapConstants.ROUTER_MAP_NAME);
+        let rawFilePath = this.context.config.getRawFilePath();
+        framework_1.PluginFileUtil.ensureFileSync(rawFilePath);
+        framework_1.PluginFileUtil.copyFileSync(routerMapFilePath, rawFilePath);
+        framework_1.Logger.info(this.context.node.getNodeName(), `Copy router map to raw file successfully, filePath: ${rawFilePath}`);
+    }
+    processHspModuleName() {
+        if (!(0, framework_1.isHapModule)(this.context.node)) {
+            return;
+        }
+        let rawFilePath = this.context.config.getRawFilePath();
+        let rawFileRouterMap = JSON.parse(framework_1.PluginFileUtil.readFileSync(rawFilePath).toString());
+        rawFileRouterMap.hspModuleNames = [...new Set(framework_1.PluginStore.getInstance().get('hspModuleNames'))];
+        rawFileRouterMap.hspModuleNames.push(...this.getRemoteHspModuleNames(this.context.node.getAllPluginIds()));
+        framework_1.PluginFileUtil.writeFileSync(rawFilePath, JSON.stringify(rawFileRouterMap));
+    }
+    getRemoteHspModuleNames(pluginIds) {
+        let remoteHspModuleNames = [];
+        try {
+            pluginIds.forEach((id) => {
+                let context = this.context.node.getContext(id);
+                let signedHspObj = context.getOhpmRemoteHspDependencyInfo(true);
+                let remoteHspObj = context.getOhpmRemoteHspDependencyInfo(false);
+                for (const key in signedHspObj) {
+                    remoteHspModuleNames.push(signedHspObj[key].name);
+                }
+                for (const key in remoteHspObj) {
+                    remoteHspModuleNames.push(remoteHspObj[key].name);
+                }
+            });
+        }
+        catch (error) {
+            framework_1.Logger.warn(this.context.node.getNodeName(), 'Your DevEco Studio version less than 5.0.3.800, may cause remote hsp dependencies get failed');
+        }
+        return remoteHspModuleNames;
+    }
+}
+exports.ResourceProcessProcessor = ResourceProcessProcessor;

package/dist/hmrouter_extension/processor/RouterMapBuildingProcessor.d.ts

@@ -0,0 +1,9 @@
+import { HMRouterExtensionContext } from '../HMRouterExtensionContext';
+export declare class RouterMapBuildingProcessor {
+    private context;
+    constructor(context: HMRouterExtensionContext);
+    execute(): void;
+    private buildRouterMap;
+    private generateRouterMapFile;
+    private readExistingRouterMap;
+}

package/dist/hmrouter_extension/processor/RouterMapBuildingProcessor.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouterMapBuildingProcessor = void 0;
+const framework_1 = require("../../framework");
+const constants_1 = require("../constants");
+const AnnotationAnalyzerRegistry_1 = require("../analyzer/AnnotationAnalyzerRegistry");
+const ConstantAnalyzer_1 = require("../analyzer/utils/ConstantAnalyzer");
+const PluginError_1 = require("../error/PluginError");
+class RouterMapBuildingProcessor {
+    constructor(context) {
+        this.context = context;
+    }
+    execute() {
+        framework_1.Logger.debug(this.context.node.getNodeName(), `Start to build router map...`);
+        this.readExistingRouterMap();
+        const constantResolver = AnnotationAnalyzerRegistry_1.AnnotationAnalyzerRegistry.getInstance().getConstantResolver();
+        const constantAnalyzer = new ConstantAnalyzer_1.ConstantAnalyzer(constantResolver);
+        constantAnalyzer.parseConstants(this.context.getAnalyzeResults());
+        for (const result of this.context.getAnalyzeResults()) {
+            this.buildRouterMap(result);
+        }
+        this.generateRouterMapFile();
+    }
+    buildRouterMap(result) {
+        if (!result.sourceFilePath) {
+            throw PluginError_1.PluginError.create(PluginError_1.ErrorCode.ERROR_PAGE_SOURCE_FILE, this.context.config.moduleName, result.sourceFilePath);
+        }
+        let pageSourceFile = this.context.config
+            .getRelativeSourcePath(result.sourceFilePath)
+            .replaceAll(constants_1.FilePathConstants.FILE_SEPARATOR, constants_1.FilePathConstants.DELIMITER);
+        if (result.annotation === constants_1.AnnotationConstants.ROUTER_ANNOTATION) {
+            let pageUrl = result.pageUrl;
+            let builderPath = this.context.generatedPaths.get(result.name) || '';
+            this.context.routerMap.push({
+                name: pageUrl,
+                pageSourceFile: builderPath,
+                buildFunction: result.name + 'Builder',
+                customData: result,
+            });
+            return;
+        }
+        const annotationConfig = {
+            [constants_1.AnnotationConstants.ANIMATOR_ANNOTATION]: {
+                prefix: constants_1.PrefixConstants.ANIMATOR_PREFIX,
+                propertyName: 'animatorName',
+                resultType: 'HMAnimatorResult',
+            },
+            [constants_1.AnnotationConstants.INTERCEPTOR_ANNOTATION]: {
+                prefix: constants_1.PrefixConstants.INTERCEPTOR_PREFIX,
+                propertyName: 'interceptorName',
+                resultType: 'HMInterceptorResult',
+            },
+            [constants_1.AnnotationConstants.LIFECYCLE_ANNOTATION]: {
+                prefix: constants_1.PrefixConstants.LIFECYCLE_PREFIX,
+                propertyName: 'lifecycleName',
+                resultType: 'HMLifecycleResult',
+            },
+            [constants_1.AnnotationConstants.SERVICE_ANNOTATION]: {
+                prefix: constants_1.PrefixConstants.SERVICE_PREFIX,
+                propertyName: 'serviceName',
+                resultType: 'HMServiceResult',
+            },
+            [constants_1.AnnotationConstants.SERVICE_PROVIDE_ANNOTATION]: {
+                prefix: constants_1.PrefixConstants.SERVICE_PROVIDE_PREFIX,
+                propertyName: 'serviceName',
+                resultType: 'HMServiceResult',
+            },
+        };
+        const config = annotationConfig[result.annotation];
+        const nameValue = result[config.propertyName];
+        const fullName = config.prefix + nameValue;
+        this.context.routerMap.push({
+            name: fullName,
+            pageSourceFile: pageSourceFile,
+            buildFunction: '',
+            customData: result,
+        });
+    }
+    generateRouterMapFile() {
+        let set = new Set();
+        this.context.routerMap.forEach((item) => {
+            if (set.has(item.name)) {
+                throw PluginError_1.PluginError.create(PluginError_1.ErrorCode.DUPLICATE_NAME, this.context.config.moduleName, item.name);
+            }
+            set.add(item.name);
+        });
+        let routerMap = {
+            routerMap: this.context.routerMap.map((item) => {
+                if (item.customData && item.customData.annotation) {
+                    delete item.customData.annotation;
+                    delete item.customData.sourceFilePath;
+                    delete item.customData.isDefaultExport;
+                    delete item.customData.templateData;
+                }
+                return item;
+            }),
+        };
+        const routerMapJsonStr = JSON.stringify(routerMap, null, 2);
+        const routerMapFilePath = this.context.config.getRouterMapDir();
+        framework_1.PluginFileUtil.ensureFileSync(routerMapFilePath);
+        framework_1.PluginFileUtil.writeFileSync(routerMapFilePath, routerMapJsonStr);
+        framework_1.Logger.info(this.context.node.getNodeName(), `hm_router_map.json has been generated in ${routerMapFilePath}`);
+    }
+    readExistingRouterMap() {
+        const moduleJsonOpt = this.context.moduleContext.getModuleJsonOpt();
+        if (!moduleJsonOpt?.module.routerMap) {
+            framework_1.Logger.debug(this.context.node.getNodeName(), `No routerMap found in the module configuration`);
+            return;
+        }
+        const routerMapFileName = moduleJsonOpt.module.routerMap.split(':')[1];
+        if (routerMapFileName !== 'hm_router_map') {
+            const routerMapFilePath = this.context.config.getModuleRouterMapFilePath(routerMapFileName);
+            const routerMapObj = framework_1.PluginFileUtil.readJson5(routerMapFilePath);
+            const systemRouterMap = routerMapObj[constants_1.RouterMapConstants.ROUTER_MAP_KEY];
+            if (systemRouterMap && systemRouterMap.length > 0) {
+                this.context.routerMap.unshift(...systemRouterMap);
+                framework_1.Logger.debug(this.context.node.getNodeName(), `System routerMap added to the current routerMap`);
+            }
+        }
+    }
+}
+exports.RouterMapBuildingProcessor = RouterMapBuildingProcessor;

package/dist/hmrouter_extension/processor/index.d.ts

@@ -0,0 +1,7 @@
+export * from './CodeGenerationProcessor';
+export * from './CompletionProcessor';
+export * from './ConfigUpdateProcessor';
+export * from './ObfuscationProcessor';
+export * from './InitializerProcessor';
+export * from './RouterMapBuildingProcessor';
+export * from './ResourceProcessor';

package/dist/hmrouter_extension/processor/index.js

@@ -0,0 +1,23 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CodeGenerationProcessor"), exports);
+__exportStar(require("./CompletionProcessor"), exports);
+__exportStar(require("./ConfigUpdateProcessor"), exports);
+__exportStar(require("./ObfuscationProcessor"), exports);
+__exportStar(require("./InitializerProcessor"), exports);
+__exportStar(require("./RouterMapBuildingProcessor"), exports);
+__exportStar(require("./ResourceProcessor"), exports);

package/examples/CustomExtension.ts

@@ -0,0 +1,256 @@
+/*
+ * 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.
+ */
+
+import { appTasks } from '@ohos/hvigor-ohos-plugin';
+import {
+  BaseAnalyzeResult,
+  ExtensionContext,
+  Logger,
+  PluginExtension,
+  registerPluginExtension
+} from '@hadss/hmrouter-plugin';
+import { ClassDeclaration, Expression, PropertyAssignment, SourceFile, SyntaxKind } from 'ts-morph';
+
+interface RouterInfo {
+  name: string;
+  pageSourceFile: string;
+  buildFunction: string;
+  customData: Record<string, any>;
+}
+
+interface MyExtensionContext extends ExtensionContext {
+  customPages?: RouterInfo[];
+  routerMap: RouterInfo[];
+}
+
+interface MyAnalyzeResult extends BaseAnalyzeResult {
+  [key: string]: any;
+}
+
+// 示例1: RouterParam注解分析器
+export class RouterParamAnalyzer {
+  readonly name = 'RouterParamAnalyzer';
+
+  analyze(sourceFile: SourceFile, filePath: string, context: MyExtensionContext): void {
+    Logger.debug('', `开始分析RouterParam注解: ${filePath}`);
+
+    // 获取所有ExpressionStatement以获取struct关键字后面的组件名称
+    const viewNameArr = sourceFile
+      .getChildrenOfKind(SyntaxKind.ExpressionStatement)
+      .map((node) => node.getText())
+      .filter((text) => text !== 'struct');
+
+    // 解析结构体声明中的RouterParam注解
+    sourceFile.getChildrenOfKind(SyntaxKind.MissingDeclaration).forEach((node, index) => {
+      node.getChildrenOfKind(SyntaxKind.Decorator).forEach((decorator) => {
+        if (decorator.getName() === "RouterParam") {
+          // 解析RouterParam注解的参数
+          const result: MyAnalyzeResult = {
+            name: viewNameArr[index],
+            annotation: decorator.getName(),
+            sourceFilePath: filePath
+          };
+
+          // 解析装饰器参数
+          decorator.getArguments().forEach((arg) => {
+            const objLiteral = arg.asKind(SyntaxKind.ObjectLiteralExpression);
+            if (objLiteral) {
+              objLiteral.getProperties().forEach((prop) => {
+                if (prop.getKind() === SyntaxKind.PropertyAssignment) {
+                  const propertyAssignment = prop as PropertyAssignment;
+                  const propertyName = propertyAssignment.getName();
+                  const initializer = propertyAssignment.getInitializer();
+
+                  if (initializer) {
+                    // 将解析结果添加到result对象
+                    result[propertyName] = this.parsePrimitiveValue(initializer);
+                  }
+                }
+              });
+            }
+          });
+
+          // 如果需要后续保存到路由表中请调用addAnalyzeResults添加分析结果
+          // context.addAnalyzeResults(result);
+
+          // 为组件添加模板数据，用于代码生成
+          context.addTemplateData(result.name, {
+            paramType: result['paramType'] || 'default',
+            isCustomParam: true,
+            customParams: result['params'] || [],
+            sourceFile: filePath
+          });
+
+          Logger.debug('', `发现RouterParam注解: ${result.name}`);
+        }
+      });
+    });
+  }
+
+  private parsePrimitiveValue(value: Expression): any {
+    let propertyValue;
+    switch (value.getKind()) {
+      case SyntaxKind.StringLiteral:
+        propertyValue = value.asKind(SyntaxKind.StringLiteral)?.getLiteralValue();
+        break;
+      case SyntaxKind.NumericLiteral:
+        propertyValue = value.asKind(SyntaxKind.NumericLiteral)?.getLiteralValue();
+        break;
+      case SyntaxKind.TrueKeyword:
+        propertyValue = true;
+        break;
+      case SyntaxKind.FalseKeyword:
+        propertyValue = false;
+        break;
+      case SyntaxKind.ArrayLiteralExpression:
+        propertyValue = value
+          .asKind(SyntaxKind.ArrayLiteralExpression)
+          ?.getElements()
+          .map((item) => {
+            if (item.getKind() === SyntaxKind.StringLiteral) {
+              return item.asKind(SyntaxKind.StringLiteral)?.getLiteralValue();
+            }
+            return null;
+          })
+          .filter(item => item !== null);
+        break;
+    }
+    return propertyValue;
+  }
+}
+
+// 示例2: CustomPage注解分析器
+export class CustomPageAnalyzer {
+  readonly name = 'CustomPageAnalyzer';
+
+  analyze(sourceFile: SourceFile, filePath: string, context: MyExtensionContext): void {
+    Logger.debug('', `开始分析CustomPage注解: ${filePath}`);
+
+    // 分析使用@CustomPage注解的类
+    sourceFile.getClasses().forEach((cls: ClassDeclaration) => {
+      cls.getDecorators().forEach(decorator => {
+        if (decorator.getName() === 'CustomPage') {
+          const className = cls.getName() || '';
+
+          // 创建分析结果
+          const result: MyAnalyzeResult = {
+            name: className,
+            annotation: 'CustomPage',
+            sourceFilePath: filePath
+          };
+
+          // 解析装饰器参数
+          decorator.getArguments().forEach((arg) => {
+            const objLiteral = arg.asKind(SyntaxKind.ObjectLiteralExpression);
+            if (objLiteral) {
+              objLiteral.getProperties().forEach((prop) => {
+                if (prop.getKind() === SyntaxKind.PropertyAssignment) {
+                  const propertyAssignment = prop as PropertyAssignment;
+                  const propertyName = propertyAssignment.getName();
+                  const initializer = propertyAssignment.getInitializer();
+
+                  if (initializer && initializer.getKind() === SyntaxKind.StringLiteral) {
+                    result[propertyName] = initializer.asKind(SyntaxKind.StringLiteral)?.getLiteralValue();
+                  }
+                }
+              });
+            }
+          });
+
+          // 添加分析结果
+          context.addAnalyzeResults(result);
+
+          // 存储自定义页面路径信息
+          const customPages = context.customPages || [];
+          customPages.push(result);
+          context.customPages = customPages;
+
+          Logger.debug('', `发现CustomPage注解: ${className}, pageUrl: ${result['pageUrl']}`);
+        }
+      });
+    });
+  }
+}
+
+// 插件扩展类
+export class CustomPluginExtension extends PluginExtension<MyExtensionContext> {
+  get name(): string {
+    return 'CustomPluginExtension';
+  }
+
+  // 提供注解分析器
+  afterAnnotationAnalysis(sourceFile: SourceFile, filePath: string, context: MyExtensionContext): void {
+    const analyzers = [new RouterParamAnalyzer(), new CustomPageAnalyzer()];
+    for (const analyzer of analyzers) {
+      analyzer.analyze(sourceFile, filePath, context);
+    }
+  }
+
+  // 代码生成阶段，可以使用RouterParam注解分析结果
+  afterCodeGeneration(context: MyExtensionContext): void {
+    // 获取所有模板数据
+    const templateDataMap = context.getTemplateDataMap();
+
+    // 示例: 输出找到的RouterParam数据
+    for (const [componentName, templateData] of templateDataMap.entries()) {
+      if (templateData.isCustomParam) {
+        Logger.info(
+          this.name,
+          `组件 ${componentName} 将使用自定义参数类型: ${templateData.paramType}`
+        );
+        // 实际场景可以在此生成额外的代码
+      }
+    }
+  }
+
+  // 路由表构建阶段，将CustomPage注解分析结果添加到路由表
+  afterRouterMapBuilding(context: MyExtensionContext): void {
+    // 从私有存储获取CustomPage分析结果
+    const customPages = context.customPages || [];
+
+    // 将CustomPage添加到路由表
+    for (const page of customPages) {
+      const pageUrl = page.customData['pageUrl'];
+      if (pageUrl) {
+        // 检查路由表中是否已存在该路径
+        const existingRoute = context.routerMap.find(route => route.customData.pageUrl === pageUrl);
+        if (!existingRoute) {
+          // 创建新的路由项并添加到路由表
+          context.routerMap.push({
+            name: pageUrl,
+            buildFunction: page.name,
+            pageSourceFile: page.pageSourceFile,
+            customData: {
+              ...page.customData,
+            }
+          });
+
+          Logger.info(
+            this.name,
+            `添加自定义页面到路由表: ${pageUrl} -> ${page.name}`
+          );
+        }
+      }
+    }
+  }
+}
+
+// 注册扩展
+registerPluginExtension(new CustomPluginExtension());
+
+export default {
+  system: appTasks,
+  plugins: []
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hadss/hmrouter-plugin",
-  "version": "1.1.0-beta.0",
+  "version": "1.1.1-alpha.0",
   "description": "HMRouter Compiler Plugin",
   "main": "dist/Index.js",
   "scripts": {
@@ -42,7 +42,7 @@
   "homepage": "https://gitcode.com/openharmony-sig/ohrouter",
   "repository": {
     "type": "git",
-    "url": "git+https://gitcode.com/openharmony-sig/ohrouter.git",
+    "url": "https://gitcode.com/openharmony-sig/ohrouter.git",
     "directory": "HMRouterPlugin"
   }
 }

package/template/customBuilder.ejs

@@ -13,6 +13,7 @@
  * limitations under the License.
  */
 
+// instrument ignore file
 // auto-generated <%= componentName %>Builder.ets by HMRouter
 import <%if(isDefaultExport) {%> <%= componentName %> <% } else {%> { <%= componentName %> } <% } %> from '<%= importPath %>'
 

package/template/viewBuilder.ejs

@@ -13,6 +13,7 @@
  * limitations under the License.
  */
 
+// instrument ignore file
 // auto-generated <%= componentName %>Builder.ets by HMRouter
 import <%if(isDefaultExport) {%> <%= componentName %> <% } else {%> { <%= componentName %> } <% } %> from '<%= importPath %>'
 import { NavDestinationHelper } from '@hadss/hmrouter';