Office 솔루션의 응용 프로그램 매니페스트

아티클
08/10/2011

응용 프로그램 매니페스트는 Microsoft Office 솔루션에 로드되는 어셈블리를 설명하는 XML 파일입니다. Visual Studio의 Microsoft Office 개발 도구는 ClickOnce 응용 프로그램 매니페스트 참조에 정의된 ClickOnce 응용 프로그램 매니페스트 스키마를 사용합니다.

Office 솔루션용 응용 프로그램 매니페스트에서는 다음과 같은 ClickOnce 요소 및 특성을 사용합니다.

요소	설명	특성
<assembly> 요소(ClickOnce 응용 프로그램)	필수적 요소로서, 최상위 요소.	manifestVersion
<assemblyIdentity> 요소(ClickOnce 응용 프로그램)	필수적 요소로서, ClickOnce 응용 프로그램의 주 어셈블리를 식별합니다.	name version publicKeyToken processorArchitecture language
<trustInfo> Element (ClickOnce Application)	응용 프로그램 보안 요구 사항을 식별합니다.	없음
<entryPoint> 요소(ClickOnce 응용 프로그램)	필수적 요소로서, 응용 프로그램 실행을 위한 코드 진입점을 식별합니다.	name dependencyName customHostSpecified
<dependency> 요소(ClickOnce 응용 프로그램)	필수적 요소로서, 응용 프로그램 실행에 필요한 각 종속성을 식별합니다. 사전 설치해야 하는 어셈블리를 식별할 수도 있습니다.	없음
<file> 요소(ClickOnce 응용 프로그램)	필수적 요소로서, 응용 프로그램에 사용되는 어셈블리 이외의 각 파일을 식별합니다. 파일과 관련된 COM(Component Object Model) 격리 데이터가 포함될 수 있습니다.	name size

Office 솔루션용 응용 프로그램 매니페스트의 co.v1 네임스페이스에는 다음 요소가 있습니다.

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

또한 이러한 응용 프로그램 매니페스트의 vstav3 네임스페이스에는 다음과 같은 요소 및 특성이 있습니다.

<addIn>
  <entryPointsCollection>
    <entryPoints>
      <entryPoint>
      </entryPoint>
    </entryPoints>
  </entryPointsCollection>
  <update></update>
  <postActions>
    <postAction>
      <postActionData>
      </postActionData>
    <postAction>
  </postActions>
  <application>
    <customizations>
      <customization>
      </customization>
    </customizations>
  </application
</addIn>

요소	설명	특성
<customHostSpecified> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, 매니페스트를 명확하게 Office 솔루션으로 표시합니다.	없음
<addin> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, 진입점을 단일 네임스페이스에 저장합니다.	없음
<entryPointsCollection> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, 하나 이상의 Office 솔루션에 대한 모든 어셈블리를 그룹화합니다.	id
<entryPoints> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, Office 솔루션을 실행할 모든 어셈블리를 그룹화합니다.	없음
<entryPoint> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, Office 솔루션에서 실행할 어셈블리를 식별합니다.	class contract
<update> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, 솔루션의 업데이트를 구성합니다.	enabled expiration
<postActions> 요소(Visual Studio에서 Office 개발)	선택적 요소로서, Office 솔루션을 설치한 후 실행할 모든 배포 후 작업을 그룹화합니다.	없음
<postAction> 요소(Visual Studio에서 Office 개발)	선택적 요소로서, 배포 후 작업을 식별합니다.	없음
<postActionData> 요소(Visual Studio에서 Office 개발)	선택적 요소로서, 배포 후 작업에 대한 데이터를 구성합니다.	없음
<application> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, 응용 프로그램 관련 정보를 단일 노드에 래핑합니다.	없음
<customizations> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, 모든 응용 프로그램 호스트 관련 정보를 별도의 네임스페이스에 저장합니다.	없음
<customization> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, 응용 프로그램 호스트 관련 정보를 별도의 네임스페이스에 저장합니다.	xmlns
<document> 요소(Visual Studio에서 Office 개발)	문서 수준 솔루션의 경우에만 필수 요소입니다. 사용자 지정 관련 정보를 저장합니다.	solutionId
<appAddin> 요소(Visual Studio에서 Office 개발)	응용 프로그램 수준 솔루션의 경우에만 필수 요소입니다. 사용자 지정 관련 정보를 저장합니다.	application loadBehavior keyName
<friendlyName> 요소(Visual Studio에서 Office 개발)	선택적 요소로서, 설치된 추가 기능 목록에 나타나는 추가 기능의 이름을 저장합니다.	없음
<description> 요소(Visual Studio에서 Office 개발)	응용 프로그램 수준 추가 기능의 경우에만 필수 요소입니다. 설치된 프로그램 목록에 나타나는 설명을 저장합니다.	없음
<formRegions> 요소(Visual Studio에서 Office 개발)	양식 영역이 포함된 Outlook 2007 추가 기능의 경우에만 필수 요소입니다.	없음
<formRegion> 요소(Visual Studio에서 Office 개발)	양식 영역이 포함된 Outlook 2007 추가 기능의 경우에만 필수 요소입니다.	Name
<vstoRuntime> 요소(Visual Studio에서 Office 개발)	필수적 요소로서, Office 솔루션에서 지원되는 특정 버전의 Visual Studio Tools for Office 런타임을 설명합니다.	release version supportUrl

설명

Office 솔루션에서 응용 프로그램 및 배포 매니페스트를 수동으로 편집할 수 있습니다. 이후에는 매니페스트 생성 및 편집 도구(mage.exe 및 mageui.exe)를 사용하여 응용 프로그램 및 배포 매니페스트에 다시 서명해야 합니다. 자세한 내용은 방법: 응용 프로그램 및 배포 매니페스트에 다시 서명을 참조하십시오.

