SolutionPackager 도구를 사용하여 솔루션 파일 압축 및 추출
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
SolutionPackager는 이러한 파일을 원본 제어 시스템에서 쉽게 관리할 수 있도록 Microsoft Dynamics 365의 압축 솔루션 파일을 여러 XML 파일 및 기타 파일로 역방향으로 분해할 수 있는 도구입니다. 다음 섹션에서는 도구를 실행하는 방법과 관리형 및 비관리형 솔루션에 도구를 사용하는 방법을 보여 줍니다.
이 항목의 내용
SolutionPackager 도구를 찾을 수 있는 위치
SolutionPackager 명령줄 인수
/map 명령 인수 사용
폴더 매핑
파일 간 매핑
파일과 경로 매핑
예제 매핑
관리형 솔루션 및 비관리형 솔루션
SolutionPackager 도구를 찾을 수 있는 위치
SolutionPackager.exe 도구는 Microsoft Dynamics 365 SDK 다운로드의 Bin 폴더에서 찾을 수 있습니다. Microsoft Dynamics CRM SDK 패키지를 다운로드합니다.
SolutionPackager 명령줄 인수
SolutionPackager는 다음 표에서 식별된 매개 변수와 함께 호출할 수 있는 명령줄 도구입니다.
인수 |
설명 |
|---|---|
/action: {Extract|Pack} |
필수 특성: 수행할 작업입니다. 작업은 솔루션 .zip 파일을 폴더로 추출하거나 폴더를 .zip 파일로 압축할 수 있습니다. |
/zipfile: <file path> |
필수 특성: 솔루션 .zip 파일의 경로 및 이름입니다. 추출할 때 파일이 있어야 읽을 수 있습니다. 압축할 때 파일이 바뀝니다. |
/folder: <folder path> |
필수 특성: 폴더 경로입니다. 추출할 때 이 폴더가 만들어지고 구성 요소 파일로 채워집니다. 압축할 때 이 폴더가 이미 있어야 하며 이전에 추출한 구성 요소 파일이 들어 있습니다. |
/packagetype: {Unmanaged|Managed|Both} |
선택 사항. 처리할 패키지 유형입니다. 기본값은 비관리형입니다. 패키지 유형은 .zip 파일 또는 구성 요소 파일 내에서 읽을 수 있으므로 이 인수는 대부분의 경우 생략할 수 있습니다. 추출하고 Both를 지정할 때 관리형 및 비관리형 솔루션 .zip 파일이 있어야 하며 한 폴더로 처리되어야 합니다. 압축하고 Both를 지정할 때 관리형 및 비관리형 .zip 파일이 한 폴더에서 생성됩니다. 자세한 내용은 이 항목의 뒷부분에 있는 관리형 및 비관리형 솔루션 작업 관련 섹션을 참조하십시오. |
/allowWrite:{Yes|No} |
선택 사항. 기본값은 Yes입니다. 이 인수는 추출하는 동안에만 사용됩니다./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)을 사용할 수 있습니다. |
/map 명령 인수 사용
다음은 /map 인수를 SolutionPackager 도구에 사용하는 방법에 대해 설명합니다.
.xapSilverlight 파일 및 플러그인 어셈블리 같은 자동 구축 시스템에 구축된 파일은 일반적으로 소스 컨트롤에 체크되지 않습니다. 웹 리소스는 SolutionPackager 도구와 직접 호환되지 않는 위치의 원본 제어에 이미 있을 수 있습니다./map 매개 변수를 포함하여 SolutionPackager 도구는 일반적으로 수행되는 Extract 폴더 내부가 아니라 다른 위치에서 이러한 파일을 읽고 패키지하도록 안내할 수 있습니다./map 매개 변수는 매핑 지시문이 포함된 XML 파일에 대한 이름과 경로를 지정해야 합니다. 지시문은 SolutionPackager에서 이름과 경로로 파일을 연결하고 연결된 파일을 찾도록 대상 위치를 나타냅니다. 다음 정보는 모든 지시문에 동일하게 적용됩니다.
동일한 파일을 연결하는 지시문을 포함하여 여러 지시문이 나열될 수 있습니다. 파일에서 빨리 나오는 지시문은 나중에 나오는 지시문보다 우선합니다.
파일이 지시문에 연결되어 있으면 적어도 하나 이상의 다른 위치에 있어야 합니다. 맞는 대안이 없을 경우 SolutionPackager에서 오류가 발생합니다.
폴더 및 파일 경로는 절대 또는 상대 경로일 수 있습니다. 상대 경로는 항상 /folder 매개 변수로 지정한 폴더에서 평가됩니다.
환경 변수는 %variable% 문을 사용하여 지정할 수 있습니다.
폴더 와일드 카드 "**"는 "모든 하위 폴더에서"를 의미하는 데 사용할 수 있습니다. 경로의 마지막 부분으로만 사용할 수 있습니다. "c:\folderA\**"를 예로 들 수 있습니다.
파일 이름 와일드카드는 “*.ext” 또는 “*.*” 양식에서만 사용할 수 있습니다. 다른 패턴은 지원되지 않습니다.
세 가지 유형의 지시문 매핑과 이러한 매핑을 사용하는 방법을 보여 주는 예제가 함께 설명되어 있습니다.
폴더 매핑
다음 표에서는 폴더 매핑에 대해 자세히 설명합니다.
Xml 형식 |
<Folder map="folderA" to="folderB" /> |
설명 |
“folderA”를 연결하는 파일 경로는 “folderB”로 전환됩니다.
|
예제 |
|
파일 간 매핑
다음 표에서는 파일 간 매핑에 대해 자세히 설명합니다.
Xml 형식 |
<FileToFile map="path\filename.ext" to="path\filename.ext" /> |
설명 |
map 매개 변수에 맞는 모든 파일은 to에 지정된 이름 및 경로에서 읽습니다. map 매개 변수의 경우
to 매개 변수의 경우
|
예제 |
|
파일과 경로 매핑
다음 표에서는 파일과 경로 매핑에 대해 자세히 설명합니다.
Xml 형식 |
<FileToPath map="path\filename.ext" to="path" /> |
설명 |
map 매개 변수에 맞는 모든 파일은 to 매개 변수에 지정된 경로에서 읽습니다. map 매개 변수의 경우
to 매개 변수의 경우
|
예제 |
|
예제 매핑
다음 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>
관리형 솔루션 및 비관리형 솔루션
Microsoft Dynamics 365 압축 솔루션 (.zip) 파일은 다음과 같이 두 가지 유형 중 하나로 내보낼 수 있습니다.
- 관리형 솔루션
조직에 가져올 준비가 된 완성된 솔루션입니다. 가져오면 필요에 따라 추가로 사용자 지정할 수 있지만 구성 요소를 추가하거나 제거할 수 없습니다. 솔루션 개발이 완료되면 이 솔루션이 권장됩니다.
- 비관리형 솔루션
추가, 제거 또는 수정할 수 있는 제한이 없는 열린 솔루션입니다. 이 솔루션은 솔루션 개발 중에 권장됩니다.
압축 솔루션 파일의 형식은 솔루션 유형(관리형 또는 비관리형)에 따라 다릅니다. 두 유형 모두 SolutionPackager에서 압축 솔루션 파일을 처리할 수 있습니다. 하지만 이 도구는 한 유형을 다른 유형으로 변환할 수 없습니다. 솔루션 파일을 다른 유형으로 변환(예: 비관리형에서 관리형으로)하는 유일한 방법은 비관리형 솔루션 .zip 파일을 Microsoft Dynamics 365 서버에 가져온 후 솔루션을 관리형 솔루션으로 내보내는 것입니다.
SolutionPackager는 비관리형 및 관리형 솔루션 .zip 파일을 /PackageType:Both 매개 변수를 통해 결합된 설정으로 처리할 수 있습니다. 이 작업을 수행하려면 다음과 같이 .zip 파일 이름을 지정하여 각 유형으로 두 번 솔루션을 내보내야 합니다.
비관리형 .zip 파일: AnyName.zip |
관리형 .zip 파일: AnyName_managed.zip |
이 도구는 관리형 zip 파일이 비관리형 파일과 같은 폴더에 있다고 가정하고 차이를 유지하면서 관리형 및 비관리형 구성 요소가 있는 하나의 폴더에 두 파일을 모두 추출합니다.
솔루션이 비관리형 및 관리형 둘 다로 추출된 후 만들 유형을 지정하도록 /PackageType 매개 변수를 사용하여 하나의 폴더에서 둘 다를 압축하거나 또는 유형별로 각각 압축할 수 있습니다. 둘 다 지정 하면 위와 같이 명명 규칙을 사용하여 .zip 파일 두 개가 생성됩니다. 이중 관리형 및 비관리형 폴더에서 압축할 때 /PackageType 매개 변수가 없으면 기본값은 비관리형 .zip 파일을 하나 생성하는 것입니다.
문제 해결
솔루션 패키저에 의해 생성된 리소스 파일을 편집하기 위해 Microsoft Visual Studio 2012를 사용하는 경우, 다시 패킹할 때 이 같은 메시지를 받을 수 있습니다: “리소스 파일 <filename>.resx의 버전 ID를 알 수 없음. 패킹 프로세스의 일환으로 사용될 solutionpackager.exe 툴에서 리소스 파일을 내보내야 합니다.” 이것은 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 리소스 편집기를 사용할 때만 관찰됩니다.
참고 항목
팀 개발을 위한 솔루션 도구
솔루션 파일로 원본 제어 사용
Solution component file reference (SolutionPackager)
솔루션 소개
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보