94 lines
2.0 KiB
Markdown
94 lines
2.0 KiB
Markdown
# BIM Engine SDK
|
||
|
||
本项目是一个通用的 SDK 开发框架，旨在通过一次编码，同时支持 Vue 2、Vue 3、React 和纯 HTML 环境。
|
||
|
||
## 📁 目录结构
|
||
|
||
```
|
||
.
|
||
├── src/ # SDK 源代码
|
||
│ └── index.ts # 入口文件
|
||
├── dist/ # 构建产物 (ESM + UMD)
|
||
├── examples/ # 各框架集成示例
|
||
│ ├── vue3-demo/ # Vue 3 + Vite
|
||
│ ├── react-demo/ # React + Vite
|
||
│ ├── vue2-demo/ # Vue 2.7 + Vite
|
||
│ └── html-demo/ # 原生 HTML
|
||
├── playground/ # 开发调试演练场 (Vue 3)
|
||
├── vite.config.ts # Vite 构建配置 (Library Mode)
|
||
├── tsconfig.json # TypeScript 配置
|
||
└── package.json # 项目元数据与<E68DAE><E4B88E><EFBFBD>赖
|
||
```
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 开发调试 (Playground)
|
||
|
||
使用内置的 Vue 3 演练场进行开发，支持热更新 (HMR)。
|
||
|
||
```bash
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
### 2. 构建 SDK
|
||
|
||
构建生成 `dist/` 目录，包含 `es` (ESM) 和 `umd` (UMD) 两种格式，以及 `.d.ts` 类型定义。
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
### 3. 运行示例项目
|
||
|
||
`examples` 目录下的项目直接引用了本地 SDK。
|
||
|
||
**运行 Vue 3 Demo:**
|
||
|
||
```bash
|
||
cd examples/vue3-demo
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
**运行 React Demo:**
|
||
|
||
```bash
|
||
cd examples/react-demo
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
**运行 Vue 2 Demo:**
|
||
|
||
```bash
|
||
cd examples/vue2-demo
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
**运行 HTML Demo:**
|
||
|
||
直接在浏览器打开 `examples/html-demo/index.html`。
|
||
|
||
## 🛠️ 技术栈
|
||
|
||
* **语言**: TypeScript
|
||
* **构建工具**: Vite (Library Mode)
|
||
* **类型生成**: vite-plugin-dts
|
||
* **开发环境**: Vue 3 (用于 Playground)
|
||
|
||
## 📦 发布配置
|
||
|
||
`package.json` 配置了 `exports` 字段，确保不同环境自动加载正确的文件：
|
||
|
||
```json
|
||
"exports": {
|
||
".": {
|
||
"types": "./dist/index.d.ts",
|
||
"import": "./dist/bim-engine-sdk.es.js",
|
||
"require": "./dist/bim-engine-sdk.umd.js"
|
||
}
|
||
}
|
||
```
|