MSIX 패키징 도구에 대한 알려진 문제 및 문제 해결 팁Known issues and troubleshooting tips for the MSIX Packaging Tool

이 문서에서는 알려진 문제에 대해 설명하고 MSIX 패키징 도구를 사용하여 앱을 MSIX로 변환할 때 고려해야 할 문제 해결 팁을 제공합니다.This article describes known issues and provides troubleshooting tips to consider when converting your apps to MSIX using the MSIX Packaging Tool. 연결 되지 않은 환경에서 Msix 패키징 도구나 드라이버를 획득 해야 하는 경우 다른 문서를 확인 하세요.Check out our other docs if you need to acquire the MSIX Packaging Tool or driver in a disconnected environments.

알려진 문제Known issues

MSIX 패키징 도구의 최신 Insider Preview 빌드 가져오기Getting the latest Insider Preview build of the MSIX Packaging Tool

Insider Program에 옵트인 (opt in) 한 경우 올바른 버전의 Msix 패키징 도구를 사용 하 고 있는지 확인 합니다.If you have opted in to our Insider Program, make sure you have the correct version of the MSIX Packaging Tool:

  • MSIX 패키징 도구의 About 섹션으로 이동 하 여 사용자가 있는 버전을 확인 합니다.Go to the About section in the MSIX Packaging Tool to view which version you are on.
  • 여기 로 이동 하 여 최신 Insider preview 버전을 확인 하 고 해당 버전의 Msix 패키징 도구를 설치 했는지 확인 합니다.Go here to determine the latest Insider Preview version, and confirm you have that version of the MSIX Packaging Tool installed.
  • 플 라이팅에 등록 된 MSA가 Microsoft Store에 로그인 된 계정 인지 확인 합니다.Make sure the MSA that's signed up for flighting is the account that is signed into the Microsoft Store.
  • 컴퓨터의 Microsoft Store를 통해 MSIX 패키징 도구를 수동으로 업데이트 합니다.Manually update the MSIX Packaging Tool through the Microsoft Store on your computer. 이 옵션을 사용할 수 있는 경우 스토어를 열고 다운로드 및 업데이트로 이동한 다음 업데이트 가져오기를 클릭 합니다.If this option if available to you, open the Store, go to Downloads and updates, and click Get updates. 또는 MSIX 패키징 도구를 검색 하 고 제품 페이지에서 업데이트를 묻는 메시지를 표시할 수 있습니다.Alternatively, search for the MSIX Packaging Tool, and on the product page you can then prompt it for an update.
  • 오프 라인에서 사용할 수 있도록 MSIX 패키징 도구를 설치 하려면 다음 지침 에 따라 오프 라인 프로세스를 통해 최신 앱을 가져올 수 있습니다.To install the MSIX Packaging Tool for offline use, follow these instructions to ensure you get the latest app through our offline process.

참가자 프로그램 참여에 관심이 있는 경우 여기를 클릭 하세요.If you are interested in joining our Insider Program, click here.

MSIX 패키징 도구 드라이버MSIX Packaging Tool driver

MSIX 패키징 도구 드라이버는 Windows 업데이트에서 패키지 기능 (주문형) 패키지로 제공 됩니다.The MSIX Packaging Tool driver is delivered as a Feature on Demand (FOD) package from Windows Update. 컴퓨터에서 Windows 업데이트 서비스를 사용 하지 않도록 설정 하거나 Windows 참가자 비행 링 설정이 컴퓨터의 OS 빌드와 일치 하지 않는 경우에는 설치에 실패 합니다.It will fail to install if the Windows Update service is disabled on the computer or if Windows Insider flight ring settings do not match the OS build of the computer.

드라이버를 가져오는 동안 문제가 발생 하거나 오프 라인 환경에서 작업 하 고 있는 경우 여기에서 드라이버를 다운로드할 수 있는 링크를 찾을 수 있습니다.If you are running into problems acquiring the driver, or you are working in an offline environment, you can find links to download the driver here.

드라이버를 다운로드 하 여 패키지를 변환 하는 동안 문제가 발생 하는 경우 다음 문제 중 하나일 수 있습니다.If you have downloaded the driver and are running into issues during your package conversion, it may be one of the following issues.

네트워크 연결 문제Network connectivity issues

다음 오류 코드는 연결 문제가 있음을 나타낼 수 있습니다.The following error codes might indicate that you are encountering connection issues:

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

WSUS (Windows Server Update Service), Configuration Manager 또는 Windows 업데이트 연결에 영향을 주는 그룹 정책Windows Server Update Service (WSUS), Configuration Manager, or group policies affecting Windows Update connectivity

다음 오류 코드는 컴퓨터의 정책이 Windows 업데이트 연결에 영향을 주고 있음을 나타낼 수 있습니다.-2145124306 (0x8024002e).The following error code may indicate that policies on your computer are be affecting Windows Update connectivity: -2145124306 (0x8024002e).

