Início
» MAC OS X
»
Como editar um arquivo plist no macOS com o Xcode
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.
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.
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.
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.
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.
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.
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.
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.
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.