Unibest 默认配置下 build:app 产物 manifest.json 缺失 tabBar 等配置导致 wgt 热更新白屏

src/manifest.json
src/pages.json

git clone <your-unibest-project>
pnpm install
pnpm build:app   # 产物 dist/.../manifest.json 缺少 plus.tabBar

# 确认缺失
cat dist/build/app/manifest.json | grep -A5 "tabBar"
# 输出为空 → 问题确认

// scripts/init-base-files.mjs
// 此脚本用于生成 src/manifest.json 和 src/pages.json 基础文件
// 由于这两个配置文件会被添加到 .gitignore 中，因此需要通过此脚本确保项目能正常运行
//
// 注意：冷 build 时 @dcloudio/uni 会在 UniPages 落盘完整 pages.json 之前就读取 tabBar。
// 因此这里必须把 pages.config.ts 中的 tabBar / globalStyle / preloadRule 写入 pages.json，
// 否则 dist/.../manifest.json 会缺 plus.tabBar，App 热更后白屏。
import fs from 'node:fs'
import path from 'node:path'
import { createRequire } from 'node:module'
import { fileURLToPath } from 'node:url'

const __filename = fileURLToPath(import.meta.url)
const __dirname = path.dirname(__filename)
const root = path.resolve(__dirname, '..')

const manifestPath = path.resolve(root, 'src/manifest.json')
const pagesPath = path.resolve(root, 'src/pages.json')
const srcDir = path.resolve(root, 'src')

if (!fs.existsSync(srcDir)) {
  fs.mkdirSync(srcDir, { recursive: true })
}

const MIN_SIZE = `{ }`.length

// 如果 src/manifest.json 不存在，就创建它；或者如果文件大小小于等于 MIN_SIZE，也重新创建
if (!fs.existsSync(manifestPath) || fs.statSync(manifestPath).size <= MIN_SIZE) {
  fs.writeFileSync(manifestPath, JSON.stringify({}, null, 2))
}

/** 去掉 UniPages 可能写入的 // 注释，便于 JSON.parse */
function stripJsonComments(text) {
  return text.replace(/^\s*\/\/.*$/gm, '')
}

function readExistingPages() {
  if (!fs.existsSync(pagesPath) || fs.statSync(pagesPath).size <= MIN_SIZE) {
    return {
      pages: [
        {
          path: 'pages/index/index',
          type: 'home',
          style: {
            navigationStyle: 'custom',
            navigationBarTitleText: '首页',
          },
        },
      ],
      subPackages: [],
    }
  }

  try {
    return JSON.parse(stripJsonComments(fs.readFileSync(pagesPath, 'utf8')))
  }
  catch {
    return { pages: [], subPackages: [] }
  }
}

const require = createRequire(import.meta.url)
const jiti = require('jiti')(__filename, {
  interopDefault: true,
  esmResolve: true,
})

const pagesConfigModule = jiti(path.resolve(root, 'pages.config.ts'))
const pagesConfig = pagesConfigModule?.default ?? pagesConfigModule

if (!pagesConfig || typeof pagesConfig !== 'object') {
  throw new Error('[init-baseFiles] failed to load pages.config.ts')
}

const pagesJson = readExistingPages()

if (!Array.isArray(pagesJson.pages)) pagesJson.pages = []
if (!Array.isArray(pagesJson.subPackages)) pagesJson.subPackages = []

if (pagesConfig.globalStyle) pagesJson.globalStyle = pagesConfig.globalStyle
if (pagesConfig.preloadRule) pagesJson.preloadRule = pagesConfig.preloadRule
if (pagesConfig.tabBar) pagesJson.tabBar = pagesConfig.tabBar
else delete pagesJson.tabBar

fs.writeFileSync(pagesPath, `${JSON.stringify(pagesJson, null, 2)}\n`)

if (!pagesJson.tabBar) {
  throw new Error('[init-baseFiles] pages.config.ts 未提供 tabBar，冷 build 产物会缺 plus.tabBar')
}

console.log(
  `[init-baseFiles] pages.json ready (tabBar=true, pages=${pagesJson.pages.length})`,
)

{
  "scripts": {
    "prebuild:app": "node scripts/init-base-files.mjs",
    "build:app": "uni build -p app"
  }
}

# .gitignore
- src/manifest.json
- src/pages.json