Java 21与Swing开发：构建scrcpy图形化工具实践

1. 项目背景与核心价值

去年在调试Android设备时，我发现自己频繁地在命令行敲scrcpy命令。虽然这个开源工具已经足够强大，但每次都要记住各种参数组合实在不够友好。于是萌生了一个想法：为什么不为scrcpy做个图形化前端？正好Java 21刚发布不久，新特性中的虚拟线程和模式匹配让我跃跃欲试，加上Swing这个老牌GUI框架的现代化改造，一个可视化工具的开发计划就这么成型了。

这个工具的核心价值在于：

1. 将scrcpy的命令行参数可视化，通过勾选复选框、填写文本框就能生成完整命令
2. 内置常用设备配置模板，支持一键连接常用设备
3. 实时显示连接状态和日志输出，比命令行更直观
4. 对Java开发者而言，这是学习现代Swing开发和Java 21新特性的绝佳案例

2. 技术选型解析

2.1 为什么选择Java 21

Java 21作为最新的LTS版本，带来了几项对GUI开发特别有用的特性：

• 虚拟线程（Virtual Threads）：解决了Swing应用中阻塞操作导致界面卡顿的老大难问题。网络连接和设备通信这类IO操作现在可以放在虚拟线程中执行
• 模式匹配（Pattern Matching）：简化了事件处理代码中对组件类型的判断，比如：

java复制if (component instanceof JCheckBox checkbox) {
    // 直接使用checkbox变量
}

• 序列化集合（Sequenced Collections）：更方便地处理设备列表等有序数据

2.2 Swing的现代化改造

很多人以为Swing已经过时，但实际上经过这些年的改进，它依然是个可靠的GUI选择：

• FlatLaf外观库：让界面拥有现代化的扁平化风格
• JFormDesigner插件：可视化布局设计，告别手写GridBagConstraints
• SwingX扩展库：提供JXTable等增强组件，方便显示设备列表

3. 核心功能实现

3.1 主界面设计

采用经典的"三栏式"布局：

java复制JSplitPane mainSplit = new JSplitPane(
    JSplitPane.HORIZONTAL_SPLIT,
    new DevicePanel(),  // 左侧设备列表
    new JSplitPane(
        JSplitPane.VERTICAL_SPLIT,
        new OptionsPanel(),  // 右上选项配置
        new LogPanel()  // 右下日志输出
    )
);

3.2 设备发现与连接

通过adb devices命令获取设备列表，关键实现：

java复制List<AndroidDevice> discoverDevices() {
    Process process = Runtime.getRuntime().exec("adb devices");
    try (var reader = new BufferedReader(
        new InputStreamReader(process.getInputStream()))) {
        
        return reader.lines()
            .skip(1)  // 跳过"List of devices"标题
            .filter(line -> !line.trim().isEmpty())
            .map(line -> {
                String[] parts = line.split("\\t");
                return new AndroidDevice(parts[0], parts[1]);
            })
            .toList();
    }
}

3.3 命令生成与执行

将GUI选项转换为scrcpy命令行参数的核心逻辑：

java复制String buildCommand(ScrcpyOptions options) {
    StringBuilder cmd = new StringBuilder("scrcpy");
    
    if (options.isShowTouches()) {
        cmd.append(" --show-touches");
    }
    if (options.getBitRate() != DEFAULT_BITRATE) {
        cmd.append(" -b ").append(options.getBitRate());
    }
    // 其他参数处理...
    
    return cmd.toString();
}

4. Java 21特性实战应用

4.1 虚拟线程处理阻塞操作

传统Swing中，执行adb命令会导致界面冻结。现在可以这样处理：

java复制button.addActionListener(e -> {
    Thread.startVirtualThread(() -> {
        String result = executeAdbCommand();
        SwingUtilities.invokeLater(() -> {
            textArea.append(result);  // 线程安全更新UI
        });
    });
});

4.2 模式匹配简化事件处理

处理不同组件的值变化时，新模式匹配语法更简洁：

java复制void stateChanged(ChangeEvent e) {
    if (e.getSource() instanceof JSlider slider) {
        updateBitRateLabel(slider.getValue());
    } else if (e.getSource() instanceof JCheckBox checkbox) {
        toggleOption(checkbox.getText(), checkbox.isSelected());
    }
}

5. 性能优化技巧

5.1 设备列表渲染优化

默认的JTable在设备多时会卡顿，解决方案：

1. 自定义TableModel实现懒加载
2. 使用SwingX的JXTable替代JTable
3. 对序列号等长文本添加Tooltip而不是完全显示

5.2 日志输出性能

实时显示scrcpy输出时要注意：

java复制// 错误做法：每次输出都立即刷新
textArea.append(line + "\n");
textArea.repaint();

// 正确做法：批量更新
private StringBuilder logBuffer = new StringBuilder();

void appendLog(String line) {
    logBuffer.append(line).append("\n");
    if (logBuffer.length() > 8192) {
        flushLog();
    }
}

private void flushLog() {
    SwingUtilities.invokeLater(() -> {
        textArea.append(logBuffer.toString());
        logBuffer.setLength(0);
    });
}

6. 打包与分发

6.1 使用jpackage创建原生安装包

Java 21改进了jpackage工具，支持生成更小的镜像：

bash复制jpackage --name ScrcpyGUI \
         --input target/libs \
         --main-jar scrcpy-gui.jar \
         --main-class com.example.Main \
         --type app-image \
         --java-options "--enable-preview"

6.2 减少运行时大小

通过jlink创建定制化JRE：

bash复制jlink --add-modules java.desktop,java.base \
      --strip-debug \
      --no-header-files \
      --output ./custom-jre

7. 常见问题解决

7.1 adb命令找不到

解决方案：

1. 在设置中添加adb路径配置
2. 启动时自动检测常见SDK位置（如Android Studio安装目录）
3. 提供下载指引

7.2 设备离线状态

处理流程：

1. 检查USB调试是否开启
2. 尝试adb kill-server && adb start-server
3. 提示用户重新插拔USB线

7.3 高DPI显示问题

在main方法开始处添加：

java复制System.setProperty("sun.java2d.uiScale", "1.0");
JFrame.setDefaultLookAndFeelDecorated(true);
FlatLaf.setGlobalExtraDefaults(
    Collections.singletonMap("@scale", 1.0f));

8. 扩展功能思路

1. 设备分组管理：对常用设备添加标签和分组
2. 预设配置方案：保存不同的分辨率、码率组合
3. 快捷键自定义：映射scrcpy的快捷键到GUI操作
4. 插件系统：通过SPI机制扩展设备控制功能

这个项目最让我惊喜的是Java 21虚拟线程的表现，即使在老机器上同时操作多个设备，界面依然保持流畅。Swing配合FlatLaf的外观也完全能满足现代GUI的需求，完全没必要为了"看起来时髦"而选择Electron这类重型方案。