애플리케이션 아이콘 설정하기

애플리케이션 아이콘은 일반적으로 애플리케이션의 최상위 창 왼쪽 상단에 표시되며 QWindow::setIcon() 메서드를 호출하여 설정할 수 있습니다.

실행 가능한 애플리케이션 파일 자체의 아이콘을 변경하려면 데스크톱에 표시되는 것처럼(즉, 애플리케이션을 실행하기 전에) 플랫폼에 따라 다른 기술을 사용해야 합니다.

Windows에서 애플리케이션 아이콘 설정하기

먼저 아이콘 이미지가 포함된 ICO 형식의 비트맵 파일을 만듭니다. 이 작업은 Microsoft Visual Studio를 사용하여 수행할 수 있습니다: File >> New 을 선택하고 Icon File 을 선택합니다.

또는 이미지매직의 변환 도구를 사용하여 이미지 세트에서 .ico 파일을 만들 수 있습니다:

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

ICO 파일을 애플리케이션의 소스 코드 디렉토리에 저장합니다(예: appico.ico 이름).

Windows에서 CMake 사용

애플리케이션의 아이콘을 구성하려면 아이콘에 대한 정보가 포함된 리소스 파일이 필요합니다. 리소스 파일은 아이콘, 커서, 글꼴 등 애플리케이션 리소스에 대한 정보가 들어 있는 텍스트 파일입니다. 리소스 파일 및 리소스 파일에 포함할 수 있는 항목에 대한 자세한 내용은 리소스 파일 정보를 참조하세요.

.rc 파일이 있으면 여기에 ICO 파일에 대한 정보를 추가하고 이를 사용하여 애플리케이션 아이콘을 구성합니다.

다음 스니펫은 Photo Surface 예제 애플리케이션에서 CMake를 사용하여 애플리케이션 아이콘을 설정하는 방법을 보여줍니다:

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

set 명령은 RC 파일의 경로가 포함된 app_icon_windows 변수를 정의합니다. 이 변수는 add_executable 명령과 함께 애플리케이션의 아이콘을 설정하는 데 사용됩니다.

Windows에서 qmake 사용하기

여전히 qmake를 사용하여 메이크파일을 생성하는 경우 .pro 프로젝트 파일에 한 줄을 추가해야 합니다:

RC_ICONS = myappico.ico

마지막으로 메이크파일과 애플리케이션을 다시 생성합니다. 이제 탐색기에서 .exe 파일이 아이콘으로 표시됩니다.

그러나 재사용하려는 myapp.rc 파일과 같은 이름의 .rc 파일이 이미 있는 경우 다음 두 단계가 필요합니다. 먼저 myapp.rc 파일에 한 줄의 텍스트를 추가합니다:

IDI_ICON1               ICON    "myappico.ico"

그런 다음 이 줄을 myapp.pro 파일에 추가합니다:

RC_FILE = myapp.rc

qmake 를 사용하지 않는 경우 필요한 단계는 먼저 .rc 파일을 만들고 rc 또는 windres 프로그램을 .rc 파일에서 실행한 다음 애플리케이션을 결과물인 .res 파일에 연결합니다.

macOS에서 애플리케이션 아이콘 설정하기

일반적으로 애플리케이션 도크 영역에 표시되는 애플리케이션 아이콘은 창에서 QWindow::setWindowIcon()을 호출하여 설정할 수 있습니다. 함수를 호출하기 전에 프로그램이 애플리케이션 도크 영역에 표시될 수 있으며, 이 경우 기본 아이콘이 튀는 애니메이션 중에 표시됩니다.

애플리케이션이 실행될 때와 Finder에 올바른 아이콘이 표시되도록 하려면 플랫폼에 따라 달라지는 기술을 사용해야 합니다.

많은 프로그램에서 아이콘 파일(.icns)을 만들 수 있지만, Apple에서 제공하는 iconutil 프로그램을 사용하는 것이 좋습니다. iconutil은 아이콘 세트 폴더를 배포 가능한 고해상도 icns 파일로 변환하는 명령줄 도구입니다. 이 도구를 사용하면 결과물인 icns 파일도 압축되므로 추가 압축을 수행할 필요가 없습니다.

macOS에서 CMake 사용

애플리케이션의 아이콘을 구성하려면 CMake에서 생성한 Info.plist 파일에 아이콘 정보가 포함되어 있어야 합니다. 이는 .icns 파일 이름을 MACOSX_BUNDLE_ICON_FILE 변수로 설정하면 됩니다.

다음 스니펫은 Photo Surface 예제 애플리케이션이 CMake를 사용하여 애플리케이션 아이콘을 설정하는 방법을 보여줍니다:

    # 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})

첫 번째 set 명령은 MACOSX_BUNDLE_ICON_FILE 변수를 정의하는데, 이는 아이콘 파일을 Info.plist 파일에 추가하는 데 필요합니다. 두 번째 set 명령은 아이콘 파일의 절대 경로로 app_icon_macos 변수를 정의합니다. 그런 다음 이 변수는 아이콘 파일의 설치 위치를 정의하는 MACOSX_PACKAGE_LOCATION을 구성하는 데 사용됩니다. 마지막으로 add_executable 변수는 app_icon_macOS 변수를 사용하여 애플리케이션의 아이콘을 설정합니다.

macOS에서 qmake 사용

여전히 qmake를 사용하여 메이크파일을 생성하는 경우 .pro 프로젝트 파일에 한 줄만 추가하면 됩니다. 예를 들어 아이콘 파일의 이름이 myapp.icns 이고 프로젝트 파일이 myapp.pro 인 경우 myapp.pro 에 이 줄을 추가합니다:

