安装 Python

要在 Python 中编写 UDT 脚本，您必须在计算机上安装 Python 和 Python 语言服务器。该安装将为应用程序执行脚本提供必需的运行环境。

重要信息

• 在安装 Python 之前，请关闭所有 InTouch 应用程序。

• 仅支持 32 位 Python。

• 您必须以管理员权限运行。

• 如果安装过程中发生错误，请检查日志文件以进行故障排除。

自动安装 Python 和 Python 语言服务器

以管理员权限运行以下自动化的 PowerShell 脚本。

InTouch-install-python-lsp.ps1

手动安装 Python 和 Python 语言服务器

注意：仅当自动化的 PowerShell 脚本安装失败，或您选择手动安装时，才执行以下步骤。如果已通过自动化的 PowerShell 脚本安装了 Python 和 Python 语言服务器，则可以跳过这些步骤。

1. 从 https://www.python.org/ftp/python/3.12.10/python-3.12.10.exe 下载安装程序文件。

2. 右键单击可执行文件，以管理员身份运行。

3. 在打开文件 - 安全警告对话框中，选择运行。

4. 在安装 Python 窗口中执行以下操作：

   1. 勾选添加 python.exe 到系统路径复选框

   2. 选择自定义安装。

   

5. 在可选功能窗口，勾选所有用户（需要管理员权限）复选框，然后选择下一步。

   

6. 在高级选项窗口中执行以下操作：

   1. 勾选为所有用户安装 Python 3.12 复选框。

   2. 核对自定义安装位置字段。

   3. 选择安装

   

7. 等待安装完成。在安装成功对话框中，选择禁用路径长度限制选项，然后选择关闭。

8. 设置环境变量路径（InTouch 使用专用的 Python 环境变量）。

   1. 打开“环境变量”。

   2. 按 Win + R，键入 sysdm.cpl，按 Enter。

   3. 转到高级选项卡，然后选择环境变量

   4. 在“系统变量”下创建变量，选择新建。

   5. 设置如下：

      • 变量名：INTOUCH_PYTHON_HOME

      • 变量值：Python 安装路径。示例：C:\Program Files (x86)\Python312-32。

   6. 选择确定以保存。

9. 添加到系统路径（可选但建议执行）

   1. 在系统变量下，找到“Path”。

   2. 选择编辑，然后选择新建。

   3. 添加以下内容：

      • %INTOUCH_PYTHON_HOME%

      • %INTOUCH_PYTHON_HOME%\Scripts

   4. 选择确定，然后再次选择确定保存。

10. 打开命令提示，运行以下命令：

    1. pip install python-lsp-server — 安装 Python 语言服务器 (LSP) 到您的 Python 环境中。

    2. python -m pip install python-lsp-server[websockets] — 安装 WebSocket 支持。

11. 安装 PythonLanguageServerPlugin

    1. 请确认 PythonLanguageServerPlugin 文件夹位于以下路径：

       C:\Program Files (x86)\Common Files\ArchestrA\Services\InTouchScriptingService

    2. 导航至 Python 安装目录：C:\Program Files (x86)\Python312-32

    3. 打开命令提示，运行以下命令：

       python.exe -m pip install "C:\Program Files (x86)\Common Files\ArchestrA\Services\InTouchScriptingService\PythonLanguageServerPlugin

12. 重启计算机以应用环境路径变更。