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(Windows Server Update Service), 구성 관리자 또는 그룹 정책

다음 오류 코드는 컴퓨터의 정책이 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 패키징 도구를 열고 패키지 편집기를 통해 앱을 편집합니다. 매니페스트를 열고 MinVersion 요소의 특성을 TargetDeviceFamily "10.0.16299.0"으로 설정합니다.

<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 DeniedFile in Use .

파일 유형 연결

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

인수가 있는 바로 가기

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

설치 디렉터리

이는 보조 드라이브를 사용 하 여 앱 변환을 수행 하는 사용자에 게 더 일반적입니다. 설치 위치를 변경 하도록 선택 하는 경우 모든 파일이 이동 되는의 루트를 변경 합니다. 즉, MSIX 패키징 도구는 이러한 모든 파일이 이동 하 고 변환 하는 동안 캡처되는 위치를 알고 있어야 합니다.

패키지 지원 프레임 워크 쓰기를 사용 하 여 디렉터리 픽스를 설치 하면이 문제를 해결할 수 있습니다. 이 기능을 MSIX 도구에서 기본적으로 기능으로 추가 하 여이를 1809로 허용 합니다. 응용 프로그램이 1709에서 작동 하지 않고 1809에 있는 경우이 문제가 발생할 수 있습니다.

피드백 보내기

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

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

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

참고

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