Documentação / Resolução de problemas

Resolução de problemas

Tem um problema? Encontre abaixo soluções para os problemas mais comuns. Cada cartão aborda um sintoma específico e como o resolver.

Permissões

“O BetterStage não consegue controlar as minhas janelas”

O BetterStage precisa da permissão de Acessibilidade para ler e mover janelas. Abra Definições do Sistema > Privacidade e segurança > Acessibilidade e confirme que o BetterStage está na lista e ativado. Se já estava ativado, experimente desativá-lo e voltar a ativá-lo. Reinicie o BetterStage depois de alterar a permissão. Se a permissão for revogada enquanto o BetterStage está em execução, a app avisa-o e restaura as janelas ocultas em vez de as deixar fora do ecrã. Revogar a Acessibilidade já não permite que o BetterStage retenha a entrada do teclado ou do rato. Voltar a concedê-la não interrompe um restauro de espaço de trabalho guardado, de continuidade ou após o despertar que esteja em curso.

“Os atalhos não funcionam”

O BetterStage usa a API nativa de teclas de atalho Carbon para os atalhos de teclado, por isso não é necessária a permissão de Monitorização de entrada. Se os atalhos não funcionarem, verifique primeiro se a permissão de Acessibilidade está ativada. Confirme também que nenhuma outra aplicação está a usar as mesmas combinações de teclas, botões do rato ou gestos do trackpad — atalhos em conflito impedem o BetterStage de receber os eventos. Reatribua os controlos de teclado, rato e trackpad em Definições > Atalhos.

“As janelas não são detetadas”

A deteção de janelas usa a API de acessibilidade do macOS, abrangida pela permissão de Acessibilidade. Confirme que está ativada em Definições do Sistema > Privacidade e segurança > Acessibilidade. Tenha em conta que algumas aplicações usam tipos de janela não padrão (como painéis flutuantes ou janelas personalizadas do Chrome) que poderão não ser detetados pela API de acessibilidade.

Comportamento das janelas

“Devo usar o BetterStage com o Stage Manager do macOS?”

Não. Desative o Stage Manager incorporado da Apple antes de usar o BetterStage. Ambas as ferramentas gerem a visibilidade das janelas, por isso usá-las em conjunto pode causar mudanças confusas, janelas ocultas ou janelas a aparecer no sítio errado. Abra Definições do Sistema > Secretária e Dock > Stage Manager e desative o Stage Manager; depois reinicie o BetterStage se o espaço de trabalho continuar com mau aspeto.

“As janelas do Firefox/Chrome animam em vez de encaixarem instantaneamente”

Alguns navegadores (Firefox, Chrome e apps baseadas em Electron) ativam um indicador de acessibilidade chamado AXEnhancedUserInterface que faz com que as deslocações das janelas sejam animadas em vez de encaixarem. O BetterStage deteta e desativa automaticamente este indicador nas apps afetadas. Se continuar a ver deslocações animadas, experimente fechar e reabrir o navegador para que o BetterStage possa voltar a aplicar a correção.

“As janelas do Firefox piscam, resistem ao posicionamento ou atrasam-se nas mudanças de Stage”

O Firefox gere as suas janelas de formas não padrão, por isso nem sempre colabora com a gestão de janelas — pode ver janelas a piscar brevemente, a resistir a um posicionamento preciso ou a atrasar-se nas mudanças de Stage. É um problema conhecido e continuamos a melhorar a compatibilidade com o Firefox.

“O Finder aparece ao mudar para uma Stage vazia”

O macOS pode ativar o Finder quando a aplicação em primeiro plano não tem janelas visíveis. O BetterStage 2.2.0 oculta janelas individuais num Space privado em vez de ocultar a aplicação inteira. Se uma janela aparecer inesperadamente numa Stage vazia, comunique o nome da app e a sequência de mudanças de Stage ou de secretária que o provocou.

“As janelas foram para a Stage errada após o repouso ou a proteção de ecrã”

