SolutionPackager 도구

아티클
05/12/2023

SolutionPackager는 Microsoft Dataverse 압축 솔루션 파일을 여러 XML 파일 및 다른 파일로 가역적으로 분해할 수 있는 도구입니다. 그런 다음 소스 제어 시스템을 사용하여 이러한 파일을 쉽게 관리할 수 있습니다. 다음 섹션에서는 도구를 실행하는 방법과 관리형 및 비관리형 솔루션에 도구를 사용하는 방법을 보여 줍니다.

SolutionPackager 도구를 찾을 수 있는 위치

SolutionPackager 도구는 Microsoft.CrmSdk.CoreTools NuGet 패키지의 일부로 배포됩니다. 프로그램을 설치하려면 다음 단계를 따르십시오.

NuGet 패키지를 다운로드합니다.
패키지 파일 이름 확장명을 .nupkg에서 .zip으로 바꿉니다.
압축(zip) 파일의 내용을 추출합니다.

<extracted-folder-name>/contents/bin/coretools 폴더에서 SolutionPackager.exe 실행 파일을 찾을 수 있습니다. Coretools 폴더에서 프로그램을 실행하거나 해당 폴더를 PATH에 추가하십시오.

SolutionPackager 명령줄 인수

SolutionPackager는 다음 표에서 식별된 매개 변수와 함께 호출할 수 있는 명령줄 도구입니다.

인수	Description
/action: {Extract\|Pack}	필수. 수행할 작업입니다. 작업은 솔루션 .zip 파일을 폴더로 추출하거나 폴더를 .zip 파일로 압축할 수 있습니다.
/zipfile: <file path>	필수. 솔루션 .zip 파일의 경로 및 이름입니다. 추출할 때 파일이 존재하고 읽을 수 있어야 합니다. 압축할 때 파일이 바뀝니다.
/folder: <folder path>	필수. 폴더 경로입니다. 추출할 때 이 폴더가 만들어지고 구성 요소 파일로 채워집니다. 압축할 때 이 폴더가 이미 있어야 하며 이전에 추출한 구성 요소 파일이 들어 있습니다.
/packagetype: {Unmanaged\|Managed\|Both}	선택 사항. 처리할 패키지 유형입니다. 기본값은 비관리형입니다. 패키지 유형은 .zip 파일 또는 구성 요소 파일 내에서 읽을 수 있으므로 이 인수는 대부분의 경우 생략할 수 있습니다. 추출하고 Both를 지정할 때 관리형 및 비관리형 솔루션 .zip 파일이 있어야 하며 한 폴더로 처리되어야 합니다. 압축하고 Both를 지정할 때 관리형 및 비관리형 .zip 파일이 한 폴더에서 생성됩니다. 자세한 내용은 이 항목의 뒷부분에 있는 관리형 및 비관리형 솔루션 작업 관련 섹션을 참조하십시오.
/allowWrite:{Yes\|No}	선택 사항. 기본값은 예입니다. 이 인수는 추출하는 동안에만 사용됩니다. /allowWrite:No를 지정하면 도구에서 모든 작업을 수행하지만 파일을 작성하거나 삭제하지 않도록 합니다. 추출 작업은 기존 파일을 덮어쓰거나 삭제하지 않고 안전하게 평가할 수 있습니다.
/allowDelete:{Yes\|No\|Prompt}	선택 사항. 기본값은 Prompt입니다. 이 인수는 추출하는 동안에만 사용됩니다. /allowDelete:Yes를 지정하면 /folder 매개 변수로 지정된 폴더에 있는 예상되지 않은 모든 파일은 자동으로 삭제됩니다. /allowDelete:No를 지정하면 삭제 작업이 수행되지 않습니다. /allowDelete:Prompt를 지정하면 모든 삭제 작업을 허용할지 아니면 거부할지 콘솔을 통해 사용자에게 묻습니다. /allowWrite:No를 지정하면 /allowDelete:Yes가 지정되어 있어도 삭제 작업이 수행되지 않습니다.
/clobber	선택 사항. 이 인수는 추출하는 동안에만 사용됩니다. /clobber를 지정하면 읽기 전용 특성 집합이 있는 파일을 덮어쓰거나 삭제합니다. 지정하지 않으면 읽기 전용 특성이 파일을 덮어쓰거나 삭제하지 않습니다.
/errorlevel: {Off\|Error\|Warning\|Info\|Verbose}	선택 사항. 기본값은 Info입니다. 이 인수는 출력할 로깅 정보의 수준을 나타냅니다.
/map: <file path>	선택 사항. 파일 매핑 지시문이 들어 있는 .xml 파일의 경로와 이름입니다. 추출 하는 동안 일반적으로 파일은 /folder 매개 변수로 지정된 폴더 내부에서 읽고, 매핑 파일에 지정된 다른 위치에서 읽습니다. 압축 작업 중 지시문에 맞는 파일은 기록되지 않습니다.
/nologo	선택 사항. 런타임 시 배너를 표시하지 않습니다.
/log: <file path>	선택 사항. 로그 파일의 경로와 이름입니다. 파일이 이미 있으면 새 로깅 정보가 파일에 추가됩니다.
@ <file path>	선택 사항. 도구에 대한 명령줄 인수가 포함된 파일의 경로와 이름입니다.
/sourceLoc: <string>	선택 사항. 이 인수는 템플릿 리소스 파일을 생성하고 추출 시에만 유효합니다. 가능한 값은 `auto` 또는 내보내려는 언어에 대한 LCID/ISO 코드입니다. 이 인수를 사용하면 지정된 로캘의 문자열 리소스가 중립 .resx 파일로 추출됩니다. `auto` 또는 길거나 짧은 형식의 스위치를 지정하면 기본 로캘 또는 솔루션이 사용됩니다. 짧은 형식의 명령(/src)을 사용할 수 있습니다.
/localize	선택 사항. 모든 문자열 리소스를 .resx 파일에 추출하거나 병합합니다. 짧은 형식의 명령(/loc)을 사용할 수 있습니다. 지역화 옵션은 .resx 파일에 대한 공유 구성 요소를 지원합니다. 추가 정보: RESX 웹 리소스 사용

