# AutoCADDotNetLibrary.Debug

**Repository Path**: geekfish/AutoCADDotNetLibrary.Debug

## Basic Information

- **Project Name**: AutoCADDotNetLibrary.Debug
- **Description**: 提供AutoCAD二次开发，用于省略netload命令，快速生成Visual Studio测试环境的MSBuild脚本。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2025-06-02
- **Last Updated**: 2025-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AutoCADDotNetLibrary.Debug

提供`AutoCAD`二次开发，用于省略`netload`命令，快速生成`Visual Studio`测试环境的`MSBuild`脚本。

![](https://img.shields.io/badge/IDE-vs2022-blue)

## 快速使用

在`nuget`上搜索并安装`AutoCADDotNetLibrary.Debug`即可使用。

```xml
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net472</TargetFramework>

    <AutoCADDebugVersion>2013</AutoCADDebugVersion>
    <AutoCADMinVersion>2013</AutoCADMinVersion>
    <AutoCADMaxVersion>2024</AutoCADMaxVersion>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="AutoCADDotNetLibrary.Debug" Version="0.9.0" />
  </ItemGroup>

</Project>
```

- 运行`Visual Studio`的`重新生成`时，会执行下面的功能：
  - 写入`AutoCADDebugVersion`指定版本的[AutoCAD 注册表](https://help.autodesk.com/view/OARX/2019/CHS/?guid=GUID-70D60274-57E0-4B22-8D0C-3C7F212A7CAF)。
  - 根据`AutoCADDebugVersion`生成`Visual Studio`的测试文件`Properties\launchSettings.json`。
  - 根据`AutoCADMinVersion`和`AutoCADMaxVersion`，生成`注册*.bat`和`注销.bat`的脚本。
- 运行`Visual Studio`的`清理`时，会执行下面的功能：
  - 删除程序**全部**的`AutoCAD注册表`。
  - 删除注册和注销的`bat`脚本。
  - 根据`IsDeleteCUIX`，删除`CUIX`。

## 属性

| 属性                | 说明                                           | 有效值                   | 默认值   |
| ------------------- | ---------------------------------------------- | ------------------------ | -------- |
| AutoCADDebugVersion | 指定测试的 AutoCAD 版本。                      | int(2006-2026)，可为空值 |          |
| AutoCADMinVersion   | 指定`bat`脚本的最小 AutoCAD 版本。             | int(2006-2026)，可为空值 |          |
| AutoCADMaxVersion   | 指定`bat`脚本的最大 AutoCAD 版本。             | int(2006-2026)，可为空值 |          |
| AutoCADDescription  | .NET 程序集的说明。                            | string                   | 项目名称 |
| AutoCADLoadctrls    | 控制加载 .NET 程序集的方式和时间。             | int                      | 2        |
| IsDeleteCUIX        | `清理`或执行`注销.bat`时，是否删除 CUIX 文件。 | bool                     | false    |

## 功能

#### 基础知识

程序写入[AutoCAD 注册表](https://help.autodesk.com/view/OARX/2019/CHS/?guid=GUID-70D60274-57E0-4B22-8D0C-3C7F212A7CAF)，AutoCAD 则会自动加载程序，而无需手动`netload`加载。

#### AutoCADDebugVersion

当使用`Visual Studio`的`重新生成`功能时，项目写入`AutoCADDebugVersion`指定的 AutoCAD 版本注册表。并指定此 AutoCAD 版本的`acad.exe`为`Visual Studio`测试环境（生成`Properties\launchSettings.json`）。

#### AutoCADDescription 和 AutoCADLoadctrls

- AutoCADDescription：注册表中的项 DESCRIPTION，代表.NET 程序集的说明，默认值为项目名称。
- AutoCADLoadctrls：注册表中的项 LOADER，代表控制加载 .NET 程序集的方式和时间，默认值为`2`。
  - 1 - 检测到代理对象时加载应用程序
  - 2 - 在启动时加载应用程序
  - 4 - 在命令开始时加载应用程序
  - 8 - 应用户或其他应用程序的请求加载应用程序
  - 16 - 不加载应用程序
  - 32 - 透明地加载应用程序

#### AutoCADMinVersion 和 AutoCADMaxVersion

当使用`Visual Studio`的`重新生成`功能时，生成`注册*.bat`和`注销.bat`的脚本，以便在其他电脑测试程序时，无需手动`netload`加载。

- `注册*.bat`：首先检测是否有此**注册表路径**，成功时写入注册表，错误时不写入。
- `注销.bat`：删除程序**全部**的`AutoCAD注册表`。
- `IsDeleteCUIX`：生成`注销.bat`脚本时，是否加入删除`cuix`文件的功能，默认值为`false`。

#### 清理

当使用`Visual Studio`的`清理`功能时：

- 删除程序**全部**的`AutoCAD注册表`。
- 删除注册和注销的`bat`脚本。
- 根据`IsDeleteCUIX`，删除`CUIX`。

### 兼容 AutoCAD 未来的版本

目前默认值仅支持`2006-2026`版本。由于`AutoCAD`的版本号是无规律的，因此需要定时更新数据。

- 不定时更新：先删除`C:\Users\admin\.nuget\packages\autocaddotnetlibrary.debug\0.9.0`整个文件夹，然后`重新生成`，脚本会重新下载[AutoCADDotNetLibrary.Debug.props](https://gitee.com/wmggy/AutoCADDotNetLibrary.Debug/raw/master/test/AutoCADDotNetLibrary.Debug.props)文件。
- 手动更新：在`C:\Users\admin\.nuget\packages\autocaddotnetlibrary.debug\0.9.0\build\AutoCADDotNetLibrary.Debug.props`增加`AutoCADVersion`项目。

## QQ 群

![QQ群](/docs/img/AutoCADDotNetLibrary%E7%BE%A4%E4%BA%8C%E7%BB%B4%E7%A0%81.png)