다음을 통해 공유

기존 프로젝트를 Windows App SDK의 다른 릴리스로 업데이트합니다

  • 아티클

이전 버전의 Windows 앱 SDK(이전의 프로젝트 리유니언) 또는 WinUI 3을 사용하여 프로젝트를 만든 경우 최신 릴리스를 사용하도록 프로젝트를 업데이트할 수 있습니다. 각 릴리스 채널에서 현재 사용할 수 있는 기능에 대해 자세히 알아보려면 Windows 앱 SDK 릴리스 채널을 참조하세요.

참고 항목

이러한 지침은 각 앱의 개별 시나리오의 고유성으로 인해 문제가 발생할 수 있습니다. 주의 깊게 따라주시고, 문제가 발견되면 microsoft-ui-xaml GitHub repo에 대한 버그를 제출해주세요.

1.0 이후 릴리스된 버전 간 업데이트

프로젝트에서 필요한 Windows 앱 SDK NuGet 패키지의 버전을 참조하지 않는 경우 Visual Studio의 NuGet 패키지 관리자 사용하여 프로젝트의 NuGet 패키지 참조를 업데이트할 수 있습니다. 예를 들어 Windows 앱 SDK VSIX의 안정적인 릴리스를 사용하여 새 프로젝트를 만드는 경우 프로젝트는 안정적인 Windows 앱 SDK 릴리스를 참조합니다. 그러나 Windows 앱 SDK 실험적 릴리스를 참조하도록 해당 프로젝트를 쉽게 다시 구성할 수 있습니다. 또는 안정적인 최신 릴리스를 참조하도록 다시 구성합니다.

단계는 기존 프로젝트에서 Windows 앱 SDK 사용의 지침을 참조하세요.

0.8에서 1.0으로 업데이트

버전 0.8(예: 버전 0.8.4)을 사용하여 프로젝트를 만든 경우 다음 지침에 따라 프로젝트를 1.0 릴리스로 업데이트할 수 있습니다.

필수 구성 요소: Windows 앱 SDK의 최신 릴리스를 다운로드하여 설치합니다. 자세한 내용은 Windows 앱 SDK용 도구 설치를 참조하세요.

지침

  1. 이 .wapproj 파일에서 TargetPlatformMinVersion 이 10.0.17763.0보다 오래된 경우 10.0.17763.0로 변경합니다.

  2. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔로 이동합니다. 이 프로세스는 .csproj/.vcxproj 및 .wapproj 파일에서 기존 프로젝트 리유니언 패키지 참조를 제거한 다음, 해당 파일에 대한 WindowsAppSDK 패키지 참조를 설치하는 것으로 구성됩니다.

  3. 다음 명령을 입력하여 .csproj/.vcxproj에서 기존 ProjectReunion 패키지를 제거합니다.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} 
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}

  4. 그런 다음, 다음을 실행하여 .wapproj에서 기존 ProjectReunion 패키지를 제거합니다.

    uninstall-package Microsoft.ProjectReunion 
uninstall-package Microsoft.ProjectReunion.WinUI

  5. 이제 명령을 실행하여 안정적 WindowsAppSDK 패키지를 설치합니다.

  6. .csproj/.vcxproj에 추가할 WindowsAppSDK 패키지 참조입니다.

    install-package Microsoft.WindowsAppSDK -ProjectName {yourProject} -Version 1.0.0

  7. .wapproj에 추가할 WindowsAppSDK 패키지 참조입니다.

    install-package Microsoft.WindowsAppSDK -Version 1.0.0

0.8 또는 0.8 미리 보기에서 1.0 실험적 또는 미리 보기 3으로 업데이트

Important

버전 1.0 미리 보기 1 및 미리 보기 2에는 심각한 버그가 있습니다. 이러한 미리 보기 중 하나를 이미 설치한 경우 1.0 미리 보기 1 및 미리 보기 2에 영향을 미치는 중요한 문제를 참조하세요. 대신 버전 1.0 미리 보기 3(1.0.0-preview3)을 사용하는 것이 좋습니다.

버전 0.8 미리 보기 또는 0.8 버전(예: 버전 0.8.1)을 사용하여 프로젝트를 만든 경우 다음 지침에 따라 프로젝트를 1.0 미리 보기 3 또는 실험적 릴리스로 업데이트할 수 있습니다.

시작하기 전에 최신 VSIX 및 NuGet 패키지를 포함하여 모든 Windows 앱 SDK 필수 구성 요소가 설치되어 있는지 확인합니다. 세부사항은 Windows 앱 SDK용 도구 설치를 참조하세요.

