CxImage怎样在Ubuntu上配置

在 Ubuntu 上配置 CxImage 的完整步骤

一 准备环境

1. 安装编译工具与常用图像依赖：
   1. 命令：sudo apt update && sudo apt install -y build-essential cmake git libpng-dev libjpeg-dev libtiff-dev libgif-dev
2. 说明：
   1. build-essential 提供 gcc、g++、make 等工具。
   2. libpng-dev、libjpeg-dev、libtiff-dev、libgif-dev 为常见图像格式编解码依赖，CxImage 在 Linux 下通常需自行编译以启用这些格式支持。

二 获取源码

1. 选择一个维护活跃的仓库并克隆（两种常见来源，任选其一）：
   1. 来源一（社区维护）：git clone https://github.com/cximage/cximage.git
   2. 来源二（示例仓库）：git clone https://github.com/antaresware/cximage.git
2. 进入源码目录并同步最新提交：
   1. 命令：cd cximage && git checkout master 或 main && git pull
3. 提示：不同仓库的目录结构可能略有差异，后续步骤以实际目录为准。

三 编译与安装

1. 方式 A（推荐，使用 CMake）：
   1. 命令：mkdir -p build && cd build && cmake … && make -j$(nproc)
   2. 安装：sudo make install（默认常见安装前缀为 /usr/local）
2. 方式 B（部分旧版或特定分支使用 Makefile）：
   1. 命令：make && sudo make install
3. 说明：若使用 CMake，可在 cmake 阶段按需开启/关闭格式插件；若使用 Makefile，请确认所有依赖开发包已安装，以免编译期报缺。

四 配置环境

1. 让系统找到头文件与库文件（写入当前用户环境，持久生效）：
   1. 编辑：nano ~/.bashrc
   2. 追加：
      1. export CPLUS_INCLUDE_PATH=/usr/local/include:$CPLUS_INCLUDE_PATH
      2. export LIBRARY_PATH=/usr/local/lib:$LIBRARY_PATH
      3. export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
   3. 生效：source ~/.bashrc
2. 可选的系统级配置（如需全局可用）：
   1. 更新动态库缓存：sudo ldconfig
   2. 若头文件/库安装到非标准前缀（如 /opt/cximage），请在 /etc/ld.so.conf.d/ 下新建配置文件（例如 cximage.conf）写入库路径并运行 sudo ldconfig。

五 验证与使用

1. 最小测试程序 test_cxImage.cpp：
   1. 代码：
      1. #include <cximage.h>
      2. #include
      3. int main() {
         1. CxImage img;
         2. if (img.Load(“test.png”)) {
            1. std::cout << “Image loaded successfully!n”;
            2. img.Save(“output.jpg”);
         3. } else {
            1. std::cerr << “Failed to load image.n”;
         4. }
         5. return 0;
         6. }
2. 编译与运行：
   1. 编译：g++ -o test_cxImage test_cxImage.cpp -lcximage
   2. 运行：./test_cxImage（确保当前目录存在 test.png，或替换为你的图片路径）
3. 常见故障排查：
   1. 编译时报找不到头文件：检查 CPLUS_INCLUDE_PATH 是否包含 /usr/local/include。
   2. 链接时报未定义引用：确认链接了 -lcximage，并检查 LIBRARY_PATH 与 LD_LIBRARY_PATH。
   3. 运行时报找不到共享库：执行 sudo ldconfig，或检查 LD_LIBRARY_PATH 与安装前缀是否一致。