# earthsdk3-code
**Repository Path**: cesiumlab/earthsdk3-code
## Basic Information
- **Project Name**: earthsdk3-code
- **Description**: earthsdk3是earthsdk2的底层重构，引擎模块化拆分，依赖重整，代码优化精简，多引擎快速扩展，自定义对象快速扩展；
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://earthsdk.com/earthui/index.html
- **GVP Project**: No
## Statistics
- **Stars**: 6
- **Forks**: 7
- **Created**: 2024-09-24
- **Last Updated**: 2025-07-01
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
🔥开放协作进行中！无论对象还是引擎，期待您提交PR成为的贡献之星！
# 一、项目启动
本工程使用monorepo来解决各个包之间的依赖关系、版本冲突、同步开发等问题;
1.使用 pnpm 工具
```sh
npm install pnpm -g
```
2.安装依赖
根目录下运行
```sh
pnpm install
```
3.启动测试项目 app1
根目录下运行
```sh
pnpm --filter app2 dev
```
# 二、EarthSDK的使用
1.依赖安装
```sh
yarn add earthsdk3
yarn add earthsdk3-ue
yarn add earthsdk3-cesium
```
2.模块使用
```js
import { ESObjectsManager } from 'earthsdk3';
import { ESUeViewer } from 'earthsdk3-ue';
//使用earthsdk3-cesium需要自行在项目中安装和配置cesium，目前支持版本cesium:0.123.1
import { ESCesiumViewer } from 'earthsdk3-cesium';
const objm = new ESObjectsManager (ESUeViewer, ESCesiumViewer);
```
3.直接使用
```html
```
# 三、开发须知
1. 注意交叉引用关系: earthsdk3可在earthsdk3-cesium和earthsdk3-ue中引用;
2. 注意交叉引用关系: earthsdk3-cesium和earthsdk3-ue不能相互引用;
3. 注意交叉引用关系: earthsdk3-cesium和earthsdk3-ue不能在earthsdk3中引用;
4. 构建项目/上传npm包都需要更新各自版本号，必须更改package.json中的version/main/types;
5. package.json中 "main": "./src/index.ts"是为了本地调试时不构建直接导出使用,构建后需还原;
7. earthsdk3-assets是静态资源，新增资源必须放到earthsdk3-assets/assets下，并更新package.json中的version上传npm;
8. 静态资源的使用，earthsdk3-assets/assets/glb/xxx 使用环境变量获取路径 ${earthsdk3-assets-script-dir}/assets/glb/xxx;