FreeCAD-Addon installieren

Diese Seite beschreibt die Einrichtung eines normalen FreeCAD-Arbeitsplatzes. Für Entwicklung und interne Details siehe das FreeCAD-Addon Handbuch.

Voraussetzungen

Du brauchst:

• FreeCAD 1.1,
• die URL des PLM-Servers,
• einen PLM-Benutzer,
• ein API-Token mit read write checkout,
• einen beschreibbaren lokalen Workspace, normalerweise ~/FreeCAD-PLM.

admin ist nur zusätzlich nötig, wenn du im Addon neue Projekte anlegen oder Projektstammdaten ändern willst.

Installation über den FreeCAD Addon Manager

Füge im Addon Manager dieses benutzerdefinierte Repository hinzu:

https://git.home.schumbi.de/ralf/freecad-plm-addon

Branch:

main

Installiere anschließend FreeCAD-PLM, starte FreeCAD neu und wähle die Workbench FreeCAD-PLM.

Beim Neustart registriert das Addon freecad-plm:// automatisch für den aktuellen Benutzer:

• Linux und Linux-Flatpak: als XDG-MIME-Handler im Benutzerprofil,
• Windows: unter HKCU\Software\Classes, ohne Administratorrechte.

Der Handler startet FreeCAD bei Bedarf oder übergibt den Link an die bereits laufende Instanz. Browser fragen beim ersten Öffnen einer externen Anwendung meist noch einmal nach. Falls die Zuordnung fehlt oder von einer anderen Anwendung überschrieben wurde, wähle in FreeCAD FreeCAD-PLM -> Web-Link-Handler einrichten.

Installation aus einem Checkout

Den tatsächlich verwendeten FreeCAD-Benutzerordner findest du in der Python-Konsole:

import FreeCAD as App
App.getUserAppDataDir()

Das Addon muss darunter als Ordner Mod/freecad-plm-addon liegen. Typische Pfade sind:

Linux Flatpak: ~/.var/app/org.freecad.FreeCAD/data/FreeCAD/v1-1/Mod/freecad-plm-addon
Linux nativ:   ~/.local/share/FreeCAD/Mod/freecad-plm-addon
Windows:       %APPDATA%\FreeCAD\v1-1\Mod\freecad-plm-addon

Verbindung einrichten

1. Workbench FreeCAD-PLM auswählen.
2. PLM-Verbindung aktivieren anklicken.
3. Verbindungseinstellungen öffnen.
4. Server-URL ohne abschließenden API-Pfad eintragen, zum Beispiel https://plm.example.local.
5. API-Token eintragen.
6. Workspace setzen, normalerweise ~/FreeCAD-PLM.
7. Slicer auf Automatisch erkennen, Bambu Studio, OrcaSlicer oder Benutzerdefiniert stellen.
8. Speichern und verbinden wählen.

Das Ausgabefenster meldet anschließend unter dem Präfix [FreeCAD-PLM], wie viele Projekte und aktive Checkouts geladen wurden.

Funktionstest

1. Ein Projekt im Baum aufklappen.
2. Ein Teil und eine Revision aufklappen.
3. Eine Revision über Mehr -> Schreibgeschützt öffnen laden.
4. Prüfen, dass die Datei aus dem Workspace geöffnet wird.
5. Danach eine FCStd-Revision in der Web-Oberfläche öffnen und In FreeCAD bearbeiten anklicken. Der Browser darf nachfragen; anschließend muss in FreeCAD die Checkout-Bestätigung erscheinen.

Erzeuge in Schritt 1 bis 4 noch keinen Checkout. Schreibgeschütztes Öffnen prüft Verbindung, Token, Download und Hashkontrolle ohne einen Server-Lock zu setzen. Schritt 5 darf vor der Checkout-Bestätigung abgebrochen werden.

Addon auf einem weiteren Rechner

Installiere das Addon dort auf dieselbe Weise. Der zweite Rechner darf einen eigenen lokalen Workspace verwenden. Projekt- und Slicerstände werden vom PLM-Server geladen; ~/FreeCAD-PLM muss nicht zwischen Rechnern kopiert oder mit einem Dateisynchronisationsdienst geteilt werden.

Aktualisieren

Bei einer Addon-Manager-Installation verwendest du dessen Update-Funktion und startest FreeCAD danach neu. Bei einem Git-Checkout:

git -C /pfad/zu/freecad-plm-addon pull --ff-only

Prüfe immer den Pfad, den App.getUserAppDataDir() tatsächlich verwendet. Der Ordner ~/FreeCAD-PLM ist der Arbeitsbereich und nicht das Addon-Repository.

Weiter

• Revision öffnen oder ansehen
• Revision auschecken
• Neues Teil anlegen
• Slicerprojekt bearbeiten