FindJNI

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

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

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

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

При использовании Android NDK сообщается соответствующая версия пакета, и можно запросить конкретный релиз. На уровнях API Android 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: При нацеливании на уровень API Android 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–2022 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.24/module/FindJNI.html