이 오류 코드가 표시 되 면 환경 설정 및 정책을확인 해야 할 수 있습니다.If you receive this error code, you may need to check your environment settings and policies.

드라이버에 다시 설치 필요Driver required a reinstall

이 시나리오에서 MSIX 패키징 도구는 오류 메시지를 알리고 드라이버를 다시 시작 해야 한다는 것을 기록 합니다.In this scenario, the MSIX Packaging Tool will notify you in the error message and logs that your driver needs a restart. 컴퓨터를 다시 시작 하 고 변환을 다시 시작 하 여이 문제를 해결 합니다.Restart your computer and start your conversion again to fix this issue.

최소 버전Minimum version

MSIX 패키지에서 최소 버전 지원 기능을 자동으로 변경 한다는 점에 유의 해야 할 몇 가지 기능이 있습니다.There are a few features to be aware of that automatically change the minimun version support in your MSIX Package.

Microsoft store 버전 관리 요구 사항 적용Enforce Microsoft store versioning requirements

1.2019.701.0보다 이전 버전의 Msix 패키징 도구 를 사용 하 여 기존 설치 관리자를 변환 하는 경우이 도구는에 대 한 Microsoft Store 버전 관리 요구 사항을 적용 하거나 다른 도구를 사용 하 여 최소 버전을 10.0.16299.0 (Windows 10, 버전 1709)로 설정 하지 않은 패키지를 만들었습니다.If you convert your existing installer using a version of the MSIX Packaging Tool earlier than 1.2019.701.0, the tool had Enforce Microsoft Store versioning requirements on, or used another tool to create your package that did not set the minimum version to 10.0.16299.0 (Windows 10, version 1709). 이렇게 하면 Windows 10 버전 1709 이상 버전에 앱을 배포할 때 오류 메시지가 발생 합니다.This will cause an error message when deploying your app to Windows 10, version 1709 or a later version.

이 문제를 해결 하려면 Msix 패키징 도구 를 열고 패키지 편집기를 통해 앱을 편집 합니다.To fix this issue, open the MSIX Packaging Tool and edit your app through Package Editor. 매니페스트를 열고 MinVersion 요소의 특성을 TargetDeviceFamily "10.0.16299.0"로 설정 합니다.Open your manifest and set the MinVersion attribute of the TargetDeviceFamily element to "10.0.16299.0".

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

MSIX 서비스MSIX with services

MSIX 패키징 도구의 버전 1.2019.1220.0에서 서비스를 사용 하 여 msix 패키지를 만들기 위한 지원을 추가 했습니다.In version 1.2019.1220.0 of the MSIX Packaging Tool, we added support for creating an MSIX package with Services. 서비스 지원에 대 한 OS 제한으로 인해 MSIX 패키징 도구는 MSIX 패키지에서 지원 되는 최소 버전을 서비스와 10.0.19025.0으로 자동으로 변경 합니다.Due to the OS restrictions with services support, the MSIX Packaging Tool automatically changes the min version supported in an MSIX package with services to 10.0.19025.0. 즉, Windows 10 버전 2004 보다 낮은 OS에는 서비스를 사용 하 여 MSIX을 설치할 수 없지만, MSIX 패키징 도구를 사용 하 여 Windows 10 1809로 msix을 만들 수 있습니다.This means that you cannot install an MSIX with services on an OS lower than the Windows 10 version 2004, but you can create that MSIX using the MSIX Packaging Tool down to Windows 10 1809. 낮은 OS에이 앱을 설치 해야 하는 경우 최소 버전을 적절 하 게 업데이트 합니다. 그러나 서비스에 대 한 지원이 작동 하지 않습니다.If you need to install this app on a lower OS, update the min version appropriately but note that support for services will not work.

프레임 워크 및 드라이버Frameworks and drivers

앱에 프레임 워크가 필요한 경우 변환의 모니터링 단계에서 프레임 워크가 설치 되었는지 확인 합니다.If the app requires a framework, make sure the framework is installed during the monitoring phase of the conversion. 로그를 방문 하 여이 문제가 발생 하는지 확인 합니다.Go through the logs to ensure this is happening. 앱에 드라이버를 설치 해야 하는 경우 앱이 제대로 실행 되는 데 필요한 지 여부를 평가 해야 합니다.If your app requires a driver to install, you need to evaluate whether this is required for your app to run properly. MSIX은 현재 드라이버 설치를 지원 하지 않습니다.MSIX currently does not support driver installation.

원격 컴퓨터Remote Machine

변환에 원격 VM을 사용 하는 데 문제가 발생 하는 경우 원격 컴퓨터 변환에 대 한 설치 지침을 참조 하세요.If you are running into issues with using a remote VM for your conversions, see Setup instructions for remote machine conversions.

