피드로 돌아가기
Electron App Icons: Cross-Platform Desktop Icon Mastery
Dev.toDev.to
Frontend

OS별 아이콘 포맷 최적화를 통한 크로스 플랫폼 UX 일관성 확보

Electron App Icons: Cross-Platform Desktop Icon Mastery

Roboticela2026년 6월 8일2beginner

Context

웹 기술 기반의 Electron 앱 개발 시 단일 PNG 파일 사용으로 인한 플랫폼별 렌더링 품질 저하 발생. Windows의 ICO 및 macOS의 ICNS 포맷 요구사항 미준수로 인한 Retina 디스플레이 대응 불가 및 OS별 UI 컨텍스트 최적화 실패.

Technical Solution

  • Windows 환경의 UI 컨텍스트 대응을 위해 16x16부터 256x256까지 다양한 해상도를 포함한 Container 구조의 ICO 포맷 적용
  • macOS Retina 디스플레이 최적화를 위해 16x16에서 1024x1024까지 @2x 변형을 포함한 ICNS 전용 포맷 설계
  • Linux 환경의 freedesktop.org 표준 준수를 위한 512x512 또는 256x256 크기의 PNG 포맷 채택
  • electron-builder 및 electron-forge 설정 파일과 연동된 플랫폼별 전용 아이콘 경로 지정 구조 구축
  • Iconify 등의 자동화 도구를 활용한 OS별 명명 규칙 및 폴더 구조의 일괄 생성 프로세스 도입

1. Windows: 16, 32, 48, 64, 128, 256px 크기가 모두 포함된 .ico 파일 생성 여부 확인

2. macOS: 1024px 포함 @2x Retina 변형이 적용된 .icns 파일 검증

3. Linux: freedesktop.org 표준을 준수하는 고해상도 PNG 파일 준비

4. Build Config: electron-builder 설정 내 플랫폼별 아이콘 경로가 정확히 매핑되었는지 체크

원문 읽기