必须使用统信UOS官方SDK及文档开展应用开发,含DTK组件、系统接口、权限模型、签名验证与上架元信息;跳过将导致初审失败或启动异常。

要在统信UOS上开展合规、稳定、可上架的应用开发,必须使用官方提供的SDK和配套开发文档——它们不仅包含DTK(Deepin Tool Kit)组件、UOS系统接口定义与权限模型说明,还内嵌签名验证机制和应用商店审核所需的元信息模板。跳过这一步直接调用底层Linux API或混用非UOS签名的Qt版本,会导致应用无法通过应用商店初审,甚至在部分UOS版本中启动失败。
下载并验证官方SDK包
访问统信软件官网开发者门户(https://www.chinauos.com/develop),点击「SDK下载」→「桌面端SDK」,选择与当前UOS主版本号匹配的SDK压缩包(如uos-20.3-sdk-v1.4.2.tar.xz)。【必须核对UOS系统版本:终端执行 cat /etc/os-version | grep VersionID,输出值需与SDK名称中的版本段严格一致】
下载完成后,进入下载目录,执行解压与校验:
tar -xf uos-20.3-sdk-v1.4.2.tar.xz && cd uos-sdk && sha256sum -c SHA256SUMS 2>/dev/null | grep OK
若无任何输出或显示“sha256sum: command not found”,说明校验失败或未安装sha256sum工具,需先执行 sudo apt install -y coreutils。
安装SDK并配置开发环境变量
运行SDK根目录下的 install.sh 脚本:
sudo ./install.sh
脚本会将头文件、库文件、CMake模块、pkg-config描述文件分别部署至 /usr/include/uos、/usr/lib/x86_64-linux-gnu/uos、/usr/lib/cmake/UOS 等标准路径。安装完成后,立即执行以下命令使环境变量生效:
source /usr/share/uos-sdk/uos-sdk-env.sh
该脚本会自动设置 UOS_SDK_ROOT、PKG_CONFIG_PATH 和 CMAKE_PREFIX_PATH。若后续编译报错提示 “Could not find a package configuration file”,说明此步未执行或终端已新建会话,需重新 source。
获取并离线加载官方开发文档
方法一:使用内置文档中心
打开「控制中心」→「开发者工具」→「UOS开发文档」,点击「下载最新版」。下载完成后点击「打开」,文档以QWebEngineView嵌入式浏览器形式加载,支持全文搜索与书签收藏。注意:首次加载需联网,但下载后的HTML资源包(位于 ~/.local/share/uos-docs/)完全离线可用。
方法二:手动提取CHM/PDF离线包
进入SDK解压目录下的 docs/ 子目录,找到 uos-sdk-reference.chm(Windows兼容格式)或 uos-sdk-api-ref.pdf。PDF文档含完整类图、信号槽索引与权限声明示例表,适合打印查阅;CHM文件双击即可打开,但UOS默认无CHM阅读器,需额外安装 xchm:sudo apt install -y xchm。
方法三:启用本地HTTP文档服务(推荐调试时使用)
cd docs/html && python3 -m http.server 8080
然后在浏览器中访问 http://localhost:8080。该方式支持实时刷新、Ctrl+F全局搜索、以及点击跳转到任意类/函数的源码位置(前提是SDK中附带了源码链接标记)。【关键提醒:此服务仅绑定127.0.0.1,外网不可访问,无需担心暴露本地文档】
用CMakeLists.txt正确引用UOS SDK
第一步:在项目根目录 CMakeLists.txt 开头添加最低要求声明
cmake_minimum_required(VERSION 3.10)
第二步:声明项目并查找UOS SDK模块
project(MyApp VERSION 1.0 LANGUAGES CXX)
find_package(UOS REQUIRED CONFIG PATHS ${UOS_SDK_ROOT}/lib/cmake/UOS)
第三步:创建可执行目标并链接DTK组件
add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE UOS::dtkwidget UOS::dtkcore)
第四步:确保头文件路径自动注入(UOS SDK的CMake配置已内置此逻辑,无需手动 include_directories)
第五步:生成构建目录并编译
mkdir build && cd build && cmake .. && make











