MSIX 패키징 도구에 대한 알려진 문제 및 문제 해결 팁

이 문서에서는 알려진 문제에 대해 설명하고 MSIX 패키징 도구를 사용하여 앱을 MSIX로 변환할 때 고려해야 할 문제 해결 팁을 제공합니다. 연결이 끊긴 환경에서 MSIX 패키징 도구 또는 드라이버를 획득해야 하는 경우 다른 문서를 확인하세요.

알려진 문제

MSIX 패키징 도구의 최신 Insider Preview 빌드 가져오기

참가자 프로그램에 옵트인한 경우 올바른 버전의 MSIX 패키징 도구가 있는지 확인합니다.

  • MSIX 패키징 도구의 정보 섹션으로 이동하여 사용 중인 버전을 확인합니다.
  • 여기로 이동하여 최신 Insider Preview 버전을 확인하고 해당 버전의 MSIX 패키징 도구가 설치되어 있는지 확인합니다.
  • 플라이팅에 등록한 MSA가 Microsoft Store 로그인된 계정인지 확인합니다.
  • 컴퓨터의 Microsoft Store 통해 MSIX 패키징 도구를 수동으로 업데이트합니다. 이 옵션을 사용할 수 있는 경우 스토어를 열고 다운로드 및 업데이트로 이동한 다음 업데이트 가져오기를 클릭합니다. 또는 MSIX 패키징 도구를 검색하고 제품 페이지에서 업데이트를 요청하는 메시지를 표시할 수 있습니다.
  • 오프라인 사용을 위해 MSIX 패키징 도구를 설치하려면 다음 지침 에 따라 오프라인 프로세스를 통해 최신 앱을 가져올 수 있습니다.

참가자 프로그램에 참여하려면 여기를 클릭하세요.

MSIX 패키징 도구 드라이버

MSIX 패키징 도구 드라이버는 Windows 업데이트 FOD(Feature on Demand) 패키지로 제공됩니다. 컴퓨터에서 Windows 업데이트 서비스를 사용하지 않도록 설정하거나 Windows 참가자 플라이트 링 설정이 컴퓨터의 OS 빌드와 일치하지 않는 경우 설치에 실패합니다.

드라이버를 획득하는 데 문제가 있거나 오프라인 환경에서 작업하는 경우 여기에서 드라이버를 다운로드할 수 있는 링크를 찾을 수 있습니다.

드라이버를 다운로드했고 패키지 변환 중에 문제가 발생하는 경우 다음 문제 중 하나일 수 있습니다.

네트워크 연결 문제

다음 오류 코드는 연결 문제가 발생했음을 나타낼 수 있습니다.

  • -2145107924(0x8024402c)
  • -2145107945(0x80244017)
  • -2145123272(0x80240438)

Windows WSUS(서버 업데이트 서비스), Configuration Manager 또는 Windows 업데이트 연결에 영향을 주는 그룹 정책

다음 오류 코드는 컴퓨터의 정책이 Windows 업데이트 연결에 영향을 미치고 있음을 나타낼 수 있습니다. -2145124306(0x8024002e).

이 오류 코드가 표시되면 환경 설정 및 정책을 확인해야 할 수 있습니다.

드라이버에 다시 설치 필요

이 시나리오에서 MSIX 패키징 도구는 오류 메시지와 로그에 드라이버 다시 시작이 필요하다는 사실을 알립니다. 컴퓨터를 다시 시작하고 변환을 다시 시작하여 이 문제를 해결합니다.

MSIX 패키징 도구 드라이버 0x80131500 시작하는 동안 오류가 발생했습니다.

변환 중에 이 오류가 발생하면 로그 파일을 확인할 때 다음과 같은 항목을 찾아야 합니다.

[Error] Error monitoring: Insufficient system resources exist to complete the requested service

이 오류는 도구가 새 시스템 이벤트 추적 세션을 시작하지만 Windows 시스템 전체를 만들 수 있는 최대 세션 수를 초과했을 때 발생합니다. 기본 제한(64)을 초과하면 ERROR_NO_SYSTEM_RESOURCES 오류가 발생하여 드라이버가 실패합니다.