/map 명령 인수 사용

다음은 /map 인수를 SolutionPackager 도구에 사용하는 방법에 대해 설명합니다.

.xap Silverlight 파일 및 플러그 인 어셈블리와 같은 자동화된 빌드 시스템에서 빌드된 파일은 일반적으로 원본 제어에 체크 인되지 않습니다. 웹 리소스는 SolutionPackager 도구와 직접 호환되지 않는 위치의 원본 제어에 이미 있을 수 있습니다. /map 매개 변수를 포함하여 SolutionPackager 도구는 일반적으로 수행되는 Extract 폴더 내부가 아니라 다른 위치에서 이러한 파일을 읽고 패키지하도록 안내할 수 있습니다. /map 매개 변수는 매핑 지시문을 포함하는 XML 파일의 이름과 경로를 지정해야 합니다. 이러한 지시문은 이름과 경로로 파일을 일치시키고 일치하는 파일을 찾기 위한 대체 위치를 나타내도록 SolutionPackager에 지시합니다. 다음 정보는 모든 지시문에 동일하게 적용됩니다.

동일한 파일과 일치하는 지시어를 포함하여 여러 지시어가 나열될 수 있습니다. 파일의 초기에 나열된 지시문은 나중에 나열된 지시문보다 우선합니다.
파일이 지시문에 연결되어 있으면 적어도 하나 이상의 다른 위치에 있어야 합니다. 맞는 대안이 없을 경우 SolutionPackager에서 오류가 발생합니다.
폴더 및 파일 경로는 절대 또는 상대 경로일 수 있습니다. 상대 경로는 항상 /folder 매개 변수로 지정한 폴더에서 평가됩니다.
환경 변수는 %variable% 문을 사용하여 지정할 수 있습니다.
폴더 와일드 카드 “**”는 "모든 하위 폴더에서"를 의미하는 데 사용할 수 있습니다. 경로의 마지막 부분으로만 사용할 수 있습니다(예: “c:\folderA\**”).
파일 이름 와일드카드는 “*.ext” 또는 “*.*” 양식에서만 사용할 수 있습니다. 다른 패턴은 지원되지 않습니다.

세 가지 유형의 지시문 매핑과 이러한 매핑을 사용하는 방법을 보여 주는 예제가 함께 설명되어 있습니다.

폴더 매핑

다음 정보에서는 폴더 매핑에 대해 자세히 설명합니다.

Xml 형식

<Folder map="folderA" to="folderB" />

설명

“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" />

설명

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" />

설명

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 sub-folders -->  
       <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를 사용하는 경우, 다시 패킹할 때 이 같은 메시지를 받을 수 있습니다: “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 리소스 편집기를 사용할 때만 관찰됩니다.

참조

솔루션 파일로 원본 제어 사용

솔루션 개념

SolutionPackager 도구