앱 정보

  • 아티클

Browse sample. 샘플 찾아보기

이 문서에서는 애플리케이션에 대한 정보를 제공하는 .NET 다중 플랫폼 앱 UI(.NET MAUI) IAppInfo 인터페이스를 사용하는 방법을 설명합니다.

인터페이스의 IAppInfo 기본 구현은 속성을 통해 AppInfo.Current 사용할 수 있습니다. IAppInfo 인터페이스와 AppInfo 클래스는 모두 네임스페이스에 Microsoft.Maui.ApplicationModel 포함됩니다.

앱 정보 읽기

인터페이스는 IAppInfo 다음 속성을 노출합니다.

  • Name — 애플리케이션 이름입니다.
  • PackageName - 패키지 이름 또는 애플리케이션 식별자(예: com.microsoft.myapp.
  • VersionString — 애플리케이션 버전(예: 1.0.0.)
  • Version — 개체로서 애플리케이션 버전입니다 Version .
  • BuildString — 버전의 빌드 번호입니다(예: 1000.).
  • RequestedTheme — 시스템 또는 애플리케이션의 검색된 테마입니다.
  • PackagingModel — 애플리케이션의 패키징 모델입니다.
  • RequestedLayoutDirection — 시스템 또는 애플리케이션의 요청된 레이아웃 방향입니다.

다음 코드 예제에서는 이러한 속성 중 일부에 액세스하는 방법을 보여 줍니다.

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

현재 테마 가져오기

이 속성은 RequestedTheme 애플리케이션에 대한 시스템에서 현재 요청된 테마를 제공합니다. 다음 값 중 하나가 반환됩니다.

Unspecified 는 운영 체제에 특정 사용자 인터페이스 스타일이 없는 경우 반환됩니다. 그 예는 13.0 이전 버전의 iOS를 실행하는 디바이스입니다.

다음 코드 예제에서는 테마를 가져오는 방법을 보여 줍니다.

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

레이아웃 방향 가져오기

이 속성은 RequestedLayoutDirection 시스템에서 애플리케이션에 사용하는 현재 레이아웃 방향을 제공합니다. 다음 값 중 하나가 반환됩니다.

Unknown 는 레이아웃 방향을 알 수 없는 경우 반환됩니다.

다음 코드 예제에서는 레이아웃 방향을 가져오는 방법을 보여 줍니다.

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

앱 설정 표시

클래스는 IAppInfo 애플리케이션에 대한 운영 체제에서 기본 설정 페이지를 표시할 수도 있습니다.

AppInfo.Current.ShowSettingsUI();

이 설정 페이지에서는 사용자가 애플리케이션 권한을 변경하고 기타 플랫폼 관련 작업을 수행할 수 있습니다.

플랫폼 구현 세부 정보

이 섹션에서는 인터페이스와 관련된 IAppInfo 플랫폼별 구현 세부 정보를 설명합니다.

앱 정보는 다음 필드에 대한 AndroidManifest.xml 에서 가져옵니다.

  • BuildStringmanifest— android:versionCode 노드
  • Name— android:label 노드에서 application
  • PackageName— package 노드에서 manifest
  • VersionString— android:versionName 노드에서 manifest

요청된 테마

Android는 구성 모드를 사용하여 사용자가 요청하는 테마 유형을 지정합니다. Android 버전에 따라 사용자가 변경하거나 배터리 절약 모드를 사용하도록 설정하면 변경될 수 있습니다.

자세한 내용은 어두운 테마에 대한 공식 Android 설명서에서 확인할 수 있습니다.