hcordova 1.0.0

package/src/utils/PluginConfigParser.js

@@ -0,0 +1,408 @@
+/*
+ * Copyright (c) 2025 Huawei Device, Inc. Ltd. and <马弓手>.
+ *
+ * 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.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+class PluginConfigParser {
+    constructor(api) {
+        this.api = api;
+        this.events = api.events;
+    }
+
+    /**
+     * 解析插件配置
+     */
+    parse(pluginDir, pluginId, pluginPackage) {
+        const pluginXmlPath = path.join(pluginDir, 'plugin.xml');
+        
+        if (!fs.existsSync(pluginXmlPath)) {
+            throw new Error(`plugin.xml not found in plugin directory: ${pluginDir}`);
+        }
+        
+        try {
+            const pluginXmlContent = fs.readFileSync(pluginXmlPath, 'utf8');
+            return this._parsePluginXml(pluginXmlContent, pluginDir, pluginId, pluginPackage);
+        } catch (error) {
+            throw new Error(`Failed to parse plugin.xml: ${error.message}`);
+        }
+    }
+
+    /**
+     * 解析plugin.xml内容
+     */
+    _parsePluginXml(xmlContent, pluginDir, pluginId, pluginPackage) {
+        const config = {
+            id: this._parsePluginId(pluginId),
+            dir: pluginDir,
+            package: pluginPackage,
+            name: this._extractTextContent(xmlContent, 'name'),
+            description: this._extractTextContent(xmlContent, 'description'),
+            license: this._extractTextContent(xmlContent, 'license'),
+            keywords: this._extractKeywords(xmlContent),
+            repo: this._extractTextContent(xmlContent, 'repo'),
+            issue: this._extractTextContent(xmlContent, 'issue'),
+            engines: this._parseEngines(xmlContent),
+            preferences: this._parsePreferences(xmlContent), // 新增：解析preference变量
+            dependencies:  this._parseDependencies(xmlContent), // 添加依赖解析
+            platform: {},
+            
+        };
+
+        // 解析平台特定配置
+        const platformMatch = xmlContent.match(/<platform\s+name="ohos">([\s\S]*?)<\/platform>/);
+        if (platformMatch) {
+            config.platform = this._parseOhosPlatformConfig(platformMatch[1], pluginDir);
+        }
+
+        return config;
+    }
+
+    _parsePluginId(pluginId) {
+        pluginId = pluginId.trim();
+        
+        // 1. Git URL - 返回仓库名（去掉.git后缀）
+        if (pluginId.startsWith('http') || pluginId.startsWith('git@') || pluginId.endsWith('.git')) {
+            return pluginId.split('/').pop().replace('.git', '');
+        }
+
+        // 2. 本地路径 - 返回目录名
+        if (pluginId.includes('\\') || pluginId.includes('/') || pluginId.startsWith('.') || path.isAbsolute(pluginId)) {
+            return path.basename(pluginId);
+        }
+        
+        // 3. 直接返回插件ID
+        return pluginId;
+    }
+    /**
+     * 提取文本内容
+     */
+    _extractTextContent(xmlContent, tagName) {
+        const match = xmlContent.match(new RegExp(`<${tagName}>([\\s\\S]*?)<\/${tagName}>`));
+        return match ? match[1].trim() : null;
+    }
+
+    /**
+     * 提取关键词
+     */
+    _extractKeywords(xmlContent) {
+        const keywordsMatch = xmlContent.match(/<keywords>([\s\S]*?)<\/keywords>/);
+        if (!keywordsMatch) return [];
+        
+        const keywordsText = keywordsMatch[1].trim();
+        return keywordsText.split(',').map(k => k.trim()).filter(k => k);
+    }
+
+    /**
+     * 解析引擎要求
+     */
+    _parseEngines(xmlContent) {
+        const engines = {};
+        const engineMatches = xmlContent.match(/<engine\s+name="([^"]+)"\s+version="([^"]+)"\s*\/>/g) || [];
+        
+        engineMatches.forEach(match => {
+            const nameMatch = match.match(/name="([^"]+)"/);
+            const versionMatch = match.match(/version="([^"]+)"/);
+            if (nameMatch && versionMatch) {
+                engines[nameMatch[1]] = versionMatch[1];
+            }
+        });
+        
+        return engines;
+    }
+
+    /**
+     * 解析preference变量声明
+     */
+    _parsePreferences(xmlContent) {
+        const preferences = {};
+        const preferenceMatches = xmlContent.match(/<preference\s+name="([^"]+)"\s+default="([^"]*)"(?:\s+required="([^"]*)")?\s*\/>/g) || [];
+        
+        preferenceMatches.forEach(match => {
+            const nameMatch = match.match(/name="([^"]+)"/);
+            const defaultMatch = match.match(/default="([^"]*)"/);
+            const requiredMatch = match.match(/required="([^"]*)"/);
+            
+            if (nameMatch) {
+                const name = nameMatch[1];
+                const defaultValue = defaultMatch ? defaultMatch[1] : '';
+                const required = requiredMatch ? requiredMatch[1].toLowerCase() === 'true' : false;
+                
+                preferences[name] = {
+                    name: name,
+                    default: defaultValue,
+                    required: required
+                };
+            }
+        });
+        
+        return preferences;
+    }
+
+    /**
+     * 解析鸿蒙平台特定配置
+     */
+    _parseOhosPlatformConfig(platformContent, pluginDir) {
+        const config = {
+            configFiles: [],
+            cmakeConfigs: [],
+            sourceFiles: [],
+            jsModules: [],
+            features: [],
+            preferences: this._parsePlatformPreferences(platformContent) // 新增：解析平台特定的preference
+        };
+
+        // 解析config-file元素
+        const configFileMatches = platformContent.match(/<config-file\s+target="([^"]+)"\s+parent="([^"]*)"(?:\s+modules-targets-name="([^"]*)")?\s*>([\s\S]*?)<\/config-file>/g) || [];
+        config.configFiles = configFileMatches.map(match => {
+            const targetMatch = match.match(/target="([^"]+)"/);
+            const parentMatch = match.match(/parent="([^"]*)"/);
+            const modulesTargetsNameMatch = match.match(/modules-targets-name="([^"]*)"/);
+            const content = this._extractTagContent(match, 'config-file');
+            
+            return {
+                target: targetMatch ? targetMatch[1] : null,
+                parent: parentMatch ? parentMatch[1] : '/*',
+                modulesTargetsName: modulesTargetsNameMatch ? modulesTargetsNameMatch[1] : 'default',
+                content: content,
+                type: 'config-file'
+            };
+        });
+
+        // 解析CMakeLists元素
+        const cmakeMatches = platformContent.match(/<CMakeLists\s+target="([^"]+)"\s+modules-name="([^"]*)"\s*>([\s\S]*?)<\/CMakeLists>/g) || [];
+        config.cmakeConfigs = cmakeMatches.map(match => {
+            const targetMatch = match.match(/target="([^"]+)"/);
+            const modulesNameMatch = match.match(/modules-name="([^"]*)"/);
+            const content = this._extractTagContent(match, 'CMakeLists');
+            
+            // 解析CMakeLists中的param元素
+            const params = [];
+            const paramMatches = content.match(/<param\s+target="([^"]+)"\s+value="([^"]+)"\s*\/>/g) || [];
+            paramMatches.forEach(paramMatch => {
+                const targetMatch = paramMatch.match(/target="([^"]+)"/);
+                const valueMatch = paramMatch.match(/value="([^"]+)"/);
+                if (targetMatch && valueMatch) {
+                    params.push({
+                        target: targetMatch[1],
+                        value: valueMatch[1]
+                    });
+                }
+            });
+            
+            return {
+                target: targetMatch ? targetMatch[1] : null,
+                modulesName: modulesNameMatch ? modulesNameMatch[1] : 'cordova',
+                params: params,
+                type: 'cmake-config'
+            };
+        });
+
+        // 解析source-file元素
+        const sourceFileMatches = platformContent.match(/<source-file\s+type="([^"]+)"\s+src="([^"]+)"\s+target-dir="([^"]+)"(?:\s+modules-name="([^"]*)")?(?:\s+runtimeOnly="([^"]*)")?\s*\/>/g) || [];
+        config.sourceFiles = sourceFileMatches.map(match => {
+            const typeMatch = match.match(/type="([^"]+)"/);
+            const srcMatch = match.match(/src="([^"]+)"/);
+            const targetDirMatch = match.match(/target-dir="([^"]+)"/);
+            const modulesNameMatch = match.match(/modules-name="([^"]*)"/);
+            const runtimeOnlyMatch = match.match(/runtimeOnly="([^"]*)"/);
+            
+            return {
+                type: typeMatch ? typeMatch[1] : null, // h, cpp 等
+                src: srcMatch ? srcMatch[1] : null,
+                targetDir: targetDirMatch ? targetDirMatch[1] : null,
+                modulesName: modulesNameMatch ? modulesNameMatch[1] : 'cordova',
+                runtimeOnly: runtimeOnlyMatch ? runtimeOnlyMatch[1].toLowerCase() === 'true' : false,
+                fileType: 'source-file'
+            };
+        });
+
+        // 解析js-module元素
+        const jsModuleMatches = platformContent.match(/<js-module\s+src="([^"]+)"\s+name="([^"]+)"(?:\s+modules-targets-name="([^"]*)")?\s*>([\s\S]*?)<\/js-module>/g) || [];
+        config.jsModules = jsModuleMatches.map(match => {
+            const srcMatch = match.match(/src="([^"]+)"/);
+            const nameMatch = match.match(/name="([^"]+)"/);
+            const modulesTargetsNameMatch = match.match(/modules-targets-name="([^"]*)"/);
+            const content = this._extractTagContent(match, 'js-module');
+            
+            // 解析clobbers元素
+            const clobbers = [];
+            const clobberMatches = content.match(/<clobbers\s+target="([^"]+)"\s*\/>/g) || [];
+            clobberMatches.forEach(clobberMatch => {
+                const targetMatch = clobberMatch.match(/target="([^"]+)"/);
+                if (targetMatch) {
+                    clobbers.push({
+                        target: targetMatch[1]
+                    });
+                }
+            });
+            
+            return {
+                src: srcMatch ? srcMatch[1] : null,
+                name: nameMatch ? nameMatch[1] : null,
+                modulesTargetsName: modulesTargetsNameMatch ? modulesTargetsNameMatch[1] : 'default',
+                clobbers: clobbers,
+                type: 'js-module'
+            };
+        });
+
+        // 解析config-file中的feature元素
+        config.configFiles.forEach(configFile => {
+            const featureMatches = configFile.content.match(/<feature\s+name="([^"]+)">([\s\S]*?)<\/feature>/g) || [];
+            featureMatches.forEach(featureMatch => {
+                const nameMatch = featureMatch.match(/name="([^"]+)"/);
+                const content = this._extractTagContent(featureMatch, 'feature');
+                
+                if (nameMatch) {
+                    const feature = {
+                        name: nameMatch[1],
+                        params: []
+                    };
+                    
+                    // 解析feature中的param元素
+                    const paramMatches = content.match(/<param\s+name="([^"]+)"\s+value="([^"]+)"\s*\/>/g) || [];
+                    paramMatches.forEach(paramMatch => {
+                        const nameMatch = paramMatch.match(/name="([^"]+)"/);
+                        const valueMatch = paramMatch.match(/value="([^"]+)"/);
+                        if (nameMatch && valueMatch) {
+                            feature.params.push({
+                                name: nameMatch[1],
+                                value: valueMatch[1]
+                            });
+                        }
+                    });
+                    
+                    config.features.push(feature);
+                }
+            });
+        });
+
+        return config;
+    }
+
+    /**
+     * 解析平台特定的preference变量
+     */
+    _parsePlatformPreferences(platformContent) {
+        const preferences = {};
+        const preferenceMatches = platformContent.match(/<preference\s+name="([^"]+)"\s+default="([^"]*)"(?:\s+required="([^"]*)")?\s*\/>/g) || [];
+        
+        preferenceMatches.forEach(match => {
+            const nameMatch = match.match(/name="([^"]+)"/);
+            const defaultMatch = match.match(/default="([^"]*)"/);
+            const requiredMatch = match.match(/required="([^"]*)"/);
+            
+            if (nameMatch) {
+                const name = nameMatch[1];
+                const defaultValue = defaultMatch ? defaultMatch[1] : '';
+                const required = requiredMatch ? requiredMatch[1].toLowerCase() === 'true' : false;
+                
+                preferences[name] = {
+                    name: name,
+                    default: defaultValue,
+                    required: required,
+                    platformSpecific: true
+                };
+            }
+        });
+        
+        return preferences;
+    }
+
+    /**
+     * 提取标签内容
+     */
+    _extractTagContent(xml, tagName) {
+        const regex = new RegExp(`<${tagName}[^>]*>([\\s\\S]*?)<\/${tagName}>`);
+        const match = xml.match(regex);
+        return match ? match[1].trim() : '';
+    }
+
+     /**
+     * 解析依赖项
+     */
+    _parseDependencies(xmlContent) {
+        const dependencies = [];
+        const dependencyMatches = xmlContent.match(/<dependency\s+([^>]+)\s*\/>/g) || [];
+        
+        dependencyMatches.forEach(match => {
+            const dependency = {};
+            
+            // 解析 id 属性
+            const idMatch = match.match(/id="([^"]+)"/);
+            if (idMatch) {
+                dependency.id = idMatch[1];
+            }
+            
+            // 解析 url 属性
+            const urlMatch = match.match(/url="([^"]+)"/);
+            if (urlMatch) {
+                dependency.url = urlMatch[1];
+            }
+            
+            // 解析 commit 属性
+            const commitMatch = match.match(/commit="([^"]+)"/);
+            if (commitMatch) {
+                dependency.commit = commitMatch[1];
+            }
+            
+            // 解析 branch 属性
+            const branchMatch = match.match(/branch="([^"]+)"/);
+            if (branchMatch) {
+                dependency.branch = branchMatch[1];
+            }
+            
+            // 解析 version 属性
+            const versionMatch = match.match(/version="([^"]+)"/);
+            if (versionMatch) {
+                dependency.version = versionMatch[1];
+            }
+            
+            // 解析 subdir 属性
+            const subdirMatch = match.match(/subdir="([^"]+)"/);
+            if (subdirMatch) {
+                dependency.subdir = subdirMatch[1];
+            }
+            
+            // 只有包含有效 id 的依赖才添加到列表
+            if (dependency.id) {
+                dependencies.push(dependency);
+            }
+        });
+        
+        return dependencies;
+    }
+
+    /**
+     * 读取插件的package.json
+     */
+    readPluginPackage(pluginDir) {
+        const packageJsonPath = path.join(pluginDir, 'package.json');
+        
+        if (!fs.existsSync(packageJsonPath)) {
+            throw new Error(`package.json not found in plugin directory: ${pluginDir}`);
+        }
+        
+        try {
+            const packageJsonContent = fs.readFileSync(packageJsonPath, 'utf8');
+            return JSON.parse(packageJsonContent);
+        } catch (error) {
+            throw new Error(`Failed to parse package.json: ${error.message}`);
+        }
+    }
+}
+
+module.exports = PluginConfigParser;