먼저 다음을 수행합니다.

  • .wapproj 파일에서 TargetPlatformMinVersion이 10.0.17763.0보다 오래된 경우 10.0.17763.0으로 변경합니다.

다음으로, 프로젝트를 다음과 같이 변경합니다.

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔로 이동합니다.

  2. 1.0 미리 보기 3에 대한 다음 명령을 입력합니다.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.WindowsAppSDK -Version 1.0.0-preview3 -ProjectName {yourProjectName}

    또는 1.0 실험적의 경우 다음 명령을 수행합니다.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.WindowsAppSDK -Version 1.0.0-experimental1 -ProjectName {yourProjectName}

  3. Application(package).wapproj를 다음과 같이 변경합니다.

    1. 이 항목 그룹을 제거합니다. 0.8.0과 다른 버전에서 업데이트하는 경우 이 항목 그룹에서 참조되는 해당 버전 번호가 표시됩니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. 이 항목 그룹을 추가하여 1.0 미리 보기 3으로 바꿉니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-preview3]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

      또는 이 항목 그룹을 1.0 실험적으로 바꿉니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-experimental1]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="[1.0.0-experimental1]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

  4. 프로젝트(.csproj 또는 .vcproj) 파일을 다음과 같이 변경합니다.

    1. 이 항목 그룹을 제거합니다. 0.8.0과 다른 버전에서 업데이트하는 경우 이 항목 그룹에서 참조되는 해당 버전 번호가 표시됩니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

    2. 이 항목 그룹을 추가하여 1.0 미리 보기 3으로 바꿉니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-preview3" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

      또는 이 항목 그룹을 1.0 실험적으로 바꿉니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-experimental1" />
    <PackageReference Include="Microsoft.WindowsAppSDK.Foundation" Version="1.0.0-experimental1" />
    <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="1.0.0-experimental1" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

  5. 솔루션 빌드에 실패하는 경우 빌드 출력을 정리하고 Visual Studio를 다시 시작한 후 앱을 다시 실행합니다.

0.8 미리 보기에서 0.8로 또는 안정적인 0.8 버전 간 업데이트

버전 0.8 미리 보기를 사용하여 프로젝트를 만든 경우 다음 지침에 따라 프로젝트를 안정적 버전의 0.8로 업데이트할 수 있습니다. 이전 안정적 버전의 0.8(예: 0.8.0)을 사용하여 프로젝트를 만들고 프로젝트를 최신 안정적 버전(예: 0.8.2)으로 업데이트하려는 경우에도 이러한 지침이 적용됩니다.

참고 항목

다음 수동 단계를 거치지 않고 Visual Studio 확장 관리자를 통해 프로젝트를 자동으로 업데이트할 수 있습니다. Visual Studio 2019에서 Extensions>Manage Extensions 를 클릭하고 왼쪽 메뉴바에서 Update 을 선택합니다. 목록에서 “프로젝트 리유니언”을 선택하고 업데이트를 클릭합니다.

시작하기 전에 최신 VSIX 및 NuGet 패키지를 포함하여 모든 Windows 앱 SDK 필수 구성 요소가 설치되어 있는지 확인합니다. 세부사항은 Windows 앱 SDK용 도구 설치를 참조하세요.

먼저 다음을 수행합니다.

  • .wapproj 파일에서 TargetPlatformMinVersion이 10.0.17763.0보다 오래된 경우 10.0.17763.0으로 변경합니다.

다음으로, 프로젝트를 다음과 같이 변경합니다.

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔로 이동합니다.

  2. 다음 명령을 입력합니다.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.8.2 -ProjectName {yourProjectName}

  3. Application(package).wapproj를 다음과 같이 변경합니다.

    1. 이 항목 그룹을 제거합니다. 0.8 미리 보기와 다른 버전에서 업데이트하는 경우 이 항목 그룹에서 참조되는 해당 버전 번호가 표시됩니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. 이 항목을 대체할 항목 그룹을 추가합니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.2]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.2]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

  4. 프로젝트(.csproj 또는 .vcproj) 파일을 다음과 같이 변경합니다.

    1. 이 항목 그룹을 제거합니다. 0.8 미리 보기와 다른 버전에서 업데이트하는 경우 이 항목 그룹에서 참조되는 해당 버전 번호가 표시됩니다.
      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>
    2. 이 항목을 대체할 항목 그룹을 추가합니다: 
      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.2" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.2" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.2" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

  5. 솔루션 빌드에 실패하는 경우 빌드 출력을 정리하고 Visual Studio를 다시 시작한 후 앱을 다시 실행합니다.

