버전 추적

샘플 찾아보기

이 문서에서는 .NET 다중 플랫폼 앱 UI(.NET MAUI) IVersionTracking 인터페이스를 사용하는 방법을 설명합니다. 이 인터페이스를 사용하면 애플리케이션 버전 및 빌드 번호를 검사 애플리케이션이 처음 시작된 경우와 같은 추가 정보를 볼 수 있습니다.

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

시작하기

앱에서 버전 추적을 사용하도록 설정하려면 MauiProgram.cs 파일의 MauiAppBuilder 개체에서 메서드를 호출 ConfigureEssentials 합니다. 그런 다음 개체에서 IEssentialsBuilder 메서드를 호출합니다 UseVersionTracking() .

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();

    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
        })
        .ConfigureEssentials(essentials =>
        {
            essentials.UseVersionTracking();
        });

    return builder.Build();
}

버전 확인

인터페이스는 IVersionTracking 앱의 현재 버전과 앱이 이전 버전과 어떻게 관련되어 있는지 설명하는 많은 속성을 제공합니다. 다음 예제에서는 추적 정보를 페이지의 레이블에 씁니다.

private void ReadVersion_Clicked(object sender, EventArgs e)
{
    labelIsFirst.Text = VersionTracking.Default.IsFirstLaunchEver.ToString();
    labelCurrentVersionIsFirst.Text = VersionTracking.Default.IsFirstLaunchForCurrentVersion.ToString();
    labelCurrentBuildIsFirst.Text = VersionTracking.Default.IsFirstLaunchForCurrentBuild.ToString();
    labelCurrentVersion.Text = VersionTracking.Default.CurrentVersion.ToString();
    labelCurrentBuild.Text = VersionTracking.Default.CurrentBuild.ToString();
    labelFirstInstalledVer.Text = VersionTracking.Default.FirstInstalledVersion.ToString();
    labelFirstInstalledBuild.Text = VersionTracking.Default.FirstInstalledBuild.ToString();
    labelVersionHistory.Text = String.Join(',', VersionTracking.Default.VersionHistory);
    labelBuildHistory.Text = String.Join(',', VersionTracking.Default.BuildHistory);

    // These two properties may be null if this is the first version
    labelPreviousVersion.Text = VersionTracking.Default.PreviousVersion?.ToString() ?? "none";
    labelPreviousBuild.Text = VersionTracking.Default.PreviousBuild?.ToString() ?? "none";
}

버전 추적을 사용하도록 설정한 후 앱이 처음 실행되면 속성이 IsFirstLaunchEver 반환 true됩니다. 이미 릴리스된 앱 IsFirstLaunchEver 의 최신 버전에서 버전 추적을 추가하는 경우 잘못 보고 true할 수 있습니다. 이 속성은 항상 버전 추적을 처음 사용하도록 설정하고 사용자가 앱을 실행하는 시간을 반환 true 합니다. 사용자가 버전을 추적하지 않는 이전 버전에서 업그레이드한 경우에는 이 속성을 완전히 사용할 수 없습니다.

플랫폼 간 차이점

모든 버전 정보는 기본 설정 API를 사용하여 저장되며 [YOUR-APP-PACKAGE-ID].microsoft.maui.essentials.versiontracking의 파일 이름과 함께 저장되며 기본 설정 설명서에 설명된 것과 동일한 데이터 지속성을 따릅니다.