niucloud/admin/scripts/sync-addon.cjs
niuzhiyun 5c0437cf53 v2.1.0-beta
1. 云编译任务系统的全面升级。 整个云编译服务器使用高性能开发语言GO全面重建整个的任务,排队体系。框架的用户,全面引入了任务管理系统设计架构。把云编译,在线升级,插件打包,构建发布版本,小程序一键上传同步等流程,高度抽象为任务系统。整个任务的执行过程会详细记录下来,支持每个过程的原始执行情况回溯。每个步骤,执行错误,加入重试与取消机制。对于网络拥堵,网络暂时断开造成的上传下载过程中不可预测的中断开始支持断点续传重续。同时,云编译支持前端驱动,与后端Redis队列驱动两种模式。前端驱动模式为轻量模式,需要页面的持续保持任务的进行。Redis队列驱动模式,支持任务后台运行,在任务后台运行的同时,同步进行业务系统的正常使用
2. 多端口,自定义扩展端口的真正支持。历史版本中,在addon.info中,已经设计有自定义端口功能,但是在整个的云编译服务器,没有真正支持自定义端口的编译与部署。在本次版本中,服务器端,以及框架已经全部支持自定义端口使能。addon.info 文件中定义的端口,会在编译端口自动枚举展示。云编译过程,会按照设定的命令自动执行,并完成部署。同时,云编译支持框架独立编译,插件组合编译等,方便开发者使用。
3. 环境检测与数据库修复,在本版本中全面引入。数据库修复,支持全量比对,表比对,插件比对,字符集编码比对,数据库修复功能,可以按照插件比对出缺失字段,并通过一键修复按钮完成数据库的修复。对于第三方插件中数据库表与框架自身不同的情况,系统会自动修正并正确执行SQL脚本。
4. 补丁管理也在本版本中实现,对于小问题,及时问题的处理,会发布小版本补丁。用户可以及时下载补丁,实时完成系统缺漏的修复。
5. 菜单系统,加入了导入菜单,导出菜单功能。niucloud开发团队全力为开发者考虑,本版本导入导出菜单可以按照插件,或者整个框架把菜单结构导出为json格式。
6. 构建版本在本次升级新加入。构建版本可以把云编译及版本构建的版本发布过程保留下来。
7. 插件校验和框架系统校验。在本版本中全面引入。支持对插件和框架进行全面校验比对。支持一键修复二开或者异常代码修复。
8. 存储设置在本版本全面优化,支持新增多种不同存储厂商的配置,并支持在不同配置中切换使用。
9. 运营面板在本次升级中植入。运营面板相当于为应用和插件加入了admin端的管理入口。本次版本开放此功能,为开发者开发admin端口功能提供了基础。我们官方在本次版本中同步发布官方客服插件,在admin端加入了平台客服的演示案例,供大家感受学习。
10. 全面优化了admin端的界面风格,加入了新的站点端默认风格。框架内置‌Vben Admin 前端框架。其实niucloud优秀的架构设计,运行速度并不慢,加入‌Vben Admin后,页面的切换效果会让用户感受到更加的丝滑与现代。
11. 前端顶部轮播组件,加入了返回首页按钮。 装修后,完美支持美团,饿了么那种模块与主模块的完美切换。
12. 小程序编译结构进行了优化,整个运行的速度更加快速。
2026-09-30 18:02:42 +08:00

