120 lines
2.3 KiB
Markdown
120 lines
2.3 KiB
Markdown
# Demo 项目启动说明
|
||
|
||
## ✅ 配置完成
|
||
|
||
Demo 项目已配置为使用打包好的框架 JS 文件。
|
||
|
||
## 🚀 启动步骤
|
||
|
||
### 1. 确保框架文件已复制
|
||
|
||
检查文件是否存在：
|
||
```
|
||
demo-project/src/libs/admin-framework.js
|
||
```
|
||
|
||
如果不存在，在项目根目录执行：
|
||
```powershell
|
||
Copy-Item "dist\admin-framework.js" "demo-project\src\libs\admin-framework.js" -Force
|
||
```
|
||
|
||
### 2. 启动开发服务器
|
||
|
||
**方法一：使用命令行**
|
||
```bash
|
||
cd demo-project
|
||
npm run dev
|
||
```
|
||
|
||
**方法二：使用 start.bat（Windows）**
|
||
```bash
|
||
cd demo-project
|
||
start.bat
|
||
```
|
||
|
||
**方法三：使用 start.sh（Linux/Mac）**
|
||
```bash
|
||
cd demo-project
|
||
./start.sh
|
||
```
|
||
|
||
### 3. 访问应用
|
||
|
||
打开浏览器访问：
|
||
- **开发环境**：http://localhost:8080
|
||
- **测试账号**：admin / admin123
|
||
|
||
## 📝 注意事项
|
||
|
||
1. **端口占用**
|
||
- 如果 8080 端口被占用，webpack 会自动使用其他端口
|
||
- 查看终端输出的实际端口号
|
||
|
||
2. **首次启动**
|
||
- 首次启动可能需要较长时间编译
|
||
- 等待 "Compiled successfully" 消息
|
||
|
||
3. **热更新**
|
||
- 修改代码后会自动刷新浏览器
|
||
- 如果没有自动刷新，手动刷新页面
|
||
|
||
## 🔍 故障排查
|
||
|
||
### 问题：找不到 admin-framework.js
|
||
|
||
**错误信息**：
|
||
```
|
||
Module not found: Error: Can't resolve './libs/admin-framework.js'
|
||
```
|
||
|
||
**解决方案**：
|
||
```powershell
|
||
# 在项目根目录执行
|
||
Copy-Item "dist\admin-framework.js" "demo-project\src\libs\admin-framework.js" -Force
|
||
```
|
||
|
||
### 问题：端口被占用
|
||
|
||
**错误信息**：
|
||
```
|
||
Error: listen EADDRINUSE: address already in use :::8080
|
||
```
|
||
|
||
**解决方案**：
|
||
1. 关闭占用 8080 端口的程序
|
||
2. 或修改 `webpack.config.js` 中的端口配置
|
||
|
||
### 问题：编译错误
|
||
|
||
**解决方案**：
|
||
1. 检查 `src/main.js` 的引用路径是否正确
|
||
2. 确保 `admin-framework.js` 文件完整
|
||
3. 删除 `node_modules` 重新安装：
|
||
```bash
|
||
rm -rf node_modules
|
||
npm install
|
||
```
|
||
|
||
## 📚 相关文档
|
||
|
||
- `使用打包框架说明.md` - 详细使用说明
|
||
- `框架更新完成.md` - 更新记录
|
||
- `README.md` - 项目说明
|
||
|
||
## 🎯 下一步
|
||
|
||
启动成功后：
|
||
1. 使用测试账号登录
|
||
2. 测试菜单导航功能
|
||
3. 测试系统管理功能
|
||
4. 查看浏览器控制台，确保没有错误
|
||
|
||
---
|
||
|
||
**当前状态**：✅ 就绪
|
||
|
||
**框架版本**：1.0.0
|
||
|
||
**启动命令**：`npm run dev`
|
||
|