변환 중 문제Issues during conversion

  • 일부 설치 관리자는 종료 코드 259로 변환하지 못할 수 있습니다.Some installers might fail to convert with exit code 259. 이는 설치 관리자가 스레드를 생성했지만 완료되길 기다리지 않았음을 나타냅니다.This indicates that the installer spawned a thread and did not wait for it to complete. 즉, 주 스레드의 설치가 완료되었으나 여전히 실행 중인 스레드를 생성했으므로 오류 259로 인해 종료되었습니다.In other words, the main thread finished installing but it exited with error 259 because it spawned a thread that is still running. setup.exe에 대한 적절한 설치 옵션을 사용하는 것이 좋습니다.We recommend that you use the appropriate install option for setup.exe.

서명 중 문제Issues during signing

잘못 된 PE 인증서 (0x800700C1)Bad PE certificate (0x800700C1)

인증서가 손상 된 이진 파일이 패키지에 포함 되어 있는 경우이 문제가 발생 합니다.This problem occurs when the package contains a binary file that has a corrupt certificate. 이 문제를 해결 하려면 명령을 사용 하 여 dumpbin.exe /headers 파일 헤더를 덤프 하 고 잘못 된 요소를 검사 합니다.To resolve this issue, use the dumpbin.exe /headers command to dump the file headers and inspect for bad elements. 헤더를 수동으로 다시 작성 하 여 문제를 해결 하십시오.Manually rewrite the headers to fix the issue. 일반적으로 MSIX 패키징 도구는 잘못 된 헤더를 자동으로 검색 합니다.In general, the MSIX Packaging tool automatically detects bad headers. 이 문제가 지속 되 면 파일 피드백을 작성 합니다.If this issue persists, file feedback. 자세한 내용은 여기를 참조하세요.More information can be found here.

Device Guard 서명Device Guard signing

이러한 단계 를 수행 하 고 비즈니스에 대 한 Microsoft Store에서 적절 한 역할을 할당 하 고 있는지 확인 합니다.Make sure to follow these steps and that you are assigning the appropriate roles in the Microsoft Store for Business.

만료된 인증서Expired certificate

  • 패키지에 서명할 때 타임 스탬프를 사용 합니다.Use a timestamp when you sign your package.
  • 유효한 기호 또는 타임 스탬프 인증서를 사용 하 여 포기 할 수 있습니다.You can resign with a valid sign or timestamp certificate.

일괄 처리 변환 스크립트를 사용 하 여 앱을 포기 할 수 있습니다.You can resign your app using the batch conversion script.

문제 해결Troubleshooting

로그 파일Log files

변환의 성공 여부와 상관 없이 변환할 때마다 로그 파일이 생성됩니다.Whether or not your conversion was successful, log files are generated for every conversion. 자세한 내용은 여기에서 확인할 수 있습니다.They can be found here:

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

오류 코드는 기록되고 변환 과정 중 실패 지점을 나타냅니다.Failure codes are written and indicate any point of failure during the conversion process. 오류 코드는 사용자가 알아보기 쉽습니다.The error codes are meant to be user friendly.

원격 디바이스 또는 VM의 로그 파일Log files from remote devices or VMs

원격 디바이스 또는 VM에서 변환이 수행된 경우 해당 디바이스에서 로그 파일을 복사한 후 피드백 항목의 일부로 첨부하는 것이 좋습니다.If the conversion is performed on a remote device or a VM, we recommend that you copy the log files from that device and attach them as part of the feedback item. 그러면 문제를 보다 효율적으로 진단하고 해결하는 데 도움이 됩니다.This will help us diagnose and resolve issues more efficiently.

여기(%localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt)에서 원격 변환의 로그를 확인할 수 있습니다.You will find the logs from the remote conversions here: %localappdata%\packages\Microsoft.MsixPackagingTool_8wekyb3d8bbwe\LocalState\DiagOutputDir\<Logs_#>\RemoteServer\Log.txt

로컬 클라이언트와 원격 서버에서 발생 하는 작업을 포함 하는 전체 로그 폴더를 공유할 수 있는 경우에도 더 유용 합니다.It would even more beneficial if you can share the whole Logs folder that will include the operations occurring on the local client as well the remote server.

일반적인 문제Common problems

MakePri/Manifest 변환 오류MakePri/Manifest translation errors

이 오류는 패키지의 매니페스트에 문제가 있는 경우에 발생 합니다.This error occurs when there is an issue with the package’s manifest. 이 문제를 확인 하려면 패키지 편집기로 이동 하 여 매니페스트를 엽니다.To identify the issue, go to Package Editor and open the manifest. 매니페스트를 열 때 문제를 식별 하 고 적절 한 수정 사항을 제공할 수 있습니다.When you open the manifest, you can identify the issue and provide the proper fix.

