Información de la aplicación
Examinar el ejemploEn este artículo se describe cómo puedes usar la interfaz IAppInfo de .NET Multi-platform App UI (.NET MAUI), que da información sobre la aplicación.
La implementación predeterminada de la interfaz IAppInfo está disponible a través de la propiedad AppInfo.Current. Tanto la interfaz IAppInfo como la clase AppInfo están contenidas en el espacio de nombres Microsoft.Maui.ApplicationModel.
Lectura de la información de la aplicación
La interfaz IAppInfo expone las propiedades siguientes:
- Name: nombre de la aplicación.
- PackageName: nombre del paquete o identificador de aplicación, como
com.microsoft.myapp. - VersionString: versión de la aplicación, como
1.0.0. - Version: versión de la aplicación, como un objeto Version.
- BuildString: número de compilación de la versión, como
1000. - RequestedTheme: tema detectado del sistema o la aplicación.
- PackagingModel: modelo de empaquetado de la aplicación.
- RequestedLayoutDirection: dirección de diseño solicitada del sistema o la aplicación.
En el ejemplo de código siguiente se muestra el acceso a algunas de estas propiedades:
string name = AppInfo.Current.Name;
string package = AppInfo.Current.PackageName;
string version = AppInfo.Current.VersionString;
string build = AppInfo.Current.BuildString;
Obtención del tema actual
La propiedad RequestedTheme proporciona el tema que el sistema solicitó actualmente para la aplicación. Se devuelve uno de los siguientes valores:
Se devolverá Unspecified cuando el sistema operativo no tenga un estilo de interfaz de usuario específico. Un ejemplo de esto se encuentran en los dispositivos que ejecutan versiones de iOS anteriores a la 13.0.
En el ejemplo de código siguiente se muestra cómo obtener el tema:
ThemeInfoLabel.Text = AppInfo.Current.RequestedTheme switch
{
AppTheme.Dark => "Dark theme",
AppTheme.Light => "Light theme",
_ => "Unknown"
};
Obtención de la dirección de diseño
La propiedad RequestedLayoutDirection proporciona la dirección de diseño actual utilizada por el sistema para la aplicación. Se devuelve uno de los siguientes valores:
Se devuelve Unknown cuando se desconoce la dirección de diseño.
En el ejemplo de código siguiente se muestra cómo obtener la dirección de diseño:
LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;
Visualización de la configuración de la aplicación
La clase IAppInfo también puede mostrar una página de configuración mantenida por el sistema operativo para la aplicación:
AppInfo.Current.ShowSettingsUI();
Esta página de configuración permite al usuario cambiar los permisos de la aplicación y realizar otras tareas específicas de la plataforma.
Detalles de implementación de la plataforma
En esta sección se describen los detalles de implementación específicos de la plataforma relacionados con la interfaz IAppInfo.
La información de la aplicación se extrae del AndroidManifest.xml para estos campos:
- BuildString:
android:versionCodeen el nodomanifest - Name:
android:labelen el nodoapplication - PackageName:
packageen el nodomanifest - VersionString:
android:versionNameen el nodomanifest
Tema solicitado
Android usa modos de configuración para especificar el tipo de tema que se va a solicitar al usuario. En función de la versión de Android, el usuario puede modificarlo o se cambia cuando está habilitado el modo de ahorro de batería.
Puede obtener más información en la documentación oficial de Android sobre el tema oscuro.
