Informações do aplicativo

Navegue pelo exemplo

Este artigo descreve como você pode usar a interface .NET Multi-platform App UI (.NET MAUI), IAppInfo que fornece informações sobre seu aplicativo.

A implementação padrão da interface está disponível por meio da IAppInfoAppInfo.Current propriedade. A interface e AppInfo a IAppInfo classe estão contidas no Microsoft.Maui.ApplicationModel namespace.

Leia as informações do aplicativo

A IAppInfo interface expõe as seguintes propriedades:

• Name — O nome do aplicativo.
• PackageName — O nome do pacote ou o identificador do aplicativo, como com.microsoft.myapp.
• VersionString — A versão do aplicativo, como 1.0.0.
• Version — A versão do aplicativo, como um Version objeto.
• BuildString — O número de compilação da versão, como 1000.
• RequestedTheme — O tema detectado do sistema ou aplicativo.
• PackagingModel — O modelo de embalagem do aplicativo.
• RequestedLayoutDirection — A direção de layout solicitada do sistema ou aplicativo.

O exemplo de código a seguir demonstra como acessar algumas dessas propriedades:

string name = AppInfo.Current.Name;
string package = AppInfo.Current.PackageName;
string version = AppInfo.Current.VersionString;
string build = AppInfo.Current.BuildString;

Obtenha o tema atual

A RequestedTheme propriedade fornece o tema atual solicitado pelo sistema para seu aplicativo. Um dos seguintes valores é retornado:

• Unspecified
• Light
• Dark

Unspecified é retornado quando o sistema operacional não tem um estilo de interface do usuário específico. Um exemplo disso ocorre nos dispositivos que executam versões do iOS anteriores à 13.0.

O exemplo de código a seguir demonstra como obter o tema:

ThemeInfoLabel.Text = AppInfo.Current.RequestedTheme switch
{
    AppTheme.Dark => "Dark theme",
    AppTheme.Light => "Light theme",
    _ => "Unknown"
};

Obter a direção do layout

A RequestedLayoutDirection propriedade fornece a direção de layout atual usada pelo sistema para seu aplicativo. Um dos seguintes valores é retornado:

• Unknown
• LeftToRight
• RightToLeft

Unknown é retornado quando a direção do layout é desconhecida.

O exemplo de código a seguir demonstra como obter a direção do layout:

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

Exibir configurações do aplicativo

A IAppInfo classe também pode exibir uma página de configurações mantidas pelo sistema operacional para o aplicativo:

AppInfo.Current.ShowSettingsUI();

Esta página de configurações permite ao usuário alterar permissões do aplicativo e executar outras tarefas específicas à plataforma.

Especificações de implementação da plataforma

Esta seção descreve detalhes de implementação específicos da IAppInfo plataforma relacionados à interface.

Android

As informações do aplicativo são retiradas do AndroidManifest.xml para os seguintes campos:

• BuildString — android:versionCode em manifest nó
• Name — android:label no application nó
• PackageName — package no manifest nó
• VersionString — android:versionName no manifest nó

Tema solicitado

O Android usa modos de configuração para especificar o tipo de tema a solicitar do usuário. Com base na versão do Android, ele pode ser alterado pelo usuário ou pode ser alterado quando o modo de economia de bateria está ativado.

Leia mais a respeito na Documentação oficial do Android para o Tema Escuro.

Catalisador para iOS/Mac

As informações do aplicativo são retiradas do Info.plist para os seguintes campos:

• BuildString — CFBundleVersion
• Name — CFBundleDisplayName se for o caso, senão CFBundleName
• PackageName — CFBundleIdentifier
• VersionString — CFBundleShortVersionString

Tema solicitado

Não especificado é sempre retornado em versões do iOS anteriores à 13.0

Windows

As informações do aplicativo são retiradas do Package.appxmanifest para os seguintes campos:

• BuildString — Usa o BuildVersion do no Identity nó
• Name — DisplayName no Properties nó
• PackageName — Name no Identity nó
• VersionString — Version no Identity nó

Tema solicitado

O código que acessa a IAppInfo.RequestedTheme propriedade deve ser chamado no thread da interface do usuário ou uma exceção será lançada.

Os aplicativos do Windows respeitam a configuração de RequestedTheme propriedade no Windows App.xaml. Se estiver definida como um tema específico, essa API sempre retornará essa configuração. Para usar o tema dinâmico do sistema operacional, remova essa propriedade do seu aplicativo. Quando seu aplicativo é executado, ele retorna o tema definido pelo usuário em Configurações do Windows: Configurações>Personalização>Cores>Escolha seu modo de aplicativo padrão.