Python 工具箱(.pyt 文件)是一个简单的文本文件,可以在任何文本编辑器(如 Microsoft Notepad 或 VI 等)中或者任何 Python 集成开发环境 (IDE) 中创建、查看和编辑。
将工具箱创建为名为 Toolbox 的类。 在 Toolbox 类的 __init__ 方法中已定义工具箱的属性,其中包括 alias、label 和 description。 工具箱的名称由 .pyt 文件的名称定义。 必须将 tools 属性设置为包含工具箱中定义的所有工具类的列表。
提示:
要确保正确识别 Python 工具箱,该工具箱类的名称必须仍为 Toolbox。
默认情况下,Python 工具箱模板创建名为 Tool 的无存根工具。 Python 工具箱模板主题中提供了用于创建 Python 工具箱的模板代码。
注:
在与 ArcGIS Pro 中的 Python 工具箱交互时,将加载工具箱代码。 首次加载工具箱时或在 ArcGIS Pro 检测代码变化时,应用程序会提示您确认是否信任代码源。 随后可以授予或拒绝加载工具箱权限。
ArcGIS Pro 在加载工具箱时会立即在顶层运行任意代码(在函数或方法外部)。 这可能导致异常行为。 此外,在顶层调用的一些 ArcPy 函数可能无法按预期运行。
为了防止异常行为,将代码包含在函数或方法块中。
要创建 Python 工具箱,请完成以下步骤:
- 在目录窗格中,单击工具箱。
- 单击新建。
- 浏览至要保存 Python 工具箱的文件夹,在名称文本框内提供名称,然后单击保存。