파일 위치

응용 프로그램 매니페스트는 솔루션의 단일 버전에 대해 고유합니다. 따라서 응용 프로그램 매니페스트는 배포 매니페스트와는 별도로 저장해야 합니다. Visual Studio에서는 게시 폴더의 Application Files 하위 디렉터리에서 관련 버전을 따라 이름이 지정된 하위 디렉터리에 버전별 파일을 배치합니다.

파일 이름 구문

응용 프로그램 매니페스트 파일의 이름은 assemblyIdentity 요소로 식별되는 응용 프로그램의 전체 이름과 확장명 뒤에 .manifest 확장명을 추가한 형식이어야 합니다. 예를 들어 OutlookAddIn1.dll 사용자 지정을 나타내는 응용 프로그램 매니페스트에서는 다음과 같은 파일 이름 구문을 사용합니다.

OutlookAddIn1.dll.manifest

문서 수준 사용자 지정 예제

설명

다음 코드 예제에서는 Visual Studio Tools for Office 솔루션과 관련된 응용 프로그램 매니페스트 섹션을 보여 줍니다. 이 예제에서는 Microsoft Office Excel 2007 문서 수준 사용자 지정을 설명합니다.

코드

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.ThisWorkbook">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet1">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet2">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet3">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:document 
          solutionId="73e" />
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

응용 프로그램 수준 추가 기능 예제

설명

다음 코드 예제에서는 Visual Studio Tools for Office 솔루션과 관련된 응용 프로그램 매니페스트 섹션을 보여 줍니다. 이 예제에서는 양식 영역이 포함된 Microsoft Office Outlook 2007 응용 프로그램 수준 추가 기능을 설명합니다.

코드

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoOutlookAddIn.ThisAddIn">
        <assemblyIdentity 
          name="ContosoOutlookAddIn" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:appAddIn 
          application="Outlook" 
          loadBehavior="3" 
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook add-in 
            created with Visual Studio Tools for Office
          </vstov4:description>
          <vstov4:formRegions>
            <vstov4:formRegion
                name="OutlookAddIn1.FormRegion1">
              <vstov4:messageClass name="IPM.Note" />
              <vstov4:messageClass name="IPM.Contact" />
              <vstov4:messageClass name="IPM.Appointment" />
            </vstov4:formRegion>
          </vstov4:formRegions>
        </vstov4:appAddIn>
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

다중 프로젝트 배포 예제

설명

다음 코드 예제에서는 Visual Studio Tools for Office 솔루션과 관련된 응용 프로그램 매니페스트 섹션을 보여 줍니다. 이 예제에서는 양식 영역이 포함된 Microsoft Office Outlook 2007 응용 프로그램 수준 추가 기능과 Microsoft Excel 2007 문서 수준 사용자 지정을 설치하는 다중 프로젝트 배포에 대해 설명합니다.

코드

  <entryPoint>
    <co.v1:customHostSpecified />
  </entryPoint>
[...]
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoExcelWorkbook.dll" 
      size="12800">
      <assemblyIdentity 
        name="ContosoExcelWorkbook" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>ONF</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoOutlookAddIn.dll" 
      size="10240">
      <assemblyIdentity 
        name="ContosoOutlookAddIn" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>i4e</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <vstav3:addIn 
    xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
    <vstav3:entryPointsCollection>
      <vstav3:entryPoints 
        id="ContosoExcel">
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.ThisWorkbook">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet1">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet2">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet3">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
      <vstav3:entryPoints 
        id="ContosoOutlook">
        <vstav3:entryPoint 
          class="ContosoOutlookAddIn.ThisAddIn">
          <assemblyIdentity 
            name="ContosoOutlookAddIn" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
    </vstav3:entryPointsCollection>
    <vstav3:update 
      enabled="true">
      <vstav3:expiration 
        maximumAge="7" 
        unit="days" />
    </vstav3:update>
    <vstav3:application>
      <vstov4:customizations 
        xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
        <vstov4:customization 
          id="ContosoExcel">
          <vstov4:document 
            solutionId="73ec4ba9-a983-40b3-af63-5fb172ea81db" />
        </vstov4:customization>
        <vstov4:customization 
          id="ContosoOutlook">
          <vstov4:appAddIn 
            application="Outlook" 
            loadBehavior="3" 
            keyName="ContosoOutlookAddIn">
            <vstov4:friendlyName>
              ContosoOutlookAddIn
            </vstov4:friendlyName>
            <vstov4:description>
              ContosoOutlookAddIn - Outlook add-in created with 
              Visual Studio Tools for Office
            </vstov4:description>
          </vstov4:appAddIn>
        </vstov4:customization>
      </vstov4:customizations>
    </vstav3:application>
  </vstav3:addIn>

배포 후 작업 예제

설명

다음 코드 예제에서는 Visual Studio Tools for Office 솔루션과 관련된 응용 프로그램 매니페스트 섹션을 보여 줍니다. 이 예제에서는 설치 작업이 완료된 후 레지스트리 키를 만드는 배포 후 작업에 대해 설명합니다.

코드

<vstav3:postActions>
  <vstav3:postAction>
    <vstav3:entryPoint 
      class="PostDeploymentAction.PostDeploymentActionSample">
      <assemblyIdentity 
        name="PostDeploymentAction" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
    </vstav3:entryPoint>
    <vstav3:postActionData>
    </vstav3:postActionData>
  </vstav3:postAction>
</vstav3:postActions>

참고 항목

참조

Office 솔루션의 배포 매니페스트

ClickOnce 응용 프로그램 매니페스트

Share via