Como editar um arquivo plist no macOS com o Xcode

Você pode editar um arquivo de lista de propriedades (.plist) no macOS usando o editor estruturado do Xcode. Faça um backup do arquivo, abra-o no Xcode, altere apenas as chaves e os valores documentados e salve. Evite editar o pacote instalado de um aplicativo de terceiros: alterar um aplicativo assinado pode invalidar sua assinatura ou impedir atualizações. Para seu próprio aplicativo, edite o código-fonte do projeto ou as configurações de compilação e recompile.

Quando editar um arquivo plist diretamente

As listas de propriedades armazenam dados estruturados — strings, números, valores booleanos, arrays e dicionários. A lista de propriedades de um aplicativo Info.plistdescreve seu pacote; listas de propriedades separadas podem armazenar preferências. Use o arquivo e a chave documentados pelo aplicativo: criar uma chave não adicionará suporte a uma configuração.

Antes de editar, verifique se o arquivo contém metadados do aplicativo ou uma preferência do usuário. Se você deseja alterar um recurso em um aplicativo que usa, comece pelas configurações ou documentação desse aplicativo. Um arquivo de preferências pode ser sobrescrito quando o aplicativo é iniciado ou fechado; o arquivo de um pacote instalado Info.plistnão é um painel de configurações geral.

Para um projeto Xcode que você mantém, verifique primeiro o painel de informaçõesInfo.plist e as configurações de compilação do alvo. O Xcode pode gerar arquivos durante a compilação, portanto, editar uma cópia compilada pode ser temporário. O guia de edição da Apple aborda o editor estruturado; a referência às configurações de compilação explica os valores gerados.

Editar um arquivo plist com o Xcode

1. Instale o Xcode

Obtenha o Xcode na Mac App Store . Atualmente, ele está listado como gratuito; verifique os requisitos da versão disponível para o seu Mac. Inicie o Xcode uma vez após a instalação.

Resultados da busca na Mac App Store mostrando a página do Xcode da Apple com um botão "Obter".
Listagem do Xcode na Mac App Store com o botão Obter.

2. Faça um backup funcional

Localize o arquivo plist no Finder e duplique-o ou copie-o para uma pasta de trabalho antes de editá-lo. Guarde o original até verificar as alterações. Armazene backups fora do .apppacote do aplicativo; adicionar arquivos lá pode alterar o conteúdo assinado.

A lista do Finder exibe o arquivo Info.plist e uma cópia de segurança separada do Info.plist em uma pasta de projeto de exemplo.
Faça um backup separado antes de editar.

3. Localize o arquivo dentro do aplicativo, se necessário.

Para inspecionar um pacote de aplicativo, clique com o botão direito do mouse no aplicativo no Finder e escolha " Mostrar conteúdo do pacote" . Isso revelará suas pastas internas. Use isso para localizar um arquivo ou edite apenas aplicativos que você mantém e que podem ser recompilados ou assinados novamente; não aplique patches em aplicativos de terceiros.

Visualização de aplicativos do Finder com um aplicativo de exemplo selecionado e a opção "Mostrar conteúdo do pacote" destacada no menu de contexto.
O Finder revela os arquivos internos de um aplicativo.

4. Abra o arquivo plist no pacote.

Abra o arquivo Contentse procure por Info.plist. Outros arquivos plist podem estar em outros locais, então siga as instruções da documentação do aplicativo ou projeto. Para um arquivo independente, use sua localização normal no Finder.

Janela do Finder mostrando uma pasta Conteúdo com o arquivo Info.plist selecionado entre os arquivos do pacote do aplicativo.
O arquivo Info.plist está localizado dentro da pasta Contents do aplicativo.

5. Abra o arquivo no Xcode.

Clique com o botão direito do mouse no arquivo plist e escolha Abrir com > Xcode . Se o Xcode não estiver aberto, escolha Outro e selecione-o em Aplicativos. Você também pode abrir o Xcode e usar Arquivo > Abrir . Um arquivo plist estruturado aparece com as linhas chave, tipo e valor.

Menu de contexto do Finder para Info.plist com a opção "Abrir com" expandida e o Xcode selecionado.
Selecione Xcode em Abrir com.

6. Alterar um valor existente ou adicionar uma linha

Clique em um valor existente para editá-lo. Para adicionar uma configuração, clique com a tecla Control pressionada no editor e escolha Adicionar Linha ou clique no controle de adição. Use a chave exata documentada pelo aplicativo; chaves com erros de digitação ou não suportadas podem ser ignoradas.

Tabela de lista de propriedades do Xcode com as colunas Chave, Tipo e Valor, e o comando Adicionar Linha aberto.
Adicione uma chave de lista de propriedades documentada.

7. Verifique o tipo de valor e salve.

Associe o tipo de valor ao formato documentado: valores booleanos, números e strings não são intercambiáveis. Matrizes armazenam itens ordenados; dicionários armazenam valores nomeados. Evite adivinhar ou duplicar chaves e, em seguida, pressione Command-S .

  • String: texto, como um identificador ou rótulo.
  • Booleano: verdadeiro ou falso.
  • Número: um número inteiro ou real.
  • Array ou dicionário: uma lista ou um grupo de valores nomeados.
