SuperTextView

GIF JNI native smoke APK

这是独立的 Android application 工程,用真实 Android Bitmap 检查 GIF JNI 的加载、 注册、解码、渲染与生命周期。工程不求值仓库根目录或 library 的旧 Gradle 配置, 也不依赖 regression-tests。唯一的 runner 是平台 android.app.Instrumentation, 没有 JUnit、AndroidX、外部 runner 或额外的 androidTest APK。

构建

需要 JDK 11、Gradle 7.5、AGP 7.4.0、Android SDK platform 28 和 build-tools 30.0.3。依赖已缓存时可离线构建。SDK 路径通过环境变量提供,不需要 创建或提交 local.properties,也不需要修改仓库原有 wrapper。

在仓库根目录执行:

export JAVA_HOME=$(/usr/libexec/java_home -v 11)  # macOS;其他系统选用 JDK 11
export ANDROID_HOME="$HOME/Library/Android/sdk" # 换成实际 SDK 目录
export GRADLE_75=/path/to/gradle-7.5/bin/gradle

"$GRADLE_75" -p native-tests --offline --no-daemon assembleDebug --console=plain

本机已缓存的 Gradle 可设置为:

export GRADLE_75="$HOME/.gradle/wrapper/dists/gradle-7.5-bin/9tzbf1ys39bmx06cf595mz8hp/gradle-7.5/bin/gradle"

产物是 native-tests/build/outputs/apk/debug/SuperTextView-native-tests-debug.apk。 sourceSets 直接编译 library/src/main/java/com/coorchice/library/gifdecoder/JNI.java, 仅增加此目录的 runner;native 库直接来自 library/src/main/jniLibs,不使用替身或副本源码。 因此,生产 .so 更新后应重新执行 assembleDebug 再安装 APK。

测试 APK 的 minSdk=21 仅用于调用平台 android.system.Os;不改变 library 的兼容范围。 targetSdk=28、compileSdk=28。所有现有 ABI 库都会打包,无需为每个 ABI 修改配置。

在已选定的设备上执行

由开发者选择并准备设备;下面的命令不创建、启动或关闭 emulator。 始终明确指定序列号,避免把结果归到错误的设备:

export ANDROID_SERIAL=emulator-5554 # 换成 adb devices -l 中确认的设备
ADB="$ANDROID_HOME/platform-tools/adb"
"$ADB" -s "$ANDROID_SERIAL" install -r native-tests/build/outputs/apk/debug/SuperTextView-native-tests-debug.apk
"$ADB" -s "$ANDROID_SERIAL" shell am instrument -w -r \
  com.coorchice.nativetests/com.coorchice.nativetests.NativeSmokeInstrumentation

验证 16 KB 运行环境时应加上硬性页大小检查:

"$ADB" -s "$ANDROID_SERIAL" shell am instrument -w -r -e requirePageSize 16384 \
  com.coorchice.nativetests/com.coorchice.nativetests.NativeSmokeInstrumentation

runner 输出 Build.SUPPORTED_ABIS、进程 os.arch、SDK、nativeLibraryDir、 Os.sysconf(OsConstants._SC_PAGESIZE) 的字节数,以及可读时的 /proc/self/smaps KernelPageSize。sysconf 从 API 21 起可用;smaps 访问失败会明确标注,不掩盖 sysconf 错误。 requirePageSize 不匹配会让 environment 用例失败。4 KB 上通过的结果不能证明 16 KB 兼容。

验证 ARM64 真实 16 KB 内核 时,同时硬性检查 smaps,避免把 x86_64 的 userspace 16 KB 模拟当成内核 16 KB:

python3 tools/run_native_smoke.py --adb "$ADB" --serial "$ANDROID_SERIAL" \
  --page-size 16384 --kernel-page-size 16384 --log native-build/arm64-16k-smoke.txt

未传 --kernel-page-size 时保留原来的 sysconf 校验,适用于 x86_64 ps16k 的模拟测试。 传入时若 smaps 不可读或内核页大小不符,测试工具会拒绝判定成功。

完整执行包含 47 个用例。每例都有 START 和 PASS / FAIL,最后返回 passed、failed、total 与 Native smoke: passed=... failed=... total=47。 全部通过时 INSTRUMENTATION_CODE: -1、failed=0;Java 断言失败返回 code 0 并继续其余用例。 adb 的 shell 退出码本身不代表测试通过,必须检查最终统计、总数和 instrumentation code。

只复现一个用例时,使用精确名称:

"$ADB" -s "$ANDROID_SERIAL" shell am instrument -w -r -e test openBytesTruncatedScreen \
  com.coorchice.nativetests/com.coorchice.nativetests.NativeSmokeInstrumentation
"$ADB" -s "$ANDROID_SERIAL" logcat -d -s GifNativeSmoke AndroidRuntime DEBUG

例如 sequentialPixels、strictFrameControls、nonStrictFrameControls、copyOwnership、 gif87BytesNoGcb、signatureBytesEmpty、signatureBytesShort5、openFileTruncatedFrame。 非法名称返回 setup 失败,不会产生零用例的假通过。单例执行不包含 environment 用例, 验证页大小应先执行完整集合,或单独执行 -e test environment -e requirePageSize 16384。

已知像素 fixture 与断言

src/main/assets/known-pixels.gif 是 3 × 2 的两帧 GIF89a:

frame 0       frame 1(合成后)
R T B         R G B
G R T         G R B

预期是手工声明的图像,不从 JNI 或 native 实现计算。所有像素,包括透明像素 alpha, 均精确比较。plain-87a.gif 是没有 GCB 的 3 × 2 单帧 GIF87a;相同像素索引中的黑色 必须是不透明 0xff000000,帧时长为 0,updateFrame 返回 -1。

可以用标准库脚本重建或检查 fixture 字节,也可以用独立 Pillow 解码器验证图像:

python3 native-tests/tools/generate_fixtures.py --check
# 可选 host 工具,需要 Pillow;APK/Gradle 不依赖 Pillow。
python3 native-tests/tools/check_fixtures.py

fixture 的 SHA-256:

a50b09b5b816977ed220a9a36638e04136c4e9485426d970dada21ed5e1244bb  known-pixels.gif
87918166e0f034a88336c928a7f0b2c116cf37462e0be4f2ee289c8428c327d3  plain-87a.gif

覆盖范围与边界

老 native 的短 signature 可能抛越界异常;忽略 DGifSlurp 失败可能在无帧输入上除零或崩溃。 这些严格用例保持启用,没有 expect-crash、跳过或容错接受部分 GIF。Java 能统计断言/异常, 但 SIGSEGV/SIGFPE 会直接终止进程,无法承诺最终统计;没有 summary 就不算通过。 崩溃前的最后一个 START 可定位输入,再用单例命令和 logcat/tombstone 继续排查。

构建成功和 host fixture 核验只证明 APK 可生成、预期图像独立可信;JNI/native Bitmap 断言必须在设备上运行才有结论。每次报告设备 ABI、页大小、APK 来源和最终统计。 本 APK 使用压缩并提取的 native 库,验证实际 ELF 加载和渲染,不声称检验 APK 内未压缩 .so 的 16 KB ZIP 对齐。它也不是 GIF 格式全量、内存泄漏或线程安全测试;画布回绕前 显式清空,不额外声称覆盖所有 disposal 模式、跨循环合成、非 strict 全量重建或失效指针行为。