Files

T

boos e0a5f57793 feat(desktop): embed BoosAPI Desktop client as a subproject

Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as
a monorepo subdirectory under desktop/. Source only — node_modules,
dist, Cargo target and the upstream .git history are excluded.

desktop/ keeps its own independent Cargo workspace (desktop/src-tauri
with crates/*); it is not part of the backend boosapi crate, so a
`cargo check` at the metapi root still compiles only the backend. Build
the desktop app from desktop/src-tauri per desktop/README.md.

Note: app icons are still placeholder assets pending the final BoosAPI
logo. The updater signing keys live outside the repo and are not
included.

2026-06-22 11:32:57 +08:00

2.3 KiB

Raw Permalink Blame History

Legacy 构建与兼容性指南（Vite / Webpack）

目的

本文档说明如何使用 legacy 构建以增强旧浏览器（例如较低版本 iOS / Safari）的兼容性，以及何时应该在源码层修复问题。

重要提醒

部分问题（尤其是正则引擎级语法，如 lookbehind (?<!...)）无法通过 polyfill 修复。legacy 构建可以转换语法和注入 API polyfill，但不能向旧的 JS 运行时“增加”正则引擎特性。如果遇到这类问题，必须在源码层重写或延迟构造并运行时检测/回退。详见 ios-regex-compat 文档。

Vite（推荐）

安装：

pnpm add -D @vitejs/plugin-legacy

示例配置（vite.config.ts）：

import legacy from '@vitejs/plugin-legacy'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    legacy({
      targets: ['defaults', 'iOS >= 11'],
      additionalLegacyPolyfills: ['regenerator-runtime/runtime'],
      renderLegacyChunks: true,
    })
  ]
})

注意：

targets 决定哪些语法/Polyfill 需要应用。根据需要支持的最低版本设置。
additionalLegacyPolyfills 可以把运行时库注入到 legacy bundle。
renderLegacyChunks 生成按需加载的 legacy chunk，并配合 type="module" / nomodule 差异化加载。
但 plugin-legacy 无法改写正则 lookbehind 等引擎级语法；此类问题仍需在源码层处理。

Webpack

常见做法是用 Babel 做两套构建（modern + legacy），通过 type="module" / nomodule 差异化服务。示例依赖与 babel.config.js 请参考英文文档上半部分。

Polyfills

使用 core-js（v3）和 Babel 的 useBuiltIns: 'usage'，并仅在 legacy 构建中注入需要的 polyfill。

正则语法特殊说明

引擎级正则语法必须在源码层处理：改写或运行时延迟构造并做 feature-detect。

测试与 CI

在 CI 中运行 modern + legacy 构建，并在旧设备/模拟器上做 smoke tests。可加入静态检查阻止新提交引入高级正则写法。

快速检查（本地）

pnpm dlx rg "\\(\\?<!|\\(\\?<=|\\\\p\\{" --glob "**/*.{js,ts,vue,jsx,tsx,mjs,cjs}" -n

总结

优先在源码层修复不兼容的正则语法；使用 legacy 构建来覆盖语法与 API 差异，并在 CI/QA 中验证旧设备表现。

2.3 KiB Raw Permalink Blame History Unescape Escape

Legacy 构建与兼容性指南（Vite / Webpack）

2.3 KiB

Raw Permalink Blame History