안녕하세요, Pip이에요이 Featured 앱들이 제 노치에 번갈아 나와요.
iPip제출

← 모든 도구

메뉴 막대 아이콘 검사기

아래에 메뉴 막대 아이콘을 끌어다 놓으세요. 이 페이지 안에서 바로 그려지고, 그림은 업로드되지 않아요.

메뉴 막대 아이콘 검사기

예시로 해 보기:

하는 일

Mac 앱이 메뉴 막대에 넣는 작은 아이콘, Apple이 메뉴 막대 엑스트라라고 부르는 것을 PNG나 SVG로 끌어다 놓으세요. 도구가 밝은 메뉴 막대와 어두운 메뉴 막대에, 템플릿 이미지로, 자체 색상으로, 선택된 상태로 그려 줘요. 그런 다음 메뉴 막대 아이콘이 이상해 보이는 원인을 검사해요. 템플릿이어야 할 그림에 색이 들어 있는지, 그림이 막대보다 큰지, 그림이 막대에 비해 너무 작거나 큰지, Retina 사본이 없는지, 템플릿이 아닐 때 아이콘이 막대에 묻히는지를 봐요. 이건 메뉴 막대 아이콘용이에요. Dock과 Finder의 앱 아이콘은 Mac 아이콘 검사기를 쓰세요.

Apple의 설명

Apple의 Human Interface Guidelines에 따르면 메뉴 막대 높이는 24 pt이고, 메뉴 막대 엑스트라에는 SF Symbol이나 직접 만든 심볼을 쓰도록 제안해요. 인터페이스 아이콘과 심볼은 검은색과 투명으로 모양을 정의하고, 시스템이 검은 부분에 다른 색을 적용하기 때문에 어두운 메뉴 막대와 밝은 메뉴 막대, 선택됐을 때도 알맞게 보여요. Apple의 AppKit 문서에는 템플릿 이미지는 검은색과 투명만 써야 하고, 알파 채널로 검은색의 불투명도를 바꿀 수 있다고 적혀 있어요. 직접 만드는 인터페이스 아이콘에는 PDF나 SVG 같은 벡터 형식을 권해요.

Apple은 메뉴 막대 아이콘의 포인트 크기를 정해 주지 않아요. 검사에 나오는 10 pt와 22 pt 기준은 저희의 경험칙이고, 도구도 사용하는 곳에서 그렇게 알려 줘요.

템플릿 이미지로 만드는 방법

// AppKit
let item = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
let image = NSImage(named: "MenuIcon")
image?.isTemplate = true
item.button?.image = image

// SwiftUI, macOS 13 or later
MenuBarExtra("Zorbclip", image: "MenuIcon") { ContentView() }

Xcode에서는 에셋 카탈로그의 이미지 세트를 선택하고 Render As를 Template Image로 설정할 수도 있어요. SF Symbol은 이미 템플릿이에요.

검사 방식

그림은 브라우저에서 그려지고 모든 픽셀을 읽어요. 거의 투명한 픽셀은 제외해요. 빨강, 초록, 파랑 값이 많이 차이 나면 색이 있는 픽셀로, 값이 가깝고 어둡지 않으면 회색이나 흰색 픽셀로 세요. 포인트 단위 크기는 픽셀을 배율로 나눈 값이에요. 도구는 파일 이름(@2x, @3x)이나 높이로 배율을 추측하고, 직접 설정할 수도 있어요. 대비는 단색 막대 색 두 가지를 기준으로 WCAG 2 공식을 사용해요. 실제 메뉴 막대는 투명해서 배경화면 색을 띠기 때문에, 미리보기와 비율은 비슷할 뿐 정확하지는 않아요.

결과별 의미

표시의미
OK이 부분은 준비됐어요.
모양동작은 하지만 어떤 사람에게는 이상해 보일 수 있거나, Apple이 요구하는 방식이 아니에요.
참고알아 두면 좋지만, 문제가 있는 건 아니에요.
수정이 부분이 바뀌기 전까지는 아이콘이 메뉴 막대에서 깨져 보여요.

질문

Mac 메뉴 막대 아이콘은 어떤 크기여야 하나요?

Apple은 메뉴 막대 높이를 24 pt로 정해 두었지만 아이콘의 고정 크기는 정하지 않았어요. 그래서 위아래에 약간 여유를 두고 24 pt 안에 그림이 들어가야 해요. Retina 화면에서도 선명하도록 @2x 사본이나 PDF, SVG를 함께 제공하세요.

템플릿 이미지란 무엇인가요?

macOS가 대신 색을 입혀 주는 이미지예요. 검은색과 투명만 있어야 해요. 시스템이 그려 주기 때문에 밝은 메뉴 막대와 어두운 메뉴 막대, 선택됐을 때도 알맞게 보여요.

다크 모드에서 메뉴 막대 아이콘이 왜 사라지나요?

보통은 템플릿 이미지가 아니기 때문이에요. 검은 아이콘을 자체 색상으로 표시하면 어두운 메뉴 막대에 묻혀요. 코드에서는 isTemplate으로, 에셋 카탈로그에서는 Render As Template Image로 템플릿으로 지정하세요.

제 아이콘이 어디엔가 업로드되나요?

아니요. 이미지는 브라우저에서 읽고 그려지며, 아무것도 전송되지 않아요.

관련 글