Bartek Szafko

W poprzednich częściach o WiX:

• część 1 – wstęp teoretyczny o instalatorach
• część 2 – pierwszy instalator
• część 3 – dodanie interfejsu użytkownika
• część 4 – customizacja interfejsu użytkownika

W tej części omówie możliwości WiX jeśli chodzi o tworzenie skrótów do naszej aplikacji z menu start oraz pulpitu.

W instalatorach możemy tworzyć dwa rodzaje skrótów advertised i unadvertised.

Advertised

Skróty tego typu mogą się odwoływać tylko do plików, które są częścią instalatora. Za to podlegają np.: procesowi naprawy. Mogą być osadzone bezpośrednio w komponencie, który zawiera plik do którego mają wskazywać.

Przy okazji – jako best practice mogę polecić trzymanie struktury folderów i komponentów osobno – dzięki temu łatwiej będzie zmieniać lokalizację komponentów.

Poniżej przykład stworzonych skrótów typu Advertised(kluczowy jest element Shortcut oraz atrybut Advertise):

<Directory Id="TARGETDIR" Name="SourceDir">
  <Directory Id="ProgramFilesFolder">
    <Directory Id="D_INSTALLLOCATION" Name="$(var.Manufacturer) $(var.ProductName)"/>
  </Directory>
  <Directory Id="DesktopFolder"/>
  <Directory Id="ProgramMenuFolder">
    <Directory Id="D_MenuStartManufacturer" Name="$(var.Manufacturer)">
      <Directory Id="D_MenuStartProduct" Name="$(var.ProductName)"/>
    </Directory>
  </Directory>
</Directory>

<DirectoryRef Id="D_INSTALLLOCATION">
  <Component Id="C_ProductComponent" Guid="0c8acba5-46b2-472a-ab89-771dda833ab7">
    <File Id="F_c2csiexe" Source="$(var.SolutionDir)c2csi\bin\$(var.Configuration)\c2csi.exe" KeyPath="yes">
      <Shortcut Id="S_MenuStartShortcut" Name="C2C" Advertise="yes" Directory="D_MenuStartProduct" Icon="I_c2csi.exe"/>
      <Shortcut Id="S_DesktopShortcut" Name="C2C" Advertise="yes" Directory="DesktopFolder" Icon="I_c2csi.exe"/>
    </File>
  </Component>
</DirectoryRef>
<Icon Id="I_c2csi.exe" SourceFile="$(var.SolutionDir)c2csi\bin\$(var.Configuration)\c2csi.exe"/>

Przy okazji mała ciekawostka – okazało się że nazwa Id zdefiniowanej ikony musi kończyć się .exe tak jak plik do którego wskazuje skrót. Z innych ciekawostek – na Viście miałem problem z usuwaniem folderów z menu start, musiałem dodać fake komponent, który zadziałał przy usuwaniu:

<DirectoryRef Id="D_MenuStartProduct">
  <Component Id="C_FakeMenuStart" Guid="92476C56-1D38-4b5e-97E7-E83F5E9917C9">
    <RegistryKey Root="HKCU" Key="Software\$(var.Manufacturer)\$(var.ProductName)\Uninstall">
      <RegistryValue Value="Fake" Type="string" KeyPath="yes"/>
    </RegistryKey>
    <RemoveFolder Id="R_MenuStartManufacturer" Directory="D_MenuStartManufacturer" On="uninstall"/>
    <RemoveFolder Id="R_MenuStartProduct" Directory="D_MenuStartProduct" On="uninstall"/>
  </Component>
</DirectoryRef>

Powyższe przykłady dodadzą, skróty dla aktualnie zalogowanego użytkownika, natomiast jeśli chcemy dodać je dla wszystkich użytkowników ( do profilu All Users) wystarczy tylko dodać:

<Property Id="ALLUSERS"><![CDATA[2]]></Property>

Unadvertised

Skróty tego typu mogą sie odwoływać do dowolnego pliku  w systemie, z tym że nie podlegają już mechanizmowi naprawy instalacji. Trzeba też tworzyć osobny komponent dla tych skrótów i stworzyć element keypath,  po których silnik instalacji sprawdzi czy dany komponent jest zainstalowany – musi to być  to wpis w rejestrze systemowym, a nie plik tak ja w poprzednim przykładzie.

<DirectoryRef Id="D_MenuStartProduct">
  <Component Id="C_UnadvertisedShortcuts" Guid="2CBF2F3D-1B06-4102-A8A4-963E49FEADF3">
    <RegistryKey Root="HKCU" Key="Software\$(var.Manufacturer)\$(var.ProductName)\Uninstall">
      <RegistryValue Value="UnadvertisedShortcuts" Type="string" KeyPath="yes"/>
    </RegistryKey>
    <Shortcut Id="S_MenuStartUnadvertisedShortcut" Name="C2C" Advertise="no" Target="[#F_c2csiexe]" Directory="D_MenuStartProduct" Icon="I_c2csi.exe"/>
  </Component>
</DirectoryRef>

Metodę unadvertised zastosujemy np.: w sytuacji gdy chcielibyśmy dodać skrót do odinstalowania aplikacji w menu start.

Pomysły

Tak się zastanawiam, czy może na lato nie byłoby warto przgotować warsztatów z WiX – czy wogóle byliby jacyś chętni, jak myślicie?