Oi, eu sou o PipEsses apps Featured se revezam no meu notch.
iPipEnviar

← Todas as ferramentas

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.

Verificador de ícone da barra de menus

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

MarcaO que significa
OKEsta parte está pronta.
AparênciaFunciona, mas pode parecer errado para algumas pessoas, ou não é o que a Apple pede.
NotaBom saber, nada está quebrado.
CorrigirO í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.

Relacionados