En esta página

Configuración del icono de la aplicación

El icono de la aplicación, que suele aparecer en la esquina superior izquierda de las ventanas de nivel superior de la aplicación, se establece llamando al método QWindow::setIcon().

Para cambiar el icono del propio archivo ejecutable de la aplicación, tal y como se muestra en el escritorio (es decir, antes de iniciar la aplicación), es necesario emplear otra técnica que depende de la plataforma.

Configuración del icono de la aplicación en Windows

En primer lugar, crea un archivo de mapa de bits en formato ICO que contenga la imagen del icono. Esto se puede hacer utilizando Microsoft Visual Studio: selecciona « File >> New » y elige « Icon File ».

Nota: Noes necesario cargar la aplicación en el IDE de Visual Studio, ya que solo se va a utilizar el editor de iconos.

Como alternativa, se puede crear un archivo « .ico » a partir de un conjunto de imágenes utilizando la herramienta «convert» de ImageMagick:

magick.exe convert icon-16.png icon-32.png icon-256.png icon.ico

Guarda el archivo ICO en el directorio del código fuente de tu aplicación, por ejemplo, con el nombre « appico.ico ».

Uso de CMake en Windows

Para configurar el icono de tu aplicación, se requiere un archivo de recursos que contenga información sobre el icono. Un archivo de recursos es un archivo de texto que contiene información sobre los recursos de la aplicación, como iconos, cursores, fuentes, etc. Para obtener más información sobre los archivos de recursos y lo que pueden contener, consulta «Acerca de los archivos de recursos».

Una vez que tenga el archivo « .rc », añada a este la información sobre el archivo ICO y utilícelo para configurar el icono de su aplicación.

El siguiente fragmento de código muestra cómo la aplicación de ejemplo «Photo Surface » utiliza CMake para configurar un icono de aplicación:

    set(app_icon_resource_windows "${CMAKE_CURRENT_SOURCE_DIR}/resources/photosurface.rc")
    qt_add_executable(photosurfaceexample main.cpp ${app_icon_resource_windows})

Observe que el comando « set » define la variable « app_icon_windows », que contiene la ruta del archivo RC. Esta variable se utiliza con el comando « add_executable » para establecer el icono de la aplicación.

Uso de qmake en Windows

Si sigues utilizando qmake para generar tus archivos makefile, debes añadir una sola línea a tu archivo de proyecto .pro:

RC_ICONS = myappico.ico

Por último, vuelve a generar tu archivo «makefile» y tu aplicación. El archivo « .exe » aparecerá ahora representado por tu icono en el Explorador.

Sin embargo, si ya dispones de un archivo ` .rc `, por ejemplo, con el nombre ` myapp.rc`, que deseas reutilizar, deberás seguir estos dos pasos. En primer lugar, añade una sola línea de texto al archivo ` myapp.rc `:

IDI_ICON1               ICON    "myappico.ico"

A continuación, añade esta línea a tu archivo « myapp.pro »:

RC_FILE = myapp.rc

Si no utilizas qmake, los pasos necesarios son los siguientes: en primer lugar, crea un archivo .rc y ejecuta el programa rc o windres sobre el archivo .rc; a continuación, vincula tu aplicación con el archivo .res resultante.

Configuración del icono de la aplicación en macOS

El icono de la aplicación, que suele aparecer en el dock de aplicaciones, se configura llamando a la función ` QWindow::setIcon()` en una ventana. Es posible que el programa aparezca en el dock de aplicaciones antes de que se realice la llamada a la función, en cuyo caso aparecerá un icono predeterminado durante la animación de rebote.

Para garantizar que aparezca el icono correcto, tanto al iniciar la aplicación como en el Finder, es necesario emplear una técnica específica para cada plataforma.

Aunque muchos programas pueden crear archivos de iconos (.icns), el método recomendado es utilizar el programa iconutil proporcionado por Apple. iconutil es una herramienta de línea de comandos que convierte carpetas de conjuntos de iconos en archivos icns de alta resolución listos para su implementación. El uso de esta herramienta también comprime el archivo icns resultante, por lo que no es necesario realizar ninguna compresión adicional.

Uso de CMake en macOS

Para configurar el icono de la aplicación, el archivo Info.plist generado por CMake debe contener la información del icono. Esto se consigue asignando el nombre del archivo .icns a la variable MACOSX_BUNDLE_ICON_FILE.

El siguiente fragmento de código muestra cómo la aplicación de ejemplo Photo Surface utiliza CMake para configurar el icono de la aplicación:

    # The MACOSX_BUNDLE_ICON_FILE variable is added to the Info.plist
    # generated by CMake. This variable contains the .icns file name,
    # without the path.
    set(MACOSX_BUNDLE_ICON_FILE photosurface.icns)

    # And the following tells CMake where to find and install the file itself.
    set(app_icon_macos "${CMAKE_CURRENT_SOURCE_DIR}/resources/photosurface.icns")
    set_source_files_properties(${app_icon_macos} PROPERTIES
           MACOSX_PACKAGE_LOCATION "Resources")

    qt_add_executable(photosurfaceexample MACOSX_BUNDLE main.cpp ${app_icon_macos})

Obsérvese que el primer comando set define la variable MACOSX_BUNDLE_ICON_FILE, necesaria para añadir el archivo de icono al archivo Info.plist. El segundo comando set define la variable app_icon_macos con la ruta absoluta al archivo de icono. Esta variable se utiliza a continuación para configurar MACOSX_PACKAGE_LOCATION, que define la ubicación de instalación del archivo de icono. Por último, el archivo « add_executable » utiliza la variable « app_icon_macOS » para establecer el icono de la aplicación.

