Python installieren

Um die UDT-Skripte in Python zu schreiben, müssen Sie Python und den Python-Sprachserver auf Ihrem Computer installieren. Diese Installation bietet die nötige Umgebung für die Ausführung Ihrer Skripte.

Wichtige Informationen

• Schließen Sie alle InTouch-Projekte, bevor Sie Python installieren.

• Nur 32-Bit-Python wird unterstützt.

• Sie müssen mit erhöhten Rechten ausführen.

• Wenn während der Installation ein Fehler auftritt, überprüfen Sie die Protokolldatei zur Fehlerbehebung.

Python und Python-Sprachserver automatisch installieren

Führen Sie das folgende automatisierte PowerShell-Skript mit erhöhten (Administrator-) Rechten aus.

InTouch-install-python-lsp.ps1

Python und Python-Sprachserver manuell installieren

Hinweis: Führen Sie die folgenden Schritte nur aus, wenn bei der automatisierten Installation des PowerShell-Skripts ein Fehler auftritt oder wenn Sie sich für die manuelle Installation entscheiden. Sie können diese Schritte überspringen, wenn Python und der Python-Sprachserver bereits mithilfe des automatisierten PowerShell-Skripts installiert wurden.

1. Laden Sie die Installationsprogrammdatei von https://www.python.org/ftp/python/3.12.10/python-3.12.10.exe herunter.

2. Klicken Sie mit der rechten Maustaste auf die ausführbare Datei, und wählen Sie Als Administrator ausführen.

3. Wählen Sie im Dialogfeld Datei öffnen - Sicherheitswarnung die Option Ausführen.

4. Führen Sie im Fenster Install Python die folgenden Schritte aus:

   1. Aktivieren Sie das Kontrollkästchen Add python.exe to PATH.

   2. Wählen Sie Customize Installation.

   

5. Aktivieren Sie im Fenster Optional Features das Kontrollkästchen for all users (requires admin privileges) und klicken Sie dann auf Next.

   

6. Führen Sie im Fenster Advanced Options die folgenden Schritte aus:

   1. Aktivieren Sie das Kontrollkästchen Install Python 3.12 for all users.

   2. Überprüfen Sie das Feld Customize install location.

   3. Wählen Sie Install aus.

   

7. Warten Sie, bis die Installation abgeschlossen ist. Wählen Sie im Dialogfeld Successful installation die Option Disable Path Length und wählen Sie dann Close aus.

8. Umgebungspfad festlegen (InTouch verwendet eine eindeutige Python-Umgebungsvariable).

   1. Öffnen Sie „Umgebungsvariablen“.

   2. Drücken Sie Win+R, geben Sie sysdm.cpl ein und drücken Sie die Eingabetaste.

   3. Gehen Sie zur Registerkarte Erweitert und wählen Sie Umgebungsvariablen.

   4. Erstellen Sie die Variable unter Systemvariablen und wählen Sie Neu.

   5. Legen Sie Folgendes fest:

      • Variablenname: INTOUCH_PYTHON_HOME

      • Variablenwert: Pfad zu Ihrer Python-Installation. Beispiel: C:\Programme (x86)\Python312-32.

   6. Wählen Sie zum Speichern OK aus.

9. Zum Pfad hinzufügen (optional, aber empfohlen)

   1. Suchen Sie unter Systemvariablen nach „Pfad“.

   2. Wählen Sie Bearbeiten und dann Neu aus.

   3. Fügen Sie Folgendes hinzu:

      • %INTOUCH_PYTHON_HOME%

      • %INTOUCH_PYTHON_HOME%\Scripts

   4. Wählen Sie OK und dann erneut OK zum Speichern aus.

10. Öffnen Sie eine Eingabeaufforderung, und führen Sie die folgenden Befehle aus:

    1. pip install python-lsp-server: zum Installieren von Python Language Server (LSP) in Ihrer Python-Umgebung.

    2. python -m pip install python-lsp-server[websockets]: für WebSocket-Unterstützung.

11. PythonLanguageServerPlugin installieren

    1. Stellen Sie sicher, dass der Ordner „PythonLanguageServerPlugin“ unter dem folgenden Pfad vorhanden ist:

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

    2. Navigieren Sie zum Python-Installationsverzeichnis: C:\Programme (x86)\Python312-32

    3. Öffnen Sie eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus:

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

12. Starten Sie den Computer neu, damit die Pfadänderungen wirksam werden.