FindJava

Поиск Java

Этот модуль находит установленный Java и определяет, где находятся файлы включения и библиотеки. Вызывающий может установить переменную JAVA_HOME для явного указания префикса установки Java.

См. также модуль FindJNI для поиска Java Native Interface (JNI).

При вызове этого модуля поиска укажите один или несколько из следующих компонентов. Смотрите пример ниже.

Runtime     = Java Runtime Environment used to execute Java byte-compiled applications
Development = Development tools (java, javac, javah, jar and javadoc), includes Runtime component
IdlJ        = Interface Description Language (IDL) to Java compiler
JarSigner   = Signer and verifier tool for Java Archive (JAR) files

Этот модуль устанавливает следующие переменные результата:

Java_JAVA_EXECUTABLE      = the full path to the Java runtime
Java_JAVAC_EXECUTABLE     = the full path to the Java compiler
Java_JAVAH_EXECUTABLE     = the full path to the Java header generator
Java_JAVADOC_EXECUTABLE   = the full path to the Java documentation generator
Java_IDLJ_EXECUTABLE      = the full path to the Java idl compiler
Java_JAR_EXECUTABLE       = the full path to the Java archiver
Java_JARSIGNER_EXECUTABLE = the full path to the Java jar signer
Java_VERSION_STRING       = Version of java found, eg. 1.6.0_12
Java_VERSION_MAJOR        = The major version of the package found.
Java_VERSION_MINOR        = The minor version of the package found.
Java_VERSION_PATCH        = The patch version of the package found.
Java_VERSION_TWEAK        = The tweak version of the package found (after '_')
Java_VERSION              = This is set to: $major[.$minor[.$patch[.$tweak]]]

Минимально необходимая версия Java может быть указана с использованием синтаксиса find_package(), например:

find_package(Java 1.8)

ПРИМЕЧАНИЕ: ${Java_VERSION} и ${Java_VERSION_STRING} не гарантированно будут идентичны. Например, некоторые версии Java могут возвращать: Java_VERSION_STRING = 1.8.0_17 и Java_VERSION = 1.8.0.17

Другой пример — Java OEM, с: Java_VERSION_STRING = 1.8.0-oem и Java_VERSION = 1.8.0

Для этих компонентов устанавливаются следующие переменные:

Java_FOUND                    - TRUE if all components are found.
Java_<component>_FOUND        - TRUE if <component> is found.

Примеры использования:

find_package(Java)
find_package(Java 1.8 REQUIRED)
find_package(Java COMPONENTS Runtime)
find_package(Java COMPONENTS Development)