mirror of
https://gitee.com/niucloud-team/niucloud.git
synced 2026-11-18 15:50:31 +00:00
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. 小程序编译结构进行了优化,整个运行的速度更加快速。
358 lines
13 KiB
JavaScript
358 lines
13 KiB
JavaScript
/**
|
||
* 组装最终可部署 dist/
|
||
*
|
||
* 将 staging 目录合并为站点可访问结构:
|
||
* dist/.addons/* → dist/assets/addons/{key}/
|
||
* dist/.core/* → dist/(index.html、assets 等,跳过 addons 子目录)
|
||
* dist/.shared/* → dist/assets/shared/
|
||
*
|
||
* 并注入 Import Map、修正 /admin 路径、修复 admin-lang import、剥离多余 style import。
|
||
*
|
||
* 用法:npm run build:assemble(需先 build-shared + build:core + build-addon)
|
||
*/
|
||
const fs = require('fs')
|
||
const path = require('path')
|
||
const { ROOT, listAddonKeys, resolveAddonEntry } = require('./addon-utils.cjs')
|
||
const { IMPORT_MAP } = require('./shared-external.cjs')
|
||
const { stripBuiltAssets } = require('./strip-style-imports.cjs')
|
||
|
||
const CORE_DIR = path.join(ROOT, 'dist', '.core')
|
||
const ADDONS_STAGING = path.join(ROOT, 'dist', '.addons')
|
||
const OUT_DIR = path.join(ROOT, 'dist')
|
||
const SHARED_DIR = path.join(ROOT, 'dist', '.shared')
|
||
const REPORT_PATH = path.join(ROOT, 'build-report.json')
|
||
|
||
function toWinLongPath(dir) {
|
||
if (process.platform !== 'win32') return dir
|
||
if (dir.startsWith('\\\\?\\')) return dir
|
||
return `\\\\?\\${path.resolve(dir)}`
|
||
}
|
||
|
||
function rmDir(dir) {
|
||
if (!fs.existsSync(dir)) return
|
||
try {
|
||
fs.rmSync(toWinLongPath(dir), { recursive: true, force: true, maxRetries: 8, retryDelay: 300 })
|
||
} catch {
|
||
fs.rmSync(dir, { recursive: true, force: true, maxRetries: 8, retryDelay: 300 })
|
||
}
|
||
}
|
||
|
||
/** Windows 下 rename 容易因文件锁失败,加重试 + 降级为 copy+delete */
|
||
function safeRename(src, dest, maxRetries = 5) {
|
||
for (let i = 0; i < maxRetries; i++) {
|
||
try {
|
||
fs.renameSync(src, dest)
|
||
return
|
||
} catch (e) {
|
||
if (e.code === 'EPERM' || e.code === 'EBUSY') {
|
||
if (i < maxRetries - 1) {
|
||
console.log(`[assemble] rename busy, retry ${i + 1}/${maxRetries}...`)
|
||
const s = Date.now(); while (Date.now() - s < 500) {}
|
||
} else {
|
||
// 最终降级:copy + delete
|
||
copyDir(src, dest)
|
||
rmDir(src)
|
||
console.log(`[assemble] rename failed, fallback to copy+delete`)
|
||
}
|
||
} else {
|
||
throw e
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
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)
|
||
}
|
||
}
|
||
|
||
function copyTree(src, dest) {
|
||
fs.mkdirSync(path.dirname(dest), { recursive: true })
|
||
fs.cpSync(src, dest, { recursive: true, force: true })
|
||
}
|
||
|
||
/**
|
||
* 清理 dist/assets 下旧的 core 产物,保留 addons(shared 随后从 .shared 重拷)
|
||
* Vite 每次构建 chunk hash 会变,不清理会留下上一版同名不同 hash 的孤儿文件
|
||
*/
|
||
function cleanCoreAssetsOutput() {
|
||
const outAssets = path.join(OUT_DIR, 'assets')
|
||
if (!fs.existsSync(outAssets)) {
|
||
fs.mkdirSync(outAssets, { recursive: true })
|
||
return
|
||
}
|
||
const addonsSrc = path.join(outAssets, 'addons')
|
||
const addonsTmp = path.join(OUT_DIR, '.addons_staging')
|
||
if (fs.existsSync(addonsTmp)) rmDir(addonsTmp)
|
||
if (fs.existsSync(addonsSrc)) {
|
||
safeRename(addonsSrc, addonsTmp)
|
||
}
|
||
if (fs.existsSync(outAssets)) {
|
||
const staleAssets = path.join(ROOT, '.build', '.assets_stale_' + Date.now())
|
||
try { safeRename(outAssets, staleAssets) } catch { rmDir(outAssets) }
|
||
}
|
||
fs.mkdirSync(outAssets, { recursive: true })
|
||
if (fs.existsSync(addonsTmp)) {
|
||
safeRename(addonsTmp, path.join(outAssets, 'addons'))
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 合并 core 产物到 dist 根目录
|
||
* 注意:跳过 core/assets/addons,避免覆盖已同步的插件目录
|
||
*/
|
||
function mergeCoreOutput() {
|
||
for (const name of ['index.html', 'manifest.json', 'niucloud.ico']) {
|
||
const src = path.join(CORE_DIR, name)
|
||
if (fs.existsSync(src)) {
|
||
fs.copyFileSync(src, path.join(OUT_DIR, name))
|
||
console.log(`[assemble] core ${name}`)
|
||
}
|
||
}
|
||
const ueditor = path.join(CORE_DIR, 'ueditor')
|
||
if (fs.existsSync(ueditor)) {
|
||
copyTree(ueditor, path.join(OUT_DIR, 'ueditor'))
|
||
console.log('[assemble] core ueditor/')
|
||
}
|
||
const coreAssets = path.join(CORE_DIR, 'assets')
|
||
const outAssets = path.join(OUT_DIR, 'assets')
|
||
if (!fs.existsSync(coreAssets)) return
|
||
fs.mkdirSync(outAssets, { recursive: true })
|
||
for (const name of fs.readdirSync(coreAssets)) {
|
||
if (name === 'addons') continue
|
||
const src = path.join(coreAssets, name)
|
||
const dest = path.join(outAssets, name)
|
||
if (fs.statSync(src).isDirectory()) {
|
||
copyDir(src, dest)
|
||
} else {
|
||
fs.copyFileSync(src, dest)
|
||
}
|
||
console.log(`[assemble] core assets/${name}`)
|
||
}
|
||
}
|
||
|
||
function copyLang(key, destAddonDir) {
|
||
const langSrc = path.join(ROOT, 'src', 'addon', key, 'lang')
|
||
if (!fs.existsSync(langSrc)) return
|
||
const langDest = path.join(destAddonDir, 'lang')
|
||
copyDir(langSrc, langDest)
|
||
}
|
||
|
||
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')
|
||
}
|
||
|
||
/** Vite 默认相对路径 ./assets/ → 部署绝对路径 /admin/assets/ */
|
||
function fixIndexHtml() {
|
||
const fn = path.join(OUT_DIR, 'index.html')
|
||
if (!fs.existsSync(fn)) return
|
||
let text = fs.readFileSync(fn, 'utf-8')
|
||
text = text.replaceAll('./assets/', '/admin/assets/')
|
||
text = text.replace('./niucloud.ico', '/admin/niucloud.ico')
|
||
fs.writeFileSync(fn, text, 'utf-8')
|
||
}
|
||
|
||
/** 注入 Import Map,使 vue / @/lang 等解析到 shared 单例 */
|
||
function injectImportMap() {
|
||
const fn = path.join(OUT_DIR, 'index.html')
|
||
if (!fs.existsSync(fn)) return
|
||
let text = fs.readFileSync(fn, 'utf-8')
|
||
const script = `<script type="importmap">\n${JSON.stringify({ imports: IMPORT_MAP }, null, 2)}\n</script>`
|
||
if (text.includes('type="importmap"')) {
|
||
text = text.replace(/<script type="importmap">[\s\S]*?<\/script>/, script)
|
||
} else {
|
||
text = text.replace('<head>', `<head>\n ${script}`)
|
||
}
|
||
fs.writeFileSync(fn, text, 'utf-8')
|
||
}
|
||
|
||
/**
|
||
* 清理 dist 根下旧文件,保留 staging(.core/.addons/.shared)与 assets
|
||
* addon 子目录在 runAssemble 里按 key 单独 rm,避免 Windows ENOTEMPTY
|
||
*/
|
||
function cleanAssembledOutput() {
|
||
if (!fs.existsSync(OUT_DIR)) {
|
||
fs.mkdirSync(OUT_DIR, { recursive: true })
|
||
return
|
||
}
|
||
const keep = new Set(['.core', '.addons', '.shared', '.addons_staging', 'assets'])
|
||
for (const name of fs.readdirSync(OUT_DIR)) {
|
||
if (keep.has(name)) continue
|
||
// 历史 trash 目录不阻塞构建,可手动删除 dist/assets.__trash_*
|
||
if (name.includes('.__trash_') || name.startsWith('assets.__')) continue
|
||
rmDir(path.join(OUT_DIR, name))
|
||
}
|
||
}
|
||
|
||
/** Element Plus 语言包,importmap 中 locale 路径指向此处 */
|
||
function copySharedLocales() {
|
||
const srcBase = path.join(ROOT, 'node_modules', 'element-plus', 'dist', 'locale')
|
||
const destBase = path.join(OUT_DIR, 'assets', 'shared', 'locale')
|
||
fs.mkdirSync(destBase, { recursive: true })
|
||
for (const file of ['zh-cn.mjs', 'en.mjs']) {
|
||
const src = path.join(srcBase, file)
|
||
if (fs.existsSync(src)) {
|
||
fs.copyFileSync(src, path.join(destBase, file))
|
||
}
|
||
}
|
||
}
|
||
|
||
|
||
function main() {
|
||
try {
|
||
runAssemble()
|
||
} catch (err) {
|
||
console.error('[assemble] ERROR:', err)
|
||
process.exit(1)
|
||
}
|
||
}
|
||
|
||
function runAssemble() {
|
||
const report = fs.existsSync(REPORT_PATH)
|
||
? JSON.parse(fs.readFileSync(REPORT_PATH, 'utf-8'))
|
||
: { success: listAddonKeys(), failed: [] }
|
||
|
||
// build:core 场景:不承担插件打包,dist/assets/addons 留空,也不生成 index.json
|
||
const skipAddons = process.env.SKIP_ADDONS === '1'
|
||
|
||
cleanAssembledOutput()
|
||
|
||
if (!fs.existsSync(CORE_DIR)) {
|
||
console.error('[assemble] missing dist/.core — run core build first')
|
||
process.exit(1)
|
||
}
|
||
|
||
const successKeys = report.success || []
|
||
const installedKeys = []
|
||
|
||
// 先同步 addon,避免后续 core 合并耗时过长时 assets/addons 仍为空
|
||
if (skipAddons) {
|
||
// build:core 场景:不打包插件,dist/assets/addons 留空,也不生成 index.json
|
||
rmDir(path.join(OUT_DIR, 'assets', 'addons'))
|
||
console.log('[assemble] SKIP_ADDONS: dist/assets/addons left empty')
|
||
} else {
|
||
for (const key of successKeys) {
|
||
const src = path.join(ADDONS_STAGING, key)
|
||
if (!fs.existsSync(src)) continue
|
||
const dest = path.join(OUT_DIR, 'assets', 'addons', key)
|
||
rmDir(dest)
|
||
copyTree(src, dest)
|
||
copyLang(key, dest)
|
||
writeAddonManifest(key, dest)
|
||
const entryRel = resolveAddonEntry(dest)
|
||
const entryFile = path.join(dest, entryRel.replace(/^\.\//, ''))
|
||
if (!fs.existsSync(entryFile)) {
|
||
console.error(`[assemble] missing ${key}/${entryRel} — run: node scripts/build-addon.cjs ${key}`)
|
||
process.exit(1)
|
||
}
|
||
installedKeys.push(key)
|
||
console.log(`[assemble] addon "${key}" -> assets/addons/${key}/`)
|
||
}
|
||
}
|
||
|
||
// 合并各插件 manifest.json 到 index.json.manifests,减少前端 N 次 HTTP 请求
|
||
// (与后端 rebuildPublicAdminAddonIndexJson 行为一致)
|
||
const manifests = {}
|
||
for (const key of installedKeys) {
|
||
const manifestFile = path.join(OUT_DIR, 'assets', 'addons', 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,保持构建不中断 */ }
|
||
}
|
||
}
|
||
|
||
// buildTime 作为插件包运行时缓存版本:addon-lang 用它拼 ?v= 参数,
|
||
// 同一构建内插件包 URL 稳定可被浏览器长期缓存,重新部署后自动失效
|
||
const indexJson = { keys: installedKeys, sharedVersion: 'admin-core-1.0.0', buildTime: Date.now(), manifests }
|
||
if (!skipAddons) {
|
||
fs.mkdirSync(path.join(OUT_DIR, 'assets', 'addons'), { recursive: true })
|
||
fs.writeFileSync(
|
||
path.join(OUT_DIR, 'assets', 'addons', 'index.json'),
|
||
JSON.stringify(indexJson, null, 2) + '\n',
|
||
'utf-8'
|
||
)
|
||
}
|
||
|
||
cleanCoreAssetsOutput()
|
||
mergeCoreOutput()
|
||
|
||
// 修复 Rollup 生成的错误 admin-lang 相对路径(否则会请求到 HTML 404)
|
||
const { fixDir } = require('./admin-lang-import-utils.cjs')
|
||
fixDir(path.join(OUT_DIR, 'assets'))
|
||
|
||
if (fs.existsSync(SHARED_DIR)) {
|
||
const sharedDest = path.join(OUT_DIR, 'assets', 'shared')
|
||
fs.mkdirSync(sharedDest, { recursive: true })
|
||
for (const name of fs.readdirSync(SHARED_DIR)) {
|
||
copyTree(path.join(SHARED_DIR, name), path.join(sharedDest, name))
|
||
}
|
||
|
||
// 生成 SFC 组件 wrapper:同时提供 named 和 default 导出
|
||
// addon 的 Components() 插件生成 import { X } (命名),默认导入 import X from 也同样支持
|
||
const { SFC_WRAPPERS } = require('./shared-external.cjs')
|
||
for (const [fileName, exportName] of Object.entries(SFC_WRAPPERS)) {
|
||
const wrapperPath = path.join(sharedDest, fileName)
|
||
fs.writeFileSync(
|
||
wrapperPath,
|
||
`export { ${exportName} as default, ${exportName} } from './core-shared.js'\n`,
|
||
'utf-8'
|
||
)
|
||
}
|
||
console.log(`[assemble] shared -> assets/shared/ (${Object.keys(SFC_WRAPPERS).length} SFC wrappers generated)`)
|
||
} else {
|
||
console.warn('[assemble] missing dist/.shared — run build-shared first')
|
||
}
|
||
copySharedLocales()
|
||
|
||
// core 合并可能覆盖 addons/index.json,需再次写入(仅 build/build:addon 产出)
|
||
if (!skipAddons) {
|
||
fs.writeFileSync(
|
||
path.join(OUT_DIR, 'assets', 'addons', 'index.json'),
|
||
JSON.stringify(indexJson, null, 2) + '\n',
|
||
'utf-8'
|
||
)
|
||
}
|
||
for (const key of installedKeys) {
|
||
writeAddonManifest(key, path.join(OUT_DIR, 'assets', 'addons', key))
|
||
}
|
||
|
||
fixIndexHtml()
|
||
injectImportMap()
|
||
const cleaned = stripBuiltAssets(OUT_DIR)
|
||
if (cleaned.length) {
|
||
console.log(`[assemble] stripped element-plus style imports from ${cleaned.length} js files`)
|
||
}
|
||
|
||
// 组装完成,移除中间 staging 目录(已合并进 dist,发布时也不会拷贝)
|
||
for (const staging of ['.core', '.shared']) {
|
||
const dir = path.join(OUT_DIR, staging)
|
||
if (fs.existsSync(dir)) {
|
||
rmDir(dir)
|
||
console.log(`[assemble] removed staging ${staging}`)
|
||
}
|
||
}
|
||
|
||
console.log(`[assemble] done: core + ${installedKeys.length} addons`)
|
||
if (report.failed?.length) {
|
||
console.warn('[assemble] skipped failed addons:', report.failed.map((f) => f.key).join(', '))
|
||
}
|
||
}
|
||
|
||
main()
|