Ubuntu 上安装 CxImage 失败排查与解决
一 准备与依赖
- 安装构建工具与图像依赖，优先使用较新的稳定分支（如 main/master）：
- 安装依赖：sudo apt update && sudo apt install -y build-essential cmake git libpng-dev libjpeg-dev libtiff-dev libgif-dev zlib1g-dev
- 获取源码：git clone https://github.com/cximage/cximage.git && cd cximage
- 构建安装：mkdir build && cd build && cmake … && make -j$(nproc) && sudo make install
- 若官方仓库暂不可用，可尝试社区维护镜像（如 antaresware/cximage），但请以 cximage/cximage 为主。
二 常见报错与修复
三 安装后验证与项目集成
-
验证安装
- 简单测试程序 test.cpp（加载 BMP 并转存 PNG/JPG）：
#include “ximage.h”
#include
int main(){ CxImage img; if(!img.Load(“test.bmp”,CXIMAGE_FORMAT_BMP)) return 1;
img.Save(“output.png”,CXIMAGE_FORMAT_PNG); img.Save(“output.jpg”,CXIMAGE_FORMAT_JPG);
std::cout<<“OK\n”; return 0; }
- 编译运行：g++ test.cpp -o test -I/usr/local/include -L/usr/local/lib -lcximage -ljpeg -lpng -lgif -ltiff -lz && ./test
- 若提示找不到共享库：export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH（可写入 ~/.bashrc 持久化）。
-
在你的项目中链接
- 命令行：g++ your.cpp -o out -I/usr/local/include -L/usr/local/lib -lcximage -ljpeg -lpng -lgif -ltiff -lz
- CMake 示例：find_package(cximage REQUIRED) 或手动 target_link_libraries(your_target PRIVATE cximage)。
四 仍未解决时的建议
- 确认使用 cximage/cximage 官方仓库的最新提交/发布版本，避免过时包或错误 fork。
- 检查 gcc/g++/cmake 版本是否满足要求，必要时升级后重试。
- 清理并全量重建：make clean && rm -rf build && mkdir build && cd build && cmake … && make -j$(nproc)。
- 若 apt 上存在同名包，可先尝试 sudo apt install cximage（不同发行版/仓库可能不存在或版本较旧，优先源码编译）。
- 提供你的 Ubuntu 版本、CxImage 版本/提交号、完整错误日志与 CMake/configure 命令，便于进一步定位。
