在 Ubuntu 下配置 CXImage 的完整步骤
一 准备与依赖
- 更新系统并安装构建工具与常用图像库依赖：
- 命令：sudo apt update && sudo apt install -y build-essential cmake git libpng-dev libjpeg-dev libtiff-dev libgif-dev
- 说明：上述依赖覆盖 PNG/JPEG/TIFF/GIF 等常见格式；若后续需要 WebP，可再补充安装 libwebp-dev 并在构建时启用相应选项。
二 获取源码
- 选择一个维护活跃的仓库并克隆到本地（两种常见来源，任选其一）：
- 命令1：git clone https://github.com/cximage/cximage.git
- 命令2：git clone https://github.com/antaresware/cximage.git
- 进入源码目录：cd cximage。
三 构建与安装
- 使用 CMake 的标准 out-of-source 构建流程：
- 命令：
- mkdir -p build && cd build
- cmake -DCMAKE_BUILD_TYPE=Release …
- make -j$(nproc)
- sudo make install
- 安装完成后，库文件通常位于 /usr/local/lib，头文件位于 /usr/local/include。若系统启用了 DESTDIR 或自定义前缀，路径会随之变化。
四 环境配置与验证
- 让系统找到头文件与库文件（若安装到 /usr/local，以下通常已足够）：
- 添加到环境（写入 ~/.bashrc 或 ~/.profile 后执行 source 使其生效）：
- echo ‘export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH’ >> ~/.bashrc
- echo ‘export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH’ >> ~/.bashrc
- echo ‘export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH’ >> ~/.bashrc
- source ~/.bashrc
- 验证安装结果：
- 检查 pkg-config 支持：pkg-config --cflags --libs cximage（若返回编译/链接标志，说明安装与配置正常；若命令不存在或找不到包，可先确认安装路径与 pkg-config 配置）。
五 编译与运行示例
- 示例代码（保存为 main.cpp）：
- #include <cximage.h>
int main() {
CxImage image;
if (image.Load(“input.png”)) {
image.Save(“output.jpg”);
}
return 0;
}
- 编译与运行：
- 命令：g++ main.cpp -o main -lcximage
- 运行：./main（确保当前目录存在 input.png，程序将生成 output.jpg）
六 常见问题与处理
- 找不到头文件或库文件：确认已设置 CPLUS_INCLUDE_PATH/LIBRARY_PATH/LD_LIBRARY_PATH，并确保库实际安装到对应目录（如 /usr/local/lib）。
- 链接失败：链接时添加 -lcximage；若使用其他图像格式，可能还需显式链接其依赖库（如 -lpng -ljpeg -ltiff -lgif）。
- 构建失败：确认已安装 git、cmake、build-essential 及图像格式依赖；必要时清理构建目录后重新配置与编译。
- 运行时报找不到共享库：检查 LD_LIBRARY_PATH 是否包含库目录，或将 /usr/local/lib 加入 /etc/ld.so.conf 并执行 sudo ldconfig 刷新缓存。