live-h5-audience 4.2.3 → 4.2.5

package/CHANGELOG.md

@@ -0,0 +1,114 @@
+# 修复日志 - live-h5-audience
+
+## 版本 4.2.3 (2024-03-11)
+
+### 修复内容
+
+#### 关键问题修复：Cannot redefine property: $router
+
+**问题描述**:
+外部项目引入 `live-h5-audience` 包时报错：
+```
+Uncaught TypeError: Cannot redefine property: $router
+```
+
+**根本原因**:
+包内的 `src/router/index.js` 和 `src/store/index.js` 在模块级别就执行了 `Vue.use(Router)` 和 `Vue.use(Vuex)`，当外部项目也安装了这些插件时，会导致重复注册。
+
+**解决方案**:
+在以下文件中添加插件安装检查：
+
+1. **src/router/index.js**
+   ```javascript
+   // 检查是否已安装，避免重复注册
+   if (!Vue._installedPlugins || !Vue._installedPlugins.find(p => p._name === 'VueRouter')) {
+     Vue.use(Router)
+   }
+   ```
+
+2. **src/store/index.js**
+   ```javascript
+   // 检查是否已安装，避免重复注册
+   if (!Vue._installedPlugins || !Vue._installedPlugins.find(p => p._name === 'Vuex')) {
+     Vue.use(Vuex)
+   }
+   ```
+
+3. **src/package-entry.js**
+   ```javascript
+   // 在 LiveH5.install() 方法中也添加检查
+   try {
+     const VueRouter = require('vue-router')
+     if (!Vue._installedPlugins || !Vue._installedPlugins.find(p => p._name === 'VueRouter')) {
+       Vue.use(VueRouter)
+     }
+   } catch (e) {
+     console.warn('[LiveH5] VueRouter 未安装或安装失败:', e.message)
+   }
+   
+   try {
+     const Vuex = require('vuex')
+     if (!Vue._installedPlugins || !Vue._installedPlugins.find(p => p._name === 'Vuex')) {
+       Vue.use(Vuex)
+     }
+   } catch (e) {
+     console.warn('[LiveH5] Vuex 未安装或安装失败:', e.message)
+   }
+   ```
+
+### 修改文件列表
+
+- `src/router/index.js` - 添加 VueRouter 安装检查
+- `src/store/index.js` - 添加 Vuex 安装检查
+- `src/package-entry.js` - 在插件 install 中添加双重检查
+- `package.json` - 版本号更新为 4.2.3
+
+### 构建结果
+
+执行 `npm run build:lib` 成功构建：
+
+- `dist/index.umd.js` - 2,532.32 KiB (519.61 KiB gzipped)
+- `dist/index.esm.js` - ESM 格式
+- `dist/index.css` - 样式文件
+
+### 使用方法
+
+```bash
+# 安装
+npm install live-h5-audience@4.2.3
+
+# 或使用本地 tgz 文件
+npm install path/to/live-h5-audience-4.2.3.tgz
+```
+
+### 验证步骤
+
+1. 在外部项目中安装包
+2. 在 `main.js` 中引入：
+   ```javascript
+   import Vue from 'vue'
+   import LiveH5, { initLiveH5App } from 'live-h5-audience'
+   import 'live-h5-audience/dist/index.css'
+   
+   Vue.use(LiveH5)
+   Vue.prototype.$liveH5Config = { mode: 'npm' }
+   window.initLiveH5App = initLiveH5App
+   ```
+3. 在组件中调用 `initLiveH5App`
+4. 检查控制台是否有 "Cannot redefine property" 错误
+
+### 已知问题
+
+无
+
+---
+
+## 版本历史
+
+### 4.2.2 (2024-03-11)
+- 首次尝试修复 VueRouter 重复注册问题
+- 仅在 package-entry.js 中添加检查，不完整
+
+### 4.2.1 (2024-03-11)
+- 初始 npm 包版本
+- 存在 VueRouter/Vuex 重复注册问题