live-h5-audience 2.0.9 → 2.0.11

package/CHANGELOG.md

@@ -0,0 +1,117 @@
+# 更新日志
+
+## [2.0.11] - 2026-03-10
+
+### 🐛 Bug 修复
+
+- 修复 Chunk 加载失败问题（`Loading chunk 0 failed`）
+- 修复 CommonJS 格式 chunk 文件合并问题
+- 修复 merge-chunks.js 脚本变量重复声明错误
+
+### 🔧 技术改进
+
+- 更新 merge-chunks.js 脚本，支持自动检测 UMD/CommonJS 格式
+- 优化 chunk 文件清理逻辑
+- 改进构建后的文件输出结构
+- 添加测试页面 `test-package.html` 用于验证构建结果
+
+### 📝 文档更新
+
+- 更新 NPM_USAGE.md，添加构建和发布流程说明
+- 完善 example-usage 示例项目
+
+---
+
+## [2.0.10] - 2026-03-10
+
+### 🎉 重大更新 - 外部化依赖重构
+
+**变更说明**：本次更新重构了 npm 包的依赖管理方式，采用外部化依赖（externals）配置，显著减小包体积并避免版本冲突。
+
+### ✨ 新增
+
+- ✅ 采用 `peerDependencies` 声明核心依赖
+- ✅ 在 `vue.config.js` 中配置 `externals` 外部化核心依赖
+- ✅ 自动检测重复安装插件，避免重复注册
+- ✅ 创建详细的使用文档 `NPM_USAGE.md`
+- ✅ 提供完整的使用示例项目 `example-usage/`
+
+### 📝 优化
+
+- 🔄 将 `vue`、`vue-router`、`vuex`、`vant`、`element-ui` 移至 `peerDependencies`
+- 🔄 更新 `src/package-entry.js` 的使用说明和注释
+- 🔄 优化插件安装逻辑，自动检测已安装的依赖
+- 🔄 更新 `README.md`，添加重要更新说明
+
+### ⚠️ 破坏性变更
+
+使用前必须安装以下依赖：
+
+```bash
+npm install vue@^2.6.0 vue-router@^3.0.0 vuex@^3.0.0 vant@^2.5.0 element-ui@^2.7.0
+```
+
+### 📚 文档
+
+- 新增 `NPM_USAGE.md` - 详细的使用文档
+- 新增 `example-usage/` - 快速入门示例项目
+- 更新 `README.md` - 添加重要更新说明和使用指南
+
+### 🔧 技术细节
+
+**依赖变更**：
+- `vue`: `dependencies` → `peerDependencies`
+- `vue-router`: `dependencies` → `peerDependencies`
+- `vuex`: `dependencies` → `peerDependencies`
+- `vant`: `dependencies` → `peerDependencies`
+- `element-ui`: `dependencies` → `peerDependencies`
+
+**配置变更**：
+```javascript
+// vue.config.js
+config.externals({
+  'vue': { commonjs: 'vue', commonjs2: 'vue', amd: 'vue', root: 'Vue' },
+  'vue-router': { commonjs: 'vue-router', commonjs2: 'vue-router', amd: 'vue-router', root: 'VueRouter' },
+  'vuex': { commonjs: 'vuex', commonjs2: 'vuex', amd: 'vuex', root: 'Vuex' },
+  'vant': { commonjs: 'vant', commonjs2: 'vant', amd: 'vant', root: 'vant' },
+  'element-ui': { commonjs: 'element-ui', commonjs2: 'element-ui', amd: 'element-ui', root: 'ELEMENT' }
+})
+```
+
+### 🚀 使用示例
+
+```javascript
+import Vue from 'vue'
+import LiveH5 from 'live-h5-audience'
+import 'live-h5-audience/dist/live-h5-audience.css'
+
+// 确保先安装依赖
+// npm install vue@^2.6.0 vue-router@^3.0.0 vuex@^3.0.0 vant@^2.5.0 element-ui@^2.7.0
+
+Vue.use(LiveH5, {
+  containerId: '#live-h5-app',
+  apiBaseUrl: 'https://api.example.com',
+  defaultRoute: '/roomList'
+})
+```
+
+### 🐛 修复
+
+- 修复了因依赖版本冲突导致的问题
+- 修复了重复安装插件导致的警告
+
+### 📖 迁移指南
+
+如果你已经使用旧版本的包，需要做以下调整：
+
+1. 安装必需的 peerDependencies
+2. 确保样式正确引入
+3. 检查容器元素是否存在
+
+详细迁移指南请参考 [NPM_USAGE.md](./NPM_USAGE.md)
+
+---
+
+## [2.0.9] 及更早版本
+
+详细变更记录请查看 Git 提交历史。

package/README.md

@@ -179,23 +179,34 @@ this.$liveH5Store
 
 ## 依赖说明
 
-### 宿主项目需要提供
-
-以下依赖由宿主项目提供（通过 externals 配置）：
-
-- `vue` >= 2.6.x
-- `vue-router` >= 3.0.x
-- `vuex` >= 3.0.x
-
-### 包内包含的依赖
-
-以下依赖已打包在 npm 包中：
-
-- `element-ui` >= 2.7.x
-- `vant` >= 2.5.x
-- `axios` >= 0.19.x
-- `vue-bus` >= 1.2.x
-- 以及其他所有功能依赖
+### 必需依赖（peerDependencies）
+
+以下依赖由**使用方**提供（不在包内打包）：
+
+| 依赖 | 版本要求 | 说明 |
+|------|---------|------|
+| `vue` | ^2.6.0 | Vue 核心框架 |
+| `vue-router` | ^3.0.0 | 路由管理 |
+| `vuex` | ^3.0.0 | 状态管理 |
+| `vant` | ^2.5.0 | 移动端组件库 |
+| `element-ui` | ^2.7.0 | 桌面端组件库 |
+
+### 包内依赖（dependencies）
+
+以下依赖已**打包**在 npm 包中：
+
+- `axios` - HTTP 请求
+- `vue-bus` - 事件总线
+- `flv.js` - FLV 播放器
+- `video.js` - 视频播放器
+- `xgplayer` - 西瓜播放器
+- `tim-js-sdk` - 腾讯 IM SDK
+- 以及其他功能依赖
+
+**为什么不将 vant 和 element-ui 打包进包内？**
+- 避免版本冲突
+- 减小包体积
+- 允许使用方灵活选择版本
 
 ## 构建和发布