SoluçõesMac7 min de leitura
Acessibilidade não funciona após atualizar app no Mac
A permissão de Acessibilidade parou depois de uma atualização no Mac? Ela segue a assinatura do app. Remova e adicione o app, ou rode tccutil reset.
Publicado pela Optimal Apps, criadora do Petal.
Nesta página
A permissão de Acessibilidade não funciona depois de uma atualização? No Mac, a causa normalmente é a assinatura de código do app. O macOS vincula cada permissão de Acessibilidade à assinatura do app que a recebeu. Quando uma atualização, uma compilação a partir do código-fonte ou uma versão mal assinada muda a assinatura, a permissão antiga deixa de valer. Os Ajustes do Sistema ainda podem mostrar a chave ativada. Para resolver, remova o app de Ajustes do Sistema > Privacidade e Segurança > Acessibilidade com o botão de menos e adicione de novo, ou rode tccutil reset Accessibility <bundle ID> e conceda o acesso de novo.
Esse problema afeta muito os apps de ditado, porque eles precisam da Acessibilidade para colar. Os passos usam os nomes do macOS Tahoe 26.
Permissão de Acessibilidade não funciona no Mac: checklist de solução rápida
| O que você vê | Causa provável | Solução |
|---|---|---|
| A chave está ativada, mas o app diz que não tem acesso | A permissão pertence a uma assinatura antiga | Remova com -, abra o app de novo e adicione outra vez |
| Desativar e ativar a chave não faz nada | Registro desatualizado da assinatura antiga | tccutil reset Accessibility <bundle ID> |
| Começou depois que você compilou o app a partir do código-fonte | Compilações locais têm outra assinatura | Redefina com tccutil depois de cada compilação |
| Começou depois de uma atualização específica | Essa versão foi mal assinada | Instale uma cópia nova e assinada corretamente |
| O app nem aparece na lista | O app ainda não pediu, ou roda de um DMG | Mova o app para /Applications, abra e adicione com + |
| A transcrição aparece, mas não cola | Falta a Acessibilidade, ou o foco saiu do campo | Corrija a permissão e clique no campo antes |
Por que a permissão quebra: as assinaturas de código
Todo app do Mac tem uma assinatura de código. Ela prova quem compilou o app e que ninguém o alterou. O macOS guarda as permissões de privacidade, como Acessibilidade, Gravação de Tela e Microfone, junto com essa assinatura.
Quando a assinatura muda, o macOS vê um app diferente. Os motivos mais comuns:
- Uma compilação a partir do código-fonte. Um desenvolvedor ou usuário compila o app com o próprio certificado, ou sem certificado. A issue #530 no repositório do VoiceInk no GitHub explica que as permissões de Acessibilidade e de Gravação de Tela param de funcionar depois de uma nova compilação por esse motivo.
- Uma versão mal assinada. A Willow Voice documentou que uma versão v1.8.4 foi publicada com uma assinatura incorreta por cerca de um dia. O macOS então pediu de novo a Acessibilidade e o Monitoramento de Entrada e tratou a atualização como um app novo.
- Uma troca da identidade de assinatura. Se um desenvolvedor muda para uma nova equipe ou um novo certificado, todos os usuários precisam conceder o acesso de novo, uma vez.
As atualizações normais do mesmo desenvolvedor, assinadas com o mesmo Developer ID, mantêm a permissão.
Passo 1: Remova o app e adicione de novo
Isso resolve a maioria dos casos e não precisa do Terminal.
- Encerre o app. Para um app da barra de menus, use o item Quit (ou Encerrar) no menu dele.
- Abra menu Apple > Ajustes do Sistema > Privacidade e Segurança > Acessibilidade.
- Selecione o app na lista.
- Clique no botão de menos (-) abaixo da lista. Digite a sua senha se o macOS pedir.
- Abra o app de novo. Ele pede a Acessibilidade, ou abre os Ajustes do Sistema.
- Se o app não aparece na lista, clique no botão de mais (+), escolha o app em /Applications e clique em Abrir.
- Ative a chave do app.
- Encerre e abra o app de novo, depois teste.
O artigo de ajuda da Willow Voice para a v1.8.4 dá a mesma ordem: remover o app com "–", reiniciar o app, ativar o acesso de novo quando ele aparecer e reiniciar mais uma vez.
Passo 2: Redefina a Acessibilidade com tccutil
Se o Passo 1 não funcionar, redefina o registro pelo Terminal.
- Descubra o bundle ID do app:
osascript -e 'id of app "VoiceInk"'
- Encerre o app.
- Redefina o registro de Acessibilidade dele:
tccutil reset Accessibility com.prakashjoshipax.VoiceInk
- Abra o app e conceda a Acessibilidade de novo.
- Se o app também usa a Gravação de Tela, redefina essa permissão também:
tccutil reset ScreenCapture com.prakashjoshipax.VoiceInk
Troque o bundle ID pelo que você encontrou no passo 1. Sempre inclua um bundle ID. Sem ele, tccutil reset Accessibility remove a Acessibilidade de todos os apps do Mac.
Passo 3: Instale uma cópia nova se uma versão foi mal assinada
Se o problema começou com uma atualização e o desenvolvedor relata um problema de assinatura:
- Baixe a versão atual no site do desenvolvedor.
- Apague o app de /Applications.
- Instale a cópia nova em /Applications.
- Repita o Passo 1 ou o Passo 2.
Passo 4: Rode o app a partir de /Applications
Um app que roda de uma imagem de disco montada, da pasta Downloads ou de uma pasta em quarentena pode receber um local temporário. Então o macOS pode não conseguir associar a permissão.
- Arraste o app para /Applications.
- Ejete a imagem de disco.
- Apague as outras cópias.
- Abra o app a partir de /Applications e conceda o acesso.
Passo 5: Confira a colagem em si
Mesmo com a Acessibilidade correta, um app de ditado ainda pode falhar ao colar se o campo de texto perde o foco ou se o app lê o clipboard com atraso. Resolva esses casos separadamente:
- Clique no campo antes de ditar e fique ali até o texto aparecer.
- Para apps Electron e terminais, leia ditado não cola no VS Code, no Terminal ou no Claude Code.
- Para o Wispr Flow, leia Wispr Flow não cola o texto.
- Para a Willow Voice, leia Willow Voice não funciona.
Como confirmar que a permissão vale
A chave nos Ajustes do Sistema não prova que a permissão vale. Teste o comportamento real:
- Abra o TextEdit e crie um documento novo.
- Clique no documento.
- Dite uma frase curta com o app.
- Se o texto aparece, a permissão funciona. Se o app mostra uma transcrição, mas o TextEdit continua vazio, a permissão não vale.
Muitos apps de ditado também mostram o próprio status de permissão nos ajustes deles. Quando o app diz que não tem acesso à Acessibilidade, mas os Ajustes do Sistema mostram a chave ativada, você tem um registro desatualizado. Volte para o Passo 1 ou o Passo 2.
Por que o macOS vincula a permissão à assinatura
O acesso à Acessibilidade é poderoso. Um app com esse acesso pode ler outras janelas e enviar pressionamentos de tecla para qualquer app. Se o macOS guardasse a permissão só pelo nome do app, uma cópia alterada ou maliciosa com o mesmo nome poderia usar essa permissão. A verificação da assinatura impede isso, e o custo é um pedido de permissão a mais quando a assinatura muda.
Para quem compila um app a partir do código-fonte
Se você mesmo compila um app de ditado de código aberto, assine cada compilação com o mesmo certificado. Um certificado Apple Development gratuito no Xcode funciona para isso. Com a mesma identidade de assinatura, a permissão continua valendo depois de cada compilação. Com uma assinatura ad-hoc ou diferente, você precisa redefinir a permissão depois de cada compilação.
A permissão de microfone segue a mesma regra
A permissão de microfone também segue a assinatura. Se um app de ditado para de ouvir você depois de uma atualização, use a mesma redefinição com Microphone no lugar de Accessibility. Os passos completos estão em permissão de microfone não funciona no Mac.
Como o Petal lida com a Acessibilidade
O Petal para Mac é um app de ditado grátis e de código aberto. Ele precisa da Acessibilidade pelo mesmo motivo que os outros apps de ditado: ele envia Command-V para colar a transcrição.
O que o Petal faz para manter a permissão válida e para não perder texto:
- Assinatura estável. O Petal é distribuído pelo GitHub Releases, com atualizações pelo Sparkle e uma assinatura Developer ID. Cada atualização mantém a mesma assinatura, então a permissão continua válida.
- Limpeza de registros desatualizados. Quando o Petal pede a Acessibilidade e não tem acesso, ele primeiro remove o próprio registro antigo (
tccutil reset Accessibility com.optimalapps.petal). O pedido seguinte então cria um registro para a assinatura atual. Isso resolve o caso "a chave está ativada, mas nada funciona" sem o Terminal. - Uma janela de ajuda. O Petal abre o painel de Acessibilidade e mostra uma pequena janela: "Drag the app below into the list above, then turn it on."
- Cópia como plano B. Se o Petal não consegue colar, ele copia a transcrição para o clipboard e avisa que precisa do acesso à Acessibilidade. O texto não se perde.
Para ativar, abra Settings > General no Petal. Se a Acessibilidade está faltando, aparece uma linha Accessibility com um botão Enable.
Perguntas
Por que um app perde a permissão de Acessibilidade depois de uma atualização no Mac?
O macOS vincula a permissão de Acessibilidade à assinatura de código do app. Se uma atualização, uma nova compilação ou uma versão mal assinada tem outra assinatura, o macOS trata o app como um app novo. O registro antigo pode continuar ativado, mas ele não vale mais.
A chave de Acessibilidade está ativada, mas o app ainda não cola. O que fazer?
Selecione o app em Privacidade e Segurança > Acessibilidade e clique no botão de menos (-) para remover. Encerre e abra o app de novo, depois adicione o app outra vez e ative a chave. Se isso não ajudar, rode tccutil reset Accessibility com o bundle ID do app.
Como redefinir a Acessibilidade de um só app?
Encerre o app e rode no Terminal tccutil reset Accessibility seguido do bundle ID, por exemplo tccutil reset Accessibility com.prakashjoshipax.VoiceInk. Abra o app e conceda o acesso de novo quando ele pedir.
Por que o meu app de ditado precisa de Acessibilidade?
Os apps de ditado colam o texto ao enviar um Command-V para o app que você está usando. O macOS só permite que um app envie pressionamentos de tecla para outros apps com acesso à Acessibilidade.