simondrey / SikuliX2

SikuliX version 2 - Java API

SikuliX Version 2 - Java API

Version 2.0.0 under developement

Download latest ready to use version 1.1.1 or get the Sources

---

Travis CI (Ubuntu 12.04-64, Java 8, xvfb)
Developing and testing locally on macOS 12 and Windows 10 with Java 8
Translation project: Transifex::SikuliX2
Documentation project: ReadTheDocs::SikuliX2 based on GitHub::SikuliX2-Docs

Forking and/or downloading this repo only makes sense:

• if you want to get a knowledge about the internals of SikuliX
• if you want to create your own packages containing SikuliX features
• if you want to contribute.

---

BE AWARE For use with Java aware scripting and Java programming you might need additional stuff and steps at your own resposibility. Currently you might also fork the project and make your tests in the project context. Issues and pull requests are only accepted here on Github.

---

sikulixapi

the API to be used in Java and Java aware scripting languages

Snapshots available on OSSRH (should work in Maven and Gradle projects):

  <repositories>
    <repository>
      <id>snapshot</id>
      <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
    </repository>
  </repositories>

  <dependencies>
    <dependency>
      <groupId>com.sikulix</groupId>
      <artifactId>sikulixapi</artifactId>
      <version>2.0.0-SNAPSHOT</version>
    </dependency>
  </dependencies>

• the new public features are in com.sikulix.api
• the current API (up to 1.1.x) in org.sikuli.script will be kept for backwards compatibility, but rerouted to com.sikulix.api/core as needed
• new projects using Java should use the API as provided by com.sikulix.api

Related subprojects (available on OSSRH/MavenCentral)

Sikulix2openCV OpenCV Java API and prebuilt libraries
Sikulix2tesseract Tess4J Java API and prebuilt libraries
Sikulix2TigerVNC The TigerVNC Java implementation for VNC support

Prerequisites for development and testing

• a Java JDK 1.8
• Maven 3+
• only 64-Bit Systems supported

For developement I use the JetBrains IDEs

• IntelliJ IDEA CE for Java and everything else
• PyCharm CE for special Jython/Python stuff
• RubyMine for special JRuby/Ruby stuff (special license for OpenSource projects)

Be aware for development and testing

• the so called folder SikulixAppData, where SikuliX specific stuff is stored once per machine, for SikuliX2 now is SikulixAppData/SX2 to allow the parallel usage of SikuliX1 and SikuliX2 on the same machine.