팩터리 OS 이미지에 앱 추가

아티클
08/02/2022
읽는 데 7분 걸림

Windows 시스템 키트에는 유니버설 Windows 앱을 팩터리 OS 이미지에 더 쉽게 추가할 수 있는 스크립트가 포함되어 있습니다. 이러한 스크립트는 작업 영역에 추가하는 앱에 따라 기능 매니페스트 파일을 자동으로 만들거나 업데이트합니다.

이미 실행 중인 이미지에 앱을 추가하려면 장치 포털을 사용하여 연결을 참조하세요.

필수 구성 요소

WSK 작업 영역
패키지에 올바르게 포함된 유니버설 Windows 앱 하나 이상

앱 수집

관리자 PC에서 앱이 지원하는 모든 아키텍처(x64, x86, ARM)에 대한 모든 종속성 및 라이선스 파일을 포함하여 .msix, .msixbundles, .appx, .appxbundle 파일을 모두 수집합니다.
작업 영역의 기본 앱 폴더에 앱을 저장합니다(예: C:\Workspace\Apps\). 앱이 각각 자체 폴더에 있는 경우 하위 폴더를 사용해도 됩니다. 스크립트로 앱을 찾을 수 있습니다.

동일한 종속성 파일을 포함하는 여러 앱이 있어도 괜찮습니다. 종속성 파일은 최종 이미지에 한 번만 추가됩니다.

이 샘플에서는 Microsoft에서 제공하는 UWP(유니버설 Windows 플랫폼) 앱으로서 WSK와 함께 번들로 제공되는 계산기 앱을 사용합니다. UWP 앱 샘플의 앱을 사용해도 되고, 자신의 앱을 대신 사용해도 됩니다.

작업 영역에 포함된 앱 FM에 앱 추가

작업 영역에는 OEMInput.xml 파일에 이미 포함되어 있는 빈 앱 FM이 있습니다. 이미지에 앱을 추가하려면 WSK의 스크립트를 사용하여 앱 FM에 앱을 추가합니다. 이 FM을 사용하지 않고 새 앱 FM을 만들어 OEMInput.xml 파일에 포함하는 방법을 알아보려면 새 앱 FM 만들기를 참조하세요.

작업 영역의 앱 FM에 앱을 추가합니다.

관리자 권한으로 Windows 시스템 키트 빌드 환경을 시작합니다(예: 탑재된 WSK ISO에서 E:\SetImagGenEnv.cmd를 마우스 오른쪽 단추로 클릭하고 관리자 권한으로 실행을 클릭).
Windows 시스템 키트 빌드 환경에서 작업 영역 폴더로 이동합니다.
```
cd c:\Workspace
```
WSKWorkspaceRoot 업데이트 환경 변수가 사용자의 작업 영역을 가리키도록 작업 영역 루트 변수를 설정합니다.
```
C:\Workspace\SetWSKWorkspaceRoot.cmd
```
작업 영역에 있는 앱을 포함된 앱 FM에 추가합니다. WSK의 스크립트를 사용하여 작업 영역에 앱을 포함하도록 앱 FM을 업데이트합니다.

UpdateWSKAppsFM 스크립트를 실행하여 작업 영역 앱 폴더(%WSKWorkspaceRoot%\Apps)의 모든 앱을 OEMAppsFM.xml에 추가합니다. 이 FM에 나열된 모든 앱이 이미지에 포함됩니다.
```
UpdateWSKAppsFM
```
옵션을 지정하지 않으면 스크립트는 작업 영역의 앱 폴더에 있는 모든 앱을 포함하도록 %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml 파일을 업데이트합니다. 스크립트 옵션은 아래 UpdateWSKAppsFM 구문을 참조하세요.

기본적으로, 앱은 모든 이미지 디자인에 포함되지만 중앙 집중식 참고 자료를 사용하여 여러 이미지 디자인을 만드는 경우 앱 식별자를 추가하고 앱을 선택 사항으로 표시할 수 있습니다.

앱을 추가, 제거 또는 업데이트할 때는 UpdateWSKAppsFM을 다시 실행하여 기능 매니페스트에 변경 내용을 추가합니다. 기능 매니페스트에 다른 편집(예: 앱을 선택 사항으로 설정)을 수행했더라도 괜찮습니다. 스크립트는 그러한 변경 내용에 영향을 주지 않습니다.

새 앱 FM 만들기

Windows 시스템 키트의 스크립트를 사용하여 새 앱 FM을 만들 수 있습니다.

Windows 시스템 키트 환경에서

폴더에 포함할 앱을 배치합니다.
CreateWSKAppsFM 스크립트를 실행하여 앱 폴더에 모든 앱을 포함합니다. 새 앱 FM의 이름 및 앱 폴더를 지정합니다.
```
CreateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewApps
```
스크립트 옵션에 대해서는 아래 CreateWSKAppsFM 구문을 참조하세요.

이 스크립트는 각 앱의 위치를 포함하는 새 기능 매니페스트 파일을 생성합니다(예: %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml).

기본적으로, 앱은 모든 이미지 디자인에 포함되지만 중앙 집중식 참고 자료를 사용하여 여러 이미지 디자인을 만드는 경우 앱 식별자를 추가하고 앱을 선택 사항으로 표시할 수 있습니다.

새 앱 FM을 <AdditionalFM>으로 OEMInput.xml 파일에 추가합니다.

<AdditionalFM>%WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml</AdditionalFM>

앱을 추가, 제거 또는 업데이트할 때 UpdateWSKAppsFM을 실행하여 기능 매니페스트에 앱을 추가합니다. 기능 매니페스트에 다른 편집(예: 앱을 선택 사항으로 설정)을 수행했더라도 괜찮습니다. 스크립트는 이러한 변경 내용에 영향을 주지 않습니다.
```
UpdateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewApps
```

앱 FM 스크립트 구문

CreateWSKAppsFM 구문

CreateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}

매개 변수	설명
-FMFile [경로]	만들려는 FM 파일의 경로입니다. 기본적으로 `%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml`을 업데이트합니다.
-AppsFolder [경로]	앱을 검색하고자 하는 폴더의 경로입니다. 기본적으로 `%WSKWorkspaceRoot%\Apps`를 검색합니다.
-IncludeWow	amd64 이미지에서 x86에 대한 지원을 추가하고 arm64 이미지에서 ARM에 대한 지원을 추가합니다.

UpdateWSKAppsFM 구문

UpdateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}

매개 변수	설명
-FMFile [경로]	업데이트하려는 FM 파일의 경로입니다. 기본적으로 `%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml`을 만들거나 대체합니다.
-AppsFolder [경로]	앱을 검색하고자 하는 폴더의 경로입니다. 기본적으로 `%WSKWorkspaceRoot%\Apps`를 검색합니다.
-IncludeWow	설정할 경우, amd64에 x86을, arm64 이미지에 ARM을 추가합니다.