최근 WinUI 3 앱을 마이크로소프트 스토어에 등록하려 했는데, 여러 차례 수정했음에도 계속 오류가 발생했습니다. 마이크로소프트 측에서 제공한 테스트 보고서는 내용이 모호하고 파악하기 어려웠습니다. 다행히 최신 보고서에 스크린샷이 첨부된 덕분에 마침내 근본적인 원인을 알게 되었습니다.
첫 번째 문제
다음은 문제 보고서 내용입니다.
제품 타일 아이콘에는 기본 이미지가 포함되어 있습니다. 타일 아이콘은 각 제품을 명확하게 구분할 수 있어야 하며, 사용자가 아이콘을 해당 앱과 연결해 혼동하지 않도록 해야 합니다. 타일 관련 자세한 내용은 https://docs.microsoft.com/en-us/windows/uwp/controls-and-patterns/tiles-and-notifications-app-assets 를 참고하세요. Mixed Reality 제품용 3D 아이콘 관련 내용은 https://docs.microsoft.com/en-us/windows/mixed-reality/3d-app-launcher-design-guidance 에서 확인할 수 있습니다.
위반 패키지: XXXXX (Package)_1.0.13.0_x86_x64_bundle.msixuploa
스크린샷에서 보시다시피 마이크로소프트 테스터가 앱을 설치했을 때, 시작 메뉴의 ‘최근 설치한 앱’ 항목에 표시된 아이콘이 제가 직접 설정한 커스텀 아이콘이 아닌 WinUI 3 기본 아이콘으로 나타났습니다. 앱 패키징 과정에서 아이콘 설정을 제대로 하지 않았기 때문에 이런 문제가 발생했습니다.
커스텀 아이콘을 정상적으로 적용하려면 프로젝트 내 Package.appxmanifest 파일을 열고, 시각 자산 탭으로 이동한 뒤 원본 이미지를 선택해 필요한 아이콘 리소스를 생성하면 됩니다.
두 번째 문제
언어 목록에 등록한 제품 이름과 기기에 설치된 후 표시되는 앱 이름이 일치하지 않습니다.
스토어 등록명: ThaiTongXXXXX
기기 표시명: XXXXX
해당 문제 발생 언어: 중국어(중국)
설치 후 표시되는 제품명 관련 문서: https://docs.microsoft.com/en-us/uwp/schemas/appxpackage/uapmanifestschema/element-displayname
스토어 등록명 관련 문서: https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/msix/add-and-edit-store-listing-info#product-name
이것 역시 유사한 유형의 오류입니다. 패키징 시 지정한 앱 이름과 마이크로소프트 스토어에 입력한 등록명이 달라 제출이 거부된 것입니다. Package.appxmanifest 파일에서 수정할 수 있는데, 애플리케이션 탭으로 이동한 후 표시 이름 항목을 마이크로소프트 파트너 센터 대시보드에 설정한 제품명과 완전히 동일하게 변경하면 해결됩니다.
세 번째 문제
앱 실행 시 강제 종료 현상이 발생합니다. 운영체제 빌드 26200.7623 버전을 사용하는 기기에서 해당 문제가 확인되었습니다.
문제 확인 기기: ASUS EXPERTBOOK P5405CSA_PX485CSA
테스트 진행 기기: ASUS EXPERTBOOK P5405CSA_PX485CSA
오류 메시지: 없음
참고: 윈도우 앱은 개발 및 자체 테스트 단계에서는 정상적으로 작동하지만, 스토어 인증 테스트를 거치는 과정에서 예기치 않게 충돌하거나 비정상적으로 작동하는 경우가 종종 있습니다. 앱 공개 후에도 동일한 문제가 발생할 수 있습니다. 문제 해결에 도움이 필요하다면 http://aka.ms/storesupport 에서 개발자 지원 서비스를 이용하세요.
ThaiTong泰语学习_10.1.2.10_Crashlog.evtx ()
테스트 기기: Microsoft Surface Laptop
오류 애플리케이션 이름: ThaiTong.exe, 버전: 1.0.0.0, 타임스탬프: 0x696f0000
오류 모듈 이름: Microsoft.UI.Xaml.dll, 버전: 3.1.7.0, 타임스탬프: 0xabafd337
예외 코드: 0xc000027b
오류 오프셋: 0x00000000003a11f5
오류 프로세스 ID: 0x0x2acc
오류 앱 실행 시간: 0x0x1dcf315da5ba390
오류 앱 경로: C:\Program Files\WindowsApps\13BB6A9C.2489817D7C86E_1.0.13.0_x64__3310hcxmkktm6\ThaiTong\ThaiTong.exe
오류 모듈 경로: C:\Program Files\WindowsApps\13BB6A9C.2489817D7C86E_1.0.13.0_x64__3310hcxmkktm6\ThaiTong\Microsoft.UI.Xaml.dll
보고서 ID: 4434c917-11b5-4bdd-ac99-a28959eb9ba6
오류 패키지 전체 이름: 13BB6A9C.2489817D7C86E_1.0.13.0_x64__3310hcxmkktm6
오류 패키지 상대 앱 ID: App
현재 세 번째 문제를 해결하기 위해 분석 중입니다. 문제가 해결되는 대로 해결 방법을 공유하겠습니다. 읽어주셔서 감사합니다.