CxImage在Ubuntu上的安装步骤

在 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），再按对应方式构建。