@xiao-ying/miniapp-sdk-browser

浏览器运行时实现，配合 @xiao-ying/miniapp-sdk 使用。

安装

pnpm add @xiao-ying/miniapp-sdk @xiao-ying/miniapp-sdk-browser

初始化

在入口处引入一次，自动挂载全局 xy：

import '@xiao-ying/miniapp-sdk'
import '@xiao-ying/miniapp-sdk-browser'

浏览器运行时会读取（可选）window.__XY_CONFIG__ 获取 manifest/path 等信息； 若未注入，SDK 会根据当前环境生成默认值。开发期可配合 @xiao-ying/miniapp-browser-bootstrap 在 Vite 入口前自动注入。

若 window.__XY_CONFIG__.appearance.themeSeedColor 有值，browser runtime 会通过 xy.appearance() / xy.onAppearanceChange() 暴露该宿主主题 seed color；缺失时走 SDK 默认小应蓝 #4da3ff fallback。@xiao-ying/[email protected] 起可通过 themeSeedColor 或 themeSeedColorByMode 注入该值。

若 window.__XY_CONFIG__.manifest.iconUrl 有值，browser runtime 会在初始化时用它覆盖页面当前的 favicon。 这只是浏览器侧启动行为，不会扩展到 App runtime。

生产环境禁用方案（入口控制）

推荐在各小应小程序入口通过条件导入控制是否在 prod 运行：

import '@xiao-ying/miniapp-sdk'

if (import.meta.env.DEV) {
  void import('@xiao-ying/miniapp-sdk-browser')
}

若某个项目允许浏览器 prod 运行，移除 if (import.meta.env.DEV) 条件即可。