SDRTrunk项目源码编译指南：Java版本要求与构建详解

项目背景与技术栈

SDRTrunk是一款基于Java开发的软件定义无线电(SDR)应用，主要用于接收和解码各类数字无线电通信信号。该项目采用Gradle作为构建工具，并依赖Java的FFM（Foreign Function and Memory）API实现与SDRPlay设备的底层交互。

核心依赖说明

1. Java版本要求

当前版本必须使用OpenJDK 23，这是由项目使用的FFM API特性决定的：

• FFM API仍处于预览阶段，需要最新Java版本支持
• 不兼容旧版LTS（如JDK 21/17）
• 预计将在OpenJDK 25（下一个LTS版本）发布后实现稳定支持

2. 构建工具

• Gradle：项目采用Gradle构建系统
• Gradle Wrapper：推荐使用项目自带的gradlew脚本，可自动处理版本兼容

完整构建流程（以Arch Linux为例）

环境准备

# 安装OpenJDK 23
sudo pacman -S jdk-openjdk

# 安装Gradle（可选，推荐使用wrapper）
sudo pacman -S gradle

源码构建

# 使用Gradle Wrapper构建（自动下载所需Gradle版本）
./gradlew build

# 指定安装目录（通过系统属性）
./gradlew -Dorg.gradle.project.installDir=/custom/path installDist

运行时部署

构建产物位于build/install/sdrtrunk目录，包含：

• 可执行脚本
• 依赖库
• 配置文件模板

技术细节解析

1. FFM API依赖：

   • 用于实现JVM与本地SDRPlay驱动的高效交互
   • 需要JEP 424（JDK 19引入）等新特性支持
   • 未来将随Java标准库的演进而调整

2. 构建系统特点：

   • 自动处理JNI库的编译和打包
   • 集成测试框架支持
   • 生成平台特定的启动脚本

常见问题解决方案

1. Java版本冲突：

   • 使用archlinux-java命令切换默认JDK版本
   • 或通过JAVA_HOME环境变量指定OpenJDK 23路径

2. 构建目录定制：

   # 修改Gradle构建输出目录
   ./gradlew -Dgradle.user.home=/alternative/cache build
   

3. 最小化运行时环境：

   • 仅需JRE 23+环境
   • 建议保留build目录下的native库文件

未来兼容性说明

建议开发者关注Java LTS发布周期，项目将在OpenJDK 25发布后评估迁移计划，届时将提供更长期的版本支持。