Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

更改 Windows 的应用程序图标¶

默认情况下，导出项目的图标将是 Godot 图标。您很可能想要为您的项目更改它。在 Windows 上可以更改两种类型的图标：文件图标和任务栏图标。

创建 ICO 文件¶

Windows 无法使用 png 或 jpg 格式的应用图标。然而，它会使用 Windows专属的 ICO 格式。你可以在任何程序中创建应用图标，但需要用像 GIMP 这类程序转换成 ICO 文件。

这个视频教程展示了怎么用 GIMP 导出 ICO 文件。

也可以使用这个 ImageMagick 命令，将 PNG 图像转换为 hiDPI 友好的 ICO 文件：

magick convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

根据你所安装的 ImageMagick 的版本的不同，你可能会需要把 magick 去掉，运行以下命令：

convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

警告

为了使 ICO 文件有效地替换默认 Godot 图标，它必须包含默认 Godot 图标所包含的所有尺寸：16×16、32×32、48×48、64×64、128×128、256×256。如果该 ICO 文件未包含所有尺寸，没有被覆盖的尺寸将保留默认 Godot 图标。

上面的 ImageMagick 命令考虑到了这一点。

更改任务栏图标¶

任务栏图标是项目运行时显示在任务栏上的图标。

要更改任务栏图标，请前往项目 → 项目设置 → Application → Config → Windows Native Icon（应用程序 → 配置 → Windows 原生图标）。单击文件夹图标，然后选择所需的 ICO 文件。

这个设置只会修改 Windows 导出的游戏图标。设置 macOS 的图标请使用 Macos Native Icon（macOS 原生图标）。其他平台请使用 Icon（图标）设置。

更改文件图标¶

从 Godot 3.5 开始，你可以使用 godoticon 来修改文件图标，无需外部工具。使用这种方法修改图标应该对内嵌 PCK 的可执行文件也有效。

警告

修改内嵌 PCK 文件的应用程序图标时存在已知问题。如果在“导出”对话框的 Windows 导出预设中勾选了 Embed Pck 选项，建议避免使用 rcedit。

文件图标是您单击以启动游戏的可执行文件的图标。

在导出选项中选择它之前，您需要额外安装一个名为 rcedit 的工具。您可以在这里进行下载。

下载后，您需要告诉 Godot 计算机上 rcedit 可执行文件的路径。请前往编辑器 → 编辑器设置 → Export → Windows。点击 rcedit 条目的文件夹图标。导航到并选择 rcedit 可执行文件。

备注

Linux 和 macOS 用户还需要安装 WINE 才能使用 rcedit。

On macOS 10.15 (Catalina) or later, make sure to use a 64-bit version of both WINE and rcedit since 32-bit applications aren't supported anymore.

您现在应该已准备好所有内容来更改文件图标。为此，您需要在导出时指定图标。转到项目 → 导出。假设您已经创建了 Windows Desktop 预设，请在 Application → Icon 字段中选择 ICO 格式的图标。

警告

All the supplied metadata must be valid. Most importantly, the version identifiers must take the form major.minor.patch.revision where every component is required and is a positive integer. For instance, 1.2.0.0 is valid but 1.2.0 is not.

If you provide invalid metadata in the export preset, the application icon won't change as rcedit will fail to change the executable's metadata.

备注

如果 rcedit 修改图标失败，你可以在改变图标后编译你自己的 Windows 导出模板。实现方法是在编译导出模板之前用你自己的 ICO 文件替换 platform/windows/godot.ico。

这样做之后，你就可以在项目的 Windows 导出预设中将你的导出模板指定为自定义导出模板。

测试结果¶

您现在可以导出项目了。如果一切正常，您应该看到：

备注

如果你的图标没有正确显示，在 Windows 10 中，请尝试清理图标缓存。实现方法是打开运行对话框并输入 ie4uinit.exe -ClearIconCache 或 ie4uinit.exe -show。