Uso de qmake en macOS

Si sigues utilizando qmake para generar tus archivos makefile, solo tienes que añadir una línea a tu archivo de proyecto .pro. Por ejemplo, si el nombre de tu archivo de icono es myapp.icns y tu archivo de proyecto es myapp.pro, añade esta línea a myapp.pro:

ICON = myapp.icns

Esto garantizará que qmake coloque tus iconos en el lugar adecuado y cree una entrada Info.plist para el icono.

Si no utilizas qmake, debes realizar los siguientes pasos manualmente:

  1. Crea un archivo ` Info.plist ` para tu aplicación (utilizando la herramienta ` PropertyListEditor`, que se encuentra en Developer/Applications).
  2. Asocia tu registro « .icns » con el registro « CFBundleIconFile » en el archivo Info.plist (de nuevo, utilizando la herramienta PropertyListEditor).
  3. Copia el archivo « Info.plist » en el directorio « Contents » del paquete de tu aplicación.
  4. Copia el archivo « .icns » en el directorio « Contents/Resources » del paquete de tu aplicación.

Configuración del icono de la aplicación en entornos de escritorio Linux habituales

En esta sección describimos brevemente los aspectos relacionados con la provisión de iconos para aplicaciones en dos entornos de escritorio Linux habituales: KDE y GNOME. La tecnología básica utilizada para describir los iconos de las aplicaciones es la misma para ambos entornos de escritorio, y puede aplicarse también a otros, pero hay detalles específicos de cada uno. La principal fuente de información sobre los estándares utilizados por estos entornos de escritorio de Linux es freedesktop.org. Para obtener información sobre otros entornos de escritorio de Linux, consulta la documentación correspondiente a los entornos que te interesen.

A menudo, los usuarios no utilizan los archivos ejecutables directamente, sino que inician las aplicaciones haciendo clic en los iconos del escritorio. Estos iconos son representaciones de «archivos de entrada del escritorio» que contienen una descripción de la aplicación, incluida información sobre su icono. Ambos entornos de escritorio pueden recuperar la información contenida en estos archivos y la utilizan para generar accesos directos a las aplicaciones en el escritorio, en el menú de inicio y en el panel.

Puede encontrar más información sobre los archivos de entrada de escritorio en la Especificación de entradas de escritorio.

Aunque los archivos de entrada de escritorio pueden encapsular de forma útil los detalles de la aplicación, seguimos necesitando almacenar los iconos en la ubicación convencional para cada entorno de escritorio. En la Especificación de temas de iconos se indican varias ubicaciones para los iconos.

Aunque la ruta utilizada para localizar los iconos depende del entorno de escritorio que se utilice y de su configuración, la estructura de directorios subyacente a cada uno de ellos debe seguir el mismo patrón: los subdirectorios se organizan por tema, tamaño del icono y tipo de aplicación. Por lo general, los iconos de las aplicaciones se añaden al tema «hicolor», por lo que un icono cuadrado de 32 píxeles de tamaño se almacenaría en el directorio « hicolor/32x32/apps » dentro de la ruta de los iconos.

Entorno de escritorio K (KDE)

Los iconos de las aplicaciones pueden instalarse para que los utilicen todos los usuarios o de forma específica para cada usuario. Un usuario que haya iniciado sesión en su escritorio KDE 4 puede descubrir estas ubicaciones utilizando kde4-config; por ejemplo, escribiendo lo siguiente en una ventana de terminal:

kde4-config --path icon

Las aplicaciones que utilicen Qt 5 y KDE Frameworks 5 encontrarán sus iconos en la lista que devuelve este comando:

qtpaths --locate-dirs GenericDataLocation icons

Normalmente, la lista de rutas separadas por dos puntos que se muestra en la salida estándar incluye la ruta de los iconos específica del usuario y la ruta para todo el sistema. Dentro de estos directorios, debería ser posible localizar e instalar iconos de acuerdo con las convenciones descritas en la Especificación de temas de iconos.

Si estás desarrollando exclusivamente para KDE, quizá te interese aprovechar el sistema de compilación de KDE para configurar tu aplicación. Esto garantiza que tus iconos se instalen en las ubicaciones adecuadas para KDE.

La página web para desarrolladores de KDE se encuentra en https://techbase.kde.org/.

GNOME

Los iconos de las aplicaciones se almacenan en un directorio estándar del sistema que contiene archivos independientes de la arquitectura. Esta ubicación se puede determinar utilizando gnome-config, por ejemplo, escribiendo lo siguiente en una ventana de terminal:

gnome-config --datadir

La ruta que aparece en la salida estándar (stdout) hace referencia a una ubicación que debería contener un directorio llamado pixmaps; la estructura de directorios dentro del directorio pixmaps se describe en la Especificación de temas de iconos.

Si estás desarrollando exclusivamente para GNOME, es posible que te interese utilizar el conjunto estándar de herramientas de compilación de GNU. Para obtener más información, consulta la sección «Directrices de integración ». De este modo, te aseguras de que tus iconos se instalen en las ubicaciones adecuadas para GNOME.

El sitio web para desarrolladores de GNOME, https://developer.gnome.org/, ofrece más información sobre el desarrollo de aplicaciones.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.