Bevor Sie sich auf aufwendiges Debuggen einlassen, verwenden Sie zuerst das integrierte Test-Framework, um zu überprüfen, ob die Standard-Tests einwandfrei ablaufen. Wenn nicht, ist vielleicht eine fehlerhafte Installation das Grundproblem.
Das Debugging von FreeCAD wird von einigen internen Mechanismen unterstützt. Die Kommandozeilen-Version von FreeCAD bietet folgende Optionen für die Debugging-Unterstützung:
Derzeit werden folgende Optionen in FreeCAD 0.15 erkannt:
Generelle Optionen:
-v [ --version ] Zeigt die Programmversion -h [ --help ] Zeigt die Hilfemeldung -c [ --console ] Startet im Konsolenmodus --response-file arg Kann auch mit '@name' spezifiziert werden.
Configuration:
-l [ --write-log ] Writes a log file to:
$HOME/.FreeCAD/FreeCAD.log
--log-file arg Unlike to --write-log this allows to log to an
arbitrary file
-u [ --user-cfg ] arg User config file to load/save user settings
-s [ --system-cfg ] arg Systen config file to load/save system settings
-t [ --run-test ] arg Test level
-M [ --module-path ] arg Additional module paths
-P [ --python-path ] arg Additional python paths
If you are running a version of FreeCAD from the bleeding edge of the development curve, it may "crash". You can help solve such problems by providing the developers with a "backtrace". To do this, you need to be running a "debug build" of the software. "Debug build" is a parameter that is set at compile time, so you'll either need to compile FreeCAD yourself, or obtain a pre-compiled "debug" version.
Vorbedingungen:
Vorgehen: Geben Sie Folgendes im Terminalfenster ein:
$ cd FreeCAD/bin $ gdb FreeCAD
GNUdebugger will output some initializing information. The (gdb) shows GNUDebugger is running in the terminal, now input:
(gdb) handle SIG33 noprint nostop (gdb) run
FreeCAD startet nun. Führen Sie die Schritte aus, die zum Einfrieren oder Absturz von FreeCAD führen. Geben Sie dann Folgendes im Terminalfenster ein:
(gdb) bt
Dies erzeugt eine längliche Liste mit den genauen Angaben, was das Programm tat als es abstürzte oder einfror. Fügen Sie dieses Listing Ihrem Fehlerbericht hinzu.
Prerequisites:
Steps: Enter the following in your terminal window:
$ cd FreeCAD/bin $ lldb FreeCAD
LLDB will output some initializing information. The (lldb) shows the debugger is running in the terminal, now input:
(lldb) run
FreeCAD will now start up. Perform the steps that cause FreeCAD to crash or freeze, then enter in the terminal window:
(lldb) bt
This will generate a lengthy listing of exactly what the program was doing when it crashed or froze. Include this with your problem report.
Dies ist ein Beispiel für die Benutzung von winpdb innerhalb von FreeCAD:
import rpdb2
rpdb2.start_embedded_debugger("test")
import FreeCAD
import Part
import Draft
print "hello"
print "hello"
import Draft
points=[FreeCAD.Vector(-3.0,-1.0,0.0),FreeCAD.Vector(-2.0,0.0,0.0)]
Draft.makeWire(points,closed=False,face=False,support=None)