0.5에서 0.8로 업데이트

버전 0.5 안정적을 사용하여 프로젝트를 만든 경우 다음 지침에 따라 프로젝트를 버전 0.8 안정적으로 업데이트할 수 있습니다.

참고 항목

다음 수동 단계를 거치지 않고 Visual Studio 확장 관리자를 통해 프로젝트를 자동으로 업데이트할 수 있습니다. Visual Studio 2019에서 Extensions>Manage Extensions 를 클릭하고 왼쪽 메뉴바에서 Update 을 선택합니다. 목록에서 “프로젝트 리유니언”을 선택하고 업데이트를 클릭합니다.

시작하기 전에 최신 VSIX 및 NuGet 패키지를 포함하여 모든 Windows 앱 SDK 필수 구성 요소가 설치되어 있는지 확인합니다. 세부사항은 Windows 앱 SDK용 도구 설치를 참조하세요.

먼저 다음을 수행합니다.

  • .wapproj 파일에서 TargetPlatformMinVersion이 10.0.17763.0보다 오래된 경우 10.0.17763.0으로 변경합니다.

다음으로, 프로젝트를 다음과 같이 변경합니다.

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔로 이동합니다.

  2. 다음 명령을 입력합니다.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.8.0 -ProjectName {yourProjectName}

  3. 다음 줄을 프로젝트(.csproj 또는 .vcproj) 파일의 첫 번째 <PropertyGroup> 내에 추가합니다.

    <UseWinUI>true</UseWinUI>

  4. Application(package).wapproj를 다음과 같이 변경합니다.

    1. 다음 섹션을 추가합니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. 다음 줄을 찾습니다:

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>

      이 줄을 이동하여 <TargetPlatformVersion> 태그 바로 아래에 있는 새 줄에 놓습니다.

    3. 이 항목 그룹을 제거합니다. 0.5.7 이전 버전에서 업데이트하는 경우 이 항목 그룹에서 참조되는 이전 버전 번호가 표시됩니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.7]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

  5. 솔루션 빌드에 실패하는 경우 빌드 출력을 정리하고 Visual Studio를 다시 시작한 후 앱을 다시 실행합니다.

0.5 미리 보기에서 0.8 미리 보기로 업데이트

버전 0.5 미리 보기를 사용하여 프로젝트를 만든 경우 다음 지침에 따라 프로젝트를 버전 0.8 미리 보기로 업데이트할 수 있습니다.

참고 항목

다음 수동 단계를 거치지 않고 Visual Studio 확장 관리자를 통해 프로젝트를 자동으로 업데이트할 수 있습니다. Visual Studio 2019에서 Extensions>Manage Extensions 를 클릭하고 왼쪽 메뉴바에서 Update 을 선택합니다. 목록에서 “프로젝트 리유니언”을 선택하고 업데이트를 클릭합니다.

시작하기 전에 최신 VSIX 및 NuGet 패키지를 포함하여 모든 Windows 앱 SDK 필수 구성 요소가 설치되어 있는지 확인합니다. 세부사항은 Windows 앱 SDK용 도구 설치를 참조하세요.

먼저 다음을 수행합니다.

  • .wapproj 파일에서 TargetPlatformMinVersion이 10.0.17763.0보다 오래된 경우 10.0.17763.0으로 변경합니다.

  • C++ 및 C# 앱의 기본 프로젝트 템플릿에는 다음 줄이 포함되었습니다. Application.Suspending 이벤트는 데스크톱 앱에 대해 더 이상 호출되지 않으므로 이러한 줄(및 이 이벤트의 다른 용도)이 코드에 여전히 있을 경우 제거해야 합니다.

    this.Suspending += OnSuspending;

    Suspending({ this, &App::OnSuspending });

다음으로, 프로젝트를 다음과 같이 변경합니다.

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔로 이동합니다.

  2. 다음 명령을 입력합니다.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.8.0-preview -ProjectName {yourProjectName}

  3. Application(package).wapproj를 다음과 같이 변경합니다.

    1. 다음 섹션을 추가합니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]">
    <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. <TargetPlatformVersion> 태그 바로 아래에 있는 새 줄에 다음 줄을 추가합니다.

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>

    3. 다음 줄을 제거합니다.

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>

      그리고 다음 줄은 다음과 같습니다.

      <Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
<Import Project="$(Microsoft_WinUI_AppX_targets)" />

      그리고 다음 항목 그룹은 다음과 같습니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