해결 방법은 다음 단계를 수행하여 기존 이벤트 추적 세션 중 일부를 중지하는 것입니다.

  1. 시작 메뉴 열고 성능 모니터 찾습니다.
  2. 마우스 오른쪽 단추로 클릭하고 자세히 선택 -> 관리자 권한으로 실행
  3. 트리 메뉴에서 데이터 수집기 집합 -> 이벤트 추적 세션을 선택합니다.
  4. 목록에서 기존 세션 중 일부를 마우스 오른쪽 단추로 클릭하고 중지를 선택합니다.

이제 MSIX 패키징 도구를 사용하여 변환을 다시 시도할 수 있습니다.

최소 버전

MSIX 패키지에서 미니문 버전 지원을 자동으로 변경하는 몇 가지 기능이 있습니다.

Microsoft Store 버전 관리 요구 사항 적용

1.2019.701.0 이전 버전의 MSIX 패키징 도구를 사용하여 기존 설치 관리자를 변환하는 경우 도구에서 Microsoft Store 버전 관리 요구 사항을 적용하거나 다른 도구를 사용하여 최소 버전을 10.0.16299.0(Windows 10 버전 1709)으로 설정하지 않은 패키지를 만들었습니다. 이로 인해 Windows 10 버전 1709 이상에 앱을 배포할 때 오류 메시지가 표시됩니다.

이 문제를 해결하려면 MSIX 패키징 도구를 열고 패키지 편집기를 통해 앱을 편집합니다. 매니페스트를 열고 요소의 TargetDeviceFamily 특성을 "10.0.16299.0"으로 설정합니다MinVersion.

<Dependencies>
    <TargetDeviceFamily> Name="Windows.Desktop" MinVersion="10.0.16299.0" MaxVersionTested = "10.0.17763.0" />
</Dependencies>

서비스를 사용하는 MSIX

MSIX 패키징 도구 버전 1.2019.1220.0에서는 서비스를 사용하여 MSIX 패키지를 만들기 위한 지원을 추가했습니다. 서비스 지원의 OS 제한으로 인해 MSIX 패키징 도구는 서비스가 있는 MSIX 패키지에서 지원되는 최소 버전을 10.0.19025.0으로 자동으로 변경합니다. 즉, Windows 10 버전 2004보다 낮은 OS에 서비스를 사용하여 MSIX를 설치할 수는 없지만 MSIX 패키징 도구를 사용하여 MSIX를 1809 Windows 10 만들 수 있습니다. 하위 OS에 이 앱을 설치해야 하는 경우 최소 버전을 적절하게 업데이트하지만 서비스에 대한 지원은 작동하지 않습니다.

프레임워크 및 드라이버

앱에 프레임워크가 필요한 경우 변환의 모니터링 단계에서 프레임워크가 설치되어 있는지 확인합니다. 로그를 통해 이런 일이 발생하는지 확인합니다. 앱에 드라이버를 설치해야 하는 경우 앱이 제대로 실행되는 데 필요한지 여부를 평가해야 합니다. MSIX는 현재 드라이버 설치를 지원하지 않습니다.

원격 컴퓨터

변환에 원격 VM을 사용하는 데 문제가 있는 경우 원격 머신 변환에 대한 설치 지침을 참조하세요.

변환 중 문제

  • 일부 설치 관리자는 종료 코드 259로 변환하지 못할 수 있습니다. 이는 설치 관리자가 스레드를 생성했지만 완료되길 기다리지 않았음을 나타냅니다. 즉, 주 스레드의 설치가 완료되었으나 여전히 실행 중인 스레드를 생성했으므로 오류 259로 인해 종료되었습니다. setup.exe에 대한 적절한 설치 옵션을 사용하는 것이 좋습니다.

서명 중 문제

잘못된 PE 인증서(0x800700C1)

이 문제는 패키지에 손상된 인증서가 있는 이진 파일이 포함되어 있을 때 발생합니다. 이 문제를 해결하려면 명령을 사용하여 dumpbin.exe /headers 파일 헤더를 덤프하고 잘못된 요소를 검사합니다. 수동으로 헤더를 다시 작성하여 문제를 해결합니다. 일반적으로 MSIX 패키징 도구는 잘못된 헤더를 자동으로 검색합니다. 이 문제가 지속되면 피드백을 제출합니다. 자세한 내용은 여기를 참조하세요.

Device Guard 서명

이러한 단계를 수행하고 비즈니스용 Microsoft Store 적절한 역할을 할당해야 합니다.

만료된 인증서

  • 패키지에 서명할 때 타임스탬프를 사용합니다.
  • 유효한 기호 또는 타임스탬프 인증서를 사용하여 사임할 수 있습니다.

