[wix] WiX 트릭과 팁

동일한 소스 파일을 사용하여 Live, Test, Training, … 버전 만들기

간단히 말해서 : 각 설치 프로그램에 대해 고유 한 UpgradeCode를 작성하고 각 설치 프로그램에 대해 각 Guid의 첫 번째 문자를 자동으로 정의하고 나머지 31 개는 고유하게 유지하십시오.

전제 조건

• MSBuild 커뮤니티 작업

가정

• WiX 변수는 UpgradeCode, ProductName, InstallName을 정의하는 데 사용됩니다.
• 이미 작동중인 설치 프로그램이 있습니다. 당신이 할 때까지 나는 이것을 시도하지 않을 것입니다.
• 모든 구성 요소는 하나의 파일 (Components.wxs)에 보관됩니다. 이 프로세스는 파일이 여러 개인 경우 작동하지만 더 많은 작업이 필요합니다.

디렉토리 구조

• Setup.Library
  • 모든 wx 파일 (구성 요소, 기능, UI 대화 상자 등)
  • Common.Config.wxi (ProductCode = “*”, ProductVersion, PlatformProgramFilesFolder, …)
• Setup.Live (wixproj)
  • “기존 파일 추가”-> “링크로 추가”(Visual Studio의 추가 버튼 옆에있는 작은 아래쪽 화살표 버튼)를 사용하여 모든 Setup.Library 파일을 연결합니다.
  • Config.wxi (고유 한 UpgradeCode, ProductName, InstallName 등이 있음)
• 설정 테스트 , …
  • 라이브에 따라 Config.wxi가 테스트 환경에 대해 구성되어 있습니다.

방법

• Setup.Library 디렉토리를 작성하고 기존 프로젝트에서 모든 wx 및 wxi 파일 (Config.wxi 제외)을 이동하십시오.
• 일반적인 wixproj에 따라 Setup.Live, Setup.Test 등을 작성하십시오.
• Setup.Live 등의 wixproj에 BeforeBuild 대상을 추가하여 MSBuild 커뮤니티 작업 파일 업데이트 수행 를 수정합니다 (A는 라이브, B는 테스트, C는 교육)
• AfterBuild 대상을 추가하여 Components.wxs Guid를 다시 0으로 되돌립니다.
• Orca에서 각 MSI의 각 구성 요소에 수정 된 guid가 있는지 확인하십시오.
• 원래 guid가 복원되었는지 확인하십시오.
• 각 MSI가 올바른 제품 및 위치를 설치 (및 업그레이드)하고 있는지 확인하십시오.

Config.wxi 예

<?xml version="1.0" encoding="utf-8"?>
<Include>
<!-- Upgrade code should not change unless you want to install
     a new product and have the old product remain installed,
     that is, both products existing as separate instances. -->
<?define UpgradeCode = "YOUR-GUID-HERE" ?>

<!-- Platform specific variables -->
<?if $(var.Platform) = x64 ?>
  <!-- Product name as you want it to appear in Add/Remove Programs-->
  <?define ProductName = "Foo 64 Bit [Live]" ?>
<?else ?>
  <?define ProductName =  "Foo [Live]" ?>
<?endif ?>

<!-- Directory name used as default installation location -->
<?define InstallName = "Foo [Live]" ?>

<!-- Registry key name used to store installation location -->
<?define InstallNameKey = "FooLive" ?>

<?define VDirName = "FooLive" ?>
<?define AppPoolName = "FooLiveAppPool" ?>
<?define DbName = "BlahBlahLive" ?>
</Include>

Config.Common.wxi 예

<?xml version="1.0" encoding="utf-8"?>
<Include>
<!-- Auto-generate ProductCode for each build, release and upgrade -->
<?define ProductCode = "*" ?>

<!-- Note that 4th version (Revision) is ignored by Windows Installer -->
<?define ProductVersion = "1.0.0.0" ?>

<!-- Minimum version supported if product already installed and this is an upgrade -->
<!-- Note that 4th version (Revision) is ignored by Windows Installer -->
<?define MinimumUpgradeVersion = "0.0.0.0" ?>

<!-- Platform specific variables -->
<?if $(var.Platform) = x64 ?>
   <?define Win64 = "yes" ?>
   <?define PlatformProgramFilesFolder = "ProgramFiles64Folder" ?>
<?else ?>
   <?define Win64 = "no" ?>
   <?define PlatformProgramFilesFolder = "ProgramFilesFolder" ?>
<?endif ?>

