Ubuntu 上 CXImage 的更新与升级指南
一 优先方案 使用 APT 升级
- 更新索引并查看可用版本：
- sudo apt update
- apt search cximage
- 执行升级（按已安装包名选择其一或多项）：
- 开发包：sudo apt install --only-upgrade libcximage-dev
- 运行时库：sudo apt install --only-upgrade libcximage
- 验证结果：
- dpkg -l | grep cximage
- 若程序在运行，重启相关服务或应用以加载新库
- 说明：若仓库中包名不同，请以 apt search 的输出为准；没有可用更新时说明仓库版本已是最新。
二 仓库无新版本时 从源码编译安装
- 安装构建依赖：
- sudo apt update
- sudo apt install -y build-essential cmake git libpng-dev libjpeg-dev libtiff-dev libgif-dev
- 获取源码并构建（两种常见方式，择一）：
- 方式 A（官方示例命令集）：
- git clone https://github.com/cximage/cximage.git
- cd cximage
- git checkout master 或 main
- mkdir build && cd build
- cmake …
- make -j$(nproc)
- sudo make install
- 方式 B（教程常见简式）：
- 在源码目录直接：make
- sudo make install
- 安装后建议执行：sudo ldconfig，确保动态库缓存更新。
三 升级后的验证与常见问题处理
- 验证安装结果：
- 查看库与头文件：dpkg -l | grep cximage；ls /usr/local/include | grep ximage；ls /usr/local/lib | grep cximage
- 若库安装到非系统目录（如 /usr/local/lib），运行程序前设置库路径：
- export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
- 可将上述行加入 ~/.bashrc 或 /etc/profile.d/cximage.sh 持久化
- 兼容性提示：
- 升级后建议重新编译并链接你的项目，确保使用新头文件与库
- 若出现“找不到库/头文件”或链接失败，检查包含路径与链接库是否包含 -lcximage，并确认库目录在链接器搜索路径中。
