@xiao-ying/miniapp-browser-bootstrap

用于在浏览器运行时同步注入 window.__XY_CONFIG__ 的 Vite 插件。

为什么需要

@xiao-ying/miniapp-sdk-browser 会在模块初始化时读取 window.__XY_CONFIG__。 该插件在应用入口脚本执行前注入配置，确保浏览器环境下能用正确的 manifest 初始化 xy。

在以下场景会跳过注入：

• 检测到 App 运行时（宿主 WebView 已注入原生桥接）
• window.__XY_CONFIG__ 已存在

使用

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import { miniAppBrowserBootstrapPlugin } from '@xiao-ying/miniapp-browser-bootstrap'

export default defineConfig({
  plugins: [
    react(),
    miniAppBrowserBootstrapPlugin({
      manifestByMode: {
        development: {
          id: 'miniapp-template',
          initialPath: '/',
          entryPrefix: '/#'
        },
        test: {
          id: 'miniapp-template',
          initialPath: '/',
          entryPrefix: '/#'
        },
        production: {
          id: 'miniapp-template',
          initialPath: '/',
          entryPrefix: '/#'
        }
      }
    })
  ]
})

配置项

• manifestByMode（必填，以 Vite mode 为 key）
• manifestByMode.*.id（必填）
• manifestByMode.*.channel（可选，默认按 mode 推断：development -> dev，test -> beta，production -> prod）
• manifestByMode.*.initialPath（默认：/）
• manifestByMode.*.entryPrefix（必填）
• manifestByMode.*.name、manifestByMode.*.description、manifestByMode.*.iconUrl（可选）

entryPrefix 决定逻辑路径来源。若包含 #，使用 location.hash；否则使用 location.pathname + location.search。逻辑路径只在首次进入页面计算一次，不随路由变化更新。

manifest.host / manifest.protocol 总是从 window.location 自动推断。