如何为Flutter Linux桌面应用设置图标，解决构建后图标失效问题

1. 替换可执行文件的默认图标 #

Flutter Linux构建模板默认使用通用图标，需替换模板内的图标文件，让flutter build linux自动生成带自定义图标的可执行文件：

• 在项目linux/目录下创建icons/文件夹，放入256x256尺寸的PNG格式图标，命名为icon.png。
• 修改linux/CMakeLists.txt，找到图标配置相关代码，替换默认图标路径：

  # 替换原有ICON_FILE配置为自定义图标路径
  set(ICON_FILE "${CMAKE_CURRENT_SOURCE_DIR}/icons/icon.png")
  

2. 配置桌面文件并让构建自动处理路径 #

避免使用绝对路径，利用Flutter构建的变量替换机制处理桌面文件：

• 将你的my_app.desktop重命名为my_app.desktop.in，放到linux/目录下，修改内容为：

  [Desktop Entry]
  Version=1.0
  Type=Application
  Name=my_app
  Exec=@EXECUTABLE_NAME@
  Icon=@EXECUTABLE_NAME@
  Comment=Welcome to the flutterverse!
  Categories=Development;
  Terminal=false
  StartupNotify=true
  

  其中@EXECUTABLE_NAME@会在构建时自动替换为实际可执行文件名与图标路径。
• 修改linux/CMakeLists.txt，添加桌面文件与图标的安装规则：

  # 处理desktop文件变量替换
  configure_file(
    "${CMAKE_CURRENT_SOURCE_DIR}/my_app.desktop.in"
    "${CMAKE_CURRENT_BINARY_DIR}/my_app.desktop"
    @ONLY
  )
  # 安装desktop文件到系统应用目录
  install(FILES "${CMAKE_CURRENT_BINARY_DIR}/my_app.desktop"
    DESTINATION "${CMAKE_INSTALL_PREFIX}/share/applications")
  # 安装图标到系统标准图标目录
  install(FILES "${CMAKE_CURRENT_SOURCE_DIR}/icons/icon.png"
    DESTINATION "${CMAKE_INSTALL_PREFIX}/share/icons/hicolor/256x256/apps"
    RENAME "@EXECUTABLE_NAME@.png")
  

3. 设置窗口WM_CLASS，解决任务栏空白图标问题 #

任务栏通过WM_CLASS属性关联窗口与桌面文件，需在Flutter代码中设置对应属性：

• 在主入口文件（如main.dart）中添加Linux平台窗口配置：

  import 'package:flutter/foundation.dart';
  import 'package:flutter/material.dart';
  import 'package:flutter/services.dart';
  
  void main() {
    if (defaultTargetPlatform == TargetPlatform.linux) {
      // 设置WM_CLASS，值需与desktop文件的Name字段一致
      SystemChannels.platform.invokeMethod<void>(
        'LinuxWindow.setWMClass',
        {'className': 'my_app', 'instanceName': 'my_app'},
      );
    }
    runApp(const MyApp());
  }
  

  应用启动后，窗口会携带正确的WM_CLASS，任务栏会自动关联对应图标，不会出现空白新增项。

4. 构建验证 #

执行flutter build linux完成构建后：

• 可执行文件（build/linux/x64/release/bundle/my_app）会显示自定义图标。
• 手动复制build/linux/x64/release/bundle/下的文件到系统目录，或在build目录执行make install，此时桌面与任务栏图标均正常显示，点击收藏图标启动应用，任务栏不会新增空白项。

内容的提问来源于stack exchange，提问作者Jaime Roman