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.