ICON = myapp.icns

이렇게 하면 qmake 이 아이콘을 적절한 위치에 배치하고 아이콘에 대한 Info.plist 항목이 생성됩니다.

qmake 을 사용하지 않는 경우 다음을 수동으로 수행해야 합니다:

1. 애플리케이션용 Info.plist 파일을 만듭니다( PropertyListEditor, Developer/Applications 에서 찾을 수 있음).
2. .icns 레코드를 Info.plist 파일의 CFBundleIconFile 레코드와 연결합니다(다시 PropertyListEditor 사용).
3. Info.plist 파일을 애플리케이션 번들의 Contents 디렉토리에 복사합니다.
4. .icns 파일을 애플리케이션 번들의 Contents/Resources 디렉토리에 복사합니다.

일반 Linux 데스크톱에서 애플리케이션 아이콘 설정하기

이 섹션에서는 두 가지 일반적인 Linux 데스크톱 환경에 애플리케이션 아이콘을 제공할 때 관련된 문제를 간략하게 설명합니다: KDE와 GNOME. 애플리케이션 아이콘을 설명하는 데 사용되는 핵심 기술은 두 데스크톱 모두에 동일하며 다른 데스크톱에도 적용될 수 있지만 각각에 고유한 세부 사항이 있습니다. 이러한 Linux 데스크톱에서 사용하는 표준에 대한 주요 정보 출처는 freedesktop.org입니다. 다른 Linux 데스크톱에 대한 자세한 내용은 관심 있는 데스크톱의 설명서를 참조하세요.

사용자는 종종 실행 파일을 직접 사용하지 않고 바탕화면의 아이콘을 클릭하여 애플리케이션을 실행합니다. 이러한 아이콘은 아이콘에 대한 정보가 포함된 애플리케이션에 대한 설명이 포함된 '데스크톱 항목 파일'의 표현입니다. 두 데스크톱 환경 모두 이러한 파일에 있는 정보를 검색할 수 있으며, 이를 사용하여 데스크톱, 시작 메뉴 및 패널에 애플리케이션 바로 가기를 생성할 수 있습니다.

데스크톱 엔트리 파일에 대한 자세한 내용은 데스크톱 엔트리 사양에서 확인할 수 있습니다.

데스크톱 항목 파일은 애플리케이션의 세부 정보를 유용하게 캡슐화할 수 있지만, 각 데스크톱 환경의 기존 위치에 아이콘을 저장해야 합니다. 아이콘의 여러 위치는 아이콘 테마 사양에 나와 있습니다.

아이콘을 찾는 데 사용되는 경로는 사용 중인 데스크톱과 그 구성에 따라 다르지만, 각 아이콘 아래의 디렉토리 구조는 테마, 아이콘 크기 및 애플리케이션 유형별로 하위 디렉터리가 배열되는 동일한 패턴을 따라야 합니다. 일반적으로 애플리케이션 아이콘은 하이컬러 테마에 추가되므로 32픽셀 크기의 정사각형 애플리케이션 아이콘은 아이콘 경로 아래의 hicolor/32x32/apps 디렉터리에 저장됩니다.

K 데스크톱 환경(KDE)

애플리케이션 아이콘은 모든 사용자가 사용하도록 설치하거나 사용자별로 설치할 수 있습니다. 현재 KDE 4 데스크톱에 로그인한 사용자는 터미널 창에 다음을 입력하는 등의 방법으로 kde4-config를 사용하여 이러한 위치를 찾을 수 있습니다:

kde4-config --path icon

Qt 5 및 KDE 프레임워크 5를 사용하는 애플리케이션은 이 명령이 반환하는 목록에서 해당 아이콘을 찾을 수 있습니다:

qtpaths --locate-dirs GenericDataLocation icons

일반적으로 stdout에 출력되는 콜론으로 구분된 경로 목록에는 사용자별 아이콘 경로와 시스템 전체 경로가 포함됩니다. 이러한 디렉토리 아래에서 아이콘 테마 사양에 설명된 규칙에 따라 아이콘을 찾아 설치할 수 있어야 합니다.

KDE 전용으로 개발하는 경우 KDE 빌드 시스템을 활용하여 애플리케이션을 구성할 수 있습니다. 이렇게 하면 아이콘이 KDE에 적합한 위치에 설치됩니다.

KDE 개발자 웹사이트는 http://techbase.kde.org/.

GNOME

애플리케이션 아이콘은 아키텍처에 독립적인 파일을 포함하는 표준 시스템 전체 디렉토리에 저장됩니다. 이 위치는 터미널 창에 다음을 입력하는 등의 방법으로 gnome-config 을 사용하여 확인할 수 있습니다:

gnome-config --datadir

stdout에 인쇄된 경로는 pixmaps 디렉터리가 포함되어야 하는 위치를 가리키며, pixmaps 디렉토리 내의 디렉토리 구조는 아이콘 테마 사양에 설명되어 있습니다.

GNOME 전용으로 개발하는 경우 GNU 빌드 도구의 표준 세트를 사용하는 것이 좋습니다. 자세한 내용은 통합 가이드라인 섹션을 참조하세요. 이렇게 하면 아이콘이 GNOME에 적합한 위치에 설치됩니다.

GNOME 개발자 웹사이트( http://developer.gnome.org/)에서 애플리케이션 개발에 대한 더 많은 정보를 얻을 수 있습니다.