O editor do Xcode mostra um exemplo de string CFBundleName alterada para SampleApp Pro, enquanto as outras linhas permanecem visíveis.
Exemplo de um valor de string editado.

8. Reabra e verifique o arquivo salvo.

Feche e abra novamente o arquivo plist para confirmar se o valor foi persistido. Para o seu próprio projeto, reconstrua e teste uma cópia. Se o aplicativo ignorar as alterações, verifique se você editou o arquivo de origem correto; os aplicativos podem ler as preferências em outros locais ou substituí-las na inicialização. Restaure o backup ou reinstale o aplicativo se ele apresentar falhas.

O editor de lista de propriedades do Xcode foi reaberto com a string SampleApp Pro salva visível na tabela.
Arquivo reaberto com o valor salvo.

Notas importantes sobre assinatura e resolução de problemas

A Apple observa que modificar um pacote de aplicativo assinado pode invalidar sua assinatura; atualizações também podem substituir edições. Para softwares que você mantém, altere o arquivo plist de origem ou a configuração de destino e, em seguida, reconstrua o aplicativo. Para preferências comuns, use as configurações do aplicativo. Não desative as proteções do macOS para editar um arquivo plist.

Se o Xcode não conseguir salvar, trabalhe a partir de uma cópia gravável. Se uma alteração desaparecer após a recompilação, atualize a origem ou a configuração de compilação. Se uma chave for ignorada, verifique sua ortografia, tipo e localização na documentação do aplicativo.

Para obter mais detalhes, consulte a documentação da Apple sobre a Lista de Propriedades de Informação e sua Nota Técnica sobre assinatura de código no macOS .

Deixar um comentário

5 melhores conversores gratuitos de WAV para MP3 para Windows e macOS

5 melhores conversores gratuitos de WAV para MP3 para Windows e macOS

Compare cinco conversores gratuitos de WAV para MP3 para Windows e macOS, incluindo limites de arquivos online, ferramentas de lote locais e configurações práticas de exportação.

Como clicar com o botão direito do mouse sem usar o mouse no Windows e no Mac

Como clicar com o botão direito do mouse sem usar o mouse no Windows e no Mac

Aprenda atalhos de teclado e recursos de acessibilidade para abrir menus de contexto no Windows e no Mac, incluindo as Teclas do Mouse e a tecla Menu Contextual do Mac.

Melhores gerenciadores de arquivos para Windows: 5 alternativas ao Explorador de Arquivos

Melhores gerenciadores de arquivos para Windows: 5 alternativas ao Explorador de Arquivos

Compare cinco gerenciadores de arquivos para Windows, desde os gratuitos Q-Dir e Files até ferramentas com dois painéis e recursos avançados, e encontre a opção ideal para copiar, classificar e organizar arquivos.

Como corrigir o erro “O arquivo não pôde ser executado porque você não tem privilégios de acesso adequados” no macOS

Como corrigir o erro “O arquivo não pôde ser executado porque você não tem privilégios de acesso adequados” no macOS

Corrija o erro de acesso ao script .command no macOS com uma alteração direcionada da permissão de execução e, em seguida, verifique o arquivo e solucione os avisos de segurança com segurança.

Como definir aplicativos padrão no macOS para Arquivos, Links da Web e E-mail

Como definir aplicativos padrão no macOS para Arquivos, Links da Web e E-mail

Escolha quais aplicativos o macOS usa para tipos de arquivo, links da web e e-mail. Siga as etapas atuais do Finder, Configurações do Sistema e Mail, além do caminho do navegador antigo.

Como editar um arquivo plist no macOS com o Xcode

Como editar um arquivo plist no macOS com o Xcode

Edite um arquivo Plist no macOS com o Xcode, faça um backup primeiro e proteja os aplicativos assinados alterando o código-fonte do projeto em vez de um pacote instalado.

Como reiniciar a Touch Bar em um MacBook Pro

Como reiniciar a Touch Bar em um MacBook Pro

Reinicie uma Touch Bar do MacBook Pro congelada ou em branco sem reiniciar o Mac. Use o Terminal ou o Monitor de Atividade e, se o problema persistir, tente estas verificações.

Como acessar arquivos de fotos do iPhone no macOS

Como acessar arquivos de fotos do iPhone no macOS

Copie fotos e vídeos do iPhone diretamente para uma pasta do Finder com o Captura de Imagem ou exporte os originais não modificados do Fotos depois de já os ter importado.

Como salvar uma imagem da área de transferência no macOS com o Preview

Como salvar uma imagem da área de transferência no macOS com o Preview

Salve uma imagem copiada de um navegador, aplicativo ou captura de tela como um arquivo independente no seu Mac e, em seguida, escolha PNG, JPEG ou outro formato compatível com o Preview.

Como bloquear a atualização do macOS Catalina no Mojave

Como bloquear a atualização do macOS Catalina no Mojave

Suprima temporariamente a atualização para o Catalina no macOS Mojave com o comando legado do Terminal, mantenha as atualizações de segurança ativadas e desfaça o bloqueio posteriormente.