<?define ProductManufacturer = "Foo Technologies"?>

<!-- Decimal Language ID (LCID) for the Product. Used for localization. -->
<?define ProductLanguage = "1033" ?>

<?define WebSiteName = "DefaultWebSite" ?>
<?define WebSitePort = "80" ?>

<?define DbServer = "(local)" ?>
</Include>

예제 Components.wxs

<?xml version="1.0" encoding="utf-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  <!-- The pre-processor variable which allows the magic to happen :) -->
  <?include $(sys.CURRENTDIR)\Config.wxi?>
  <?include ..\Setup.Library\Config.Common.wxi?>
  <Fragment Id="ComponentsFragment">
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="$(var.PlatformProgramFilesFolder)">
        <Directory Id="INSTALLLOCATION" Name="$(var.InstallName)">
          <Component Id="ProductComponent" Guid="0XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" KeyPath="yes">
          ...

참고 : 이제 구성 요소 *당 하나의 파일을 사용하고 파일을 키 경로로 설정하여 Guid 속성을 구성 요소 (와 동등한 )에서 제외하는 것이 좋습니다 . 이렇게하면 아래에 표시된 호출 ModifyComponentsGuids및 RevertComponentsGuids대상 이 필요하지 않습니다 . 그러나 모든 구성 요소에서 가능하지는 않습니다.

Setup.Live.wixproj 예제

<Import Project="$(MSBuildExtensionsPath)\MSBuildCommunityTasks\MSBuild.Community.Tasks.Targets" />
<Target Name="BeforeBuild">
  <CallTarget Targets="ModifyComponentsGuids" />
</Target>
<Target Name="AfterBuild">
  <CallTarget Targets="RevertComponentsGuids" />
</Target>
<!-- Modify the first character of every Guid to create unique value for Live, Test and Training builds -->
<Target Name="ModifyComponentsGuids">
  <FileUpdate Files="..\Setup.Library\Components.wxs" Regex="Guid=&quot;([a-f]|[A-F]|\d)" ReplacementText="Guid=&quot;A" />
</Target>
<!-- Revert the first character of every Guid back to initial value -->
<Target Name="RevertComponentsGuids">
  <FileUpdate Files="..\Setup.Library\Components.wxs" Regex="Guid=&quot;([a-f]|[A-F]|\d)" ReplacementText="Guid=&quot;0" />
</Target>

마지막 생각들

• 이 프로세스는 또한 동일한 설치 프로그램에 대해 서로 다른 병합 모듈 (라이브, 테스트 등의 기능)에 대해 다른 설치 프로그램을 작성하는 데에도 효과적입니다. 더 안전한 옵션 인 것처럼 다른 설치 프로그램을 사용했습니다. 다른 사람이 동일한 상자에 있고 다른 병합 모듈의 기능을 사용하는 경우 Training 대신 Live를 업그레이드 할 위험이 더 큽니다.
• MSI를 사용하여 업그레이드 및 새로 설치를 수행하는 경우 (예 : 주요 업그레이드 만 접근) 레지스트리에 설치 위치를 저장하는 경우 각 설치의 키 이름에 대한 변수를 작성하십시오.
• 또한 각 설치 프로그램마다 고유 한 가상 디렉터리 이름, 응용 프로그램 풀, 데이터베이스 이름 등을 사용할 수 있도록 각 Config.wxi에 변수를 만듭니다.

업데이트 1 : 구성 요소 자동 생성 Guids 는 각 파일에 대해 Guid = “*”를 사용하여 구성 요소를 생성하고 파일을 키 경로로 설정하면 FileUpdate 작업을 호출 할 필요가 없습니다.

업데이트 2 : 우리가 제기 한 문제 중 하나는 구성 요소 Guid를 자동 생성하지 않고 빌드가 실패하면 임시 파일을 수동으로 삭제해야한다는 것입니다.

업데이트 3 : svn : externals 및 임시 파일 생성에 대한 의존성을 제거하는 방법을 찾았습니다. 이렇게하면 빌드 프로세스가보다 탄력적이며 (Guids 와일드 카드를 사용할 수없는 경우 가장 좋은 옵션 임) 빛이나 양초에 빌드 실패가있을 경우 덜 부서지기 쉽습니다.

업데이트 4 : 인스턴스 변환을 사용 하는 다중 인스턴스 지원 은 WiX 3.0 이상 버전이므로 확실히 살펴볼 가치가 있습니다.

답변

Package.msi

c : \ Package.log