Wix: Using Patch Creation Properties - Small Update

Source Reference: wix help document  -- WiX Toolset License

Using Patch Creation Properties 

A patch contains the differences between one or more pairs of Windows Installer packages. The tool PatchWiz.dll in the Windows SDK compares pairs of packages and produces a patch using a file called a Patch Creation Properties (PCP) file.

It is recommended that you download the latest Windows SDK to get the newest tools for building patches.

Setting Up the Sample

A Patch Creation Properties (PCP) file instructs PatchWiz.dll to generate a patch from differences in one or more pairs of packages. A patch contains the differences between the target and upgrade packages, and will transform the target package to the upgrade package. Both the target and upgrade packages are created below.

Create a directory that will contain the sample

Create a directory from which you plan on running the sample. This will be the sample root.

md C:\sample

Create two subdirectories

Under the sample root create two subdirectories called "1.0" and "1.1".

md C:\sample\1.0

md C:\sample\1.1

Create a text file called Sample.txt for 1.0

Create a text file in the "1.0" directory called Sample.txt and put some text in it telling you that it is the 1.0 version of the file.

echo This is version 1.0 > C:\sample\1.0\Sample.txt

Create a text file called Sample.txt for 1.1

Create a text file in the "1.1" directory called Sample.txt and put some text in it telling you that it is the 1.1 version of the file.

echo This is version 1.1 > C:\sample\1.1\Sample.txt

Create your product authoring in the sample root folder

Create your product authoring in the sample root folder called Product.wxs with the following contents:

<?xml version="1.0" encoding="UTF-8"?>

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">

    <Product Id="48C49ACE-90CF-4161-9C6E-9162115A54DD"

        Name="WiX Patch Example Product"

        Language="1033"

        Version="1.0.0"

        Manufacturer="Dynamo Corporation"

        UpgradeCode="48C49ACE-90CF-4161-9C6E-9162115A54DD">

        <Package Description="Installs a file that will be patched."

            Comments="This Product does not install any executables"

            InstallerVersion="200"

            Compressed="yes" />

        <Media Id="1" Cabinet="product.cab" EmbedCab="yes" />

        <FeatureRef Id="SampleProductFeature"/>

    </Product>

    <Fragment>

        <Feature Id="SampleProductFeature" Title="Sample Product Feature" Level="1">

            <ComponentRef Id="SampleComponent" />

        </Feature>

    </Fragment>

    <Fragment>

        <DirectoryRef Id="SampleProductFolder">

            <Component Id="SampleComponent" Guid="{C28843DA-EF08-41CC-BA75-D2B99D8A1983}" DiskId="1">

                <File Id="SampleFile" Name="Sample.txt" Source=".\$(var.Version)\Sample.txt" />

            </Component>

        </DirectoryRef>

    </Fragment>

    <Fragment>

        <Directory Id="TARGETDIR" Name="SourceDir">

            <Directory Id="ProgramFilesFolder" Name="PFiles">

                <Directory Id="SampleProductFolder" Name="Patch Sample Directory">

                </Directory>

            </Directory>

        </Directory>

    </Fragment>

</Wix>

Create your patch authoring in the sample root

Create your Patch Creation Properties (PCP) authoring in the sample root called Patch.wxs with the following content:

<?xml version="1.0" encoding="utf-8"?>

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">

    <PatchCreation

        Id="224C316C-5894-4771-BABF-21A3AC1F75FF"

        CleanWorkingFolder="yes"

        OutputPath="patch.pcp"

        WholeFilesOnly="yes"

        >

        <PatchInformation

            Description="Small Update Patch"

            Comments="Small Update Patch"

            ShortNames="no"

            Languages="1033"

            Compressed="yes"

            Manufacturer="Dynamo Corp"/>

        <PatchMetadata

            AllowRemoval="yes"

            Description="Small Update Patch"

            ManufacturerName="Dynamo Corp"

            TargetProductName="Sample"

            MoreInfoURL="http://www.dynamocorp.com/"

            Classification="Update"

            DisplayName="Sample Patch"/>

        <Family DiskId="5000"

            MediaSrcProp="Sample"

            Name="Sample"

            SequenceStart="5000">

            <UpgradeImage SourceFile="C:\sample\1.1\admin\product.msi" Id="SampleUpgrade">

                <TargetImage SourceFile="C:\sample\1.0\admin\product.msi" Order="2"     

                    Id="SampleTarget" IgnoreMissingFiles="no" />

            </UpgradeImage>

        </Family>

        <PatchSequence PatchFamily="SamplePatchFamily"

            Sequence="1.0.0.0"

            Supersede="yes" />

    </PatchCreation>

</Wix>

Note that SequenceStart must be greater than the last sequence in the File table in the target package or the patch will not install.

Build the Target and Upgrade Packages

Open a command prompt and make sure the following WiX and Windows Installer SDK tools are in your PATH.

  • Candle.exe
  • Light.exe
  • MsiMsp.exe
  • PatchWiz.dll
  • MSPatchC.dll
  • MakeCab.exe

Build the target package

candle.exe -dVersion=1.0 product.wxs

light.exe product.wixobj -out 1.0\product.msi

Perform an administrative installation of the target package

Msiexec.exe is used to perform an administrative installation but nothing is actually registered on your system. It is mainly file extraction.