일괄 변환 스크립트를 사용하여 앱을 사임할 수 있습니다.

문제 해결

로그 파일

변환의 성공 여부와 상관 없이 변환할 때마다 로그 파일이 생성됩니다. 자세한 내용은 여기에서 확인할 수 있습니다.

%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\

오류 코드는 기록되고 변환 과정 중 실패 지점을 나타냅니다. 오류 코드는 사용자가 알아보기 쉽습니다.

원격 디바이스 또는 VM의 로그 파일

원격 디바이스 또는 VM에서 변환이 수행된 경우 해당 디바이스에서 로그 파일을 복사한 후 피드백 항목의 일부로 첨부하는 것이 좋습니다. 그러면 문제를 보다 효율적으로 진단하고 해결하는 데 도움이 됩니다.

여기(%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt)에서 원격 변환의 로그를 확인할 수 있습니다.

로컬 클라이언트와 원격 서버에서 발생하는 작업을 포함하는 전체 Logs 폴더를 공유할 수 있다면 훨씬 더 유용합니다.

일반적인 문제

MakePri/매니페스트 번역 오류

이 오류는 패키지의 매니페스트에 문제가 있을 때 발생합니다. 문제를 식별하려면 패키지 편집기로 이동하여 매니페스트를 엽니다. 매니페스트를 열면 문제를 식별하고 적절한 수정 사항을 제공할 수 있습니다.

파일을 찾을 수 없습니다.

파일이 열려 있거나 존재하지 않을 수 있습니다. 이 문제를 해결하려면 적절한 파일을 추가하거나 현재 사용 중인 파일을 닫습니다. 열려 있는 경우 오류가 표시되지 File not Found 않습니다. 대신 오류가 Access Denied 발생합니다 File in Use .

파일 유형 연결

FTA(파일 형식 연결)와 관련된 문제는 패키지마다 다릅니다. MSIX 패키징 도구는 두 번 클릭 설치에 대한 파일 연결을 지원합니다. 예를 들어 앱에 상황에 맞는 메뉴가 있는 경우 자동으로 추가되지 않으므로 매니페스트에 수동으로 추가해야 합니다. 예제는 desktop4:FileExplorerContextMenus 매니페스트 요소를 참조하세요.

인수가 있는 바로 가기

인수가 있는 바로 가기는 현재 MSIX에서 지원되지 않습니다. 설치 관리자에 이러한 항목이 포함된 것을 감지하면 MSIX는 인수가 없는 타일을 만듭니다.

설치 디렉터리

이는 보조 드라이브를 사용하여 앱 변환을 수행하는 사용자에게 더 일반적입니다. 설치 위치를 변경하도록 선택하면 모든 파일이 이동하는 위치의 루트가 변경 됩니다. 즉, MSIX 패키징 도구는 이러한 모든 파일이 어디로 이동하는지 알아야 하며 변환 중에 캡처됩니다.

패키지 지원 프레임워크 쓰기를 사용하여 디렉터리 수정을 설치하여 이 문제를 해결할 수 있습니다. MSIX 도구에서 기본적으로 이를 기능으로 추가했으며, 이를 1809까지 허용합니다. 애플리케이션이 1709에서 작동하지 않고 1809년에 있는 경우 이것이 문제일 수 있습니다.

피드백 보내기

피드백을 보내는 가장 좋은 방법은 피드백 허브를 통해서입니다.

  1. 피드백 허브를 열거나 Windows + F를 입력합니다.
  2. 문제를 재현하기 위해 제목 및 필요한 단계를 제공합니다.
  3. 범주에서 을 선택한 후 MSIX 패키징 도구를 선택합니다.
  4. 변환과 연결된 로그 파일을 첨부합니다. 위에 제공된 폴더에서 로그를 찾을 수 있습니다.
  5. 변환된 MSIX 패키지를 첨부합니다(가능한 경우).
  6. 제출을 클릭합니다.

또한 설정피드백 탭으로 이동하여 MSIX 패키징 도구에서 직접 피드백을 보낼 수도 있습니다.

참고

피드백이 전달되는 데 24시간이 걸릴 수 있습니다. 따라서 VM을 사용하여 패키지를 변환하는 경우 변환 후 24시간 동안 VM을 켜놓고 현재 상태를 유지하는 것이 좋습니다. 또한 피드백에 변환 로그를 수동으로 연결할 수 있습니다.