134 lines
4.6 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/**
* 将 dist/.addons/{key} 同步到 dist/assets/addons/{key}
*
* build-addon 成功后调用;也可单独执行以刷新已构建插件到 assets 目录。
* 同时写入 manifest.json、lang/ 备份、assets/addons/index.json,并更新 build-report.json。
*
* 用法:node scripts/sync-addon.cjs <addon-key>
*/
const fs = require('fs')
const path = require('path')
const { ROOT, resolveAddonEntry } = require('./addon-utils.cjs')
/** Vite addon 构建 staging */
const ADDONS_STAGING = path.join(ROOT, 'dist', '.addons')
const OUT_DIR = path.join(ROOT, 'dist')
/** 记录各 addon 构建成功/失败,assemble 据此决定复制哪些 key */
const REPORT_PATH = path.join(ROOT, 'build-report.json')
function rmDir(dir) {
if (!fs.existsSync(dir)) return
fs.rmSync(dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })
}
function copyDir(src, dest) {
fs.mkdirSync(dest, { recursive: true })
for (const name of fs.readdirSync(src)) {
const s = path.join(src, name)
const d = path.join(dest, name)
if (fs.statSync(s).isDirectory()) copyDir(s, d)
else fs.copyFileSync(s, d)
}
}
/** 复制源码 lang 目录,供运行时 fetch json 降级或运维查阅 */
function copyLang(key, destAddonDir) {
const langSrc = path.join(ROOT, 'src', 'addon', key, 'lang')
if (!fs.existsSync(langSrc)) return
copyDir(langSrc, path.join(destAddonDir, 'lang'))
}
/** 运行时 initAddonManifests 会 fetch 此文件 */
function writeAddonManifest(key, destAddonDir) {
const manifest = {
key,
version: '1.0.0',
sharedVersion: 'admin-core-1.0.0',
// entry 保持相对路径(./index-[hash].js),与旧插件 ./index.js 兼容;
// 真正拼带 key 的 URL 由运行时 loader 用 addon key 重建,避免 adminUrl 丢 key
entry: resolveAddonEntry(destAddonDir),
langBase: './lang/'
}
fs.writeFileSync(
path.join(destAddonDir, 'manifest.json'),
JSON.stringify(manifest, null, 2) + '\n',
'utf-8'
)
}
function readReport() {
if (!fs.existsSync(REPORT_PATH)) return { success: [], failed: [] }
return JSON.parse(fs.readFileSync(REPORT_PATH, 'utf-8'))
}
function writeReport(report) {
fs.writeFileSync(REPORT_PATH, JSON.stringify(report, null, 2) + '\n', 'utf-8')
}
/** 将 key 记入 success 列表,并从 failed 中移除 */
function markSuccess(key) {
const report = readReport()
const success = new Set(report.success || [])
success.add(key)
report.success = [...success].sort()
report.failed = (report.failed || []).filter((f) => f.key !== key)
writeReport(report)
}
/** 浏览器启动时 fetch:/admin/assets/addons/index.json */
function writeAddonsIndex(keys) {
const addonsDir = path.join(OUT_DIR, 'assets', 'addons')
fs.mkdirSync(addonsDir, { recursive: true })
// 合并各插件 manifest.json 到 index.json.manifests,减少前端 N 次 HTTP 请求
// (与后端 rebuildPublicAdminAddonIndexJson 行为一致)
const manifests = {}
for (const key of keys) {
const manifestFile = path.join(addonsDir, key, 'manifest.json')
if (fs.existsSync(manifestFile)) {
try {
const data = JSON.parse(fs.readFileSync(manifestFile, 'utf-8'))
if (data && Object.keys(data).length) manifests[key] = data
} catch { /* 忽略损坏的 manifest,保持构建不中断 */ }
}
}
fs.writeFileSync(
path.join(addonsDir, 'index.json'),
JSON.stringify({ keys, sharedVersion: 'admin-core-1.0.0', buildTime: Date.now(), manifests }, null, 2) + '\n',
'utf-8'
)
}
function syncAddon(key) {
const src = path.join(ADDONS_STAGING, key)
if (!fs.existsSync(src)) {
console.error(`[sync-addon] missing staging: ${src}`)
process.exit(1)
}
const entryRel = resolveAddonEntry(src)
const entry = path.join(src, entryRel.replace(/^\.\//, ''))
if (!fs.existsSync(entry)) {
console.error(`[sync-addon] missing ${key}/${entryRel} — rebuild addon first`)
process.exit(1)
}
const dest = path.join(OUT_DIR, 'assets', 'addons', key)
rmDir(dest)
fs.cpSync(src, dest, { recursive: true, force: true })
copyLang(key, dest)
writeAddonManifest(key, dest)
markSuccess(key)
const report = readReport()
writeAddonsIndex(report.success || [key])
console.log(`[sync-addon] ${key} -> dist/assets/addons/${key}/`)
}
const key = process.argv[2] || process.env.ADDON_KEY
if (!key) {
console.error('Usage: node scripts/sync-addon.cjs <addon-key>')
process.exit(1)
}
syncAddon(key)