在 Ubuntu 上安装 CxImage 的可行方案
方案一 使用系统包管理器安装（推荐）
- 更新索引并安装开发包：
- sudo apt update
- sudo apt install libcximage-dev
- 验证安装结果：
- pkg-config --cflags --libs cximage
- 若输出了编译与链接参数（如 -I/usr/include/cximage 与 -lcximage），说明安装成功。
- 说明：该方式简单、稳定，适合大多数项目；后续编译程序时可直接使用 -lcximage 进行链接。
方案二 从源码构建与安装
- 安装构建依赖：
- sudo apt update
- sudo apt install build-essential cmake git libpng-dev libjpeg-dev libtiff-dev libgif-dev zlib1g-dev
- 获取源码（选择一个活跃镜像仓库）：
- git clone https://github.com/cximage/cximage.git
- 或 git clone https://github.com/antaressoftware/cxImage.git
- 构建与安装（两种常见方式，择一即可）：
- 方式 A（Unix Makefiles，部分仓库自带 Makefile）：
- cd cxImage
- make
- sudo make install
- 方式 B（CMake，若仓库提供 CMakeLists.txt）：
- mkdir build && cd build
- cmake -DCMAKE_INSTALL_PREFIX=/usr/local …
- make -j$(nproc)
- sudo make install
- 验证安装：
- pkg-config --cflags --libs cximage
- 若命令有效，表示头文件与库文件已就绪，可用于项目构建。
编译与运行示例
- 示例程序 test_cxImage.cpp：
- #include <cximage.h>
int main() {
CXImage img;
if (img.Load(“test.png”)) {
img.Save(“out.jpg”);
return 0;
}
return 1;
}
- 编译与运行：
- g++ test_cxImage.cpp -o test_cxImage -lcximage
- ./test_cxImage
- 若构建系统支持 pkg-config，也可用：
- g++ test_cxImage.cpp -o test_cxImage $(pkg-config --cflags --libs cximage)
常见问题与处理
- 头文件或库路径未被找到：
- 将 /usr/local/include 与 /usr/local/lib 加入环境变量（写入 ~/.bashrc 或 ~/.profile 后执行 source）：
- export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH
- export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH
- export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
- 运行时报找不到共享库：
- 确认 /usr/local/lib 位于 /etc/ld.so.conf 或 /etc/ld.so.conf.d/*.conf 中，然后执行 sudo ldconfig
- 或临时使用 export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
- 仓库与分支差异：
- 不同镜像仓库的目录结构与构建方式可能不同，遇到 Makefile 或 CMakeLists.txt 缺失时，优先切换到包含构建文件的仓库/分支（如 master 或 main），再按对应方式构建。
