在 Debian 上搭建 cxImage 开发环境
一 准备与依赖
- 更新索引并安装基础构建工具与图像编解码依赖：
- sudo apt update
- sudo apt install -y build-essential cmake
- sudo apt install -y libpng-dev libjpeg-dev libtiff-dev libgif-dev
- 说明：上述库用于支持 PNG/JPEG/TIFF/GIF 等格式的编解码。若需要 WebP，可额外安装 libwebp-dev。这些依赖是后续从源码构建与运行示例程序所必需的。
二 安装方式
- 方式 A 包管理器安装（推荐，若仓库提供）
- 检查可用包：apt search libcximage
- 安装开发包：sudo apt install -y libcximage-dev
- 验证：pkg-config --cflags --libs cximage（能打印出编译与链接标志即表明开发文件就绪）
- 说明：部分 Debian 版本/仓库可能未收录该库，若 apt 找不到包，请改用方式 B 源码构建。
- 方式 B 从源码构建
- 获取源码（选择一个维护活跃的分支/仓库，以下为示例）：
- git clone https://github.com/antaressoftware/cxImage.git
- cd cxImage
- 构建与安装：
- mkdir -p build && cd build
- cmake -DCMAKE_BUILD_TYPE=Release …
- make -j$(nproc)
- sudo make install
- 验证：pkg-config --cflags --libs cximage（若返回为空，见下一节“常见问题”处理）
三 验证与第一个程序
- 编译与运行示例（C++）
- 示例代码 test_cxImage.cpp：
- #include
#include “cximage.h”
int main() {
CxImage img;
if (img.Load(“test.png”)) { // 将 test.png 放到程序工作目录，或改为你的图片路径
std::cout << “Image loaded successfully!\n”;
} else {
std::cerr << “Failed to load image.\n”;
}
return 0;
}
- 编译与运行：
- g++ -o test_cxImage test_cxImage.cpp -lcximage
- ./test_cxImage
- 若加载成功将输出：Image loaded successfully!；否则请检查图片路径与依赖是否安装完整。
四 常见问题与处理
- 找不到头文件或链接失败
- 确认头文件搜索路径包含 /usr/local/include，库搜索路径包含 /usr/local/lib。
- 临时导出环境变量（或写入 ~/.bashrc 后 source）：
- export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH
- export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
- 编译时显式指定：g++ … -I/usr/local/include -L/usr/local/lib -lcximage
- pkg-config 找不到 cximage
- 确认已安装开发包（libcximage-dev），或源码安装后检查 /usr/local/lib/pkgconfig/cximage.pc 是否存在；必要时将 /usr/local/lib/pkgconfig 加入 PKG_CONFIG_PATH：
- export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH
- 运行时报找不到共享库
- 确保 /usr/local/lib 在动态链接器缓存中：
- echo “/usr/local/lib” | sudo tee /etc/ld.so.conf.d/local.conf
- sudo ldconfig
- 仓库无包或版本过旧
- 采用“方式 B 源码构建”，并根据需要开启/关闭对应格式插件（修改 CMake 选项或在构建前准备相应第三方库）。
