当前位置：首页 > news >正文

JNativeHook跨平台部署：Windows、macOS、Linux全攻略

news 2026/5/16 8:54:12

JNativeHook跨平台部署：Windows、macOS、Linux全攻略

【免费下载链接】jnativehookGlobal keyboard and mouse listeners for Java.项目地址: https://gitcode.com/gh_mirrors/jn/jnativehook

JNativeHook是一款强大的Java库，提供全局键盘和鼠标监听功能，支持Windows、macOS和Linux三大主流操作系统。本指南将详细介绍如何在不同平台上部署JNativeHook，帮助开发者快速实现跨平台的输入事件监听功能。

📋 准备工作：环境依赖与前期配置

在开始部署JNativeHook之前，需要确保系统已安装以下基础依赖：

Java环境：Oracle JDK或OpenJDK（推荐JDK 8及以上版本）
构建工具：Maven和CMake
编译工具：GCC、Clang（Linux/macOS）或MSVC（Windows）

平台特定依赖

Linux系统

需要安装X Window System相关开发库：

sudo apt-get install libx11-dev libxtst-dev libxt-dev libxinerama-dev libx11-xcb-dev libxkbcommon-dev libxkbcommon-x11-dev libxkbfile-dev

macOS系统

需安装Xcode命令行工具：

xcode-select --install

Windows系统

需安装Visual Studio 2022（含C++开发组件）和Windows SDK。

🔄 获取源码与基础构建

克隆项目仓库

git clone https://gitcode.com/gh_mirrors/jn/jnativehook cd jnativehook

编译Java类文件

首先使用Maven编译Java源代码，生成必要的JNI头文件：

mvn compile

🖥️ 平台部署指南

Windows平台部署

支持的架构

x86（32位）
x86_64（64位）
ARM（实验性）

编译步骤（以x86_64为例）

# 编译libuiohook md target\build\libuiohook\ cmake -B target\build\libuiohook\ -S src\external\libuiohook\ ^ -G "Visual Studio 17 2022" -A x64 ^ -D CMAKE_INSTALL_PREFIX=target\ ^ -D BUILD_SHARED_LIBS=OFF ^ -D USE_EPOCH_TIME=ON cmake --build target\build\libuiohook\ --parallel 2 --config RelWithDebInfo --clean-first cmake --install target\build\libuiohook\ --config RelWithDebInfo # 编译JNI库 md target\build\jni\ cmake -B target\build\jni\ ^ -G "Visual Studio 17 2022" -A x64 ^ -D CMAKE_PREFIX_PATH=target\ ^ -D CMAKE_SYSTEM_NAME=windows ^ -D CMAKE_SYSTEM_PROCESSOR=x86_64 cmake --build target\build\jni\ --parallel 2 --config RelWithDebInfo --clean-first cmake --install target\build\jni\ --config RelWithDebInfo

Linux平台部署

支持的架构

x86
x86_64
ARM
ARM64

编译步骤（以x86_64为例）

# 编译libuiohook mkdir -p target/build/libuiohook/ cmake -B target/build/libuiohook/ -S src/external/libuiohook/ \ -G "Unix Makefiles" \ -D CMAKE_INSTALL_PREFIX=target/ \ -D BUILD_SHARED_LIBS=OFF \ -D USE_EPOCH_TIME=ON cmake --build target/build/libuiohook/ --parallel 2 --clean-first cmake --install target/build/libuiohook/ # 编译JNI库 mkdir -p target/build/jni/ cmake -B target/build/jni/ \ -G "Unix Makefiles" \ -D CMAKE_PREFIX_PATH=target/ \ -D CMAKE_SYSTEM_NAME=linux \ -D CMAKE_SYSTEM_PROCESSOR=x86_64 cmake --build target/build/jni/ --parallel 2 --clean-first cmake --install target/build/jni/

macOS平台部署

支持的架构

x86_64
ARM64（Apple Silicon）

编译步骤（以ARM64为例）

# 编译libuiohook mkdir -p target/build/libuiohook/ cmake -B target/build/libuiohook/ -S src/external/libuiohook/ \ -G "Unix Makefiles" \ -D CMAKE_INSTALL_PREFIX=target/ \ -D BUILD_SHARED_LIBS=OFF \ -D USE_EPOCH_TIME=ON cmake --build target/build/libuiohook/ --parallel 2 --clean-first cmake --install target/build/libuiohook/ # 编译JNI库 mkdir -p target/build/jni/ cmake -B target/build/jni/ \ -G "Unix Makefiles" \ -D CMAKE_PREFIX_PATH=target/ \ -D CMAKE_SYSTEM_NAME=darwin \ -D CMAKE_SYSTEM_PROCESSOR=arm64 cmake --build target/build/jni/ --parallel 2 --clean-first cmake --install target/build/jni/

📦 打包与使用

完成 native 库编译后，使用 Maven 打包生成 JAR 文件：

mvn package

生成的 JAR 文件位于target目录下，包含以下类型：

普通 JAR：jnativehook-<version>.jar
源码 JAR：jnativehook-<version>-sources.jar
Javadoc JAR：jnativehook-<version>-javadoc.jar

在项目中引用 JAR 文件后，即可开始使用 JNativeHook 的全局键盘和鼠标监听功能。

🔧 高级配置：自定义库加载

JNativeHook 2.0 及以上版本提供了NativeLibraryLocator接口，允许自定义库加载逻辑。例如，从网络 URL 加载库文件：

public class UrlLibraryLocator implements NativeLibraryLocator { public Iterator<File> getLibraries() { // 实现自定义库加载逻辑 // 完整示例可参考 doc/LibraryLoading.md } }

通过实现此接口，可以灵活控制库的加载来源和方式，满足特殊部署需求。