Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Alterando o ícone do aplicativo para Windows

Por padrão, o ícone do projeto exportado será o ícone do Godot. Você provavelmente vai querer mudar isso para seu projeto. Existem dois tipos de ícones que podem ser alterados no Windows: o ícone do arquivo e o ícone da barra de tarefas.

Criando um arquivo ICO

O Windows não usa formatos como png ou jpg para ícones de aplicativo. Em vez disso, ele usa um formato somente para Windows chamado ICO. Você pode criar seu ícone de aplicativo em qualquer programa, mas terá que convertê-lo para um arquivo ICO usando um programa como o GIMP.

Este tutorial em vídeo explica como exportar um arquivo ICO com o GIMP.

Também é possível converter uma imagem PNG para um arquivo ICO amigável ao hiDPI usando este comando do ImageMagick:

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

Depending on which version of ImageMagick you installed, you might need to leave out the magick and run this command instead:

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

Aviso

Para o arquivo ICO apropriadamente substituir o ícone Godot predefinido, ele deve conter todos os tamanhos inclusos no ícone Godot predefinido: 16x16, 32x32, 48x48, 64x64, 128x128, 256x256. Caso o arquivo ICO não contenha todos os tamanhos, o ícone Godot predefinido será mantido para os que não foram substituídos.

O comando de ImageMagick acima leva isso em consideração.

Mudando o ícone da barra de tarefas

O ícone da barra de tarefas é o ícone que aparece na barra de tarefas quando seu projeto está sendo executado.

../../_images/icon_taskbar_icon.png

Para alterar o ícone da barra de tarefas, vá para Projeto → Opções do Projeto → Aplicação → Config → Windows Native Icon. Clique no ícone da pasta e selecione seu arquivo ICO.

../../_images/icon_project_settings.png

Esta configuração só altera o ícone do jogo exportado no Windows. Para definir o ícone para macOS, use Macos Native Icon. E para qualquer outra plataforma, use a configuração Icon.

Mudando o ícone do arquivo

In Godot 3.5 and later, you can change the file icon without external tools using godoticon. Changing the file icon this way should work for executables containing an embedded PCK.

Aviso

Existem problemas conhecidos ao alterar o ícone do aplicativo em executáveis que incorporam um arquivo PCK. É recomendado evitar usar o rcedit por enquanto se você excolher a opção Embed Pck para sua predefinição de exportação no diálogo de Exportar.

O ícone do arquivo é o ícone do executável que você clica para iniciar o projeto.

../../_images/icon_file_icon.png

Antes de selecioná-lo nas opções de exportação, você precisará instalar uma ferramenta extra chamada rcedit. Você pode baixá-la aqui.

Após o download, você precisa dizer ao Godot o caminho para o executável rcedit em seu computador. Vá para Editor → Configurações do Editor → Export → Windows. Clique no ícone da pasta para a entrada rcedit. Navegue e selecione o executável rcedit.

Nota

Os usuários de Linux e macOS também precisarão instalar o WINE para usar o 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.

../../_images/icon_rcedit.png

Agora você deve ter tudo pronto para alterar o ícone do arquivo. Para fazer isso, você precisa especificar o ícone ao exportar. Vá para Projeto → Exportar. Assumindo que você já tenha criado uma predefinição Windows Desktop, selecione seu ícone em formato ICO no campo Application → Icon.

Aviso

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.

../../_images/icon_export_settings.png

Nota

Se o rcedit falhar em alterar o ícone, você pode em vez disso compilar seus próprios modelos de exportação Windows com o ícone alterado. Para isso, substitua o platform/windows/godot.ico pelo seu próprio arquivo ICO antes de compilar os modelos de exportação.

Uma vez feito isso, você pode especificar seus modelos de exportação como modelos de exportação personalizados na predefinição de exportação do Windows do seu projeto.

Testando o resultado

Agora você pode exportar o projeto. Se funcionou corretamente, você deve ver isto:

../../_images/icon_result.png

Nota

Se seu ícone não estiver aparecendo corretamente, no Windows 10, tente limpar o cache de ícones. Para isso, abra a caixa de diálogo Executar e digite ie4uinit.exe -ClearIconCache ou ie4uinit.exe -show.