← Back to team overview

sikuli-driver team mailing list archive

Re: [Question #140519]: Sikuli X - Windows - libraries not found - problems when running a script

 

Question #140519 on Sikuli changed:
https://answers.launchpad.net/sikuli/+question/140519

Description changed to:
This question/answer is for documentation purposes.

--- Sikuli X-1.0 (installer and portable distribution)
--- Windows all Systems

You try to run a script and you get an error like this
java.language.UnsatisfiedLinkError: ..... Win32Util.dll .....

or any other errors, that talk about not found libraries 
and you can find "... com.wapmx.nativeutils.jniloader.NativeLoader ...." 
somewhere in the error traceback.

**** Installation directories and settings

--- On Windows, there are environment variables, that contain the standard directory for application programs and other software like Java. These environment variables can be inspected and edited in
System Properties -> extended System Properties -> Environment variables 

- Windows 32-Bit
%PROGRAMFILES% (C:\Program Files\ in a standard installation)
Sikuli installs itself here (if not changed by you), when using the installer (%PROGRAMFILES%\Sikuli X\)

- Windows 64-Bit
%PROGRAMFILES% (C:\Program Files\ in a standard installation, contains 64-Bit applications and software)
%PROGRAMFILES(X86)% (C:\Program Files (x86)\ in a standard installation, contains 32-Bit applications and software)
Sikuli installs itself here (if not changed by you), when using the installer (%PROGRAMFILES(X86)%\Sikuli X\)

--- Correct Java version
Currently (X-1.0rc3) Sikuli runs with the 32-Bit JRE6. This normally is installed in
Win 32-Bit:  %PROGRAMFILES%\Java
Win 64-Bit:  %PROGRAMFILES(X86)%\Java
If it is somewhere else, you have to set the PATH accordingly or use %JAVA_HOME%, to point to the 32-Bit JRE.

--- PATH settings for Sikuli, to find it's libraries and some Java stuff

The following is for non standard situations and when using the zipped version of the Sikuli distribution (no installer provided).
When installing Sikuli somewhere else, you have to replace %PROGRAMFILES%\Sikuli X\ and %PROGRAMFILES(X86)%\Sikuli X respectively in the following with the absolute path to your installation directory.
When using the Sikuli installer, you only have to check the situation, if you run into problems.

The dynamic link libraries, that Sikuli needs for different system specific features, are located in Sikuli's installation directory in the directory named libs. So you need to have this added to the PATH:
Win 32-Bit: %PROGRAMFILES%\Sikuli X\libs
Win 64-Bit: %PROGRAMFILES(X86)%\Sikuli X\libs

additionally, Sikuli needs a library from Java. So this has to be added to PATH  too:
Win 32-Bit:  %PROGRAMFILES%\Java\jre6\bin
Win 64-Bit:  %PROGRAMFILES(X86)%\Java\jre6\bin

So in the end the PATH should have these two additional entries:
Win 32-Bit: %PROGRAMFILES%\Sikuli X\libs;%PROGRAMFILES%\Java\jre6\bin
Win 64-Bit: %PROGRAMFILES(X86)%\Sikuli X\libs;%PROGRAMFILES(X86)%\Java\jre6\bin

If you used the Sikuli installer, have a standard Windows configuration and did not change the installation directory, the installer should have made these two entries:
Win 32-Bit: C:\Program Files\Sikuli X\libs;C:\Program Files\Java\jre6\bin
Win 64-Bit: C:\Program Files (x86)\Sikuli X\libs; C:\Program Files (x86)\Java\jre6\bin

Java7: When running with Java7, replace jre6 with jre7 (not done by the
installer).

If your environment variables contain non standard directories, these
should be shown in the generated PATH entries.

IMPORTANT: 
--- It is recommended, to use System Properties -> extended System Properties -> Environment variables, to inspect and edit these variables.
--- Take care, that only these two mentioned PATH entries are present and that they point to the correct directories.
--- always use the Windows Software uninstall feature, before reinstalling Sikuli.
--- In some cases a reboot helps, after making changes to the environment
--- If Sikuli-IDE.exe does not work, try Sikuli-IDE.bat or Sikuli-IDE-w.bat from the Sikuli installation directory.

**** For Sikuli 10.x users, who migrate to Sikuli X:
When installing Sikuli X, you have to:
-- Uninstall Sikuli 10.x using the Windows Software uninstall feature
-- Reboot your machine
-- Install Sikuli X using the installer

You received this question notification because you are a member of
Sikuli Drivers, which is an answer contact for Sikuli.