FindJNI

Поиск заголовков и библиотек Java Native Interface (JNI).

JNI позволяет коду Java, выполняемому в Java Virtual Machine (JVM) или Dalvik Virtual Machine (DVM) на Android, вызывать и быть вызванным нативными приложениями и библиотеками, написанными на других языках, таких как C и C++.

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

Новое в версии 3.24: Добавлены импортируемые целевые платформы, компоненты AWT, JVM, и поддержка Android NDK. Если компоненты не указаны, модуль по умолчанию устанавливает пустой список компонентов при нацеливании на Android и все доступные компоненты в противном случае.

При использовании Android NDK сообщается соответствующая версия пакета и можно запросить определённую версию. В Android API уровня 31 и выше можно запросить дополнительный компонент NativeHelper. NativeHelper также экспонируется как неявная зависимость от компонента JVM (только если это не вызывает конфликта), который предоставляет унифицированный доступ к функциям JVM.

Импортируемые целевые платформы

Новое в версии 3.24.

JNI::JNI: Основная целевая платформа JNI, определена только если был найден jni.h.
JNI::AWT: Библиотека Java AWT Native Interface (JAWT), определена только если был найден компонент AWT.
JNI::JVM: Библиотека Java Virtual Machine (JVM), определена только если был найден компонент JVM.
JNI::NativeHelper: При нацеливании на Android API уровня 31 и выше целевая платформа предоставит доступ к libnativehelper.so, который экспонирует функции JVM, такие как JNI_CreateJavaVM.

Переменные результатов

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

JNI_INCLUDE_DIRS: Директории заголовков для использования.
JNI_LIBRARIES: Библиотеки для использования (JAWT и JVM).
JNI_FOUND: TRUE, если заголовки и библиотеки JNI были найдены.
JNI_<component>_FOUND: Новое в версии 3.24.

TRUE, если <component> был найден.
JNI_VERSION: Полная версия пакета Android NDK (включая суффиксы, такие как -beta3 и -rc1) или неопределена в противном случае.
JNI_VERSION_MAJOR: Новое в версии 3.24.

Главная версия Android NDK или неопределена в противном случае.
JNI_VERSION_MINOR: Новое в версии 3.24.

Дополнительная версия Android NDK или неопределена в противном случае.
JNI_VERSION_PATCH: Новое в версии 3.24.

Ревизионная версия Android NDK или неопределена в противном случае.

Переменные кэша

Также доступны следующие переменные кэша для установки или использования:

JAVA_AWT_LIBRARY: Путь к библиотеке Java AWT Native Interface (JAWT).
JAVA_JVM_LIBRARY: Путь к библиотеке Java Virtual Machine (JVM).
JAVA_INCLUDE_PATH: Путь к заголовкам jni.h.
JAVA_INCLUDE_PATH2: Путь к заголовкам, зависящим от машины, jni_md.h и jniport.h. Переменная определена только если jni.h зависит от одного из этих заголовков. В отличие от этого, Android NDK jni.h может обычно использоваться автономно.
JAVA_AWT_INCLUDE_PATH: Путь к заголовкам jawt.h.

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.29/module/FindJNI.html