bim_engine/demo-vue/README.md

BIM Engine SDK Vue3 Demo

这是一个使用 Vue3 + TypeScript 的演示项目，用于验证 BIM Engine SDK 在 Vue 环境下的兼容性。

前置要求

1. 确保父项目已经构建完成：

   cd ..
   npm run build
   

2. 安装依赖：

   npm install
   

3. 复制 SDK 文件到 public 目录：

   npm run copy-sdk
   

   或者手动复制：

   mkdir -p public/lib
   cp ../dist/bim-engine-sdk.umd.js public/lib/
   cp ../dist/bim-engine-sdk.umd.js.map public/lib/
   

运行

开发模式

npm run dev

服务器会在 http://localhost:8081 启动，并自动打开浏览器。

构建

npm run build

构建后的文件会在 dist 目录中。

预览构建结果

npm run preview

项目结构

demo-vue/
├── src/
│   ├── App.vue          # 主组件（包含所有功能）
│   ├── main.ts          # Vue3 入口文件
│   ├── style.css        # 全局样式
│   └── vite-env.d.ts    # TypeScript 类型声明
├── public/
│   ├── lib/             # SDK 文件目录
│   │   └── bim-engine-sdk.umd.js
│   └── model/           # 3D 模型文件
│       └── gujianzhu.glb
├── index.html           # HTML 入口
├── package.json         # 项目配置
├── vite.config.ts      # Vite 配置
├── tsconfig.json        # TypeScript 配置
└── README.md           # 说明文档

使用说明

1. 点击 "初始化引擎" 按钮初始化 3D 引擎
2. 点击 "加载模型" 按钮加载 3D 模型
3. 其他功能按钮可以测试 SDK 的各种功能

技术栈

• Vue 3.4+ (Composition API)
• TypeScript 5.9+
• Vite 7.2+

注意事项

• 确保父项目的 dist 目录中有构建好的 SDK 文件
• 模型文件路径是相对于 public 目录的
• 使用 HTTP 服务器运行（不能直接打开 HTML 文件）以避免 CORS 问题