hcordova 1.0.0

package/src/utils/PlatformProject.js

@@ -0,0 +1,452 @@
+/*
+ * 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');
+const os = require('os'); 
+const {execSync } = require('child_process');
+
+class PlatformProject {
+    constructor(api) {
+        this.api = api;
+        this.events = api.events;
+        this.sourceRoot = api.sourceRoot; // 从 Api 传递过来
+    }
+    
+    // 创建鸿蒙项目
+    /*
+    *projectPath目标路径
+    */
+    create(projectPath, packageName, projectName) {
+        return new Promise((resolve, reject) => {
+            try {
+                this.events.emit('log', 'Creating HarmonyOS project...');
+                
+                // 确保目标目录存在
+                this.events.emit('verbose', `Ensuring project path: ${projectPath}`);
+                this.ensureDirSync(projectPath);
+                
+                // 获取模板目录
+                this.events.emit('verbose', 'Getting template directory...');
+                const templateDir = this.getTemplateDir();
+                this.events.emit('verbose', `Using template directory: ${templateDir}`);
+                
+                // 验证模板
+                this.events.emit('verbose', 'Validating template...');
+                this.validateTemplate(templateDir);
+                
+                // 复制模板文件
+                this.events.emit('verbose', 'Copying template files...');
+                this.copyTemplateFiles(templateDir, projectPath);
+                
+                // 复制 Cordova 源代码
+                this.events.emit('verbose', 'Copying Cordova source code...');
+                try {
+                    this.copyCordovaSource(projectPath);
+                } catch (error) {
+                    this.events.emit('warn', `Cordova source copy skipped: ${error.message}`);
+                }
+                
+                // 处理模板变量
+                this.events.emit('verbose', 'Processing template variables...');
+                this.processTemplateVariables(projectPath, packageName, projectName);
+                
+                this.events.emit('log', 'HarmonyOS project created successfully');
+                resolve();
+            } catch (error) {
+                this.events.emit('error', `Failed to create HarmonyOS project: ${error.message}`);
+                this.events.emit('error', `Stack trace: ${error.stack}`);
+                // 确保传递的是 Error 对象，而不是字符串
+                reject(new Error(`Platform creation failed: ${error.message}`));
+            }
+        });
+    }
+    
+    // 确保目录存在
+    ensureDirSync(dir) {
+        try {
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+        } catch (error) {
+            throw new Error(`Failed to create directory ${dir}: ${error.message}`);
+        }
+    }
+
+    // 复制目录
+    copySync(source, target) {
+        try {
+            const stat = fs.statSync(source);
+            
+            if (stat.isFile()) {
+                const targetDir = path.dirname(target);
+                this.ensureDirSync(targetDir);
+                fs.copyFileSync(source, target);
+                return;
+            }
+            
+            if (stat.isDirectory()) {
+                this.ensureDirSync(target);
+                const items = fs.readdirSync(source);
+                
+                for (const item of items) {
+                    const sourcePath = path.join(source, item);
+                    const targetPath = path.join(target, item);
+                    this.copySync(sourcePath, targetPath);
+                }
+            }
+        } catch (error) {
+            throw new Error(`Failed to copy ${source} to ${target}: ${error.message}`);
+        }
+    }
+
+    // 下载 cordova-openharmony HAR 工程源码
+      async downloadHarSourceCode() {
+        const harRepo = 'https://gitcode.com/OpenHarmony-Cordova/cordova-openharmony.git';
+        const tempDir = path.join(os.tmpdir(), 'cordova-openharmony-har-' + Date.now());
+        
+        try {
+            // 创建临时目录
+            if (!fs.existsSync(tempDir)) {
+                fs.mkdirSync(tempDir, { recursive: true });
+            }
+            
+            // 克隆 HAR 工程仓库
+            console.log('Cloning cordova-openharmony HAR repository...');
+            execSync(`git clone ${harRepo} ${tempDir}`, { stdio: 'inherit' });
+            
+            // 验证 HAR 工程结构
+            const requiredFiles = [
+            'src/main/ets/',
+            'src/main/module.json5',
+            'oh-package.json5'
+            ];
+            
+            for (const file of requiredFiles) {
+                if (!fs.existsSync(path.join(tempDir, file))) {
+                    throw new Error(`Invalid HAR project structure: ${file} not found`);
+                }
+            }
+            
+            console.log('HAR source code downloaded successfully');
+            return tempDir;
+            
+        } catch (error) {
+            // 清理临时文件
+            this.cleanupTempFiles(tempDir);
+            throw new Error(`Failed to download HAR source code: ${error.message}`);
+        }
+    }
+
+      // 清理临时文件
+    cleanupTempFiles(tempDir) {
+        if (tempDir && fs.existsSync(tempDir)) {
+            try {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+            } catch (error) {
+            // 忽略清理错误
+            }
+        }
+    }
+
+    // 复制 Cordova 源代码到 cordova 目录
+    async copyCordovaSource(projectPath) {
+        this.events.emit('log', 'Copying Cordova source code...');
+        
+        try {
+            const cordovaOpenHarmonyRoot = await this.downloadHarSourceCode();
+
+            this.events.emit('verbose', `Cordova root: ${cordovaOpenHarmonyRoot}`);
+            
+            const cordovaTargetDir = path.join(projectPath, 'cordova');
+            this.events.emit('verbose', `Cordova target: ${cordovaTargetDir}`);
+            
+            this.ensureDirSync(cordovaTargetDir);
+            
+            // 第一步：复制项目工程文件
+            this.events.emit('verbose', 'Copying Cordova project files...');
+            this.copyCordovaFiles(cordovaOpenHarmonyRoot, cordovaTargetDir);
+            this.events.emit('log', 'Cordova source code copied successfully');
+            
+        } catch (error) {
+            this.events.emit('error', `Cordova source copy failed: ${error.message}`);
+            this.events.emit('error', `Cordova copy stack: ${error.stack}`);
+            throw error; // 重新抛出以便外层捕获
+        }
+    }
+
+    // 修改后的方法：复制整个 templates/cordova 目录到工程的 cordova 目录
+    ensureEssentialFilesInCordovaDir(sourceRoot, targetCordovaDir) {
+        this.events.emit('verbose', 'Copying entire cordova platform directory...');
+        
+        try {
+            // 源目录：templates/cordova
+            const cordovaSourceDir = path.join(sourceRoot, 'templates', 'cordova');
+            
+            this.events.emit('verbose', `Source cordova dir: ${cordovaSourceDir}`);
+            this.events.emit('verbose', `Target cordova dir: ${targetCordovaDir}`);
+            
+            if (!fs.existsSync(cordovaSourceDir)) {
+                throw new Error(`Cordova platform directory not found: ${cordovaSourceDir}`);
+            }
+            
+            // 复制整个 templates/cordova 目录到目标 cordova 目录
+            this.copySync(cordovaSourceDir, targetCordovaDir);
+            
+            // 验证关键文件是否复制成功
+            this.validateCordovaFiles(targetCordovaDir);
+            
+            this.events.emit('verbose', 'Entire cordova platform directory copied successfully');
+            
+        } catch (error) {
+            this.events.emit('error', `Failed to copy cordova platform directory: ${error.message}`);
+            throw error;
+        }
+    }
+    
+    // 验证 cordova 目录中的关键文件
+    validateCordovaFiles(cordovaDir) {
+        const requiredFiles = ['Api.js'];
+        let allFound = true;
+        
+        for (const file of requiredFiles) {
+            const filePath = path.join(cordovaDir, file);
+            if (fs.existsSync(filePath)) {
+                this.events.emit('verbose', `${file} found in cordova dir`);
+            } else {
+                this.events.emit('error', `${file} missing in cordova dir`);
+                allFound = false;
+            }
+        }
+        
+        return allFound;
+    }
+
+    // 获取 cordova-openharmony 根目录
+    getCordovaOpenHarmonyRoot() {
+        return this.sourceRoot;
+    }
+    
+    // 复制 Cordova 文件
+    copyCordovaFiles(sourceDir, targetDir) {
+        const excludeDirs = ['templates', 'bin', 'node_modules', '.git', 'test'];
+        const excludeFiles = ['.DS_Store', 'Thumbs.db', '*.log'];
+        
+        try {
+            const items = fs.readdirSync(sourceDir);
+            
+            for (const item of items) {
+                const sourcePath = path.join(sourceDir, item);
+                const targetPath = path.join(targetDir, item);
+                
+                if (this.shouldCopyCordovaItem(item, sourcePath, excludeDirs, excludeFiles)) {
+                    this.copySync(sourcePath, targetPath);
+                }
+            }
+        } catch (error) {
+            throw new Error(`Failed to copy Cordova files: ${error.message}`);
+        }
+    }
+    
+    // 判断是否应该复制 Cordova 项目中的项目
+    shouldCopyCordovaItem(itemName, itemPath, excludeDirs, excludeFiles) {
+        // 排除目录
+        if (excludeDirs.includes(itemName)) {
+            return false;
+        }
+        
+        // 排除隐藏文件和系统文件（除了 .gitignore）
+        if (itemName.startsWith('.') && itemName !== '.gitignore') {
+            return false;
+        }
+        
+        // 排除特定文件
+        if (excludeFiles.includes(itemName)) {
+            return false;
+        }
+        
+        // 检查文件状态
+        try {
+            const stat = fs.statSync(itemPath);
+            return stat.isFile() || stat.isDirectory();
+        } catch (error) {
+            return false;
+        }
+    }
+    
+   // 获取模板目录
+    getTemplateDir() {
+        try {
+            this.events.emit('verbose', 'Searching for template directory...');
+            
+            const possiblePaths = [
+                path.join(this.getCordovaOpenHarmonyRoot(), 'templates', 'project')
+            ];
+            
+            this.events.emit('verbose', 'Possible template paths:');
+            for (const templatePath of possiblePaths) {
+                this.events.emit('verbose', `  - ${templatePath}`);
+            }
+            
+            for (const templatePath of possiblePaths) {
+                if (fs.existsSync(templatePath)) {
+                    this.events.emit('verbose', `Found template directory: ${templatePath}`);
+                    return templatePath;
+                }
+            }
+            
+            this.events.emit('verbose', `Could not find template directory`);
+            const errorMsg = `Could not find template directory. Searched in: ${possiblePaths.join(', ')}`;
+            this.events.emit('error', errorMsg);
+            throw new Error(errorMsg);
+            
+        } catch (error) {
+            this.events.emit('error', `Error in getTemplateDir: ${error.message}`);
+            this.events.emit('error', `Stack: ${error.stack}`);
+            throw error; // 重新抛出
+        }
+    }
+    
+    // 验证模板目录
+    validateTemplate(templateDir) {
+        const requiredFiles = [
+            'build-profile.json5',
+            'oh-package.json5'
+        ];
+        
+        const missingFiles = [];
+        
+        for (const file of requiredFiles) {
+            const filePath = path.join(templateDir, file);
+            if (!fs.existsSync(filePath)) {
+                missingFiles.push(file);
+            }
+        }
+        
+        if (missingFiles.length > 0) {
+            throw new Error(`Required template files missing: ${missingFiles.join(', ')}`);
+        }
+        
+        this.events.emit('verbose', 'Template validation passed');
+    }
+    
+    // 复制模板文件
+    copyTemplateFiles(sourceDir, targetDir) {
+        this.events.emit('verbose', `Copying template files from ${sourceDir} to ${targetDir}`);
+        
+        try {
+            this.copySync(sourceDir, targetDir);
+            this.events.emit('verbose', 'Template files copied successfully');
+        } catch (error) {
+            throw new Error(`Failed to copy template files: ${error.message}`);
+        }
+    }
+    
+    // 处理模板变量
+    processTemplateVariables(projectPath, packageName, projectName) {
+        this.events.emit('verbose', 'Processing template variables...');
+        
+        const variables = {
+            PACKAGE_NAME: packageName,
+            PROJECT_NAME: projectName,
+            ID: packageName,
+            NAME: projectName
+        };
+        
+        try {
+            const filesToProcess = this.findTemplateFiles(projectPath);
+            for (const filePath of filesToProcess) {
+                this.processTemplateFile(filePath, variables);
+            }
+            
+            this.events.emit('verbose', `Processed ${filesToProcess.length} template files`);
+        } catch (error) {
+            this.events.emit('warn', `Template variable processing failed: ${error.message}`);
+        }
+    }
+    
+    // 查找需要处理的模板文件
+    findTemplateFiles(projectPath) {
+        const extensions = ['.json5', '.json', '.js', '.ts', '.txt', '.xml'];
+        const files = [];
+        
+        const scanDirectory = (dir) => {
+            try {
+                const items = fs.readdirSync(dir);
+                
+                for (const item of items) {
+                    const fullPath = path.join(dir, item);
+                    
+                    try {
+                        const stat = fs.statSync(fullPath);
+                        
+                        if (stat.isDirectory()) {
+                            // 跳过一些不需要扫描的目录
+                            if (!['node_modules', '.git', 'build'].includes(item)) {
+                                scanDirectory(fullPath);
+                            }
+                        } else if (extensions.some(ext => item.endsWith(ext))) {
+                            files.push(fullPath);
+                        }
+                    } catch (error) {
+                        // 跳过无法访问的文件
+                        continue;
+                    }
+                }
+            } catch (error) {
+                // 跳过无法读取的目录
+                this.events.emit('verbose', `Cannot read directory: ${dir}`);
+            }
+        };
+        
+        scanDirectory(projectPath);
+        return files;
+    }
+    
+    // 处理单个模板文件
+    processTemplateFile(filePath, variables) {
+        try {
+            let content = fs.readFileSync(filePath, 'utf8');
+            let modified = false;         
+            for (const [key, value] of Object.entries(variables)) {
+                const placeholder = `{{${key}}}`;
+                
+                // 使用 split + join 方法替换所有出现
+                if (content.includes(placeholder)) {
+                    const before = content;
+                    content = content.split(placeholder).join(value);
+                    const after = content;
+                    
+                    if (before !== after) {
+                        modified = true;
+                    }
+                }
+            }
+            
+            if (modified) {
+                fs.writeFileSync(filePath, content, 'utf8');
+                this.events.emit('verbose', `Successfully processed: ${path.relative(process.cwd(), filePath)}`);
+            } 
+        } catch (error) {
+            const errorMsg = `Error processing ${filePath}: ${error.message}`;
+            this.events.emit('verbose', errorMsg);
+            console.error(errorMsg); // 详细错误日志
+            throw error; // 重新抛出错误以便上层处理
+        }
+    }
+}
+
+module.exports = PlatformProject;