Verificador de ícone da barra de menus
Solte o ícone da barra de menus abaixo. Ele é desenhado aqui mesmo nesta página, e a imagem nunca é enviada.
Teste um exemplo:
O que faz
Solte o pequeno ícone que seu app para Mac coloca na barra de menus, o que a Apple chama de menu bar extra, como PNG ou SVG. A ferramenta o desenha em uma barra de menus clara e em uma escura, como imagem template e com as próprias cores, e no estado selecionado. Depois verifica o que faz ícones da barra de menus parecerem errados: cores em uma imagem feita para ser template, uma imagem mais alta que a barra, um desenho pequeno ou grande demais, uma cópia Retina faltando e um ícone que some na barra quando não é template. Isto é para o ícone da barra de menus. Para o ícone do seu app no Dock e no Finder, use o verificador de ícones do Mac.
O que a Apple diz
As Human Interface Guidelines da Apple dizem que a barra de menus tem 24 pt de altura e sugerem um símbolo para um menu bar extra, seja um SF Symbol ou o seu próprio. Ícones e símbolos de interface usam preto e transparente para definir a forma, e o sistema aplica outras cores às partes pretas, para que o ícone fique certo em barras de menus escuras e claras e quando está selecionado. A documentação do AppKit da Apple diz que imagens template devem ser só pretas e transparentes, e que o canal alfa pode mudar a opacidade do preto. Para seus próprios ícones de interface, a Apple sugere um formato vetorial como PDF ou SVG.
A Apple não define um tamanho em pontos para ícones da barra de menus. As marcas de 10 pt e 22 pt nas verificações são a nossa regra prática, e a ferramenta avisa isso onde as usa.
Como transformá-lo em imagem template
// 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() }No Xcode, você também pode selecionar o conjunto de imagens no seu catálogo de assets e definir Render As como Template Image. Um SF Symbol já é um template.
Como funcionam as verificações
A imagem é desenhada no seu navegador e cada pixel é lido. Pixels quase transparentes são deixados de fora. Um pixel conta como colorido quando vermelho, verde e azul estão bem distantes, e como cinza ou branco quando estão próximos mas não escuros. Tamanhos em pontos são os pixels divididos pela escala. A ferramenta deduz a escala pelo nome do arquivo (@2x, @3x) ou pela altura, e você pode defini-la por conta própria. O contraste usa a fórmula WCAG 2 contra duas cores de barra chapadas. A barra de menus real é translúcida e assume as cores do papel de parede, então as prévias e as razões são próximas, não exatas.
O que cada resultado significa
| Marca | O que significa |
|---|---|
| OK | Esta parte está pronta. |
| Aparência | Funciona, mas pode parecer errado para algumas pessoas, ou não é o que a Apple pede. |
| Nota | Bom saber, nada está quebrado. |
| Corrigir | O ícone vai parecer quebrado na barra de menus até isso mudar. |
Perguntas
Que tamanho deve ter um ícone da barra de menus do Mac?
A Apple dá à barra de menus uma altura de 24 pt e nenhum tamanho fixo para o ícone, então a imagem precisa caber em 24 pt, com um pouco de espaço acima e abaixo. Entregue uma cópia @2x, ou um PDF ou SVG, para que fique nítida em telas Retina.
O que é uma imagem template?
Uma imagem que o macOS colore para você. Deve ser só preta e transparente. O sistema a desenha para que fique certa em barras de menus claras e escuras e quando está selecionada.
Por que o ícone da minha barra de menus some no modo escuro?
Normalmente porque não é uma imagem template. Um ícone preto mostrado com as próprias cores some em uma barra de menus escura. Marque-o como template, com isTemplate no código ou Render As Template Image no catálogo de assets.
Meu ícone é enviado para algum lugar?
Não. A imagem é lida e desenhada no seu navegador, e nada é enviado.