Depurar plug-ins no After Effects 26.5 no macOS

Última atualização em 9 de set de 2026

Corrigir um problema que impede o Xcode de se anexar ao After Effects 26.5 ao depurar plug-ins C/C++ no macOS.

Se você escreve plug-ins C/C++ para o After Effects e usa o Xcode para depurar seu plug-in no macOS, talvez não consiga se anexar a uma instância em execução.Este artigo mostra como corrigir isso.

Problema

Quando você tenta anexar o Xcode a uma versão em execução do After Effects 26.5, o Xcode mostra uma caixa de diálogo dizendo que não foi possível anexar ao processo e pede para conceder permissão de depuração.

O diálogo do Xcode que aparece quando a conexão ao After Effects falha, exibindo "Could not attach to pid" com os botões "Show Details" e "OK".
O Xcode mostra esta caixa de diálogo quando o macOS impede que o depurador se anexe ao processo do After Effects.

A assinatura de código do After Effects bloqueia o depurador

After Effects possui assinatura de código, e o macOS impede que o Xcode se conecte a um aplicativo com assinatura de código por padrão.Para depurar seu plug-in, crie uma cópia de desenvolvimento do After Effects e assine-a novamente com permissão de depuração ativada.

Para ativar a depuração do seu plug-in, faça o seguinte:

Faça uma cópia de toda a pasta de instalação do After Effects e nomeie-a como Adobe After Effects-developer.Coloque a cópia ao lado da pasta de instalação padrão.

Abra o Terminal e certifique-se de que seu diretório atual seja gravável, como sua pasta inicial.Em seguida, execute:

codesign -d --xml --entitlements entitlements.xml "/Applications/Adobe After Effects-developer/Adobe After Effects 2026.app"

Abra o arquivo entitlements.xml que a etapa anterior criou.

Remova todos os caracteres que aparecem antes de <?xml.

Adicione a seguinte permissão:

<key>com.apple.security.get-task-allow</key> <true/>

Assine novamente a cópia de desenvolvimento:

codesign -f -s - --entitlements entitlements.xml "/Applications/Adobe After Effects-developer/Adobe After Effects 2026.app"

Inicie a cópia assinada novamente e anexe seu depurador como de costume.

Nota

Você precisa repetir este processo sempre que depurar um build não Beta mais recente.

Saiba mais sobre como depurar versões Beta na documentação do SDK do After Effects.