Skip to content

Commit

Permalink
[DOC] Added troubleshoutings guidelines
Browse files Browse the repository at this point in the history
  • Loading branch information
LAGNEAU Romain committed Feb 26, 2025
1 parent e3c2bb4 commit 6f29e3e
Showing 1 changed file with 46 additions and 0 deletions.
46 changes: 46 additions & 0 deletions doc/tutorial/java/tutorial-java-started.dox
Original file line number Diff line number Diff line change
Expand Up @@ -131,6 +131,52 @@ is no other Blas/Lapack 3rd party available.

A complete discussion about this issue is given here in [issue #806](https://github.com/lagadic/visp/issues/806).

\subsection java_started_issue_windows Error running Java app with Intel MKL

If you face the follwoing error:

```
Exception in thread "main" java.lang.UnsatisfiedLinkError: no visp_java361 in java.library.path: C:\visp-ws\visp-java\x64\vc17\bin\Release
at java.base/java.lang.ClassLoader.loadLibrary(ClassLoader.java:2458)
at java.base/java.lang.Runtime.loadLibrary0(Runtime.java:916)
at java.base/java.lang.System.loadLibrary(System.java:2063)
at visp_started/visp_started.Started.<clinit>(Started.java:12)
```

Run the following command:

```
java -XshowSettings:properties -version
```

In the result of the command, check the value of `java.library.path`:
```
Property settings:
file.encoding = UTF-8
file.separator = \
java.class.path =
java.class.version = 65.0
java.home = C:\Program Files\Java\jdk-21
java.io.tmpdir = C:\Users\CHERCH~1\AppData\Local\Temp\
java.library.path = $LIST_OF_FOLDERS
```

Ensure that the `.dll` and `.lib` of visp (`visp_core.dll`, `visp_java${VERSION_NUMBER}.dll)
and so on are located in one of these folders.

\subsection java_started_issue_includes Issues with the includes

If Oracle complains about the `import` statements, add in the `module-info.java` the following lines:

```
module ${APPLICATION_PACKAGE_NAME} {
requires visp;
}
```

where `${APPLICATION_PACKAGE_NAME}` must be replaced by the name that appears in the `package` statement
in the `Started.java` file.

\section java_started_next 6. Next tutorial

You are now ready to continue with \ref tutorial-java-apriltag.
Expand Down

0 comments on commit 6f29e3e

Please sign in to comment.