简 述: 仅纯粹 C++ 开发了一款 Sunny 截图软件,原生应用;支持 “截图 & 钉图”、”图片翻译”、”OCR提取文字” 等功能,多套皮肤和 Win10 的亚克力效果(类透明磨砂),简洁整体设计的窗口,

支持跨平台:已验证可运行在的系统 ヾ(≧▽≦*)o;

官网: https://sunny.xmuli.tech

支持跨平台:已验证可运行在的系统 ヾ(≧▽≦*)o,详见官网文档

① Windows 7 / 8 / 10 / 11

② MacOS: 10 / 11 / 12 / 13 / 14

③ Linux:Debian 12,Ubuntu 20.04 / 22.04 / 24.04,Deepin/UOS V20-23, openkylin 1.0.x,等

现已上架 Microsoft Store 和 Linux 多个应用商城,撒花🎊🎊🎊🎉🎉🎉;

开发完之后一直也没有宣传过,寂静的在的一隅仓库呆着着; 直到连续几天发现涌入大量流量,Star 也随之猛长;蛤?着什么情况,我啥也没干了。问了下新人,才知 Sunny 已被很多大佬和知名软件网站给翻牌子了,属实意外惊喜╰(°▽°)╯。

[TOC]


本文初发于 “偕臧的小站“,同步转载于此。


描述

Sunny 截图是使用纯 C++ 开发的一款简洁且漂亮的 “截图&拼图” 的软件工具,亦支持图片翻译和OCR 等功能;支持 Windows,MacOS,Linux 平台。

本项目从 2023 年起,至少会持续开发和维护十年,再更久的事情,那就彼时再说~;可以放心使用,因为我自身也在使用;

官网

**官网: ** https://sunny.xmuli.tech | 作者: 偕臧

GitHub | Gitee | Releases | Issues | App Store : Microsoft Store / Deepin Store / UOS Store / Spark Store /

反馈 Bug, 提出建议或者想法,任何帮助改进,亦可加入交流群:alt text

功能特色

  • 特色功能
    • 截图 & 钉图
    • 图片翻译(中/英/日/韩/俄/等)
    • OCR 提取文字
    • 窗口属性
    • 自动检测
    • 代码签名
  • 样式功能
    • 亚克力的透明磨砂
    • 自定义的活动色
    • 自定义”边框 & 十字线”的宽度
    • 绘画工具栏支持:垂直 & 水平
    • 钉图窗口的阴影效果
    • 钉图透明度
    • 多种系统风格
  • 其它功能
    • 自定义尺寸和位置截图、延时截图、窗口检测截图
    • 翻译和提取文字的 API,支持用私人 key
    • 手动保存 & 快捷保存 & 自动保存
    • 自动拷贝到剪切板
    • 调整字体及大小
    • 快捷键自定义
    • 国际化翻译
    • 开源库鸣谢
  • 跨平台移植
    • Windows 7 / 8 / 10 / 11+
    • Ubuntu 20.04 / 22.04+
    • Deepin / UOS V20.9 - 23+
    • openkylin V1.0.1+
  • App Store 已上架
    • Microsoft Store 微软商店
    • Deepin / UOS Store 深度社区 / 统信商店
    • Spark Store 星火商店
    • openkylin Store (Ongoing) 麒麟商店

相关文章


演示效果

视频

👉 Sunny 截图是一款简洁且漂亮的截图的软件工具,亦支持【图片翻译】和【OCR】


截图

Windows 10/11+

MacOS 10.15~13+

Linux

  • Ubuntu 22.04

  • Deepin V20.9 / UOS

  • openkylin V1.0.1


代码签名证书

极力推荐从 GirHub Release 下载,更新最快最稳定。下载文件后,文件右键属性校验其唯一性,确保文件没被篡改;

键盘快捷键

