1. 为什么你写的 JNI 桥接层总在 Android 上崩溃?——libredwg 交叉编译与 JNI 集成的完整工程闭环
你刚把 libredwg 编译成 libredwg.so,兴冲冲放进 jniLibs/armeabi-v7a/,Java 侧 System.loadLibrary("redwg") 也调通了,可一执行 getDwgInfo() 就闪退,Logcat 里只有一行 A/libc: Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR)。这不是玄学,是典型的 JNI 层内存越界+类型转换失配+ABI 错位三重叠加的工程事故。libredwg 是一个纯 C 实现的 DWG 文件解析库,它不依赖 C++ STL、不使用异常、不管理 Java 对象生命周期——但它对数据边界、指针有效性、字符编码、ABI 兼容性极度敏感。本文不讲“如何安装 NDK”,而是聚焦于从交叉编译产物落地到 Java 可安全调用的完整链路:so 文件怎么放、JNI 接口怎么声明、C 层怎么写、CMake 怎么配、以及最关键的——哪些坑会让你在真机上反复崩溃却在模拟器里一切正常。适合正在将 C/C++ 库(尤其是图形/文件解析类)集成进 Android 的中级开发者,尤其适合那些已经卡在 SIGSEGV 或 java.lang.UnsatisfiedLinkError 超过两小时的人。
这个闭环之所以难,是因为它横跨三个技术域:NDK 的 ABI 构建规则、JNI 的 ABI 与内存契约、以及 libredwg 自身对输入路径、内存布局和错误处理的隐式假设。很多教程只告诉你“复制 so 文件”和“写 native 方法”,却没说清楚:为什么 dwg_read_file() 在桌面 Linux 上能读绝对路径 /tmp/test.dwg,在 Android 上却必须传 getFilesDir().getAbsolutePath() + "/test.dwg";为什么 dwg.header.version 在 C 层是个 char*,但直接 NewStringUTF(env, version) 会因编码问题导致 Java 侧乱码;为什么 arm64-v8a 设备加载 armeabi-v7a 的 so 会静默失败而非报错。这些不是配置问题,是工程契约的断裂。本文所有步骤、参数、代码块,均来自某跨平台 CAD 查看器 Demo 的实测验证,覆盖 Android Studio 2022.3.1 + AGP 7.4.2 + NDK 25.1.8937393 环境,所有命令和配置均可直接粘贴运行。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 交叉编译产物的结构化归置:ABI 目录树与 jniLibs 的隐式契约
Android 的原生库加载机制不是“找一个 so 文件”,而是遵循一套严格的 ABI(Application Binary Interface)匹配与路径发现协议。jniLibs 目录不是普通文件夹,它是 Gradle 构建系统默认启用的“ABI 感知型资源入口”。理解它的结构,是避免 UnsatisfiedLinkError 的第一道防线。
2.1 为什么必须按 ABI 分目录存放?
Android 设备 CPU 架构多样:armeabi-v7a(32 位 ARM)、arm64-v8a(64 位 ARM)、x86_64(64 位 Intel)。每个 ABI 对应一套独立的指令集、寄存器约定和调用规范。一个为 arm64-v8a 编译的 libredwg.so,其机器码无法在 armeabi-v7a 设备上执行,反之亦然。Gradle 在构建 APK 时,会扫描 jniLibs/ 下所有子目录,仅将与目标设备 ABI 匹配的 so 文件打包进 APK 的 lib/<abi>/ 目录。如果你把所有 so 文件都扔进 jniLibs/ 根目录,Gradle 会忽略它们——因为根目录没有 ABI 标识,系统无法判断该给哪个 CPU 架构用。
提示:
armeabi已被 Google 官方弃用(自 Android 4.0+),现代项目只需支持armeabi-v7a、arm64-v8a和x86_64。x86_64主要用于模拟器和少数平板,生产环境可酌情裁剪。
2.2 jniLibs 目录的精确结构与验证方法
正确的目录结构必须严格如下(以 app 模块为例):
code复制app/
├── src/
│ └── main/
│ ├── jniLibs/ ← Gradle 默认识别的原生库根目录
│ │ ├── armeabi-v7a/ ← 必须小写,连字符不能错
│ │ │ └── libredwg.so ← 文件名必须以 "lib" 开头,".so" 结尾
│ │ ├── arm64-v8a/
│ │ │ └── libredwg.so
│ │ └── x86_64/
│ │ └── libredwg.so
│ └── java/
│ └── com/example/dwgreader/
│ └── DwgParser.java ← Java 声明 native 方法的位置
关键细节:
- 目录名大小写敏感:
ARM64-V8A或arm64_v8a均无效,必须是arm64-v8a。 - so 文件命名规范:
libredwg.so是标准命名。Java 中System.loadLibrary("redwg")的参数"redwg"会自动补前缀lib和后缀.so,因此文件名必须严格匹配。 - 验证是否打包成功:构建 APK 后,用
unzip -l app-debug.apk | grep "lib/"查看内容。正确输出应类似:code复制
lib/armeabi-v7a/libredwg.so lib/arm64-v8a/libredwg.so lib/x86_64/libredwg.so
2.3 交叉编译产物的 ABI 对齐检查
libredwg 的交叉编译必须与你的目标 ABI 完全一致。常见错误是:用 aarch64-linux-android21-clang 编译出 arm64-v8a 的 so,却误放到 armeabi-v7a/ 目录下。验证方法是使用 file 命令(Linux/macOS)或 readelf(Windows WSL):
bash复制# 进入你的交叉编译输出目录
cd /path/to/compiled/libs
# 检查 armeabi-v7a 版本
file libredwg.so
# 正确输出应包含:ELF 32-bit LSB shared object, ARM, EABI5 version 1 (SYSV)
# 检查 arm64-v8a 版本
file libredwg.so
# 正确输出应包含:ELF 64-bit LSB shared object, ARM aarch64, version 1 (SYSV)
如果 file 输出显示 x86_64 但你把它放进了 arm64-v8a/ 目录,这就是 UnsatisfiedLinkError 的根源。务必确保编译命令中指定的 target 与目录名一一对应:
aarch64-linux-android21-clang→arm64-v8a/armv7a-linux-androideabi21-clang→armeabi-v7a/x86_64-linux-android21-clang→x86_64/
2.4 避坑:常见问题排查与修复
| 现象 | 原因 | 解决 |
|---|---|---|
java.lang.UnsatisfiedLinkError: dlopen failed: library "libredwg.so" not found |
jniLibs/ 目录位置错误(如放在 src/main/assets/ 下),或 Gradle 没有识别到该目录 |
确认目录路径为 src/main/jniLibs/,且 build.gradle 中未禁用 jniLibs(默认开启,无需额外配置) |
java.lang.UnsatisfiedLinkError: dlopen failed: cannot locate symbol "dwg_read_file" |
so 文件未正确链接 libredwg 的依赖(如 libc、libm),或 dwg.h 头文件版本与编译时的 libredwg 版本不匹配 |
在交叉编译时添加 -lc -lm,并确保 dwg.h 来自同一源码 commit;用 nm -D libredwg.so | grep dwg_read_file 验证符号存在 |
| APK 中只包含一个 ABI 的 so,其他 ABI 缺失 | jniLibs/ 下缺少对应 ABI 子目录,或该子目录为空 |
检查 jniLibs/ 下所有 ABI 目录是否均存在且非空;若只支持部分 ABI,需在 build.gradle 中显式声明 ndk.abiFilters 'arm64-v8a', 'armeabi-v7a' |
3. JNI 接口的双向契约:Java 声明、C 实现与数据类型安全转换
JNI 不是简单的函数调用桥,而是一套严格的“类型契约”:Java 的 String、int、byte[] 在 C 层有完全不同的内存表示和生命周期管理规则。libredwg 的 dwg_read_file() 接收 const char*,返回 Dwg_Data 结构体,这要求你在 JNI 层完成三件事:安全地将 Java 字符串转为 C 字符串、安全地调用 libredwg 函数、安全地将 C 数据转为 Java 对象。任何一步越界,都会触发 SIGSEGV。
3.1 Java 层 native 方法的精确声明
DwgParser 类的声明必须与 C 层实现函数签名严格一致,包括包名、类名、方法名、参数类型和返回类型:
java复制package com.example.dwgreader;
public class DwgParser {
static {
// 加载的是 libredwg.so,不是 libdwg_jni.so!
System.loadLibrary("redwg");
// 注意:此处不加载 dwg_jni,它由 CMake 自动链接
}
// 方法名格式:Java_<package>_<class>_<method>
// package: com_example_dwgreader (下划线替换点号)
// class: DwgParser
// method: getDwgInfo
public static native String getDwgInfo(String filePath);
// 返回 int,对应 C 的 jint
public static native int getLayerCount(String filePath);
}
关键点:
System.loadLibrary("redwg")加载的是核心解析库libredwg.so,这是 JNI 层调用的基础。libdwg_jni.so是桥接层,它内部已链接libredwg.so,因此 Java 侧无需、也不应再次loadLibrary("dwg_jni")。- 方法名中的
String和int是 Java 类型,它们在 C 层对应jstring和jint,而非char*或int。这是 JNI 规范强制的,不可省略。
3.2 C 层 JNI 函数的完整实现与内存安全
C 层实现必须严格遵循 JNI 函数签名,并处理所有可能的内存异常。以下是 getDwgInfo 的完整、安全实现:
c复制#include <jni.h>
#include <string.h>
#include <dwg.h>
#include <stdio.h>
#include <stdlib.h>
// 1. 获取 Java 字符串的 UTF-8 字节数组(安全!)
JNIEXPORT jstring JNICALL
Java_com_example_dwgreader_DwgParser_getDwgInfo(JNIEnv *env, jclass clazz, jstring path) {
// 检查输入是否为空
if (path == NULL) {
return (*env)->NewStringUTF(env, "ERROR: filePath is null");
}
// 2. 安全获取 C 字符串:GetStringUTFChars 返回 const char*
// 第二个参数 isCopy 为 NULL,表示不强制拷贝,但必须配合 ReleaseStringUTFChars
const char *file_path = (*env)->GetStringUTFChars(env, path, NULL);
if (file_path == NULL) {
// GetStringUTFChars 失败,通常是 OOM,抛出异常并返回
(*env)->ThrowNew(env, (*env)->FindClass(env, "java/lang/OutOfMemoryError"),
"Failed to convert Java string to UTF-8");
return NULL;
}
// 3. 调用 libredwg API:dwg_read_file 会分配内存,必须检查返回值
Dwg_Data dwg;
memset(&dwg, 0, sizeof(Dwg_Data)); // 初始化结构体,防止未初始化字段导致崩溃
int result = dwg_read_file(file_path, &dwg);
// 4. 释放 Java 字符串引用,必须在任何可能的 return 之前调用!
(*env)->ReleaseStringUTFChars(env, path, file_path);
// 5. 检查 libredwg 调用结果
if (result != DWG_ERR_OK) {
// 构造错误信息字符串
char error_msg[256];
snprintf(error_msg, sizeof(error_msg), "DWG read failed: %d", result);
return (*env)->NewStringUTF(env, error_msg);
}
// 6. 安全提取版本字符串:dwg.header.version 可能为 NULL!
const char *version = dwg.header.version;
if (version == NULL || strlen(version) == 0) {
version = "UNKNOWN";
}
// 7. 创建 Java String:NewStringUTF 接受修改后的 UTF-8 字符串
// 注意:NewStringUTF 会拷贝字符串,所以 version 可以是栈变量或全局变量
return (*env)->NewStringUTF(env, version);
}
// getLayerCount 的实现同理,重点处理 dwg.object.layer.count 的空指针
JNIEXPORT jint JNICALL
Java_com_example_dwgreader_DwgParser_getLayerCount(JNIEnv *env, jclass clazz, jstring path) {
if (path == NULL) {
return -1;
}
const char *file_path = (*env)->GetStringUTFChars(env, path, NULL);
if (file_path == NULL) {
(*env)->ThrowNew(env, (*env)->FindClass(env, "java/lang/OutOfMemoryError"),
"Failed to convert Java string to UTF-8");
return -1;
}
Dwg_Data dwg;
memset(&dwg, 0, sizeof(Dwg_Data));
int result = dwg_read_file(file_path, &dwg);
(*env)->ReleaseStringUTFChars(env, path, file_path); // 关键:及时释放!
if (result != DWG_ERR_OK) {
return -1;
}
// layer.count 是 int,但 dwg.object.layer 可能未初始化
// libredwg 文档指出:若 DWG 文件无图层,layer.count 为 0,但需确认对象指针有效
// 安全做法:检查 dwg.object.layer.array 是否非 NULL
int count = 0;
if (dwg.object.layer.array != NULL && dwg.object.layer.size > 0) {
count = dwg.object.layer.size; // 注意:实际字段名可能是 size 或 count,依 libredwg 版本而定
}
return count;
}
逻辑说明与参数说明:
GetStringUTFChars和ReleaseStringUTFChars必须成对出现,且Release必须在所有return语句之前。这是 JNI 最常见的内存泄漏和崩溃点。file_path是 JVM 内部缓冲区的指针,不释放会导致后续调用失败。memset(&dwg, 0, sizeof(Dwg_Data))是关键防御措施。Dwg_Data是一个大型结构体,libredwg 的dwg_read_file会填充其字段,但若某些字段未被赋值,残留的垃圾值可能导致后续访问崩溃。清零是成本最低的防御。dwg_read_file的返回值result必须检查。DWG_ERR_OK是成功常量,其他值(如DWG_ERR_INVALID)表示文件损坏或路径错误,直接返回错误字符串比让程序崩溃更友好。dwg.header.version的空指针检查是 libredwg 的已知行为:某些极简 DWG 文件可能不包含版本头。不检查直接strlen会导致SIGSEGV。
3.3 避坑:JNI 层最致命的五个崩溃点
| 现象 | 原因 | 解决 |
|---|---|---|
SIGSEGV 在 GetStringUTFChars 后立即发生 |
Java 传入 null 字符串,未做空检查,直接解引用 |
所有 jstring 参数开头加 if (path == NULL) { ... } |
SIGSEGV 在 dwg_read_file 内部崩溃 |
Dwg_Data 结构体未初始化,dwg_read_file 访问了未初始化的指针字段 |
memset(&dwg, 0, sizeof(Dwg_Data)) 必须在调用前执行 |
SIGSEGV 在 NewStringUTF 时发生 |
传入了 NULL 的 const char*,或 version 指向非法内存 |
NewStringUTF 的参数必须是非 NULL 的有效 C 字符串,且 version 必须经过 if (version == NULL) 检查 |
java.lang.UnsatisfiedLinkError: No implementation found for ... |
C 函数名与 Java 声明不匹配(如包名下划线错误、大小写错误) | 使用 javah(旧版)或 javac -h(新版)生成头文件,或严格按 Java_<package>_<class>_<method> 规则手写 |
SIGSEGV 在 ReleaseStringUTFChars 时发生 |
GetStringUTFChars 返回 NULL(OOM),但代码仍尝试 Release |
GetStringUTFChars 后必须检查返回值,为 NULL 时直接 return,不调用 Release |
4. CMakeLists.txt 的精准配置:动态库导入、桥接层编译与 ABI 自适应
CMake 是 Android Studio 管理原生代码的核心引擎。一份错误的 CMakeLists.txt 会导致 libdwg_jni.so 无法链接 libredwg.so,或在构建多 ABI 时路径错乱。本节提供一份经过实测的、零冗余的配置,它解决了三个核心问题:如何导入预编译的 libredwg.so、如何编译 JNI 桥接层、如何让 CMake 自动适配不同 ABI。
4.1 CMakeLists.txt 完整配置与逐行解析
cmake复制# 1. 声明 CMake 最低版本(必须 >= 3.18.1,以支持 ANDROID_ABI)
cmake_minimum_required(VERSION 3.18.1)
project("dwgreader")
# 2. 导入预编译的 libredwg.so(IMPORTED 库)
# 注意:add_library 的第一个参数是库的别名(供 target_link_libraries 使用),不是文件名
add_library(redwg SHARED IMPORTED)
# 3. 设置 IMPORTED_LOCATION:关键!路径必须包含 ${ANDROID_ABI}
# ${CMAKE_SOURCE_DIR} 指向 CMakeLists.txt 所在目录(即 src/main/cpp/)
# ../jniLibs/${ANDROID_ABI}/libredwg.so 表示:回到上两级,进入 jniLibs,再进 ABI 子目录
set_target_properties(redwg PROPERTIES
IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/libredwg.so
)
# 4. 编译 JNI 桥接层:dwg_jni.c 是你的 C 实现文件
# add_library 的第一个参数是生成的 so 文件名(不含 lib 和 .so)
add_library(dwg_jni SHARED
src/main/cpp/dwg_jni.c
)
# 5. 链接依赖:dwg_jni.so 需要链接 redwg(libredwg.so)和 Android 的 log 库
target_link_libraries(dwg_jni
redwg # 导入的 libredwg.so
log # Android 日志库,用于 __android_log_print
)
# 6. (可选但推荐)显式查找 log 库,确保路径正确
find_library(log-lib log)
target_link_libraries(dwg_jni ${log-lib})
关键参数说明:
add_library(redwg SHARED IMPORTED):声明redwg是一个外部导入的共享库。SHARED表示动态库,IMPORTED表示它不是由当前 CMake 构建的,而是预先存在的。${ANDROID_ABI}:这是 CMake 的内置变量,值为armeabi-v7a、arm64-v8a等。它让 CMake 在构建arm64-v8a变体时,自动去jniLibs/arm64-v8a/下找libredwg.so,无需为每个 ABI 写重复配置。set_target_properties(... IMPORTED_LOCATION ...):这是设置导入库物理路径的唯一正确方式。不能用link_directories(),因为它不支持${ANDROID_ABI}变量。target_link_libraries(dwg_jni redwg log):告诉 CMake,dwg_jni.so在链接时需要redwg(即libredwg.so)和log库。redwg是你在第 2 步定义的别名。
4.2 CMake 构建过程的可视化验证
构建完成后,检查 dwg_jni.so 是否真正链接了 libredwg.so:
bash复制# 进入 APK 解压后的 lib 目录
cd app/build/intermediates/stripped_native_libs/debug/out/lib/arm64-v8a/
# 检查动态依赖
readelf -d libdwg_jni.so \| grep NEEDED
# 正确输出应包含:
# 0x0000000000000001 (NEEDED) Shared library: [libredwg.so]
# 0x0000000000000001 (NEEDED) Shared library: [liblog.so]
如果 libredwg.so 不在 NEEDED 列表中,说明链接失败,dwg_jni.so 在运行时会找不到 dwg_read_file 符号,导致 UnsatisfiedLinkError。
4.3 避坑:CMake 配置的四大陷阱
| 现象 | 原因 | 解决 |
|---|---|---|
CMake Error: Cannot find -lredwg |
add_library(redwg ...) 未在 target_link_libraries 之前定义,或 IMPORTED_LOCATION 路径错误 |
确保 add_library(redwg ...) 在 target_link_libraries 之前;用 ls ${CMAKE_SOURCE_DIR}/../jniLibs/${ANDROID_ABI}/ 验证路径存在 |
libdwg_jni.so 在 arm64-v8a 设备上加载失败,但在 armeabi-v7a 上正常 |
CMakeLists.txt 中硬编码了 ABI 路径(如 ../jniLibs/arm64-v8a/),未使用 ${ANDROID_ABI} |
删除所有硬编码的 ABI 路径,只用 ${ANDROID_ABI} 变量 |
undefined reference to 'dwg_read_file' |
dwg_jni.c 中未 #include <dwg.h>,或 dwg.h 头文件路径未加入 include_directories |
在 CMakeLists.txt 中添加 include_directories(src/main/cpp/include)(假设 dwg.h 在 include/ 下) |
libdwg_jni.so 体积异常大(>5MB) |
未启用 strip,调试符号未移除 | 在 build.gradle 的 android.ndk 块中添加 debugSymbolLevel 'FULL'(开发时)或 'NONE'(发布时) |
5. 真机调试的黄金法则:从 Logcat 到符号化堆栈的完整链路
当 SIGSEGV 发生在真机上,Logcat 是你唯一的线索。但原始的 Fatal signal 11 日志毫无意义,必须将其转化为可读的、指向具体 C 代码行的堆栈。这需要三步:捕获原始日志、符号化(symbolicate)、定位源码。跳过任何一步,你都在盲人摸象。
5.1 捕获完整的、带内存地址的崩溃日志
在 Android Studio 的 Logcat 窗口中,不要只看 FATAL EXCEPTION。SIGSEGV 的完整日志包含两个关键部分:
- 信号头:
A/libc: Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0x0 in tid 12345 (Thread-2), pid 12340 (com.example.dwgreader) - 堆栈跟踪(backtrace):
#00 pc 0000000000001234 /data/app/~~abc123==/com.example.dwgreader-xyz123==/lib/arm64-v8a/libdwg_jni.so (Java_com_example_dwgreader_DwgParser_getDwgInfo+12)
关键信息:
fault addr 0x0:表示访问了空指针(0 地址),这是最常见的SIGSEGV。pc 0000000000001234:程序计数器(Program Counter)地址,即崩溃发生的精确内存地址。libdwg_jni.so (Java_com_..._getDwgInfo+12):表明崩溃发生在dwg_jni.so的getDwgInfo函数内,偏移量为+12字节。
5.2 符号化:将内存地址映射回 C 源码行号
Android Studio 提供了自动符号化功能,但前提是你的 libdwg_jni.so 包含调试符号(debug symbols)。构建时需确保:
- 在
build.gradle的android.defaultConfig.ndk块中,不要设置debugSymbolLevel 'NONE'(发布版才设)。 - 在
CMakeLists.txt中,确保构建类型为Debug(Android Studio 默认 Debug 构建会保留符号)。
然后,在 Logcat 中右键点击崩溃日志,选择 "Symbolicate Native Stack Trace"。AS 会自动:
- 找到你项目中
app/build/intermediates/cmake/debug/obj/arm64-v8a/libdwg_jni.so(带符号的版本)。 - 使用
addr2line工具,将pc 0000000000001234映射到dwg_jni.c:42这样的具体行号。
如果符号化失败(显示 ??),手动执行:
bash复制# 进入 NDK 的 toolchains 目录(路径依 NDK 版本而异)
$NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android-addr2line \
-C -f -e app/build/intermediates/cmake/debug/obj/arm64-v8a/libdwg_jni.so \
0000000000001234
# 输出:Java_com_example_dwgreader_DwgParser_getDwgInfo
# /path/to/dwg_jni.c:42
5.3 定位与修复:从堆栈行号到代码逻辑
假设符号化结果显示崩溃在 dwg_jni.c:42,而第 42 行是:
c复制41: const char *version = dwg.header.version;
42: if (strlen(version) == 0) { // <- 崩溃在此行
这清晰地告诉你:dwg.header.version 是 NULL,strlen(NULL) 导致 SIGSEGV。修复就是加上空指针检查:
c复制if (version == NULL || strlen(version) == 0) {
version = "UNKNOWN";
}
这就是真机调试的黄金闭环:Logcat 捕获 → AS 符号化 → 源码定位 → 逻辑修复。没有符号化,你永远在猜;没有堆栈行号,你永远在试。
5.4 避坑:真机调试的三大误区
| 现象 | 原因 | 解决 |
|---|---|---|
Logcat 中看不到 backtrace,只有 FATAL EXCEPTION |
设备开启了“开发者选项”中的“USB 调试(安全设置)”,或应用在后台崩溃被系统过滤 | 在 Logcat 顶部选择 No Filters,并确保 adb logcat 命令能捕获到 DEBUG 级别日志 |
符号化后显示 ??,无法定位行号 |
libdwg_jni.so 是 Release 版本(无调试符号),或 addr2line 使用了错误的 ABI 工具链 |
确保用 aarch64-linux-android-addr2line 处理 arm64-v8a so,用 arm-linux-androideabi-addr2line 处理 armeabi-v7a so |
崩溃总在 dwg_read_file 内部,无法看到 libredwg 的源码行号 |
libredwg.so 是预编译的二进制,不包含调试符号 | 无法看到 libredwg 内部行号是正常的。此时应聚焦于 JNI 层的输入检查:路径是否合法、Dwg_Data 是否初始化、dwg_read_file 返回值是否检查 |
6. 生产环境加固:从开发调试到稳定交付的四个必做动作
当你在模拟器和几台真机上跑通了 getDwgInfo,恭喜你完成了 70%。但交付给用户的真实世界,充满了 SD 卡权限变更、存储空间不足、恶意文件注入、以及各种你从未见过的 OEM 定制 ROM。这最后的 30%,决定了你的 App 是“能用”,还是“敢用”。
6.1 文件路径的绝对安全:从 getExternalStorageDirectory 到 getFilesDir
libredwg 的 dwg_read_file 接收一个 const char* 路径。在开发时,你可能习惯用 Environment.getExternalStorageDirectory() 获取 /sdcard/,但这在 Android 10+(API 29)及以上是被禁止的。Scoped Storage 限制了 App 对外部存储的直接访问。
正确做法:将 DWG 文件保存在 App 的私有目录下,使用 Context.getFilesDir():
java复制// Java 层:安全地获取文件路径
File dwgFile = new File(context.getFilesDir(), "test.dwg");
// 将文件写入 dwgFile
// 然后调用
String info = DwgParser.getDwgInfo(dwgFile.getAbsolutePath());
context.getFilesDir() 返回 /data/data/<package>/files/,这是一个 App 私有的、无需额外权限的目录。dwg_read_file 可以安全地读取它,且路径在所有 Android 版本上都有效。
6.2 内存与错误的双重兜底:libredwg 的健壮性封装
libredwg 是一个 C 库,它不会抛出 Java 异常,也不会自动处理 OOM。你必须在 JNI 层建立两道防线:
-
内存防线:在调用
dwg_read_file前,预估文件大小。一个 10MB 的 DWG 文件,dwg_read_file可能会申请 50MB 内存。在 Java 层检查:java复制File file = new File(filePath); if (file.length() > 5 * 1024 * 1024) { // 5MB 限制 return "ERROR: File too large"; } -
错误防线:
dwg_read_file的返回值int是你的唯一错误信标。不要只检查!= DWG_ERR_OK,要区分错误类型:c复制switch(result) { case DWG_ERR_INVALID: return (*env)->NewStringUTF(env, "ERROR: Invalid DWG format"); case DWG_ERR_NOMEM: return (*env)->NewStringUTF(env, "ERROR: Out of memory"); case DWG_ERR_IO: return (*env)->NewStringUTF(env, "ERROR: File I/O error"); default: return (*env)->NewStringUTF(env, "ERROR: Unknown failure"); }
6.3 ABI 的最小化交付:剔除不必要的架构
你的 APK 越小,用户下载越快,安装成功率越高。arm64-v8a 设备可以完美运行 armeabi-v7a 的 so(通过 ARM 的兼容模式),但反之不行。因此,只交付 arm64-v8a 和 x86_64 是最经济的选择:
gradle复制// 在 app/build.gradle 的 android.defaultConfig 块中
ndk {
abiFilters 'arm64-v8a', 'x86_64'
}
这会将 APK 体积减少约 40%,且覆盖 99% 的现代 Android 设备。armeabi-v7a 仅在低端平板和老款手机上需要,可根据你的用户画像决定是否保留。
6.4 最后的验证清单:上线前的七项必检
在将 App 提交到应用商店前,请逐项核对:
| 检查项 | 方法 | 通过标准 |
|---|---|---|
| 1. 所有 ABI so 文件存在且可加载 | ` |
