构建 ADLX 的 Java 绑定

导航: 使用 ADLX 进行编程 → ADLX 编程指南 → 快速入门

本指南概述了构建 ADLX 的 Java 绑定包装器的步骤，这是在 Java 应用程序中使用 ADLX 进行编程的先决条件。

先决条件

• 已安装ADLX SDK。
• 已安装Visual Studio 2019。
• 已安装 swigwin 4.0.2，并且 swigwin 4.0.2 安装的路径已添加到 Path 用户环境变量中。
• 已安装 OpenJDK 17。
• OpenJDK 17 安装的路径已添加到 JAVA_HOME 系统环境变量中。
• OpenJDK 17 安装的 bin 路径已添加到 Path 系统环境变量中。

构建 ADLX 的 Java 绑定

• 为您的 Java ADLX 绑定包装器创建一个文件夹并命名，例如 ADLXJavaBind。
• 在 ADLXJavaBind 文件夹中创建一个新文件，并将其命名为 ADLXJavaBind.i。
• 编辑 ADLXJavaBind.i，并使用 SWIG 输入格式添加您希望包装的接口的 SDK 头文件。要为事件通知创建绑定，请为相应的侦听器接口启用 director 包装回调。

例如，

feature("director") IADLXDisplayListChangedListener; 注意：有关 Java 绑定的示例，请参阅 Java 示例 ADLXJavaBind.i 文件。

• 创建一个名为 ADLXJavaBind 的 C++ 动态链接库项目，并按如下方式配置项目：
• | 键 | 值 | 说明 | |---|---|---| | VC++ 目录 > 包含目录 | $(JAVA_HOME)/include and$(JAVA_HOME)/include/win32 | 添加 java include 路径和 java/win32 include 路径 | | C/C++ > 预编译头 | 不使用预编译头 | 不使用预编译头 |
• 将 ADLXJavaBind.i 文件添加到项目中。
• 右键单击 ADLXJavaBind.i 文件，然后从菜单中选择属性。在属性对话框中，选择 **配置属性** > **常规** > **项类型** > **自定义生成工具**。

按如下方式设置配置：

• | 键 | 值 | 说明 | |---|---|---| | 命令行 | if not exist $(SolutionDir)out mkdir$(SolutionDir)out swig.exe -c++ -java -package out -outdir ../out/ ADLXJavaBind.i | 调用 SWIG.exe 构建 ADLXJavaBind.i 文件 | | 输出 | %(Filename)_wrap.cxx | 设置输出文件名格式 |
• 构建项目。

结果：以下文件已添加到 ADLXJavaBind 项目的输出文件夹中：

• ADLXJavaBind_wrap.h 文件。
• ADLXJavaBind_wrap.cxx 文件。
• 多个 *.java 文件。
• 将以下文件添加到项目中
• ADLXJavaBind_wrap.h
• ADLXJavaBind_wrap.cxx
• SDK/Platform/Windows/WinAPIs.cpp
• SDK/ADLXHelper/Windows/Cpp/ADLXHelper.h
• SDK/ADLXHelper/Windows/Cpp/ADLXHelper.cpp
• 重新生成项目。

结果： ADLXJavaBind.dll 在 "$(SolutionDir)$(Platform)$/(Configuration)/" 文件夹中构建。

另请参阅： ADLXJavaBind