Linux的.so如何打包进JAR？

核心原理

1. 资源嵌入
   将.so文件作为资源放入JAR包的特定目录（如/native/linux-x86_64/），通过ClassLoader访问。
2. 运行时提取
   程序启动时，将.so从JAR提取到临时目录，用System.load()加载。
3. 多平台兼容
   根据系统属性（os.name, os.arch）选择对应平台的库文件。

操作步骤

项目结构准备

src/
├── main/
│   ├── java/
│   │   └── com/example/
│   │       ├── NativeUtils.java  # 库加载工具类
│   │       └── MainApp.java      # 主程序
│   └── resources/
│       └── native/               # 存放.so文件
│           ├── linux-x86_64/
│           │   └── libnative.so  # Linux库
│           └── win32-x86/
│               └── native.dll    # Windows库

实现库加载工具类

package com.example;
import java.io.*;
import java.nio.file.*;
public class NativeUtils {
    public static void loadLibrary(String libName) throws IOException {
        // 1. 确定平台目录
        String os = System.getProperty("os.name").toLowerCase();
        String arch = System.getProperty("os.arch").toLowerCase();
        String platformDir = 
            os.contains("linux") ? "linux-" + (arch.contains("64") ? "x86_64" : "x86") :
            os.contains("win")   ? "win32-" + (arch.contains("64") ? "x86_64" : "x86") :
            "unsupported";
        // 2. 构造资源路径
        String resourcePath = "/native/" + platformDir + "/" + System.mapLibraryName(libName);
        InputStream in = NativeUtils.class.getResourceAsStream(resourcePath);
        if (in == null) {
            throw new UnsatisfiedLinkError("Native library not found: " + resourcePath);
        }
        // 3. 创建临时文件
        Path tempDir = Files.createTempDirectory("native-lib");
        Path tempFile = tempDir.resolve(System.mapLibraryName(libName));
        Files.copy(in, tempFile, StandardCopyOption.REPLACE_EXISTING);
        in.close();
        // 4. 设置权限（Linux必需）
        if (!os.contains("win")) {
            tempFile.toFile().setExecutable(true);
        }
        // 5. 加载库并注册删除钩子
        System.load(tempFile.toAbsolutePath().toString());
        tempFile.toFile().deleteOnExit();
        tempDir.toFile().deleteOnExit();
    }
}

主程序调用

package com.example;
public class MainApp {
    static {
        try {
            NativeUtils.loadLibrary("native"); // 加载libnative.so
        } catch (IOException e) {
            throw new RuntimeException("Failed to load native library", e);
        }
    }
    public static void main(String[] args) {
        // 调用JNI方法
        new MainApp().callNativeMethod();
    }
    // 声明本地方法
    public native void callNativeMethod();
}

构建JAR（Maven示例）

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <resources>
                    <resource>
                        <directory>src/main/resources</directory>
                        <includes>
                            <include>native/**/*.so</include> <!-- 包含.so文件 -->
                        </includes>
                    </resource>
                </resources>
            </configuration>
        </plugin>
    </plugins>
</build>

运行命令：
mvn clean package

关键注意事项

1. 文件权限
   Linux需显式设置临时文件可执行权限：tempFile.setExecutable(true)。
2. 路径区分
   使用System.mapLibraryName("native")自动生成平台相关文件名（Linux→libnative.so，Windows→native.dll）。
3. 内存泄漏预防
   deleteOnExit()确保临时文件在JVM退出时删除。
4. 平台兼容性
   通过os.name和os.arch动态匹配目录,支持多平台部署。

替代方案对比

推荐场景：

• 需要轻量级方案 → 本文方案
• 追求开发效率 → JNA

常见问题解决

• UnsatisfiedLinkError
  检查：

  1. .so文件是否在JAR的/native/正确平台目录下
  2. 临时文件权限（Linux需chmod +x）
  3. 库依赖是否完整（用ldd libnative.so验证）

• 资源路径错误
  使用jar -tf app.jar确认.so文件路径。

引用说明

本文方法参考了以下技术实践：

1. Oracle官方JNI规范中关于动态库加载的说明
2. Apache Commons IO中临时文件处理的最佳实践
3. Stack Overflow社区对跨平台库加载的讨论（如此案例）
4. JNA官方文档中资源加载的实现逻辑

通过将平台相关库与JAR整合，可显著提升Java应用的部署便利性,尤其适合容器化环境。