创建和存储脚本

Altium Designer 脚本通常创建并存储在脚本项目 (*.PrjScr) 中创建和存储，但也可添加或存储到任何类型的项目中。

要开始编写脚本，首先要创建一个新的脚本项目，并将脚本文件添加到该项目中。

创建脚本项目和脚本

脚本项目可以帮助你管理脚本，可以通过从主菜单中选择 File » New » Script » Script Project创建脚本项目。

新项目 (Script_Project1.PrjScr) 用来存储脚本的新项目将列在 "项目 "面板中。

要在项目中添加新脚本，请右键单击项目名称，然后从右键菜单中选择 Add New to Project。

建立了新脚本项目后，就可以向项目中添加新脚本了。

创建新脚本时，可根据项目要求选择两种脚本类型--脚本单元和脚本表格。

脚本类型

脚本单元

脚本单元是具有特定语言语法的脚本文档，例如 DelphiScript。

包含脚本代码的脚本单元。

脚本窗体

脚本窗体是一个窗口，可容纳一系列控件，如按钮、备忘和列表框等，这些控件可带有事件处理程序。在编辑器中，脚本窗体有两个视图，可使用 Code和 Form选项卡进行选择，如下图脚本文档底部所示。

已打开代码和表单选项卡的脚本表单。

项目中的脚本关系

当一个项目中有多个脚本时，该项目中的任何脚本（使用相同的语言集）都可以访问全局变量和过程。项目中的所有脚本实际上都是 "可见 "的，因此一个脚本中的存储过程可以调用同一脚本项目中不同脚本中的另一个存储过程。

同一项目中的脚本必须具有唯一的存储过程和全局变量名称。一种方法是将不同脚本中使用的所有常用存储过程/函数移到同一项目中的一个新脚本中。这样，新的通用脚本中的过程和函数就可以在不同的脚本项目中方便地重复使用。

► 有关从另一个脚本调用过程的示例，请参阅编写脚本。

将脚本项目上传到连接工作区

Altium Designer 与所连接的工作区相结合，可以创建和管理工作区脚本。这些脚本直接在工作区中创建，相关的脚本项目 (*.PrjScr) 上传至目标工作区脚本的修订版。具体过程如下

1. 在连接的工作区中创建一个新的脚本项，使用 Explorer面板创建一个新的脚本项。有关在工作区创建项的更多信息，请参阅 "创建和编辑内容"页面。

2. 右键单击面板上所需的脚本项，然后选择 Explorer面板中的所需脚本项上单击右键，然后从上下文菜单中选择 Upload命令。标准的 Windows Open对话框，浏览所需的脚本项目文件 (*.PrjScr).

   如果项目没有计划修订版，上载将上载到下一个计划修订版，该修订版将在上载过程中即时创建。

   
   指定要上传到目标脚本项的脚本项目文件。

3. 选择所需文件后，单击 Open按钮进行上传。项目文件以及同一文件夹中的所有文件都会上载到修订版中，并在该修订版的 Details面板的 Explorer面板中。

   
   上载的项目以及同一文件夹中的所有文件都会在 Details方面视图选项卡中列出。

另外，也可将选定的脚本项目文件和相关源文件从 Windows 资源管理器中的源文件夹拖入新的工作区脚本中，然后拖入面板中的所需文件夹。 Explorer面板中的所需文件夹。对话框 Create New Item对话框将出现，拖动的文件将列在 Sources区域。该 Name项将是文件名，包括扩展名（条目之间用分号隔开）。文件名 Description的格式为 Uploaded from , Size , Created on (条目用分号分隔）。根据需要更改。的 Item ID将与文件夹级别定义的项目命名方案一致。如果文件夹没有定义命名方案，命名将按照 $CONTENT_TYPE_CODE-{000000}方案。

使用拖放方法将脚本项目和相关文件上传到新创建的工作区脚本的初始修订版。

编辑工作区脚本

在任何阶段，你都可以返回到工作区脚本的任何修订版并直接对其进行编辑。右键单击 Explorer面板上单击右键，然后从上下文菜单中选择 Edit命令。这将在 Altium Designer 中打开该修订版，可根据需要对其进行编辑，然后使用 Save to server命令（快捷键 Ctrl+Alt+S) - 可从右键单击上下文菜单中获取。 Projects面板中与项目条目相关的右键上下文菜单。

访问该命令可直接编辑脚本的现有版本。

如果你需要更改存储在工作区脚本中的项目或相关源文件，并拥有更新后的源文件，你可以将这些文件上传到该工作区脚本，新文件将存储在该工作区脚本的下一个修订版中。

全局项目

脚本项目可以使用 Global Projects功能安装脚本项目，以便在软件启动时预载和使用它们。这些脚本中的全局变量和程序可在其他打开的脚本项目中使用。

要将脚本项目设置为全局项目，请通过对话框导航到脚本系统 - 全局项目页面。 Preferences对话框导航到脚本系统 - 全局项目页面。使用 Install 按钮导航到并从文件或工作区中选择一个项目。对所有要全局化的脚本项目重复此过程。

只要用户连接到工作区，Altium Designer 就可以使用已安装的工作区脚本项目。请注意，已安装的 Workspace 脚本项目是按照其在工作区文件夹结构中的位置或 "路径 "以及包含脚本项目数据的 Workspace 脚本的 ID 列出的。

使用 Scripting System – Global Projects对话框中的 Preferences对话框安装脚本。

全局项目允许本地项目中相同类型的脚本使用已安装的全局脚本项目中的例程。当 Select item to Run对话框 (File » Run Script）时，已安装的脚本项目将与当前打开的其他脚本项目一起显示在 Projects 面板中打开的其他脚本项目。