当前位置：首页 > news >正文

Ubuntu 22.04 + Qt 6.9.3 + 阿里云 OSS C++ SDK V2 整合部署全攻略

news 2026/7/19 5:23:07

🚨 重要提醒：环境与版本信息

在开始整合前，请确认您的环境与以下信息一致，以避免不必要的兼容性问题。

操作系统：Ubuntu 22.04 x86_64
Qt 版本：Qt 6.9.3
工作目录：/home/wzh/src
目标 SDK：阿里云 OSS C++ SDK V2（预览版）

1. 一次性安装系统全部依赖

打开终端，执行以下命令安装所有必要的编译工具和运行时库：

sudoaptupdate# 安装编译工具链、OSS SDK底层依赖、Qt6图形依赖sudoaptinstallbuild-essential cmakegitlibcurl4-openssl-dev libssl-dev uuid-dev libgl1-mesa-dev libxkbcommon-dev-y

2. 拉取 OSS SDK 源码

进入您的工作目录，克隆 OSS SDK 的官方仓库：

cd/home/wzh/srcgitclone https://github.com/aliyun/alibabacloud-oss-cpp-sdk-v2.git oss-sdk-src

3. CMake 编译并安装 OSS SDK

我们将 SDK 编译并安装到独立的第三方库目录，便于项目管理。

cd/home/wzh/src/oss-sdk-srcmkdirbuild&&cdbuild cmake..\-DCMAKE_INSTALL_PREFIX=/home/wzh/src/thirdparty/oss-v2\-DBUILD_SHARED_LIBS=ON\-DCMAKE_CXX_STANDARD=17make-j$(nproc)sudomakeinstall

参数说明：

-DCMAKE_INSTALL_PREFIX：指定 SDK 的安装路径。
-DBUILD_SHARED_LIBS=ON：编译为动态链接库（.so 文件），便于发布。
-DCMAKE_CXX_STANDARD=17：强制使用 C++17 标准编译。

4. 库瘦身（发布必备）

为减小最终发布程序的体积，可以对生成的动态库进行瘦身处理：

cd/home/wzh/src/thirdparty/oss-v2/lib strip libalibabacloud_oss_v2.so

5. Qt6 工程完整`.pro`配置

QT += core gui widgets concurrent network CONFIG += c++17 thread exceptions rtti stl # OSS SDK 路径配置 OSS_ROOT = $$PWD/thirdparty/oss-v2 INCLUDEPATH += $${OSS_ROOT}/lib INCLUDEPATH += $${OSS_ROOT}/include LIBS += -L$${OSS_ROOT}/lib LIBS += -lalibabacloud_oss_v2 -lcurl -lssl -lcrypto -luuid # RPATH 配置：确保开发机和目标设备都能找到动态库 unix { QMAKE_RPATHDIR += $${OSS_ROOT}/lib QMAKE_RPATHDIR += $${OPENCV_ROOT}/lib QMAKE_RPATHDIR += $${ORIGIN}/thirdparty/oss-v2/lib QMAKE_RPATHDIR += $${ORIGIN}/thirdparty/opencv/install/lib }

6. 代码引入头文件示例

在需要使用 OSS 功能（如上传、下载文件）的.cpp文件顶部，添加以下头文件：

#include<alibabacloud/oss/OssClient.h>usingnamespaceAlibabaCloud::OSS;// 后续即可使用 OssClient 等类进行开发

7. 发布到目标设备的部署操作

发布时，只需携带可执行程序和必要的动态库，无需头文件。

7.1 打包目录结构

建议按以下结构组织发布文件夹：

你的程序发布文件夹/ ├── 你的Qt可执行程序 └── thirdparty/ └── oss-v2/lib/libalibabacloud_oss_v2.so # OpenCV库文件也应放在类似位置，例如 thirdparty/opencv/install/lib/

7.2 目标设备系统依赖安装

在目标设备上（仅需执行一次），安装运行所需的基础系统库：

sudoaptinstalllibcurl4-openssl-dev libssl-dev uuid-dev

7.3 运行程序

赋予可执行权限并运行你的 Qt 程序：

chmod+x ./你的程序名 ./你的程序名

8. 常见报错与快速修复

链接报错undefined reference to ‘uuid_generate‘：
检查.pro文件的LIBS中是否包含了-luuid。
运行时错误error while loading shared libraries: libalibabacloud_oss_v2.so：
1. 核对设备上thirdparty目录的层级是否与打包时一致。
2. 确认.pro文件中的QMAKE_RPATHDIR配置正确，特别是$${ORIGIN}/thirdparty/oss-v2/lib路径。
C++ 语法报错：
确认.pro文件中已配置CONFIG += c++17。
Qt6 程序启动失败，提示图形相关错误：
确保在第一步已完整安装系统依赖libgl1-mesa-dev。