CxImage在Ubuntu上的兼容性测试

CxImage在Ubuntu的兼容性测试方案

一 测试目标与环境准备

• 目标：验证在Ubuntu上编译、链接与运行CxImage的可用性，覆盖x86_64与ARM64两类架构，并评估JPEG/PNG/TIFF/GIF/BMP等主流格式的加载、保存与转换功能。
• 建议环境：
  • Ubuntu 22.04 LTS 或 24.04 LTS
  • 编译器：gcc/g++ 11+ 或 clang 14+
  • 基础工具：build-essential cmake autoconf automake libtool pkg-config
  • 依赖库：libjpeg-dev libpng-dev libtiff-dev libgif-dev zlib1g-dev libjasper-dev（按需）
• 安装依赖示例：
  • sudo apt update
  • sudo apt install -y build-essential cmake autoconf automake libtool pkg-config
  • sudo apt install -y libjpeg-dev libpng-dev libtiff-dev libgif-dev zlib1g-dev
  • 注：libjasper-dev在部分发行版仓库可能缺失，若需J2K/JPEG2000支持，可参考下述源码构建方式或改用系统自带OpenJPEG方案。

二 构建与安装

• 源码获取与目录结构
  • 获取 Linux 适配版本的源码包（如：cximage599c_tar.zip），解压后确认子目录：CxImage j2k jasper jbig jpeg png tiff zlib（共8个，建议全部构建为静态库，避免运行时缺失插件）。
• 生成与编译（Autotools 流程）
  • 在项目根目录依次执行：
    • aclocal
    • autoconf -i -v -f
    • find . -name Makefile -exec rm -f {} ;
    • ./configure
    • make
  • 常见修复要点：
    • 若出现“cannot guess build type”，显式指定：./configure --build=x86_64-linux-gnu --host=x86_64-linux-gnu
    • 若出现“C preprocessor /lib/cpp fails sanity check”，安装build-essential。
    • 若libjasper头文件缺失，使用：./configure --with-extra-includes=/path/to/cximage599c/cximage/jasper/include
    • 若automake报错，执行：automake --add-missing
    • 64位/交叉编译需生成位置无关代码：在相应子目录 Makefile 或顶层环境加入**-fPIC**。
• 交叉编译与ARM要点
  • 交叉编译时同样确保上述8个子目录均被构建，并按目标架构传入**–build/–host**；链接阶段注意加上**-lstdc++**。
  • 个别版本的libjasper在编译jpc_cs.c时可能报“undefined ulong”，可在jpc_cs.h中加入：
    • #ifndef ulong
    • typedef unsigned long ulong;
    • #endif
  • 链接示例（按实际路径调整）：
    • gcc -o demo demo.o -L…/build-linux -lCxImage -lj2k -ljpeg -ljbig -ltiff -lpng -lzlib -ljasper -lstdc++
  • 若遇到复杂示例链接异常，可尝试将报错的**.o**文件临时并入工程参与链接以定位问题。
• 替代构建方式（若仓库提供 CMakeLists）
  • mkdir build && cd build
  • cmake -DCMAKE_BUILD_TYPE=Release …
  • make -j$(nproc)
  • sudo make install
  • 安装后可通过pkg-config获取编译/链接参数（若提供 .pc 文件）。

三 兼容性测试用例设计

• 编译链接验证
  • 使用 g++ 编译最小示例，链接libCxImage及依赖库（如：-lCxImage -ljpeg -ltiff -lpng -lzlib -ljasper -ljbig -lstdc++），确认无未定义引用与架构不匹配问题。
• 功能与格式覆盖
  • 加载与保存：对BMP/GIF/ICO/TGA/JPEG/PCX/PNG/TIFF/MNG/RAS等格式执行“读→处理→写”回环，核对返回码与输出文件可用性。
  • 转换链路：JPEG↔PNG↔TIFF、带/不带Alpha通道的PNG、灰度与调色板图像等组合。
  • 元数据与异常：读取/写入EXIF/IPTC（若库版本支持），对损坏文件与不支持格式进行负向测试。
• 稳定性与资源
  • 大图与批量：对**>10k×10k像素与100+**文件批量转换进行稳定性与内存占用观察。
  • 并发：多进程/多线程并发调用，验证线程安全与句柄泄漏。
• 运行时依赖
  • 使用ldd检查可执行文件依赖是否全部解析；必要时设置LD_LIBRARY_PATH或安装到系统库目录。

四 常见问题与修复要点

• 构建配置与工具链
  • “cannot guess build type”：显式传入**–build/–host**；
  • “C preprocessor /lib/cpp fails sanity check”：安装build-essential；
  • “automake --add-missing”缺失目标：执行 automake --add-missing；
  • libjasper头文件缺失：使用**–with-extra-includes**指定头文件路径。
• 代码与链接问题
  • TIFF文件打开失败或接口不匹配：部分 Linux 发行版中的libtiff版本差异导致，需按实际源码调整tif_xfile.cpp中的**_TIFFFdOpen/_TIFFOpenEx**实现以匹配库符号。
  • 链接时报错含“__cxa_allocate_exception”等 C++ 符号未定义：在链接命令末尾补加**-lstdc++**。
  • libjasper编译报错“undefined ulong”：在jpc_cs.h添加typedef unsigned long ulong;。
• 依赖与运行
  • 使用ldd排查缺失依赖；若库安装到**/usr/local/lib**，确保**/etc/ld.so.conf**或环境变量包含该路径并执行ldconfig。

五 交付物与判定标准

• 交付物
  • 构建产物：libCxImage.a及依赖库（或安装到系统目录的共享库）、头文件、必要的**.pc**文件（若有）。
  • 测试报告：覆盖的格式/分辨率/批量规模、成功率、性能与资源占用、已知限制与修复建议。
• 判定标准
  • 在目标Ubuntu版本与x86_64/ARM64架构下，所有目标格式可稳定加载、保存与转换；
  • 批量与并发场景无崩溃/泄漏；
  • 运行时依赖完整，部署后无需额外手动拷贝第三方库。