SolutionPackager는 Microsoft Dataverse 압축된 솔루션 파일을 여러 XML 파일 및 기타 파일로 역방향으로 분해할 수 있는 도구입니다. 그런 다음 소스 제어 시스템을 사용하여 이러한 파일을 쉽게 관리할 수 있습니다. 다음 섹션에서는 도구를 실행하는 방법과 관리형 및 비관리형 솔루션에 도구를 사용하는 방법을 보여 줍니다.
중요
SolutionPackager 도구는 더 이상 솔루션 압축을 풀고 포장하는 데 권장되는 방법이 아닙니다. SolutionPackager 도구의 기능은 Power Platform CLI에 통합됩니다.
pac solution 명령에는 SolutionPackager 도구의 동일한 기본 기능을 통합하는 unpack, pack, clone, sync 등의 많은 동사가 있습니다.
SolutionPackager 도구를 찾을 수 있는 위치
SolutionPackager 도구는 Microsoft.CrmSdk.CoreTools NuGet 패키지의 일부로 배포됩니다. 프로그램을 설치하려면 다음 단계를 따르십시오.
- NuGet 패키지를 다운로드합니다.
- 패키지 파일 이름 확장명을 .nupkg에서 .zip으로 바꿉니다.
- 압축(zip) 파일의 내용을 추출합니다.
<extracted-folder-name>/contents/bin/coretools 폴더에서 SolutionPackager.exe 실행 파일을 찾으세요. Coretools 폴더에서 프로그램을 실행하거나 해당 폴더를 PATH에 추가하십시오.
SolutionPackager 명령줄 인수
SolutionPackager는 다음 표에서 식별된 매개 변수와 함께 호출할 수 있는 명령줄 도구입니다.
| 인수 | 설명 |
|---|---|
| /action: {추출|패키지} | 필수. 수행할 동작입니다. 작업은 솔루션 .zip 파일을 폴더로 추출하거나 폴더를 .zip 파일로 압축할 수 있습니다. |
| /zipfile: <파일 경로> | 필수. 솔루션 .zip 파일의 경로 및 이름입니다. 추출할 때 파일이 존재하고 읽을 수 있어야 합니다. 압축할 때 파일이 바뀝니다. |
| /folder: <폴더 경로> | 필수. 폴더 경로입니다. 추출할 때 이 폴더가 만들어지고 구성 요소 파일로 채워집니다. 압축할 때 이 폴더가 이미 있어야 하며 이전에 추출한 구성 요소 파일이 들어 있습니다. |
| /packagetype: {관리되지 않음|관리형|둘 다} | 선택 사항. 처리할 패키지 유형입니다. 기본값은 비관리형입니다. 패키지 유형은 .zip 파일 또는 구성 요소 파일 내에서 읽을 수 있으므로 이 인수는 대부분의 경우 생략할 수 있습니다. 추출하고 Both를 지정할 때 관리형 및 비관리형 솔루션 .zip 파일이 있어야 하며 한 폴더로 처리되어야 합니다. 압축하고 Both를 지정할 때 관리형 및 비관리형 .zip 파일이 한 폴더에서 생성됩니다. 자세한 내용은 이 문서의 뒷부분에 있는 관리형 및 비관리형 솔루션 작업 관련 섹션을 참조하십시오. |
| /allowWrite:{예|아니요} | 선택 사항. 기본값은 예입니다. 이 인수는 추출하는 동안에만 사용됩니다. /allowWrite:No를 지정하면 도구에서 모든 작업을 수행하지만 파일을 작성하거나 삭제하지 않도록 합니다. 추출 작업은 기존 파일을 덮어쓰거나 삭제하지 않고 안전하게 평가할 수 있습니다. |
| /allowDelete:{예|아니오|프롬프트} | 선택 사항. 기본값은 Prompt입니다. 이 인수는 추출하는 동안에만 사용됩니다. /allowDelete:Yes를 지정하면 /folder 매개 변수로 지정된 폴더에 있는 예상되지 않은 모든 파일은 자동으로 삭제됩니다. /allowDelete:No를 지정하면 삭제 작업이 수행되지 않습니다. /allowDelete:Prompt를 지정하면 모든 삭제 작업을 허용할지 아니면 거부할지 콘솔을 통해 사용자에게 묻습니다. /allowWrite:No를 지정하면 /allowDelete:Yes가 지정되어 있어도 삭제 작업이 수행되지 않습니다. |
| /clobber | 선택 사항. 이 인수는 추출하는 동안에만 사용됩니다. /clobber를 지정하면 읽기 전용 특성 집합이 있는 파일을 덮어쓰거나 삭제합니다. 지정하지 않으면 읽기 전용 특성이 있는 파일은 덮어쓰거나 삭제되지 않습니다. |
| /errorlevel: {Off|오류|경고|정보|상세} | 선택 사항. 기본값은 Info입니다. 이 인수는 출력할 로깅 정보의 수준을 나타냅니다. |
| /map: <파일 경로> | 선택 사항. 파일 매핑 지시문이 들어 있는 .xml 파일의 경로와 이름입니다. 추출 하는 동안 일반적으로 파일은 /folder 매개 변수로 지정된 폴더 내부에서 읽고, 매핑 파일에 지정된 다른 위치에서 읽습니다. 팩 작업 중에 지시문과 일치하는 파일은 기록되지 않습니다. |
| /nologo | 선택 사항. 런타임 시 배너를 억제합니다. |
| /log: <파일 경로> | 선택 사항. 로그 파일의 경로와 이름입니다. 파일이 이미 있으면 새 로깅 정보가 파일에 추가됩니다. |
| @ <파일 경로> | 선택 사항. 도구에 대한 명령줄 인수가 포함된 파일의 경로와 이름입니다. |
| /sourceLoc: <문자열> | 선택 사항. 이 인수는 템플릿 리소스 파일을 생성하고 추출 시에만 유효합니다. 가능한 값은 auto 또는 내보내려는 언어에 대한 LCID/ISO 코드입니다. 이 인수를 사용하면 지정된 로캘의 문자열 리소스가 중립 .resx 파일로 추출됩니다.
auto 또는 스위치의 길거나 짧은 형식만 지정된 경우, 기본 지역 설정이나 솔루션이 사용됩니다. 짧은 형식의 명령(/src)을 사용할 수 있습니다. |
| /localize | 선택 사항. 모든 문자열 리소스를 .resx 파일에 추출하거나 병합합니다. 짧은 형식의 명령(/loc)을 사용할 수 있습니다. 지역화 옵션은 .resx 파일에 대한 공유 구성 요소를 지원합니다. 추가 정보: RESX 웹 리소스 사용 |
| /솔루션이름: <이름> | 선택 사항. 원본 폴더에 여러 솔루션이 포함된 경우 압축하거나 추출할 솔루션의 고유 이름입니다 solutions/*/solution.yml. 둘 이상의 솔루션이 검색될 때 필요합니다. YAML 소스 제어 형식에만 적용됩니다. 명령의 짧은 형식인 /sn을 사용할 수 있습니다. |
| /remapPluginTypeNames | 선택 사항. 지정된 경우, 플러그인의 완전한 정규화된 형식 이름은 솔루션에 포함된 어셈블리에 따라 재매핑됩니다. 기본적으로 YAML 소스 제어 형식으로 사용하도록 설정됩니다. 명령의 짧은 형식인 /fp를 사용할 수 있습니다. |
소스 제어 파일 형식
SolutionPackager는 솔루션을 추출하고 압축할 때 두 개의 폴더 레이아웃을 지원합니다.
XML 형식(레거시)
원래 형식입니다. 솔루션 메타데이터는 Other\Solution.xml 및 Other\Customizations.xml에 저장되고, 모든 구성 요소 파일은 해당 파일과 함께 평면 폴더 계층 구조로 추출됩니다. 이 형식은 더 많은 구성 없이 파일을 추출할 때 기본 형식입니다 .zip .
YAML 소스 제어 형식
Dataverse Git 통합과 함께 도입된 이 형식은 구조화된 폴더 계층 구조에 분산된 YAML 파일로 솔루션 메타데이터를 저장합니다. Power Apps 네이티브 Git 통합을 사용하여 솔루션을 커밋할 때 작성된 형식입니다.
XML 형식보다 장점
- 소스 제어에서 더 깨끗하고 읽기 쉬운 구성 요소별 차이 생성
- 단일 리포지토리 폴더에서 여러 솔루션 지원
- 캔버스 앱
.msapp파일 및 최신 흐름은 이 형식에서만 지원됩니다. - 플러그 인 형식 이름 다시 매핑은 기본적으로 사용하도록 설정됩니다.
필수 폴더 구조
<rootFolder>/
├── solutions/
│ └── <SolutionUniqueName>/
│ ├── solution.yml (solution metadata)
│ ├── solutioncomponents.yml (paths to all component files)
│ ├── rootcomponents.yml (root-level components)
│ └── missingdependencies.yml (dependency info)
├── publishers/
│ └── <PublisherUniqueName>/
│ └── publisher.yml (publisher definition)
├── entities/ (entity components, if present)
├── workflows/ (classic workflows, if present)
├── modernflows/ (Power Automate cloud flows, if present)
├── canvasapps/ (canvas app .msapp files, if present)
└── [other component folders]/
중요
YAML 형식은 solutions/ 하위 폴더에 *solution.yml 파일이 포함되어 있을 때 자동으로 감지됩니다.
YAML 매니페스트 파일(solution.ymlsolutioncomponents.yml등)이 아래solutions/<SolutionUniqueName>/가 아닌 폴더의 루트에 배치되는 경우 도구는 YAML 형식을 검색하지 않습니다. 도구는 XML 경로로 되돌아가, Customizations.xml가 누락되었다는 잘못된 오류를 보고합니다. 이 문제를 해결하는 방법에 대한 자세한 내용은 문제 해결 을 참조하세요.
추가 정보: 솔루션 YAML 소스 제어 형식 참조
자동 검색 규칙 서식 지정
| 상태 | 사용되는 형식 |
|---|---|
solutions/*/solution.yml found — 정확히 하나의 솔루션 |
폴더에서 솔루션 이름을 유추하는 YAML 형식 |
solutions/*/solution.yml 발견됨 — 여러 솔루션 |
인수가 /SolutionName 필요한 YAML 형식 |
하위 디렉터리가 없음 solutions/ |
XML 형식(레거시) |
YAML 형식 폴더 압축
다음 명령은 YAML 형식 폴더를 압축합니다.
SolutionPackager.exe /action:Pack /zipfile:MySolution.zip /folder:C:\repos\myrepo
다중 솔루션 폴더에서 패키징
다음 명령은 다중 솔루션 폴더에 지정된 솔루션을 압축합니다.
SolutionPackager.exe /action:Pack /zipfile:SolutionA.zip /folder:C:\repos\myrepo /SolutionName:SolutionA
/map 명령 인수 사용
다음은 /map 인수를 SolutionPackager 도구에 사용하는 방법에 대해 설명합니다.
.xap Silverlight 파일 및 플러그 인 어셈블리와 같은 자동화된 빌드 시스템에서 빌드된 파일은 일반적으로 원본 제어에 체크 인되지 않습니다. 웹 리소스는 SolutionPackager 도구와 직접 호환되지 않는 위치의 원본 제어에 이미 있을 수 있습니다. /map 매개 변수를 포함하여 SolutionPackager 도구는 일반적으로 수행되는 Extract 폴더 내부가 아니라 다른 위치에서 이러한 파일을 읽고 패키지하도록 안내할 수 있습니다. /map 매개 변수는 매핑 지시문을 포함하는 XML 파일의 이름과 경로를 지정해야 합니다. 이러한 지시문은 이름과 경로로 파일을 일치시키고 일치하는 파일을 찾기 위한 대체 위치를 나타내도록 SolutionPackager에 지시합니다. 다음 정보는 모든 지시문에 동일하게 적용됩니다.
동일한 파일과 일치하는 지시어를 포함하여 여러 지시어가 나열될 수 있습니다. 파일의 초기에 나열된 지시문은 나중에 나열된 지시문보다 우선합니다.
파일이 지시문에 연결되어 있으면 적어도 하나 이상의 다른 위치에 있어야 합니다. 맞는 대안이 없을 경우 SolutionPackager에서 오류가 발생합니다.
폴더 및 파일 경로는 절대 또는 상대 경로일 수 있습니다. 상대 경로는 항상 /folder 매개 변수로 지정한 폴더에서 평가됩니다.
환경 변수는 %variable% 문을 사용하여 지정할 수 있습니다.
폴더 와일드카드 "**"는 "모든 하위 폴더"를 의미하는 데 사용할 수 있습니다. 경로의 마지막 부분(예: "c:\folderA\**")으로만 사용할 수 있습니다.
파일 이름 와일드카드는 "*.ext" 또는 "*.*" 형식에서만 사용할 수 있습니다. 다른 패턴은 지원되지 않습니다.
세 가지 유형의 지시문 매핑과 이러한 매핑을 사용하는 방법을 보여 주는 예제가 함께 설명되어 있습니다.
폴더 매핑
다음 정보에서는 폴더 매핑에 대해 자세히 설명합니다.
XML 형식
<Folder map="folderA" to="folderB" />
Description
"folderA"가 일치하는 파일 경로는 "folderB"로 전환됩니다.
각 하위 폴더의 계층 구조는 정확히 맞아야 합니다.
폴더 와일드카드는 지원되지 않습니다.
파일 이름을 지정할 수 없습니다.
예제
<Folder map="folderA" to="folderB" /> <Folder map="folderA\folderB" to="..\..\folderC\" /> <Folder map="WebResources\subFolder" to="%base%\WebResources" />
파일 간 매핑
다음 정보는 파일 간 매핑에 대해 자세히 설명합니다.
XML 형식
<FileToFile map="path\filename.ext" to="path\filename.ext" />
Description
map 매개 변수에 맞는 모든 파일은 to 매개 변수에 지정된 이름 및 경로에서 읽습니다.
map 매개 변수의 경우
파일 이름을 지정해야 합니다. 경로는 선택 사항입니다. 경로를 지정하지 않으면 모든 폴더에서 파일을 연결할 수 있습니다.
파일 이름 와일드카드는 지원되지 않습니다.
폴더 와일드카드는 지원됩니다.
to매개 변수의 경우파일 이름과 경로를 지정해야 합니다.
파일 이름은
map매개 변수의 이름과 다를 수 있습니다.파일 이름 와일드카드는 지원되지 않습니다.
폴더 와일드카드는 지원됩니다.
예제
<FileToFile map="assembly.dll" to="c:\path\folder\assembly.dll" />
<FileToFile map="PluginAssemblies\**\this.dll" to="..\..\Plugins\**\that.dll" />
<FileToFile map="Webresrouces\ardvark.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\aardvark.jpg" />
<FileToFile
map="pluginpackages\cr886_PluginPackageTest\package\cr886_PluginPackageTest.nupkg"
to="myplg\bin\Debug\myplg.1.0.0.nupkg" />
위의 NuGet 패키지 예에서 cr886_PluginPackageTest.nupkg는 지정된 위치에 파일이 이미 존재하는 경우 덮어쓰이지 않습니다.
파일과 경로 매핑
다음에서는 파일-경로 간 매핑에 대해 자세히 설명합니다.
XML 형식
<FileToPath map="path\filename.ext" to="path" />
Description
map 매개 변수에 맞는 모든 파일은 to 매개 변수에 지정된 경로에서 읽습니다.
map 매개 변수의 경우
파일 이름을 지정해야 합니다. 경로는 선택 사항입니다. 경로를 지정하지 않으면 모든 폴더에서 파일을 연결할 수 있습니다.
파일 이름 와일드카드는 지원됩니다.
폴더 와일드카드는 지원됩니다.
to 매개 변수의 경우
경로를 지정해야 합니다.
폴더 와일드카드는 지원됩니다.
파일 이름을 지정하지 않아야 합니다.
예제
<FileToPath map="assembly.dll" to="c:\path\folder" />
<FileToPath map="PluginAssemblies\**\this.dll" to="..\..\Plugins\bin\**" />
<FileToPath map="*.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\" />
<FileToPath map="*.*" to="..\..\%ARCH%\%TYPE%\drop" />
예제 매핑
다음 XML 코드 샘플에서는 SolutionPackager 도구를 활성화하여 모든 웹 리소스와 CRMDevTookitSample이라는 개발자 도구 키트 프로젝트에서 생성된 두 가지 기본 어셈블리를 읽을 수 있는 전체 매핑 파일을 보여 줍니다.
<?xml version="1.0" encoding="utf-8"?>
<Mapping>
<!-- Match specific named files to an alternate folder -->
<FileToFile map="CRMDevTookitSamplePlugins.dll" to="..\..\Plugins\bin\**\CRMDevTookitSample.plugins.dll" />
<FileToFile map="CRMDevTookitSampleWorkflow.dll" to="..\..\Workflow\bin\**\CRMDevTookitSample.Workflow.dll" />
<!-- Match any file in and under WebResources to an alternate set of subfolders -->
<FileToPath map="WebResources\*.*" to="..\..\CrmPackage\WebResources\**" />
<FileToPath map="WebResources\**\*.*" to="..\..\CrmPackage\WebResources\**" />
</Mapping>
관리형 솔루션 및 비관리형 솔루션
Dataverse 압축 솔루션(.zip) 파일은 다음과 같이 두 가지 유형 중 하나로 내보낼 수 있습니다.
관리형 솔루션
조직에 가져올 준비가 된 완성된 솔루션입니다. 구성 요소를 가져온 후에는 추가 사용자 지정을 허용할 수 있지만 구성 요소를 추가하거나 제거할 수 없습니다. 솔루션 개발이 완료되면 이 솔루션이 권장됩니다.
관리되지 않는 솔루션
추가, 제거 또는 수정할 수 있는 제한이 없는 열린 솔루션입니다. 이 솔루션은 솔루션 개발 중에 권장됩니다.
압축 솔루션 파일의 형식은 솔루션 유형(관리형 또는 비관리형)에 따라 다릅니다. 두 유형 모두 SolutionPackager에서 압축 솔루션 파일을 처리할 수 있습니다. 그러나 도구는 한 형식을 다른 형식으로 변환할 수 없습니다. 솔루션 파일을 다른 유형으로 변환(예: 비관리형에서 관리형으로)하는 유일한 방법은 비관리형 솔루션 .zip 파일을 Dataverse 서버에 가져온 후 솔루션을 관리형 솔루션으로 내보내는 것입니다.
SolutionPackager는 비관리형 및 관리형 솔루션 .zip 파일을 /PackageType:Both 매개 변수를 통해 결합된 설정으로 처리할 수 있습니다. 이 작업을 수행하려면 다음과 같이 .zip 파일 이름을 지정하여 각 유형으로 두 번 솔루션을 내보내야 합니다.
비관리형 .zip 파일: AnyName.zip
관리형 .zip 파일: AnyName_managed.zip
이 도구는 관리형 zip 파일이 비관리형 파일과 같은 폴더에 있다고 가정하고 차이를 유지하면서 관리형 및 비관리형 구성 요소가 있는 하나의 폴더에 두 파일을 모두 추출합니다.
솔루션이 비관리형 및 관리형 둘 다로 추출된 후 만들 유형을 지정하도록 /PackageType 매개 변수를 사용하여 하나의 폴더에서 둘 다를 압축하거나 또는 유형별로 각각 압축할 수 있습니다. 두 파일을 모두 지정하면 위와 같은 명명 규칙을 사용하여 두 개의 .zip 파일이 생성됩니다. 이중 관리형 및 비관리형 폴더에서 압축할 때 /PackageType 매개 변수가 없으면 기본값은 비관리형 .zip 파일을 하나 생성하는 것입니다.
문제 해결
Visual Studio 사용하여 리소스 파일을 편집할 때 표시되는 메시지
Visual Studio를 사용하여 솔루션 패키저에서 만든 리소스 파일을 편집하는 경우, 다시 패키지할 때 다음과 유사한 메시지를 받을 수 있습니다: "Failed to determine version id of the resource file <filename>.resx the resource file must be exported from the solutionpackager.exe tool in order to be used as part of the pack process." 이러한 경우 Visual Studio가 리소스 파일의 메타데이터 태그를 데이터 태그로 바꾸기 때문입니다.
해결 방법
즐겨 사용하는 텍스트 편집기에서 리소스 파일을 열고, 다음 태그를 찾아 업데이트합니다.
<data name="Source LCID" xml:space="preserve"> <data name="Source file" xml:space="preserve"> <data name="Source package type" xml:space="preserve"> <data name="SolutionPackager Version" mimetype="application/x-microsoft.net.object.binary.base64"><data>에서<metadata>로 노드 이름을 변경합니다.예를 들어 다음 문자열은
<data name="Source LCID" xml:space="preserve"> <value>1033</value> </data>변경 사항:
<metadata name="Source LCID" xml:space="preserve"> <value>1033</value> </metadata>그러면 솔루션 패키지 작성 도구에서 리소스 파일을 읽고 가져올 수 있습니다. 이 문제는 Visual Studio 리소스 편집기를 사용하는 경우에만 관찰되었습니다.
오류: YAML 폴더가 있는 "필요한 파일을 찾을 수 없습니다.\Other\Customizations.xml"
이 오류는 YAML 파일(예: pac solution packYAML 파일이 포함된 폴더)에 대해 SolutionPackager(또는solution.yml)를 실행할 때 나타나지만 해당 파일은 필요한 solutions/<SolutionUniqueName>/ 하위 폴더 내부가 아닌 폴더의 루트에 배치됩니다.
원인: 이 도구는 파일이 포함된 하위 폴더를 solutions/ 찾아 YAML 소스 제어 형식을 검색합니다 *solution.yml . 해당 디렉터리가 없을 경우 도구는 조용히 XML(레거시) 형식으로 자동 전환되어 Other\Customizations.xml을 예상합니다. 결과 오류 메시지는 XML 파일을 참조하며 오해의 소지가 있는 YAML을 언급하지 않습니다.
수정: YAML 매니페스트 파일이 올바른 경로 아래에 있도록 폴더를 다시 구성합니다.
<rootFolder>/
solutions/<YourSolutionUniqueName>/ ← move solution.yml here
solution.yml
solutioncomponents.yml
rootcomponents.yml
missingdependencies.yml
publishers/<YourPublisherUniqueName>/
publisher.yml
Git 통합 커밋에서 폴더를 가져온 경우 폴더 pac solution clone구조가 이미 정확해야 합니다. 하위 디렉터리가 없는 solutions/ 최상위 YAML 파일만 포함하는 폴더는 불완전한 추출을 나타내며 직접 압축할 수 없습니다.
경고: rootcomponents.yml 선언된 구성 요소에 원본 파일이 없음
캔버스 앱과 같은 구성 요소가 나열되지만 rootcomponents.yml 예상 구성 요소 폴더(예 canvasapps/<schema-name>/: )에 해당 소스 파일이 없는 경우 이 경고가 나타납니다.
효과: 도구는 여전히 성공하고(종료 코드 0) 유효한 .zip 파일을 생성하지만 선언된 구성 요소는 패키지된 솔루션에서 생략됩니다.
원인: 폴더가 부분 추출에 의해 생성되었거나 구성 요소의 원본 파일이 리포지토리에 포함되지 않았습니다. 예를 들어 솔루션 매니페스트 파일만 커밋되었고 캔버스 앱 자체는 커밋되지 않았습니다.
수정: 선언된 모든 구성 요소에 rootcomponents.yml 해당 원본 파일이 폴더에 있는지 확인합니다. 캔버스 앱의 경우, .msapp 파일은 canvasapps/<schema-name>/에 있어야 합니다. 파일이 누락된 경우 Dataverse에서 전체 솔루션을 다시 내보내고 다시 압축을 풀거나 전체 추출을 가져오는 데 사용합니다 pac solution clone .
참조
- 솔루션 파일에 소스 제어 사용
- 솔루션 개념