Lista de propriedades de informações

Artigo
10/15/2024

Um arquivo de lista de propriedades de informações é um arquivo XML codificado usando Unicode UTF-8 que contém informações de configuração do seu aplicativo do .NET MAUI (.NET Multi-Platform App UI) no iOS e no Mac Catalyst. O nó raiz do arquivo é um dicionário, que contém um conjunto de chaves e valores que definem a configuração do aplicativo. O nome do arquivo de lista de propriedades de informações é Info.plist e diferencia maiúsculas de minúsculas. Todos os aplicativos iOS e Mac Catalyst do .NET MAUI devem conter um arquivo Info.plist que descreva o aplicativo.

O .NET MAUI cria arquivos Info.plist para iOS e Mac Catalyst quando você cria um aplicativo do .NET MAUI a partir de um modelo de projeto. Esses arquivos estão localizados nas pastas Platforms/iOS e Platforms/Mac Catalyst e são preenchidos com uma lista inicial de chaves de lista de propriedades.

Quando você cria seu aplicativo, o .NET MAUI copia o arquivo Info.plist para o pacote compilado antes de assinar o pacote com código. Durante a operação de cópia, o .NET MAUI usa propriedades de build para fazer alguma substituição de variável. Ele também pode inserir chaves adicionais que representam a configuração especificada de outras maneiras. Devido a isso, o arquivo de lista de propriedades de informações fornecido no pacote de aplicativo não é idêntico ao arquivo de origem no projeto.

Editar a lista de propriedades de informações no editor

Clicar duas vezes em um arquivo Info.plist o abrirá no editor Info.plist do Visual Studio, que contém duas exibições dos dados:

Aplicativo, que permite definir propriedades comuns do aplicativo:

Observação

Os valores dos campos Nome do Aplicativo, Identificador do Pacote, Versão e Build são recuperados do arquivo de projeto do aplicativo. Para mais informações, consulte Fornecer informações do aplicativo.
Avançado, que permite especificar tipos de documentos, UTIs (identificadores de tipo universal) e tipos de URL compatíveis:

Editar a origem da lista de propriedades de informações

O arquivo Info.plist também pode ser aberto em um editor externo para editar sua origem XML. Chaves e valores para configurar o aplicativo podem ser adicionados para as seguintes categorias:

Configuração de pacote, para configurar as características básicas de um pacote, como nome, tipo e versão. Para mais informações, confira Configuração de pacote em developer.apple.com.
Interface do usuário, para configurar cenas, ícones e fontes de um aplicativo. Para mais informações, confira Interface do usuário em developer.apple.com.
Execução do aplicativo, para configurar a inicialização, a execução e o encerramento do aplicativo. Para mais informações, confira Execução do aplicativo em developer.apple.com.
Recursos protegidos, para controlar o acesso de um aplicativo a serviços protegidos e dados do usuário. Para mais informações, consulte Recursos protegidos em developer.apple.com.
Dados e armazenamento, para configurar os recursos de gerenciamento de dados do seu aplicativo. Para mais informações, confira Dados e armazenamento em developer.apple.com.
Serviços de aplicativos, para configurar os serviços que seu aplicativo fornece. Para mais informações, veja Serviços de aplicativo em developer.apple.com.
Kernel e drivers, para configurar drivers de dispositivo fornecidos pelo seu aplicativo. Para mais informações, veja Kernel e drivers em developer.apple.com.

Fornecer informações do aplicativo

O editor Info.plist recupera dados básicos do aplicativo no arquivo de projeto do aplicativo, em vez de armazená-los diretamente no arquivo Info.plist. No momento do build, o .NET MAUI copia esses dados para o arquivo Info.plist que é fornecido no pacote do aplicativo.

Nome do aplicativo

O nome de um aplicativo do .NET MAUI é armazenado no arquivo de projeto do aplicativo como a propriedade de build ApplicationTitle.

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto do aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue até a guia Geral > MAUI compartilhado. O campo ID do aplicativo listará o nome do aplicativo.

Quando o valor do campo Título do aplicativo for atualizado, o valor do campo Nome do aplicativo na exibição do aplicativo no arquivo Info.plist será atualizado automaticamente.

Application ID

O identificador do pacote de um aplicativo do .NET MAUI é armazenado no arquivo de projeto como a propriedade de build ApplicationId.

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto do aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue até a guia Geral > Compartilhado MAUI. O campo ID do Aplicativo lista o identificador do pacote.

Quando o valor do campo ID do aplicativo for atualizado, o valor do campo Identificador do pacote na exibição do aplicativo no arquivo Info.plist será atualizado automaticamente.

Versão de exibição do aplicativo

A versão de exibição do aplicativo de um aplicativo do .NET MAUI é armazenada no arquivo de projeto do aplicativo como a propriedade de build ApplicationDisplayVersion.

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto do aplicativo .NET MAUI e selecione Propriedades. Em seguida, navegue até a guia MAUI compartilhado > Geral. O campo Versão de exibição do aplicativo listará a versão de exibição do aplicativo.

Quando o valor do campo Versão de exibição do aplicativo for atualizado, o valor do campo Versão na exibição do aplicativo no arquivo Info.plist será atualizado automaticamente.

Versão do aplicativo

A versão do aplicativo de um aplicativo do .NET MAUI é armazenada no arquivo de projeto do aplicativo como a propriedade de build ApplicationVersion.

Quando o valor do campo Versão do aplicativo for atualizado, o valor do campo Build na exibição do aplicativo no arquivo Info.plist será atualizado automaticamente.

Confira também

Lista de propriedades de informações em developer.apple.com

Compartilhar via