package/src/utils/PluginDownloader.js

@@ -0,0 +1,181 @@
+/*
+ * Copyright (c) 2025 Huawei Device, Inc. Ltd. and <马弓手>.
+ *
+ * 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.
+ */
+
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+
+class PluginDownloader {
+    constructor(api) {
+        this.api = api;
+        this.events = api.events;
+    }
+
+    /**
+     * 下载插件
+     * @param {string} pluginId - 插件ID（可以是路径、git地址、npm包名）
+     * @param {string} targetDir - 目标目录
+     * @param {Object} options - 选项
+     * @returns {Promise<string>} 插件本地路径
+     */
+    async download(pluginId, targetDir, options = {}) {
+        this.events.emit('log', `Downloading plugin: ${pluginId}`);
+        
+        try {
+            // 判断插件来源类型
+            const sourceType = this._getSourceType(pluginId);
+            switch (sourceType) {
+                case 'local':
+                    return await this._handleLocalPlugin(pluginId, targetDir);
+                case 'git':
+                    return await this._handleGitPlugin(pluginId, targetDir, options);
+                default:
+                    throw new Error(`Unsupported plugin source: ${pluginId}`);
+            }
+        } catch (error) {
+            this.events.emit('error', `Failed to download plugin ${pluginId}: ${error.message}`);
+            throw error;
+        }
+    }
+
+    /**
+     * 获取插件来源类型
+     */
+    _getSourceType(pluginId) {
+        if (fs.existsSync(pluginId)) {
+            return 'local';
+        } else if (pluginId.startsWith('git+') || 
+                   pluginId.includes('.git') || 
+                   pluginId.includes('github.com') || 
+                   pluginId.includes('gitee.com') ||
+                    pluginId.includes('gitcode.com')) {
+            return 'git';
+        } else {
+            return 'git'; // 假设HTTP/HTTPS链接也是git仓库
+        }
+    }
+
+    /**
+     * 处理本地插件
+     */
+    async _handleLocalPlugin(pluginPath, targetDir) {
+        this.events.emit('log', `Handling local plugin: ${pluginPath}`);
+        
+        const absolutePath = path.resolve(pluginPath);
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`Local plugin path does not exist: ${absolutePath}`);
+        }
+
+        try{
+            // 如果是目录，直接返回路径
+            const stats = fs.statSync(absolutePath);
+            if (stats.isDirectory()) {
+                const pluginName = this._extractPluginName(pluginPath);
+                const targetPath = path.join(targetDir, pluginName);
+                this.copyDir(absolutePath, targetPath);
+                return targetPath;
+            }
+        } catch (error)  {
+            this.events.emit('Error', `copy file failed: ${error.message}`);
+        }
+        // 如果是文件，可能是压缩包，需要解压
+        throw new Error('File-based plugins not yet supported, please use directory or git repository');
+    }
+
+    /**
+     * 处理Git插件
+     */
+    async _handleGitPlugin(gitUrl, targetDir, options) {
+        if(!gitUrl.startsWith('http://') && !gitUrl.startsWith('https://')) {
+            gitUrl = "https://gitcode.com/OpenHarmony-Cordova/"+gitUrl+".git";
+        }
+        this.events.emit('log', `Cloning git repository: ${gitUrl}`);
+        
+        const pluginName = this._extractPluginName(gitUrl);
+        const pluginDir = path.join(targetDir, pluginName);
+        
+        // 清理目标目录
+        if (fs.existsSync(pluginDir)) {
+            fs.rmSync(pluginDir, { recursive: true, force: true });
+        }
+
+        try {
+            // 克隆仓库
+            const gitCommand = `git clone ${gitUrl} ${pluginDir}`;
+            execSync(gitCommand, { stdio: 'inherit' });
+            
+            // 如果指定了分支或标签，切换到指定版本
+            if (options.gitRef) {
+                execSync(`git checkout ${options.gitRef}`, { 
+                    cwd: pluginDir, 
+                    stdio: 'inherit' 
+                });
+            }
+            
+            this.events.emit('log', `Successfully cloned plugin to: ${pluginDir}`);
+            return pluginDir;
+        } catch (error) {
+            // 清理失败的文件
+            if (fs.existsSync(pluginDir)) {
+                fs.rmSync(pluginDir, { recursive: true, force: true });
+            }
+            throw new Error(`Git clone failed: ${error.message}`);
+        }
+    }
+
+    copyDir(src, dest) {
+        // 创建目标目录
+        fs.mkdirSync(dest, { recursive: true,force:true});
+
+        // 读取源目录内容
+        const entries = fs.readdirSync(src, { withFileTypes: true });
+
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+
+            if (entry.isDirectory()) {
+                // 如果是目录，递归拷贝
+                this.copyDir(srcPath, destPath);
+            } else {
+                // 如果是文件，直接拷贝
+                fs.copyFileSync(srcPath, destPath);
+            }
+        }
+    }
+
+    /**
+     * 从URL或包名中提取插件名称
+     */
+    _extractPluginName(source) {
+        // 处理git URL
+        if (source.includes('.git')) {
+            const match = source.match(/\/([^\/]+)\.git$/);
+            if (match) return match[1];
+        }
+        
+        // 处理普通URL
+        if (source.includes('/')) {
+            const parts = source.split('/');
+            return parts[parts.length - 1];
+        }
+        
+        // 处理npm包名（可能包含scope）
+        return source.replace(/^@/, '').replace(/\//g, '-');
+    }
+}
+
+module.exports = PluginDownloader;