Debug your Java application

DEBUG YOUR JAVA APPLICATION WHEN A CRASH OR AN EXCEPTION OCCURS IN OPENINVENTOR


If a crash or an exception occurs in your application when using Open Inventor, it can be a crash inside the native libraries of Open Inventor. In that case it is impossible to get a useful traceback if your application use the default native libraries of Open Inventor.

In order to solve this issue and to communicate useful traceback to our customer support , we deliver what we call “debug” libraries of Open Inventor in addition to the default library. These libraries are functionally similar to the default one, but they contain additional debug information’s that are necessary to get native traceback when a crash occurs. Warnings : Using these libraries makes your application run much slower compare to using the default native libraries.

Windows

  1. These debug libraries can be found in be found in $OIVJHOME/jre/bin-debug
  2. In order to launch an application in full debug mode, your application must set the new environment variable OIV_JAVA_LOAD_DEBUG_NATIVE_LIBRARIES to 1. When activated, Open Inventor loads the debug version of native dlls. As the debug version of these dlls are packaged in a separated folder, the PATH variable must be set to this one.

Linux

  1. these debug libraries can be found in $OIVJHOME/jre/lib/amd64-debug.
  2. In order to launch an application in full debug mode, the LD_LIBRARY_PATH must be set to this folder.

MacOS

  1. these debug libraries can be found in $OIVJHOME/jre/lib/x86_64-debug.
  2. In order to launch an application in full debug mode, the DYLD_LIBRARY_PATH must be set to this folder.

 

Note: the debug libraries are useless during the run time of your application and they must not be distributed.