파일을 찾을 수 없음File not found

파일이 열려 있거나 존재 하지 않을 수 있습니다.The file may either be open or non-existent. 이 문제를 해결 하려면 적절 한 파일을 추가 하거나 현재 사용 중인 파일을 닫으십시오.To resolve this issue, add the appropriate file or close the file that is currently in use. File not Found열린 경우 오류가 발생 하지 않습니다.Note that you will not get a File not Found error if it is open. 대신 또는 오류를 받게 됩니다 Access Denied File in Use .Instead, you’ll get an Access Denied or File in Use error.

파일 유형 연결File Type Associations

FTA (파일 유형 연결)와 관련 된 문제는 패키지 마다 다릅니다.The issues regarding File Type Associations (FTA) vary from package to package. MSIX 패키징 도구는 두 번 클릭 설치에 대 한 파일 연결을 지원 합니다.MSIX Packaging Tool support file associations for double click installs. 예를 들어 앱이 상황에 맞는 메뉴를 포함 하는 경우 자동으로 추가 되지 않으므로 매니페스트에 수동으로 추가 해야 합니다.For example, if your app has context menu, it is not automatically added, so you will need to add it manually to the manifest. 예는 desktop4: FileExplorerContextMenus manifest 요소를 참조 하세요.See the desktop4:FileExplorerContextMenus manifest element for an example.

인수가 있는 바로 가기Shortcuts with arguments

인수가 있는 바로 가기는 현재 MSIX에서 지원 되지 않습니다.Shortcuts with arguments are not currently supported with MSIX. 설치 관리자에 이러한 항목이 포함 된 것을 감지 하면 MSIX에서 인수 없이 타일을 만듭니다.If we detect that the installer includes these, MSIX will create a tile with no arguments.

설치 디렉터리Install directory

이는 보조 드라이브를 사용 하 여 앱 변환을 수행 하는 사용자에 게 더 일반적입니다.This is more common for those who use a secondary drive to perform app conversions. 설치 위치를 변경 하도록 선택 하는 경우 모든 파일이 이동 되는의 루트를 변경 합니다.If you choose to change the installation location, it changes the root of where all of the files go. 즉, MSIX 패키징 도구는 이러한 모든 파일이 이동 하 고 변환 하는 동안 캡처되는 위치를 알고 있어야 합니다.This means that the MSIX Packaging tool will need to know where all these files go and will be captured during conversion.

패키지 지원 프레임 워크 쓰기를 사용 하 여 디렉터리 픽스를 설치 하면이 문제를 해결할 수 있습니다.You can fix this by using the Package Support Framework write to install directory fix. 이 기능을 MSIX 도구에서 기본적으로 기능으로 추가 하 여이를 1809로 허용 합니다.We have added this as a capability by default in the MSIX Tool, which allows this down to 1809. 응용 프로그램이 1709에서 작동 하지 않고 1809에 있는 경우이 문제가 발생할 수 있습니다.If your application isn't working in 1709 and is in 1809, this is likely the issue.

피드백 보내기Sending feedback

피드백을 보내는 가장 좋은 방법은 피드백 허브를 통하는 것입니다.The best way to send your feedback is through the Feedback Hub.

  1. 피드백 허브를 열거나 Windows + F를 입력합니다.Open Feedback Hub or type Windows + F.
  2. 문제를 재현하기 위해 제목 및 필요한 단계를 제공합니다.Provide a title and necessary steps to reproduce the issue.
  3. 범주에서 을 선택한 후 MSIX 패키징 도구를 선택합니다.Under Category, select Apps and select MSIX Packaging Tool.
  4. 변환과 연결된 로그 파일을 첨부합니다.Attach any log files associated to the conversion. 위에 제공된 폴더에서 로그를 찾을 수 있습니다.You can find the logs in the folder provided above.
  5. 변환된 MSIX 패키지를 첨부합니다(가능한 경우).Attach the converted MSIX package (if possible).
  6. 제출을 클릭합니다.Click Submit.

또한 설정피드백 탭으로 이동하여 MSIX 패키징 도구에서 직접 피드백을 보낼 수도 있습니다.You can also send us feedback directly from the MSIX Packaging Tool by going to the Feedback tab under Settings.

참고

피드백이 전달되는 데 24시간이 걸릴 수 있습니다.It may take 24 hours for your feedback to get to us. 따라서 VM을 사용하여 패키지를 변환하는 경우 변환 후 24시간 동안 VM을 켜놓고 현재 상태를 유지하는 것이 좋습니다.Therefore if you are using a VM to convert your package, you may want to keep your VM on and in its current state for 24 hours after conversion. 또한 변환 로그를 피드백에 수동으로 연결할 수 있습니다.Also, you can manually attach conversion logs to the feedback.