| 方式 | 适用场景 | 需要提供 Vue | 隔离程度 | 首选入口 |
|---|---|---|---|---|
| NPM | Vue 2 工程，由打包器管理依赖 | 是 | 与业务页面同上下文 | import { api } from "bee-report" |
| 全局 API | 页面已加载 OwlReport 全局构建产物 | window.Vue 或第三参 |
与业务页面同上下文 | window.beeReport.api |
| iframe | 需要独立页面、样式或运行环境隔离 | 父页面仍需 Vue 完成前置校验 | iframe 隔离 | api.mount({ iframe: true }) |
| BBP | 已部署并采用 BBP 门户菜单或 CLZ | 按 BBP 环境提供 | 由门户管理 | 仅见“BBP 集成（可选）”章节 |
优先选择 NPM；它让依赖和销毁逻辑最清晰。只有在宿主无法共享运行上下文、存在明显样式冲突或必须加载独立入口页时才使用 iframe。BBP 菜单和 CLZ 是门户专用能力，不应成为普通 NPM、全局 API 或 iframe 项目的前置条件。
无论选择哪种方式，核心输入都相同：reportCode、reportVersion 和一个有效挂载点。完整字段见 reportOptions，打印字段见 printOptions。