191 lines
4.5 KiB
Markdown
191 lines
4.5 KiB
Markdown
# Aspose.CAD for Java 安装运行指南
|
||
|
||
## 📋 概述
|
||
|
||
本指南将帮助您安装和运行Java版本的DWG颜色元素提取器，以解决Python版本的API问题。
|
||
|
||
## 🔧 环境安装
|
||
|
||
### 1. 安装Java环境
|
||
|
||
#### Windows系统
|
||
1. 访问 [Oracle Java下载页面](https://www.oracle.com/java/technologies/downloads/)
|
||
2. 下载Java 8或Java 11的Windows版本
|
||
3. 运行安装程序，按照提示完成安装
|
||
4. 设置环境变量：
|
||
- 打开"系统属性" → "高级" → "环境变量"
|
||
- 新建系统变量：`JAVA_HOME` = `C:\Program Files\Java\jdk1.8.0_XXX`
|
||
- 编辑Path变量，添加：`%JAVA_HOME%\bin`
|
||
|
||
#### 验证Java安装
|
||
```cmd
|
||
java -version
|
||
javac -version
|
||
```
|
||
|
||
### 2. 安装Maven
|
||
|
||
#### Windows系统
|
||
1. 访问 [Apache Maven下载页面](https://maven.apache.org/download.cgi)
|
||
2. 下载Binary zip archive版本
|
||
3. 解压到 `C:\Program Files\Apache\maven`
|
||
4. 设置环境变量：
|
||
- 新建系统变量：`MAVEN_HOME` = `C:\Program Files\Apache\maven`
|
||
- 编辑Path变量，添加：`%MAVEN_HOME%\bin`
|
||
|
||
#### 验证Maven安装
|
||
```cmd
|
||
mvn -version
|
||
```
|
||
|
||
## 🚀 项目运行
|
||
|
||
### 1. 准备项目文件
|
||
|
||
确保以下文件存在：
|
||
```
|
||
problem/java/
|
||
├── pom.xml
|
||
├── README.md
|
||
└── src/main/java/DwgColorExtractor.java
|
||
```
|
||
|
||
### 2. 准备测试文件
|
||
|
||
将DWG文件复制到 `problem/java/` 目录：
|
||
```
|
||
problem/java/
|
||
├── 测试图纸文件.dwg
|
||
├── 25-014.dwg
|
||
└── ... (其他DWG文件)
|
||
```
|
||
|
||
### 3. 编译项目
|
||
|
||
打开命令提示符，进入项目目录：
|
||
```cmd
|
||
cd "C:\Users\83500\久翌\CAD编辑同步excel\测试文件区\problem\java"
|
||
mvn clean compile
|
||
```
|
||
|
||
### 4. 运行程序
|
||
|
||
```cmd
|
||
mvn exec:java -Dexec.mainClass="DwgColorExtractor"
|
||
```
|
||
|
||
### 5. 查看结果
|
||
|
||
程序运行后，会在 `output/` 目录中生成结果文件：
|
||
```
|
||
output/
|
||
├── 测试图纸文件_color_elements.csv
|
||
├── 测试图纸文件_color_elements.json
|
||
└── 测试图纸文件_color_elements_report.txt
|
||
```
|
||
|
||
## 🔍 故障排除
|
||
|
||
### 常见问题及解决方案
|
||
|
||
#### 1. Java环境问题
|
||
**问题**: `'java' 不是内部或外部命令`
|
||
**解决**:
|
||
- 检查JAVA_HOME环境变量是否正确设置
|
||
- 检查Path变量是否包含Java的bin目录
|
||
- 重启命令提示符
|
||
|
||
#### 2. Maven环境问题
|
||
**问题**: `'mvn' 不是内部或外部命令`
|
||
**解决**:
|
||
- 检查MAVEN_HOME环境变量是否正确设置
|
||
- 检查Path变量是否包含Maven的bin目录
|
||
- 重启命令提示符
|
||
|
||
#### 3. 依赖下载失败
|
||
**问题**: Maven无法下载依赖
|
||
**解决**:
|
||
- 检查网络连接
|
||
- 尝试使用国内镜像源
|
||
- 清理Maven缓存：`mvn clean`
|
||
|
||
#### 4. 编译错误
|
||
**问题**: 编译时出现错误
|
||
**解决**:
|
||
- 检查Java版本是否兼容
|
||
- 检查pom.xml文件是否正确
|
||
- 查看详细错误信息
|
||
|
||
#### 5. 运行时错误
|
||
**问题**: 程序运行时出现错误
|
||
**解决**:
|
||
- 检查DWG文件是否存在
|
||
- 检查文件权限
|
||
- 查看详细错误信息
|
||
|
||
### 调试模式
|
||
|
||
启用详细日志输出：
|
||
```cmd
|
||
mvn exec:java -Dexec.mainClass="DwgColorExtractor" -Dexec.args="--debug"
|
||
```
|
||
|
||
## 📊 预期结果
|
||
|
||
如果Java版本工作正常，您应该看到：
|
||
|
||
1. **成功加载DWG文件**
|
||
```
|
||
✓ 成功加载DWG文件
|
||
图像尺寸: 4794836 x 1171005
|
||
```
|
||
|
||
2. **找到CAD实体**
|
||
```
|
||
找到 X 个块
|
||
找到 Y 个实体
|
||
找到 Z 个图层
|
||
```
|
||
|
||
3. **提取到目标颜色元素**
|
||
```
|
||
成功提取 N 个目标颜色元素
|
||
```
|
||
|
||
4. **生成结果文件**
|
||
```
|
||
✓ CSV文件已保存: output/测试图纸文件_color_elements.csv
|
||
✓ JSON文件已保存: output/测试图纸文件_color_elements.json
|
||
✓ 统计报告已保存: output/测试图纸文件_color_elements_report.txt
|
||
```
|
||
|
||
## 🎯 与Python版本的对比
|
||
|
||
| 功能 | Python版本 | Java版本 |
|
||
|------|------------|----------|
|
||
| 文件加载 | ✅ 正常 | ✅ 正常 |
|
||
| CAD实体访问 | ❌ 失败 | ✅ 正常 |
|
||
| 颜色提取 | ❌ 失败 | ✅ 正常 |
|
||
| 坐标获取 | ❌ 失败 | ✅ 正常 |
|
||
| 结果保存 | ❌ 失败 | ✅ 正常 |
|
||
|
||
## 📝 注意事项
|
||
|
||
1. **许可证要求**: Java版本也需要有效的Aspose.CAD许可证
|
||
2. **性能差异**: Java版本可能有更好的性能
|
||
3. **API差异**: Java版本的API与Python版本不同
|
||
4. **依赖管理**: 需要正确配置Maven依赖
|
||
|
||
## 🔗 相关链接
|
||
|
||
- [Aspose.CAD for Java 文档](https://docs.aspose.com/cad/java/)
|
||
- [Java 8 官方文档](https://docs.oracle.com/javase/8/docs/)
|
||
- [Maven 官方文档](https://maven.apache.org/guides/)
|
||
- [OpenJDK 下载](https://openjdk.org/)
|
||
|
||
---
|
||
|
||
**指南版本**: 1.0
|
||
**最后更新**: 2024-12-19
|
||
**适用系统**: Windows 10/11
|