PCB设计软件：Altium Designer二次开发_（19）.AltiumDesigner二次开发最佳实践.docx

PAGE1

PAGE1

AltiumDesigner二次开发最佳实践

1.环境搭建与配置

1.1安装AltiumDesigner

在开始二次开发之前，首先需要确保您已经安装了最新版本的AltiumDesigner。您可以从Altium官网下载安装包，并按照提示进行安装。安装过程中，请确保选择开发工具和SDK等相关组件，以便后续开发工作顺利进行。

1.2配置开发环境

AltiumDesigner的二次开发主要基于其提供的Script和Add-InAPI。开发环境的配置包括以下步骤：

安装VisualStudio：

选择安装VisualStudioCommunity版或其他版本，确保安装了C#和C++开发工具。

打开VisualStudioInstaller，选择“修改”已安装的VisualStudio版本，确保安装了以下组件：

.NET桌面开发

C++桌面开发

安装AltiumDesignerSDK：

从AltiumDesigner的安装目录中找到SDK安装包，通常是AltiumDesignerInstallationDirectory\SDK。

运行SDK安装包，按照提示完成安装。

安装完成后，SDK文档和示例代码将安装在指定目录下，例如C:\ProgramFiles\AltiumDesigner\SDK。

配置VisualStudio项目：

打开VisualStudio，创建一个新的C#或C++项目。

在项目中添加对AltiumDesignerSDK的引用。具体步骤如下：

右键点击解决方案资源管理器中的项目，选择“管理NuGet程序包”。

在“浏览”选项卡中搜索并安装Altium.Scripting和Altium.AddIn包。

或者手动添加引用：

右键点击项目，选择“添加”-“引用”。

在“浏览”选项卡中，导航到SDK安装目录下的bin文件夹，选择相应的DLL文件。

1.3创建第一个脚本

1.3.1脚本类型

AltiumDesigner支持多种脚本类型，包括：

C#脚本：使用C#语言编写，适用于复杂的逻辑处理。

VBScript脚本：使用VBScript语言编写，适用于简单的脚本任务。

JScript脚本：使用JScript语言编写，适用于简单的脚本任务。

1.3.2创建C#脚本

创建项目：

打开VisualStudio，选择“文件”-“新建”-“项目”。

选择“控制台应用(.NETFramework)”，命名为MyFirstAltiumScript，点击“创建”。

添加引用：

右键点击项目，选择“管理NuGet程序包”。

搜索并安装Altium.Scripting包。

编写代码：

在Program.cs文件中编写以下代码：

usingSystem;

usingAltium.DXP;//引入AltiumDesigner的命名空间

classProgram

{

staticvoidMain(string[]args)

{

//创建AltiumDesigner的实例

varapplication=newSchServer();

//检查是否成功创建实例

if(application==null)

{

Console.WriteLine(无法连接到AltiumDesigner);

return;

}

//获取当前打开的原理图文档

vardocument=application.ActiveDocument;

//检查是否有文档打开

if(document==null)

{

Console.WriteLine(没有打开的原理图文档);

return;

}

//输出当前文档的名称

Console.WriteLine($当前打开的原理图文档:{document.Name});

//关闭AltiumDesigner实例

application.Quit();

}

}

运行脚本：

确保AltiumDesigner已经打开，并且有一个原理图文档处于活动状态。

在VisualStudio中按F5键运行脚本，您将在控制台中看到当前打开的原理图