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

Другим примером является OEM Java, с: 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)