Keys Description Mode
F6 窗口激活截图图 全局
Ctrl + F6 仅延时截图 全局
Shift + F6 自定义截图(起点位置 + 截图区域 + 延迟时间) 全局
🐱‍🐉
Esc 退出截图 本地
Tab 切换挡位,检测的子窗口矩形的深度 本地
` / ~ 显示捕捉窗口的属性信息 (Path/Size/PID/HWnd …) 本地
Ctrl + Shift + S 快捷键快速保存到到指定的路径 本地
, , , ( A, S, W, D ) 移动选中区域 1px 本地
Ctrl + , , , 外扩选中区域 10 px 本地
Shift + , , , 内缩选中区域 10 px 本地

应用商店下载

Microsoft Store

在 Window 10/11+ 系统,也在微软商店直接下载


Deepin / UOS Store

深度社区、 统信操作系统商店中,已可直接下载

Spark Store

以及三方的星火商店,也可直接下载


截图作品系列

很久之前就想些一个软件截图的软件,目前一共写如下三个层级的难度作品,提供大家参考

  • Ⅰ. 新手之作 ShotX
    • 项目地址:ShotX | 镜像
    • 功 能:①基本的截图功能,复制和保存,②右键托盘及菜单,③支持 Window,MacOS,Linux,④攥写 Github-Action 的 CI/CD 自动脚本 .yml;实现自动打包和发布,⑤更多见 README 和 源码
    • 描 述:新手级的截图,适合初学 Qt/C++ 入门者
  • Ⅱ. 高级之作 FLIPPED
    • 官 网:flipped.xmuli.tech
    • 项目地址:FLIPPED | 镜像
    • 功 能:①贴图和钉图,②多屏截图,延时截图,自定义截图,③智能检测窗口矩形(Windows & Linux),④矩形、椭圆、箭头、画笔、马赛克、文本、序号,⑤撤销、重做(多级)、保存、取消、拷贝到剪切板,⑥截图框样式三套,且主题色提供自定义;屏幕十字线样式自定义,⑦国际化:英文、简体中文、繁体中文;字体和字号自定义,⑧支持设置窗口,托盘,截图区域之间的流畅切换,⑨更多见 README 和 源码
    • 描 述:高级难度,适合已学习 Qt/C++ 数年经验进阶,需同类型软件的代码借鉴,但可探索中独立写一个大的软件。出发于隐私安全,无任何联网功能。
  • Ⅲ. 商业级别的成熟之作 Sunny (推荐)
    • 官 网:sunny.xmuli.tech
    • 项目地址:Sunny | 镜像
    • 功 能:是 FLIPPED 作品的超集合,常见截图功能都都包含。还包含额外的功能:① “图片翻译” (中/英/日/韩/俄等),和”OCR 提取文字”,也支持用户私人token 的额度使用 ,② .iss 脚本和 CMake 来提供便携版,安装版,③ 绘画工具栏的亚克力效果,且支持跨平台(毛玻璃效果),④编辑文本支持富文本,同一个注释可采用多个字体和颜色等(暂未遇到其它同类软件也能做到),⑤全新的 UI/UE 设计交互,“设置窗口” 无任何缝隙拼接感,颜值达到简约美观,⑥优化截屏完成后的内存释放;⑦国际化翻译更方便,⑧CMake 重写拆分为 EXE + DLL 隔离,⑨进行代码签名,方便下载校验和防篡改,⑩成功上架 Window 的微软商店,Linux 的 深度/统信商店,以及三方的星火商店等;麒麟商店也在上架待审核
    • 描 述:基于前两个的项目经验和不足,直接重写了一套新的框架和UI界面;目前个人从代码功能和产品体验来说,已经达到 工程代码整洁、规范、稳定和健壮性,优秀的解耦机制,漂亮简约得 UI / UX 设计,可以随时应对变化的实际需求,很久之内都无需重构了。定位为 漂亮和简洁,功能实用为主。
项目 描述 开发经验
ShotX 功能极简的截图工具 简易,新手级的截图,适合初学 Qt/C++ 入门
FLIPPED 简洁且漂亮,功能完整的截图软件;隐私安全,无任何联网功能 高级难度,属 Qt/C++ 数年经验的进阶作品,在借鉴同类作品的代码时,可于探索中独立完成的一个大的软件
Sunny 一款简洁且漂亮的截图的软件工具。亦支持图片翻译和OCR;已上架微软商店,深度/统信商店,及三方的星火商店等 专业级作品,适合已多年沉浸研究 Qt/C++ 经验,随心所欲写任意所需功能,属于商业级的成熟作品,是本截图系列的最高水准之作

注: ShotX,FLIPPED,Sunny 这三款均支持跨平台 Windows / MacOS / Linux。

笔记: Sunny = FLIPPED的功能重构 + 代码重构 + UI重构 + 网络功能(图片翻译+OCR)+ 上架应用商店 + 后续新功能;而 ShotX 是最早的练手探索

如何开发一款截图软件呢?

在写和发布的后的期间,也遇到很多私聊请教 、 邮件沟通某个功能实现?反馈 Bug 和给出使用心得和建议;都给答疑了,但想来可写为一整篇,中间遇到的困难点都写出来,公开出来提供后来者参考。

编译环境

  💻 MacOS 13 📎 Qt 5.15.2 📎 gcc/g++ 9.2 📎 gdb8.3

  💻 Ubuntu 22.04 📎Deepin 20.9-23+ 📎 Qt 5.15.2 📎 gcc/g++ 9.0 📎 gdb8.0

  💻 win10 22H2 📎 Qt 5.15.2 📎 Visual Studio 2022 📎 C++17

【整体思路】

  • 基础窗口: 创建一个 QWidget 窗口,去掉标题栏后,全屏且置顶,捕获此刻多屏幕状态保存为 QPixamp,然后绘画在 QWidget 最底层,再绘画一层透明黑色作为遮罩
  • 绘画工具栏: 作为是一个单独的子窗口,包含两个一级和二级的绘画工具栏,控制二级的显隐
  • 鼠标光标: 将 QWidget 放于虚拟桌面的左上角;相对坐标和绝对坐标的转换
  • 功能思路: 时刻判断当前所处模式:Wait / Select / Move / Draw / Stretch 标记;根据模式标记,对鼠标的 Press / Move / Release 事件进行对应的操作;重点是鼠标放下和松开时的 QPoint
    • 捕获模式:智能窗口 / 全屏截图 / 延时截图 / 自定义截图 等
    • 绘画模式则细分:一级绘画栏和二级绘画栏(愈加精确的参数)
    • 拉伸可为:拉伸已绘图形 / 选中框 / … ,操作是可见区域的任意一个图案
    • 移动同上
  • 钉图功能: 独立的窗口,将图片绘画在最底层,且需要重绘缩小一圈,为毛玻璃的彩虹灯预留位置
  • 杂项但重要: 国际化,不重启切换语言字体,编译,打包,CI /CD,热键,窗口尺寸遍历,显示窗口详细信息及大小,代码签名证书,上架应用商店;太多了,单独成篇写在下面

【如何购买代码签名】

【如何上架应用商城】

  • 『问题』如何上架到微软的 Microsoft Store?如何上架 Linux 的深度/统信/麒麟商城,以及如三方的星火商店呢?

    篇幅太长,单写了一篇,包含详细上架 Windows Store, Deepin/UOS Store, 三方 星火商店等。

    👉 《Sunny截图上架Microsoft Store及Linux商店流程的指北

    Note:

    个人作品上架微软商店的流程很折磨,最后上架成功后也是拨开云雾;

    若是文章对你有价值,亦可帮我积累Sunny的微软信誉,或者在深度商店的好评,甚至感谢🙇‍ ;

    Windows 用户推荐的下载 👉 Sunny_setup_msvc_1.3.0_x64.exe


【打包发布 Windows / MacOS / Linux 上】

介绍多种平台和格式:①Windows:绿色便携版和安装包 .exe ②MacOS:.app.img ③Linux: 绿色版、 .deb.AppImage

  • 『问题』Windows 如何构建打包为 .exe 文件?如何生成构绿色版和安装版?

    QT 项目在 Windows 平台上面发布成可执行程序

  • 『问题』MacOS 如何构建打包为 .dmg 文件?

    QT 项目在 MacOS 平台上面发布成可执行程序

  • 『问题』Linux 如何构建打包为 .deb 文件、如何打包为通用的 .AppImage 格式?

    • Linux下又多种打包 .deb 打包方法:

      • 〖方法一〗通过 ldd.sh + Sunny.sh 两个脚本打包依赖,参考《QT 项目在 Linux 平台上面发布成可执行程序

      • 〖方法二〗通过 dh_make + dpkg-buildpackage 命令《Linux 中用 dh_make 将 Qt + CMake 项目打包为 deb 文件

      • 〖方法三,最推荐〗通过 CMake 的 cpack 命令,那样就不需要填写 debian 文件夹下的 control 等文件,直接拷贝相关资源文件过去。 CMakeLists.txt 底部加上 CPack 的相关代码,核心如下:

        # CPACK: General Settings
        set (CPACK_GENERATOR "TBZ2")
        set (CPACK_PACKAGE_NAME "${project_name}")
        set (CPACK_PACKAGE_VERSION "${project_version}")
        set (CPACK_PACKAGE_VENDOR "https://github.com/XMuli")
        set (CPACK_PACKAGE_DESCRIPTION_SUMMARY "Simple and beautiful screenshot software tool for Windows, MacOS and Linux")
        set (CPACK_PACKAGE_FILE_NAME "${CPACK_PACKAGE_NAME}-${CPACK_PACKAGE_VERSION}")
        set (CPACK_PACKAGE_CONTACT "https://sunny.xmuli.tech")
        # 设置Debian软件包的依赖关系
        set (CPACK_DEBIAN_PACKAGE_DEPENDS "libqt5x11extras5, libqt5svg5")
        set (CPACK_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}")
        set (CPACK_DEBIAN_PACKAGE_SHILIBDEPS ON)
        
        include(CPack)
    • Linux下有多种打包 .AppImage 打包方法

      #【方式四】使用 linuxdeployqt 方式打包,在 Ubuntu 22.04 打包,不可以使用 -----------------------------
      ####linuxdeployqt-continuous-x86_64.AppImage 方案可在 Ubuntu 22.04 上面不可行####
      $ ../linuxdeployqt-continuous-x86_64.AppImage Sunny -appimage
      $ sudo apt install  libfuse2
      
      但是由于过于作者的固执坚守旧的版本,所以无法使用,理由和可能的解决如下:
      https://github.com/probonopd/linuxdeployqt/issues/340#issuecomment-932712016
      即:使用linuxdeploy和linuxdeploy-plugin-qt
      
      #####linuxdeploy-x86_64.AppImage + linuxdeploy-plugin-qt-x86_64.AppImage 下面方案可行#####
      https://github.com/BearKidsTeam/thplayer/blob/master/.github/workflows/linux.yml#L54
      
      $ sudo apt update
      $ sudo apt install qtbase5-dev qtmultimedia5-dev libqt5multimedia5-plugins
      $ sudo add-apt-repository universe
      $ sudo apt install libfuse2
      
      $ wget https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage
      $ wget https://github.com/linuxdeploy/linuxdeploy-plugin-qt/releases/download/continuous/linuxdeploy-plugin-qt-x86_64.AppImage
      $ chmod +x linuxdeploy*.AppImage
      
      $ mkdir build && cd build
      $ cmake ..
      $ cmake --build . -j$(nproc)
      $ cd ..
      
      $ ../linuxdeploy-x86_64.AppImage --appdir AppDir -e bin/Sunny -d bin/resources/cpack/tech.xmuli.sunny.desktop -i bin/resources/logo/logo.svg --icon-filename tech.xmuli.sunny -p qt -o appimage
      
      $  ./linuxdeploy-x86_64.AppImage --appdir AppDir -e build/thplayer -d assets/thplayer.desktop -i assets/thplayer.svg --icon-filename thplayer -p qt -o appimage
      $ mv TouHou_Player*.AppImage thplayer-linux.AppImage
  • 『问题』如何书写 .yml 的脚本,通过 GitHub 的Action 资源,自动打包构建生成 Release 呢?

    通过写三个系统的 .yml 脚本,路径必须是 .github/workflows ,随着时间的流逝⌛,想要持续构建对应的云系统和 Kit 也必须更新,文档和版本参见 images ,直接往 .yml 修改;这是一个实际可跑的脚本 *.yml 都是可以编译成功的,失败可能是额度时间不够了,如某次成功的示例,可看到头像是 GitHub 的头像发布的 Release-v6.1


【UI / UX 设计的效果】

  • 『问题』截图的一级二级的菜单工具栏,如何实现 Windows7 的透明磨砂 / Windows 的亚克力的效果,且能够支持 Windows / Linux / MacOS?

    单纯实现亚克力效果不难,难在Linux和 MacOS 上也能实现这个效果?这是当时的一些探索和经验,总结了四种方法放置于 GitHub - AcrylicWindow

  • 『问题』如何实现一个完美的无边框窗口跨平台,且还要占用低,没有瑕疵BUG,还能白嫖?

    也折腾过,难度也很大,后来发现对于截图,费力可以实现,但是没必要,成本太大;结论:这样现成的没有,目前效果和跨平台都最佳的方案是framelesshelper, 有时放弃也是一种解决方案。

  • 『问题』如何实现国际化多语言的切换?尤其是未使用 Qt Designer 来创建 .ui 文件,遇到无 ui->retranslateUi(this) 函数?不重启软件便可以切换语言

    对于有有 .ui 的部分,可以通过 《Qt 项目(CMake)设置国际化支持》来解决。对于存手写的控件实现的,且大致实现的思路是:

    下拉框中切换语言时,发射信号 → 全局单例 → 信号和槽函 → 到主窗口的槽函数,在里面进行重新加载语言,所有相关的控件的默认文本,都写在这个函数里面,便可以不重启软件,直接实现语言切换成功


【用户体验细节】

  • 『问题』是否需要管理员权限才能运行?

    全程不会弹 UAC 弹窗,不需要管理员权限就可以使用所有功能,也不会中途提权,仅普通用户权限即可,包括导向安装,静默安装,使用卸载;

  • 『问题』Windows 和 Linux 支持一次截多个屏幕,MacOS 仅只能截图单个屏幕,如何实现呢?

    MacOS 除了系统自带的截图支持外,至今没有任何一个三方软件可以做到这点,包括大厂等某企鹅的截图的,无解。根原是属于此苹果接口没公开,至少没人能够发现。

  • 『问题』如何确保 MacOS 上的效果和 Window上面保持外观的一致?

    一个难点是再 MacOS 上也要和再 Windows 的效果保持一致,于是对不同风格进行对比,但 Fusion 又会倒是 Setting 窗口非原生的样式,但好在十分接近;选取一个平衡点。另外还手绘画了一个二十多个自定义或者复杂控件。


【看不见的优化】

  • 『问题』如何解决使用 ESC 取消截图后的内存泄露问题?QPointer 、智能指针、还是单例?

    也花了大力气来探究,在完成一次截图之后,内存的占用会在合适时机自动释放出来;这是定位在消耗内存的变量;开发环境显示器为 4K 27 寸 + 3K笔记本双屏;

  • 『问题』对于使用单例模式不止一处时,有序需要多个单例用来传递或者保存数值时候,重复写很容易

    可采用奇异递归模板的方式,然后添加一个宏展开为友元类;多个单例都只用写一份,而前提是需要对 《C++ 类的六个特殊成员函数》 很熟悉,才能理解,属于优雅的一种实现。

  • 『问题』日志和崩溃生成 DUMP 记录?

    日志可以通过配置文件修改,若是遇到传说的崩溃,亦会自动生成 .dmp 和 崩溃原因;

    转储文件存放: C:/Users/用户名/AppData/Local/XMuli/Sunny/cache/Sunny_Dumps/dump_2024_02_29_11_31_30_714.dmp

    实现方法可通过 WIN API 来实现

    #ifdef _MSC_VER
    SetUnhandledExceptionFilter((LPTOP_LEVEL_EXCEPTION_FILTER)ApplicationCrashHandler);//注冊异常捕获函数
    #endif

    额,你没接触过 DUMP,完全不会对其进行解剖分析?也简单写了一个使用 WinDbg 进行入门

    WinDbg:入门分析 dmp 文件『一』》、《WinDbg:调试之附加进程生成 dmp『二』

  • 『问题』希望单例运行EXE,确保全局唯一性?

    可以通过共享内存QSharedMemory 和系统信号量 QSystemSemaphore,双重保证程序在一台终端上,仅会运行一个;

    也能杜绝很罕见的一种情况,即使上次程序崩溃之后,但仍有残留的僵死进程,被误判当前没有启动。严谨(中指推一下眼镜)

    QString uniqueKey = "SunnyUniqueKey"; // 使用唯一的标识符来创建共享内存和系统信号量
    QSharedMemory sharedMemory;
    sharedMemory.setKey(uniqueKey);
    
    // 尝试附加到现有的共享内存并分离
    if (sharedMemory.attach()) {
        sharedMemory.detach();
    }
    
    // 尝试创建共享内存,如果已经存在,表示已经有一个实例在运行, 判断是为了确保在同一台计算机上只能运行一个相同实例的程序。
    if (!sharedMemory.create(1)) {
        qDebug() << "There is already an instance of the application running (by QSharedMemory)!";
        return 1;
    }
    
    // 创建系统信号量, 再尝试获取系统信号量,如果已经被其他实例持有,程序就退出, 判断是为了确保在多个进程同时启动时,只有一个进程能够继续执行。QSystemSemaphore用于创建系统信号量,如果系统信号量已经被其他实例持有(比如由于上一次程序异常退出导致信号量未被释放),则acquire函数会返回false,
    QSystemSemaphore systemSemaphore(uniqueKey, 1, QSystemSemaphore::Open);
    if (!systemSemaphore.acquire()) {
        qDebug() << "There is already an instance of the application running (by QSystemSemaphore)!";
        return 1;
    }
    
    // ...程序其它逻辑
    
    // 释放系统信号量
    systemSemaphore.release();

【Qt / C++ 编码问题】


【项目杂项】


  • 【编译遇坑】【杂谈经验总结】等有空再更

番外:意外之喜

分享一下喜悦

在 v1.3 发布的那天晚上,记得 downloads 是 900+ 的样子;发布完了就去睡觉了。

第二天早上一看下载量就是 1k, 1.1k;中午再看一眼就是 1.2k;晚上再看就是 1.3k;

第三天是 1.4k,

第四天是 1.5k,

… …哈哈哈哈哈哈哈哈哈, 放假回家过年了,也没怎么看

约大大前天回来一看,嗯,还是 1.5k,大家玩的开心愉快

大前天到了 1.6k

前天到了 1.7k

昨天号到了 1.7k

今天的到了 1.8k , 纪念打卡(–写这篇时)

在写过的所有软件中,总的下载量虽然不是最大的,但短时间增速率长是最快的 ヾ(≧▽≦*)o。


系列地址

QtExamples 欢迎 star ⭐ 和 fork 🍴 这个系列的 C++ / QT / DTK 学习,附学习由浅入深的目录,这里你可以学到如何亲自编写这类软件的经验,这是一系列完整的教程,并且永久免费