Deixe a disposição dos ecrãs estabilizar. O layout de um ecrã memorizado volta sozinho; se aparecer um aviso de recuperação, escolha Restaurar espaço de trabalho ou Manter o layout atual. Para janelas que continuam ocultas depois de uma secretária ter sido removida, ou que ficaram fora do ecrã após uma alteração de ecrãs, use Recuperar janelas na barra de menus. Se o BetterStage indicar que os Spaces do macOS estão indisponíveis, termine a transição de secretária e escolha Tentar novamente. Reinicie o BetterStage se o problema persistir.

“Uma caixa de diálogo ou janela flutuante está presa atrás do TabStack”

Abra a Roda Snap e escolha Trazer flutuantes para a frente em Mais ações. Isso traz para a frente as janelas flutuantes e não controladas deste monitor sem alterar o layout nem revelar separadores ocultos. Recuperar janelas também recupera as janelas que o BetterStage ocultou em Spaces privados, incluindo janelas cuja secretária original foi removida.

“Faltam janelas após uma falha”

O BetterStage regista as janelas movidas para Spaces privados e executa um assistente de recuperação separado. Se o BetterStage terminar inesperadamente, o assistente usa esses registos para devolver as janelas ocultas às respetivas secretárias guardadas. Se continuarem a faltar janelas, reinicie o BetterStage e use Recuperar janelas. Uma secretária removida ou um ecrã desligado podem exigir um destino de substituição acessível.

Configuração da app

“Executar a partir do terminal vs. pacote .app”

Quando executa o BetterStage através de swift run num terminal, o macOS associa a permissão de Acessibilidade à app de terminal, e não ao próprio BetterStage. Para uma gestão correta das permissões, em que o BetterStage aparece pelo nome nas Definições do Sistema, compile e execute antes o pacote .app.

“A barra de Stages não aparece”

A barra de Stages pode ser acionada através da margem ativa (levando o cursor ao topo do ecrã) ou com o atalho de teclado Opt+Up Arrow. Confirme que a margem ativa está ativada nas Definições. Se a barra de Stages continuar a não aparecer, verifique se o BetterStage tem a permissão de Acessibilidade necessária.

Nos ecrãs integrados de Mac com entalhe, Definições > Stages > Barra de Stages > Evitar o entalhe do ecrã pode ignorar o próprio entalhe, mantendo ativa o resto da margem superior.

“O monitor não é reconhecido depois de o voltar a ligar”

O BetterStage reconhece os monitores por detalhes de hardware, como o modelo e o número de série, e não apenas pelo ID de ecrã que o macOS atribui. Em casos raros, por exemplo após uma atualização de controladores ou com uma porta ou adaptador diferente, esses detalhes mudam. Experimente desligar e voltar a ligar o monitor e depois reinicie o BetterStage. Se o monitor continuar a não ser reconhecido, volte a configurá-lo em Definições > Ecrãs.

“O ⌘Tab continua a mostrar o seletor de apps do macOS”

O Seletor ⌘Tab do BetterStage é opcional e está desativado por predefinição. Ative Usar o ⌘Tab do BetterStage em Definições > Seletor ⌘Tab e confirme que o Pro, a avaliação ou uma pré-visualização Pro diária está ativa. Sem pré-visualizações, mostra os ícones das apps; permita a Gravação do ecrã para ter miniaturas em direto. Consulte o guia do Seletor ⌘Tab.

“As minhas Stages não carregam depois de voltar à versão 2.0.x”

As Stages guardadas pelo BetterStage 2.2 não podem ser abertas por versões anteriores. Se reinstalou a 2.0.x, as suas Stages não vão carregar; em vez disso, atualize para a versão mais recente a partir da página de transferência.

Comunicar um erro

O BetterStage mantém um registo de diagnóstico rotativo limitado a 10 MB, para nunca encher o disco. Para o anexar a um relatório de erro, abra o ícone do BetterStage na barra de menus e escolha Revelar registo de diagnóstico… — o Finder abre no ficheiro de registo para que o possa arrastar para uma mensagem do Discord, um problema no GitHub ou um e-mail.

As versões finais evitam registos detalhados que captariam títulos de janelas. Se estiver a reproduzir um problema e quiser um registo mais completo, execute uma versão beta ou candidata a versão final, capture o registo e depois volte ao canal de versões finais.

Ainda precisa de ajuda?

Se o seu problema não estiver abordado acima, contacte-nos e ajudamos a pôr tudo a funcionar.