chore: release v0.1.4 packaging fixes

Author: txp666

.github/workflows/release.yml

@@ -36,7 +36,7 @@ jobs:
         if: runner.os == 'Linux'
         run: |
           sudo apt-get update
-          sudo apt-get install -y ninja-build libgl1-mesa-dev
+          sudo apt-get install -y ninja-build libgl1-mesa-dev libxcb-cursor0 libxkbcommon-x11-0
 
       - name: Install macOS packages
         if: runner.os == 'macOS'
@@ -103,8 +103,81 @@ jobs:
               find build/release -maxdepth 6 -print
               exit 1
             fi
-            cp "$binary_target" "$package_root/"
+
+            mkdir -p "$package_root/bin" "$package_root/lib" "$package_root/plugins"
+            cp "$binary_target" "$package_root/bin/FluentSerialAssistant"
+            chmod +x "$package_root/bin/FluentSerialAssistant"
+
+            qt_prefix="${QT_ROOT_DIR:-}"
+            if [ -z "$qt_prefix" ]; then
+              qt_prefix="$(qtpaths6 --install-prefix 2>/dev/null || qtpaths --install-prefix)"
+            fi
+            qt_plugins_dir="$(qtpaths6 --plugin-dir 2>/dev/null || qtpaths --plugin-dir)"
+
+            copy_qt_dependencies() {
+              local source_file="$1"
+              while IFS= read -r dep; do
+                if [ -z "$dep" ] || [ ! -f "$dep" ]; then
+                  continue
+                fi
+                case "$dep" in
+                  "$qt_prefix"/*)
+                    copy_qt_library "$dep"
+                    ;;
+                esac
+              done < <(ldd "$source_file" | awk '{ if ($2 == "=>") print $3; else if ($1 ~ /^\//) print $1; }')
+            }
+
+            copy_qt_library() {
+              local dep="$1"
+              local base
+              base="$(basename "$dep")"
+              if [ -f "$package_root/lib/$base" ]; then
+                return
+              fi
+              cp -Lf "$dep" "$package_root/lib/$base"
+              copy_qt_dependencies "$dep"
+            }
+
+            copy_qt_plugin_group() {
+              local group="$1"
+              shift
+              local destination="$package_root/plugins/$group"
+              mkdir -p "$destination"
+              local pattern plugin
+              for pattern in "$@"; do
+                for plugin in "$qt_plugins_dir/$group"/$pattern; do
+                  if [ ! -e "$plugin" ]; then
+                    continue
+                  fi
+                  cp -Lf "$plugin" "$destination/"
+                  copy_qt_dependencies "$plugin"
+                done
+              done
+            }
+
+            copy_qt_dependencies "$package_root/bin/FluentSerialAssistant"
+            copy_qt_plugin_group platforms 'libqxcb.so'
+            copy_qt_plugin_group imageformats '*.so'
+            copy_qt_plugin_group iconengines '*.so'
+            copy_qt_plugin_group tls '*.so'
+            copy_qt_plugin_group platforminputcontexts '*.so'
+
+            printf '%s\n' '[Paths]' 'Prefix = ..' 'Plugins = ../plugins' > "$package_root/bin/qt.conf"
+            printf '%s\n' \
+              '#!/usr/bin/env bash' \
+              'set -e' \
+              'app_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"' \
+              'export LD_LIBRARY_PATH="$app_dir/lib:${LD_LIBRARY_PATH:-}"' \
+              'export QT_PLUGIN_PATH="$app_dir/plugins"' \
+              'exec "$app_dir/bin/FluentSerialAssistant" "$@"' \
+              > "$package_root/FluentSerialAssistant"
             chmod +x "$package_root/FluentSerialAssistant"
+
+            mkdir -p "$package_root/share/applications" "$package_root/share/icons/hicolor/1024x1024/apps"
+            cp packaging/linux/tech.zhangshu.FluentSerialAssistant.desktop "$package_root/share/applications/"
+            cp logo.png "$package_root/share/icons/hicolor/1024x1024/apps/tech.zhangshu.FluentSerialAssistant.png"
+            du -sh "$package_root"
           fi
 
           cp README.md CHANGELOG.md LICENSE "$package_root/"

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 本项目遵循面向用户的变更记录格式。版本号在正式发布前可能继续调整。
 
+## [0.1.4] - 2026-07-08
+
+### 修复
+
+- macOS 发布包写入应用 `.icns` 图标，修复 Finder 和 Dock 中不显示应用图标的问题。
+- Linux 发布包改为携带 Qt 运行库、Qt 插件、启动脚本和桌面图标元数据，避免只发布裸可执行文件导致包体异常小且依赖系统 Qt。
+- 增加 GitHub Social preview 预览图，用于替换默认仓库动态卡片中的 owner 头像。
+
 ## [0.1.3] - 2026-07-08
 
 ### 新增

CMakeLists.txt

@@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.21)
 
 project(
     FluentSerialAssistant
-    VERSION 0.1.3
+    VERSION 0.1.4
     DESCRIPTION "A Fluent Qt serial assistant prototype"
     LANGUAGES CXX
 )
@@ -68,6 +68,12 @@ if(WIN32)
     target_sources(FluentSerialAssistant PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/app_icon.rc")
 endif()
 
+if(APPLE)
+    set(APP_ICON_PATH_MACOS "${CMAKE_CURRENT_SOURCE_DIR}/src/app/resources/app_icon.icns")
+    target_sources(FluentSerialAssistant PRIVATE "${APP_ICON_PATH_MACOS}")
+    set_source_files_properties("${APP_ICON_PATH_MACOS}" PROPERTIES MACOSX_PACKAGE_LOCATION "Resources")
+endif()
+
 target_include_directories(FluentSerialAssistant PRIVATE src src/app)
 
 target_link_libraries(FluentSerialAssistant
@@ -96,6 +102,7 @@ set_target_properties(FluentSerialAssistant PROPERTIES
     MACOSX_BUNDLE TRUE
     MACOSX_BUNDLE_BUNDLE_NAME "Fluent Serial Assistant"
     MACOSX_BUNDLE_GUI_IDENTIFIER "tech.zhangshu.FluentSerialAssistant"
+    MACOSX_BUNDLE_ICON_FILE "app_icon.icns"
     MACOSX_BUNDLE_SHORT_VERSION_STRING "${PROJECT_VERSION}"
     MACOSX_BUNDLE_BUNDLE_VERSION "${PROJECT_VERSION}"
 )

README.md

@@ -180,10 +180,16 @@ CI 会在以下平台执行 Release 构建：
 
 - Windows：`windows-latest`，MSVC 2022
 - Linux：`ubuntu-latest`，GCC
-- macOS：`macos-13`，Clang
+- macOS：`macos-15`，Clang
 
 CI 不使用本机 `CMakePresets.json` 中的固定 Qt 路径，而是在工作流中安装 Qt 并通过 CMake 直接配置。
 
+推送 `v*` 标签会触发 Release 打包：
+
+- Windows：使用 `windeployqt` 生成部署目录。
+- macOS：使用 `.app` bundle，包含应用 `.icns` 图标。
+- Linux：生成携带 Qt 运行库、Qt 插件、启动脚本和桌面图标元数据的 `.tar.gz`。
+
 ## 使用说明
 
 1. 选择串口端口，必要时点击刷新。

docs/images/social-preview.png

@@ -0,0 +1,15 @@
+# Fluent 串口助手 v0.1.4
+
+这是一个发布包修复版本。
+
+## 修复
+
+- macOS 发布包写入应用 `.icns` 图标，Finder 和 Dock 会显示应用 logo。
+- Linux 发布包不再只包含裸可执行文件，改为携带 Qt 运行库、Qt 插件、启动脚本和桌面图标元数据。
+- 增加 GitHub Social preview 预览图，可上传到仓库 Settings 以替换默认动态卡片图片。
+
+## 发布资产
+
+- Windows x64：包含 `windeployqt` 部署后的运行文件。
+- macOS：包含 `.app` 应用包和应用图标。
+- Linux x64：包含可执行启动脚本、Qt 运行库、Qt 插件和桌面图标元数据。

docs/release-notes/v0.1.4.md

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Name=Fluent Serial Assistant
+Name[zh_CN]=Fluent 串口助手
+Comment=Serial terminal assistant
+Comment[zh_CN]=Fluent 风格串口调试助手
+Exec=FluentSerialAssistant
+Icon=tech.zhangshu.FluentSerialAssistant
+Categories=Development;Utility;
+Terminal=false

packaging/linux/tech.zhangshu.FluentSerialAssistant.desktop

@@ -20,7 +20,7 @@ int main(int argc, char *argv[])
     app.setStyle(QStyleFactory::create(QStringLiteral("Fusion")));
     QCoreApplication::setOrganizationName(QStringLiteral("txp"));
     QCoreApplication::setApplicationName(QStringLiteral("FluentSerialAssistant"));
-    QCoreApplication::setApplicationVersion(QStringLiteral("0.1.3"));
+    QCoreApplication::setApplicationVersion(QStringLiteral("0.1.4"));
 
     AppFontPreferences::loadCustomFonts();
     FluentQt::FluentConfig::instance()->load();