niucloud/uni-app/scripts/build-mp-framework.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

250 lines
10 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/build/mp-core/
*/
const fs = require('fs')
const path = require('path')
const {
ROOT,
PAGES_JSON,
BUILD_DIR,
MP_OUT_BUILD,
MP_CORE_DIR,
MP_FRAMEWORK_DIR,
MP_LOCK_PATH,
makeBuildId,
runUniMpBuild,
snapshotMpBuild,
collectCommonManifest,
readJson,
writeJson,
stripOrphanAddonSubpackages,
installMergeScriptToFramework,
applyFrameworkAppJsonSubPackages,
loadFrameworkNonAddonSubPackages,
rmDir
} = require('./mp-utils.cjs')
const { patchDiyGroupInlineComponents } = require('./mp-diy-group-inline.cjs')
const {
installNativeDiyBridgeRouter,
buildAppDiyRegistryMap
} = require('./mp-diy-bridge-merge.cjs')
const { scanAllDiyComponents } = require('./diy-component-scan.cjs')
const PAGES_BACKUP = path.join(BUILD_DIR, 'pages.full.backup.json')
const PAGES_FRAMEWORK = path.join(BUILD_DIR, 'pages.framework.json')
function swapPagesJson(useFramework, rawBackup) {
if (useFramework) {
// 保存原始内容到内存(保留注释),不依赖磁盘备份文件
rawBackup = fs.readFileSync(PAGES_JSON, 'utf-8')
fs.copyFileSync(PAGES_FRAMEWORK, PAGES_JSON)
console.log('[build-mp-framework] swapped pages.json -> pages.framework.json')
return rawBackup
} else if (rawBackup) {
fs.writeFileSync(PAGES_JSON, rawBackup, 'utf-8')
console.log('[build-mp-framework] restored pages.json (with comments)')
}
}
const UV_BARREL_PAGE_PATH = 'app/pages/_uv_barrel/index'
/**
* 构建期专用:在主包插入一个临时页面,模板里用上全部 uview-plus 组件,
* 强制 uni 把组件文件(node-modules/uview-plus/components/*)与各自 props(NN)
* 全部打进框架 common/vendor.js;构建完成后该页面会从 app.json 与产物中移除。
* 这样框架自带完整 uview-plus,插件合并时无需再处理 uview-plus 组件。
*/
// 判断某个 pages 条目是否为本脚本注入的临时 barrel 页面(兼容历史遗留的不同路径/格式)
function isBarrelPageEntry(p) {
const entryPath = typeof p === 'string' ? p : p && p.path
return typeof entryPath === 'string' && entryPath.includes('_uv_barrel')
}
function injectUviewBarrelPage() {
if (process.env.SKIP_UV_BARREL) {
console.log('[build-mp-framework] SKIP_UV_BARREL set, skip barrel page')
return false
}
const compRoot = path.join(ROOT, 'node_modules', 'uview-plus', 'components')
if (!fs.existsSync(compRoot)) {
console.warn('[build-mp-framework] uview-plus not found, skip barrel page')
return false
}
const names = fs
.readdirSync(compRoot)
.filter((n) => {
const d = path.join(compRoot, n)
if (!fs.statSync(d).isDirectory()) return false
if (n.includes('--')) return false // u--xxx 为内部别名标签,双连字符在模板中无法解析
return fs.existsSync(path.join(d, `${n}.vue`))
})
.sort()
if (!names.length) return false
const tags = names.map((n) => ` <${n} />`).join('\n')
const pageVue =
`<template>\n` +
` <view class="uv-barrel">\n` +
`${tags}\n` +
` </view>\n` +
`</template>\n\n` +
`<script setup>\n` +
`// 构建期专用:强制打包全部 uview-plus 组件,产物中会被移除\n` +
`</script>\n`
const srcDir = path.join(ROOT, 'src', 'app', 'pages', '_uv_barrel')
fs.mkdirSync(srcDir, { recursive: true })
fs.writeFileSync(path.join(srcDir, 'index.vue'), pageVue, 'utf-8')
const fw = readJson(PAGES_FRAMEWORK)
if (!Array.isArray(fw.pages)) fw.pages = []
// 先清除任何历史残留的 barrel 条目(可能格式/路径不同),避免重复或非法 page
fw.pages = fw.pages.filter((p) => !isBarrelPageEntry(p))
fw.pages.push({ path: UV_BARREL_PAGE_PATH, style: {} })
writeJson(PAGES_FRAMEWORK, fw)
console.log(`[build-mp-framework] injected uview barrel page (${names.length} components)`)
return true
}
/** 从 mp-core/app.json 移除临时页面入口并删除其编译产物文件 */
function stripUviewBarrelFromCore() {
const appPath = path.join(MP_CORE_DIR, 'app.json')
if (fs.existsSync(appPath)) {
const appJson = readJson(appPath)
if (Array.isArray(appJson.pages)) {
const len = appJson.pages.length
appJson.pages = appJson.pages.filter((p) => !isBarrelPageEntry(p))
if (appJson.pages.length !== len) {
writeJson(appPath, appJson)
console.log('[build-mp-framework] removed barrel page entry from app.json')
}
}
}
const outDirs = [
path.join(MP_CORE_DIR, 'app', 'pages', '_uv_barrel'),
path.join(MP_CORE_DIR, 'pages', '_uv_barrel'),
path.join(MP_OUT_BUILD, 'app', 'pages', '_uv_barrel'),
path.join(MP_OUT_BUILD, 'pages', '_uv_barrel')
]
outDirs.forEach((outDir) => {
if (fs.existsSync(outDir)) {
rmDir(outDir)
console.log('[build-mp-framework] removed barrel page files from mp-core:', outDir)
}
})
}
/** 清理构建期临时文件:src 临时页面 + pages.framework.json 中的注入项 */
function removeUviewBarrelTemp() {
const srcDirs = [
path.join(ROOT, 'src', 'app', 'pages', '_uv_barrel'),
path.join(ROOT, 'src', 'pages', '_uv_barrel')
]
srcDirs.forEach((srcDir) => {
if (fs.existsSync(srcDir)) rmDir(srcDir)
})
if (fs.existsSync(PAGES_FRAMEWORK)) {
const fw = readJson(PAGES_FRAMEWORK)
if (Array.isArray(fw.pages)) {
const len = fw.pages.length
fw.pages = fw.pages.filter((p) => !isBarrelPageEntry(p))
if (fw.pages.length !== len) writeJson(PAGES_FRAMEWORK, fw)
}
}
}
function main() {
const buildId = makeBuildId('mp-framework')
// build:mp-weixin:core 场景(SKIP_ADDONS=1):框架包不携带已编译插件包与合并元数据
// (插件在 SaaS 侧经 build:mp-weixin:addon + merge-mp-addon 独立合并/部署)。
const skipAddons = process.env.SKIP_ADDONS === '1'
require('./generate-mp-framework-pages.cjs')
require('./generate-diy-registry.cjs').generateDiyRegistry()
const { generateDiyDynamicBridgeMp } = require('./generate-diy-dynamic-bridge-mp.cjs')
generateDiyDynamicBridgeMp({ target: 'app' })
generateDiyDynamicBridgeMp({ target: 'router' })
injectUviewBarrelPage()
const pagesBackup = swapPagesJson(true)
let code = 0
let buildOk = false
try {
console.log('[build-mp-framework] uni build -p mp-weixin ...')
code = runUniMpBuild()
if (code !== 0) {
console.error('[build-mp-framework] FAILED')
process.exit(code)
}
if (!fs.existsSync(MP_OUT_BUILD)) {
console.error('[build-mp-framework] missing output:', MP_OUT_BUILD)
process.exit(1)
}
const stripped = stripOrphanAddonSubpackages(MP_OUT_BUILD)
if (stripped) {
console.log(`[build-mp-framework] removed ${stripped} orphan addon plugin dir(s)`)
}
snapshotMpBuild(MP_OUT_BUILD, MP_CORE_DIR, {
kind: 'framework',
buildId,
commonManifest: collectCommonManifest(MP_OUT_BUILD)
})
applyFrameworkAppJsonSubPackages(MP_CORE_DIR)
stripUviewBarrelFromCore()
writeJson(
path.join(MP_CORE_DIR, 'mp-framework-subpackages.json'),
loadFrameworkNonAddonSubPackages()
)
installNativeDiyBridgeRouter(MP_CORE_DIR, buildAppDiyRegistryMap(scanAllDiyComponents))
console.log('[build-mp-framework] installed native diy-dynamic-bridge router (merge-patchable)')
const appRegistry = buildAppDiyRegistryMap(scanAllDiyComponents)
const inlineResult = patchDiyGroupInlineComponents(MP_CORE_DIR, appRegistry)
console.log(
`[build-mp-framework] diy-group inlined ${inlineResult.count} app diy component(s) (no bridge hop)`
)
const { applyMpWeixinPost } = require('./mp-weixin-post.cjs')
applyMpWeixinPost(MP_CORE_DIR)
const meta = readJson(path.join(MP_CORE_DIR, 'mp-build-meta.json'))
const lock = fs.existsSync(MP_LOCK_PATH) ? readJson(MP_LOCK_PATH) : {}
lock.framework = {
buildId,
gitCommit: meta.gitCommit,
time: new Date().toISOString(),
dir: 'dist/build/mp-core'
}
writeJson(MP_LOCK_PATH, lock)
installMergeScriptToFramework(MP_CORE_DIR)
if (skipAddons) {
// 框架包不携带已编译插件包与合并元数据(防止历史 build:mp-weixin:addon
// 写入的 mp-addons/ 或 merge-mp-addon 的 mp-merge-meta.json 残留进 core 产物)
const addonPkgDir = path.join(MP_CORE_DIR, 'mp-addons')
if (fs.existsSync(addonPkgDir)) {
rmDir(addonPkgDir)
console.log('[build-mp-framework] SKIP_ADDONS: removed mp-addons/ from core output')
}
for (const f of ['mp-merge-meta.json', 'index.json']) {
const fp = path.join(MP_CORE_DIR, f)
if (fs.existsSync(fp)) {
fs.rmSync(fp, { force: true })
console.log(`[build-mp-framework] SKIP_ADDONS: removed ${f} from core output`)
}
}
}
console.log(`[build-mp-framework] OK -> ${path.relative(ROOT, MP_CORE_DIR)}/ (${buildId})`)
console.log('[build-mp-framework] 框架包可直接导入开发者工具(仅主包,无插件分包)')
console.log('[build-mp-framework] 添加插件后合并:')
console.log(' 1. 将插件包放入 dist/build/mp-core/mp-addons/{key}/')
console.log(' 或 npm run build:mp-weixin:addon shop (自动输出到 mp-addons/shop/)')
console.log(' 2. cd dist/build/mp-core && node merge-mp-addon.cjs')
buildOk = true
} finally {
swapPagesJson(false, pagesBackup)
removeUviewBarrelTemp()
if (buildOk) {
require('./cleanup-diy-dynamic-bridge-src.cjs').cleanupAddonDiyBridgeSrc()
}
}
}
main()