必须通过uos应用商店一键安装（推荐新手）或手动编译源码（适配全架构）；前者自动处理签名、qt依赖与桌面集成，后者需安装build-essential、qt6-base-dev等依赖，使用gitee.com/uniontech/pencil2d-uos分支，执行qmake -qt=qt6、make、sudo make install并刷新ldconfig。
要在统信UOS系统上安装并直接运行Pencil2D进行2D手绘动画制作，必须避开Windows/macOS惯用的预编译安装包路径——UOS不兼容原生Windows版.exe或macOS .dmg，也不能直接运行未签名的Linux通用二进制文件；需优先采用应用商店认证包或源码编译适配方式。
通过UOS应用商店一键安装（推荐新手）
该方式适用于已通过统信UOS V20/23兼容性认证的Pencil2D官方包，自动处理签名验证、Qt依赖与桌面集成，无需终端操作。
1. 点击屏幕左下角启动器图标 → 在搜索框输入“Pencil2D”并回车。
2. 在结果中识别发布者为“Pencil2D Team”或“UnionTech Software”的官方应用条目（非第三方打包者）。
3. 点击进入详情页，确认版本号≥0.7.0且标注“支持AMD64/ARM64”架构，再点击右上角“安装”按钮。
4. 输入管理员密码后等待进度条完成；安装成功后，可在“图形图像”分类或搜索栏直接启动Pencil2D。
⚠️ 若搜索无结果，说明当前UOS版本未上架该应用，需切换至源码编译方案。
手动编译安装（适配全架构，含ARM64/LoongArch）
统信UOS默认未预装Qt 6开发套件和C++构建工具，需先补全依赖再编译源码。此路径可确保Pencil2D与UOS内核及图形栈深度兼容。
第一步：启用开发者模式并安装基础构建工具
打开“控制中心”→“系统安全”→“安全中心”，开启“开发者模式”，输入当前用户密码验证；随后在终端执行：
sudo apt update && sudo apt install build-essential qt6-base-dev qt6-multimedia-dev libgl1-mesa-dev
第二步：获取适配UOS的源码分支
官方主干代码对UOS的Wayland会话支持不稳定，必须使用社区维护的UOS专用分支：
git clone https://gitee.com/uniontech/pencil2d-uos.git && cd pencil2d-uos
第三步：配置Qt构建环境
执行 qmake -qt=qt6 CONFIG+=release，若提示“qmake: could not find a Qt installation of ‘qt6’”，说明Qt6路径未注册，需运行：
sudo /opt/qt6/bin/qtchooser -install qt6 /opt/qt6/bin/qmake
第四步：编译并安装
make -j$(nproc) → 编译耗时约8–12分钟（视CPU核心数而定）
sudo make install
【关键】安装完成后，执行 sudo ldconfig 刷新动态库缓存，否则启动时提示“libQt6Core.so.6: cannot open shared object file”
启动与基础绘图验证
方法一：命令行启动（排查环境问题首选）
终端输入 pencil2d，若窗口正常弹出且菜单栏完整显示，说明Qt组件与图形驱动已就绪。
方法二：桌面快捷方式启动
若编译安装后未自动生成图标，手动创建.desktop文件：
sudo nano /usr/share/applications/pencil2d.desktop，填入标准Desktop Entry字段，保存后执行 sudo update-desktop-database。
首次启动时，时间轴默认为空白帧，点击工具栏“铅笔”图标 → 在画布任意位置单击拖动即可绘制线条；按Ctrl+Z可撤销，无需额外配置压感——UOS已内置Wacom/Huion HID协议支持。