msiexec.exe /a 1.0\product.msi /qb TARGETDIR=C:\sample\1.0\admin

Build the upgrade package

candle.exe -dVersion=1.1 product.wxs

light.exe product.wixobj -out 1.1\product.msi

Perform an administrative installation of the upgrade package

msiexec.exe /a 1.1\product.msi /qb TARGETDIR=C:\sample\1.1\admin

Build the Patch

The Patch.wxs file is compiled into a PCP file that is then processed by MsiMsp.exe to product the patch package.

candle.exe patch.wxs

light.exe patch.wixobj -out patch\1.1\patch.pcp

msimsp.exe -s patch\patch.pcp -p patch\1.1\patch.msp -l patch.log

Verify the Patch

To verify that the patch works, install the product and then the patch.

Install the 1.0 product

msiexec.exe /i 1.0\product.msi /l*vx install.log

Verify version 1.0

Go to "Program Files\Patch Sample Directory" and open Sample.txt. Verify that this is the 1.0 version. Close Sample.txt.

Install the patch

msiexec.exe /p patch\patch.msp /l*vx patch.log

Verify version 1.1

Go to "Program Files\Patch Sample Directory" and open Sample.txt. Verify that this is now the 1.1 version. Close Sample.txt.

Uninstall the patch

On Windows XP Service Pack 2 and Windows Server 2003, go to "Add/Remove Programs" in the Control Panel and make sure that Show Updates is checked. On Windows Vista and newer, go to "Programs" then "View installed updates" in the Control panel. Select "Sample Patch" from under "WiX Patch Example Product" and click the Uninstall button.

Go to "Program files\Patch Sample Directory" and open Sample.txt. Verify that this is again the 1.0 version. Close Sample.txt.

Uninstall the product

On Windows XP Service Pack 2 and Windows Server 2003, go to "Add/Remove Programs" in the Control Panel. On Windows Vista and newer, go to "Programs" then "Uninstall a program" in the Control Panel. Select "WiX Patch Example Product" and click the Uninstall button.

Restrictions

Please review restrictions on how patches must be built to avoid problem during patch installation.

时间： 2024-10-01 02:29:19

Wix: Using Patch Creation Properties - Small Update的相关文章

Wix: Using Patch Creation Properties - Minor Update

Based on the project created in Wix: Using Patch Creation Properties - Small Update, Following changes are made to make a minor upgrade: 1. Change Product Version. 2. Add MinorUpdateTargetRTM="1" under PatchMetadata node. Details see attachment:

From MSI to WiX, Part 1 - Required properties, by Alex Shevchuk

Following content is directly reprinted from From MSI to WiX, Part 1 - Required properties Author: Alex Shevchuk Introduction Today I will start a series of posts about creating an MSI installation package using WiX.  The goal here is to show what is

Install Windows Security Update/Patch

Keywords: Windows, security update, patch, KB2532531 If failed to install a update, follow steps below:1. Download the patch manually from Microsoft Update Catalog. Notes: Only IE is supported by the site.2. Install the download patch. It's done if t

WIX 安装部署教程(六) 为你收集的七个知识点

前段时间整理5篇WIX(Windows Installer XML)的安装教程,但还不够完善,这里继续整理了七个知识点分享给大家.WIX最新版本3.8,点击下载 WIX安装部署(一)同MSBuild自动生成打包文件 WIX安装部署(二)自定义安装界面和行为 WIX安装部署(三)自定义安装界面和行为 WIX安装部署(四)添加安装文件及快捷方式 WIX安装部署(五)Bootstrap 捆绑安装 1.设置路径变量 有的时候路径过长,文件又比较多,重复粘贴一个地址总是不舒服,而且要改起来也很麻烦,那这个

OpenWrt patch

Working with patches Prepare quilt configuration Adding a new patch Edit an existing patch Adding or editing kernel patches Adding or editing toolchain patches Naming patches Refreshing patches Iteratively modify patches without cleaning the source t

兔子--properties文件

Properties 在Android中,比起用纯字符串读写并自行解析,或是用xml来保存配置, Properties显得更简单和直观,因为自行解析需要大量代码,而xml的操作又远不及Properties方便 update.url=http://baidi... public static String getUpgradeUrl() { Properties prop = new Properties(); return prop.getProperty("update.url");

java中的Properties类的操作

java中有个比较重要的类:Properties类,该类主要用于读取java的配置文件.每种语言都自己所支持的配置文件.java中的配置常为*.perperties文件,文件格式为文本格式,内容格式为“健=值”对格式,文本注释信息可用#注释. Properties继承Hashtable 它提供了几个主要的方法: 1． getProperty ( String key),用指定的键在此属性列表中搜索属性.也就是通过参数 key ,得到 key 所对应的 value. 2． load ( Input

Matlab中所有自定义的函数

Functions By Category | Alphabetical List Language Fundamentals Entering Commands ans Most recent answer clc Clear Command Window diary Save Command Window text to file format Set display format for output home Send cursor home iskeyword Determine wh

OpenStack Identity API v3 (CURRENT)

Table Of Contents Identity API v3 (CURRENT) Authentication and token management Password authentication with unscoped authorization Password authentication with scoped authorization Password authentication with explicit unscoped authorization Token a