</ItemGroup>

  4. 프로젝트(.csproj 또는 .vcproj) 파일을 다음과 같이 변경합니다.

    1. 다음 항목 그룹을 제거합니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.5.0-prerelease" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.5.0-prerelease" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.5.0-prerelease" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

    2. 다음 항목 그룹을 추가합니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" />
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" />
    <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

  5. 솔루션 빌드에 실패하는 경우 빌드 출력을 정리하고 Visual Studio를 다시 시작한 후 앱을 다시 실행합니다.

0.5 미리 보기에서 0.5로 업데이트

버전 0.5 미리 보기를 사용하여 프로젝트를 만든 경우 다음 지침에 따라 프로젝트를 안정적 버전 0.5.7로 업데이트할 수 있습니다.

시작하기 전에 최신 VSIX 및 NuGet 패키지를 포함하여 모든 Windows 앱 SDK 필수 구성 요소가 설치되어 있는지 확인합니다. 세부사항은 Windows 앱 SDK용 도구 설치를 참조하세요.

먼저 다음을 수행합니다.

  • [데스크톱 앱 전용] .wapproj 파일에서 TargetPlatformMinVersion이 10.0.17763.0보다 오래된 경우 10.0.17763.0으로 변경합니다.

  • C++ 및 C# 앱의 기본 프로젝트 템플릿에는 다음 줄이 포함되었습니다. Application.Suspending 이벤트는 데스크톱 앱에 대해 더 이상 호출되지 않으므로 이러한 줄(및 이 이벤트의 다른 용도)이 코드에 여전히 있을 경우 제거해야 합니다.

    this.Suspending += OnSuspending;

    Suspending({ this, &App::OnSuspending });

다음으로, 프로젝트를 다음과 같이 변경합니다.

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔로 이동합니다.

  2. 다음 명령을 입력합니다.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}

  3. UWP 앱이 있는 경우 이 단계에서 업데이트 프로세스를 완료해야 합니다. 데스크톱 앱이 있는 경우 애플리케이션(패키지).wapproj에서 다음과 같이 변경합니다.

    1. 다음 섹션을 추가합니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
        <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. <TargetPlatformVersion> 태그를 찾아 해당 태그 바로 아래에 있는 새 줄에 다음을 추가합니다.

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>

    3. 다음 줄을 제거합니다.

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>

      그리고 다음 줄은 다음과 같습니다.

      <Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
<Import Project="$(Microsoft_WinUI_AppX_targets)" />

      그리고 다음 항목 그룹은 다음과 같습니다.

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
    <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
      <ExcludeAssets>all</ExcludeAssets>
    </PackageReference>
</ItemGroup>

WinUI 3 미리 보기 4에서 0.5로 업데이트

WinUI 3 미리 보기 4를 사용하여 데스크톱 앱을 만든 경우 다음 지침에 따라 프로젝트를 프로젝트 리유니언 0.5로 업데이트할 수 있습니다.

시작하기 전에 최신 VSIX 및 NuGet 패키지를 포함하여 모든 Windows 앱 SDK 필수 구성 요소가 설치되어 있는지 확인합니다. 세부사항은 Windows 앱 SDK용 도구 설치를 참조하세요.

먼저 다음을 수행합니다.

  • .wapproj 파일에서 TargetPlatformMinVersion이 10.0.17763.0보다 오래된 경우 10.0.17763.0으로 변경합니다.

  • C++ 및 C# 앱의 기본 프로젝트 템플릿에는 다음 줄이 포함되었습니다. Application.Suspending 이벤트는 데스크톱 앱에 대해 더 이상 호출되지 않으므로 이러한 줄(및 이 이벤트의 다른 용도)이 코드에 여전히 있을 경우 제거해야 합니다.

    this.Suspending += OnSuspending;

    Suspending({ this, &App::OnSuspending });

다음으로, 프로젝트를 다음과 같이 변경합니다.

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔로 이동합니다.

  2. 다음 명령을 입력합니다.

    uninstall-package Microsoft.WinUI -ProjectName {yourProject}
install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}

  3. Application(package).wapproj를 다음과 같이 변경합니다.

    1. 다음 섹션을 추가합니다.

      <ItemGroup>
  <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
    <IncludeAssets>build</IncludeAssets>
  </PackageReference>
</ItemGroup>

    2. 다음 줄을 제거합니다.

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>

      <Import Project="$(AppxTargetsLocation)Microsoft.WinUI.AppX.targets" />

  4. 프로젝트의 {YourProject}(package)/build/ 폴더에서 기존의 Microsoft.WinUI.AppX.targets 파일을 삭제합니다.