Configuración del icono de la aplicación

El icono de la aplicación, que normalmente se muestra en la esquina superior izquierda de las ventanas de nivel superior de una 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 presenta 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, cree un archivo de mapa de bits en formato ICO que contenga la imagen del icono. Esto puede hacerse utilizando Microsoft Visual Studio: Seleccione File >> New y elija Icon File.

Alternativamente, se puede crear un archivo .ico a partir de un conjunto de imágenes utilizando la herramienta de conversión de ImageMagick:

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

Guarde el archivo ICO en el directorio de código fuente de su aplicación, por ejemplo, con el nombre appico.ico.

Uso de CMake en Windows

Para configurar el icono de su aplicación, se necesita 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, consulte Acerca de los archivos de recursos.

Una vez que tenga el archivo .rc, añádale información sobre el archivo ICO y utilícelo para configurar el icono de su aplicación.

El siguiente fragmento 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})

Observa 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 todavía estás usando qmake para generar tus makefiles, necesitas agregar una sola línea a tu archivo de proyecto .pro:

RC_ICONS = myappico.ico

Finalmente, regenera tu makefile y tu aplicación. El archivo .exe estará ahora representado por su icono en el Explorador.

Sin embargo, si ya dispone de un archivo .rc, por ejemplo, con el nombre myapp.rc, que desea reutilizar, deberá realizar los dos pasos siguientes. En primer lugar, añada una sola línea de texto al archivo myapp.rc:

IDI_ICON1               ICON    "myappico.ico"

A continuación, añada esta línea a su archivo myapp.pro:

RC_FILE = myapp.rc

Si no utiliza qmake, los pasos necesarios son: primero, cree un archivo .rc y ejecute el programa rc o windres en el archivo .rc, después enlace su aplicación con el archivo .res resultante.

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

El icono de la aplicación, que normalmente se muestra en el área dock de la aplicación, se configura llamando a QWindow::setIcon() en una ventana. Es posible que el programa aparezca en el área dock de la aplicación antes de la llamada a la función, en cuyo caso aparecerá un icono por defecto durante la animación de rebote.

Para asegurarse de que aparece el icono correcto, tanto cuando se está lanzando la aplicación, como en el Finder, es necesario emplear una técnica que depende de la plataforma.

Aunque muchos programas pueden crear archivos de iconos (.icns), lo recomendable es utilizar el programa iconutil suministrado por Apple. iconutil es una herramienta de línea de comandos que convierte las carpetas de iconos en archivos icns de alta resolución listos para su despliegue. El uso de esta herramienta también comprime el archivo icns resultante, por lo que no es necesario realizar una 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 puede lograrse estableciendo el nombre del archivo .icns en la variable MACOSX_BUNDLE_ICON_FILE.

El siguiente fragmento 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})

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

Uso de qmake en macOS

Si sigues utilizando qmake para generar tus makefiles, sólo tienes que añadir una única 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 sus iconos en el lugar adecuado y cree una entrada Info.plist para el icono.

Si no utiliza qmake, deberá hacer lo siguiente manualmente:

1. Cree un archivo Info.plist para su aplicación (utilizando el PropertyListEditor, que se encuentra en Developer/Applications).
2. Asocie su registro .icns con el registro CFBundleIconFile en el archivo Info.plist (de nuevo, utilizando PropertyListEditor).
3. Copie el archivo Info.plist en el directorio Contents de su paquete de aplicaciones.
4. Copie el archivo .icns en el directorio Contents/Resources de su paquete de aplicaciones.

Configuración del icono de la aplicación en escritorios Linux comunes

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

A menudo, los usuarios no utilizan directamente los archivos ejecutables, 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 que incluye información sobre su icono. Ambos entornos de escritorio son capaces de recuperar la información de estos archivos y la utilizan para generar accesos directos a las aplicaciones en el escritorio, en el menú de inicio y en el panel.

Encontrará más información sobre los archivos de entrada al escritorio en la Especificación de entrada al escritorio.

Aunque los archivos de entrada al 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 del tema de iconos se indican varias ubicaciones para los iconos.

Aunque la ruta utilizada para ubicar los iconos depende del escritorio en uso, y de su configuración, la estructura de directorios bajo cada uno de ellos debería seguir el mismo patrón: los subdirectorios se organizan por tema, tamaño del icono y tipo de aplicación. Generalmente, los iconos de las aplicaciones se añaden al tema hicolor, por lo que un icono de aplicación cuadrado de 32 píxeles de tamaño se almacenaría en el directorio hicolor/32x32/apps debajo de la ruta de iconos.

Entorno de escritorio K (KDE)

Los iconos de aplicación se pueden instalar para que los utilicen todos los usuarios o por usuario. Un usuario actualmente conectado a 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 devuelta por este comando:

qtpaths --locate-dirs GenericDataLocation icons

Normalmente, la lista de rutas separadas por dos puntos impresa en stdout incluye la ruta de iconos específica del usuario y la ruta de todo el sistema. Bajo estos directorios, debería ser posible localizar e instalar iconos de acuerdo con las convenciones descritas en la Especificación del Tema de Iconos.

Si está desarrollando exclusivamente para KDE, puede aprovechar el sistema de compilación de KDE para configurar su aplicación. Esto asegura que sus iconos se instalen en las ubicaciones apropiadas para KDE.

El sitio web para desarrolladores de KDE está 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 puede determinarse usando gnome-config, por ejemplo escribiendo lo siguiente en una ventana de terminal:

gnome-config --datadir

La ruta impresa en stdout se refiere 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 del Tema de Iconos.

Si está desarrollando exclusivamente para GNOME, puede que desee utilizar el conjunto estándar de herramientas de compilación de GNU. Para más información, vea la sección Pautas de integración. Esto asegura que sus iconos se instalen en las ubicaciones apropiadas para GNOME.

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