Condividi tramite

Informazioni sull'app

  • Articolo

Browse sample. Esplorare l'esempio

Questo articolo descrive come usare l'interfaccia dell'interfaccia dell'app multipiattaforma .NET (.NET MAUI), IAppInfo che fornisce informazioni sull'applicazione.

L'implementazione predefinita dell'interfaccia IAppInfo è disponibile tramite la AppInfo.Current proprietà . Sia l'interfaccia che AppInfo la IAppInfo classe sono contenute nello spazio dei Microsoft.Maui.ApplicationModel nomi .

Leggere le informazioni sull'app

L'interfaccia IAppInfo espone le proprietà seguenti:

  • Name — Nome dell'applicazione.
  • PackageName — Nome del pacchetto o identificatore dell'applicazione, ad esempio com.microsoft.myapp.
  • VersionString — Versione dell'applicazione, ad esempio 1.0.0.
  • Version — Versione dell'applicazione, come Version oggetto .
  • BuildString — Numero di build della versione, ad esempio 1000.
  • RequestedTheme — Tema rilevato del sistema o dell'applicazione.
  • PackagingModel — Modello di creazione del pacchetto dell'applicazione.
  • RequestedLayoutDirection — Direzione del layout richiesta del sistema o dell'applicazione.

Nell'esempio di codice seguente viene illustrato l'accesso ad alcune di queste proprietà:

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

Ottenere il tema corrente

La RequestedTheme proprietà fornisce il tema corrente richiesto dal sistema per l'applicazione. Viene restituito uno dei valori seguenti:

Unspecified viene restituito quando il sistema operativo non ha uno stile di interfaccia utente specifico. Un esempio è rappresentato dai dispositivi che eseguono versioni di iOS precedenti alla 13.0.

L'esempio di codice seguente illustra come ottenere il tema:

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

Ottenere la direzione del layout

La RequestedLayoutDirection proprietà fornisce la direzione del layout corrente usata dal sistema per l'applicazione. Viene restituito uno dei valori seguenti:

Unknown viene restituito quando la direzione del layout è sconosciuta.

L'esempio di codice seguente illustra come ottenere la direzione del layout:

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

Visualizzare le impostazioni dell'app

La IAppInfo classe può anche visualizzare una pagina di impostazioni gestite dal sistema operativo per l'applicazione:

AppInfo.Current.ShowSettingsUI();

Questa pagina di impostazioni consente all'utente di modificare le autorizzazioni dell'applicazione e di eseguire altre attività specifiche della piattaforma.

Specifiche dell'implementazione della piattaforma

Questa sezione descrive i dettagli di implementazione specifici della piattaforma correlati all'interfaccia IAppInfo .

Le informazioni sull'app provengono da AndroidManifest.xml per i campi seguenti:

  • BuildString — android:versionCode nel manifest nodo
  • Name — android:label nel application nodo
  • PackageName — package nel manifest nodo
  • VersionString — android:versionName nel manifest nodo

Tema richiesto

Android usa le modalità di configurazione per specificare il tipo di tema da richiedere all'utente. In base alla versione di Android, può essere modificata dall'utente o può essere modificata quando è abilitata la modalità risparmio batteria.

Altre informazioni sono disponibili nella documentazione di Android relativa al tema scuro.