Tutorial Installer: Instalasi WiX Toolset (1 dari 5)

WiX Toolset

Tutorial installer ini membahas cara membuat installer aplikasi menggunakan WiX Toolset. Membuat installer merupakan tahap akhir dari siklus pembuatan aplikasi. Setelah program aplikasi selesai dibuat dan diuji, tahap selanjutnya adalah membuat paket instalasi untuk didistribusikan kepada pengguna akhir/konsumen.

Project artikel ini dapat diakses pada repositori Kodesiana pada https://github.com/Kodesiana/WixInstallerExample. Artikel ini merupakan artikel bersambung dengan urutan sebagai berikut.

  1. Tutorial Installer: Instalasi WiX Toolset (1 dari 5) [artikel ini]
  2. Tutorial Installer: Membuat Installer Aplikasi (2 dari 5)
  3. Tutorial Installer: Kustomisasi dan Install Conditions (3 dari 5)
  4. Tutorial Installer: Membuat Bootstrapper Installer (4 dari 5)
  5. Tutorial Installer: Finalisasi Setup Project/Finishing (5 dari 5)

Persiapan Membuat Installer

Pada artikel ini, penulis akan menggunakan project Wiyata Bhakti, aplikasi point-of-sales buatan Kodesiana.com. Aplikasi POS ini menggunakan .NET Framework 4.5, SQL Server 2014 LocalDB sebagai basis data, dan Crystal Report untuk membuat laporan.

Sebelum memulai membuat installer, kita akan mempersiapkan beberapa hal, yaitu:

  1. Visual Studio 2017 Community Edition, IDE untuk membuat WiX project.
  2. WiX Toolset, untuk membuat installer.
  3. Project untuk dibuat installer (Wiyata Bhakti).

Berdasarkan kebutuhan project Wiyata Bhakti, penulis ingin agar proses instalasi aplikasi Wiyata Bhakti dapat dilakukan dengan mudah bagi pengguna. Penulis ingin .NET Framework, SQL Server Local DB dan Crystal Report sudah dipaket dalam sebuah installer agar pengguna dapat memasang aplikasi Wiyata Bhakti dengan mudah.

Hasil akhir setup:

  1. Install aplikasi utama yaitu Wiyata Bhakti.
  2. Install .NET Framework 4.5 apabila belum diinstal.
  3. Install SQL Server 2014 LocalDB apabila belum diinstal.
  4. Install Crystal Report apabila belum diinstal.
  5. Buat shortcut pada start menu dan Desktop.
  6. Setup bisa digunakan pada Windows 32-bit dan 64-bit.

WiX Toolset

WiX Toolset (kependekan dari Windows Installer XML Toolset) merupakan program untuk membuat installer Windows menggunakan XML. WiX merupakan program berbasis command line tapi memiliki integrasi dengan Visual Studio untuk mempermudah proses pembuatan installer.

Instalasi WiX Toolset v3

Buka halaman unduh WiX Toolset: http://wixtoolset.org/releases. Klik Download v3.* kemudian pada halaman GitHub, klik wix3**.exe. Pada contoh ini versi WiX yang digunakan adalah versi 3.11.1, jadi file yang diunduh adalah wix311.exe. Tutup Visual Studio apabila dibuka dan pasang WiX Toolset.

Tampilan Installer WiX Toolset
Tampilan Installer WiX Toolset

Klik Install untuk memasang WiX Toolset. Setelah proses instalasi selesai, buka Visual Studio dan buat project baru. Pilih Setup Project for WiX v3. Setelah itu, project baru akan muncul dengan file default Product.wxs.

Membuat Setup Project WiX
Membuat Setup Project WiX

Pada tahap ini, Anda telah berhasil membuat sebuah project setup kosong.

Pengenalan WiX Toolset

Sebelum melanjutkan pada artikel yang akan datang, Anda perlu mengetahui sedikit mengenai struktur WiX. WiX menggunakan ekstensi file wxs dan secara otomatis akan membuat file Product.wxs setelah membuat project baru.

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
    <Product Id="*" Name="ContohSetup" Language="1033" Version="1.0.0.0" Manufacturer="" UpgradeCode="1600e328-9361-4403-850c-58c04d6bc3c4">
        <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

        <MajorUpgrade DowngradeErrorMessage="A newer version of [ProductName] is already installed." />
        <MediaTemplate />

        <Feature Id="ProductFeature" Title="ContohSetup" Level="1">
            <ComponentGroupRef Id="ProductComponents" />
        </Feature>
    </Product>

    <Fragment>
        <Directory Id="TARGETDIR" Name="SourceDir">
            <Directory Id="ProgramFilesFolder">
                <Directory Id="INSTALLFOLDER" Name="ContohSetup" />
            </Directory>
        </Directory>
    </Fragment>

    <Fragment>
        <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
            <!-- TODO: Remove the comments around this Component element and the ComponentRef below in order to add resources to this installer. -->
            <!-- <Component Id="ProductComponent"> -->
            <!-- TODO: Insert files, registry keys, and other resources here. -->
            <!-- </Component> -->
        </ComponentGroup>
    </Fragment>
</Wix>

Selain itu, WiX juga menggunakan elemen <Fragment> untuk memisahkan beberapa bagian installer kedalam beberapa file. Saat membuat file wxs baru, secara otomatis WiX akan membuat file dengan isi sebagai berikut.

Isi file wxs kosong:

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
    <Fragment>

    </Fragment>
</Wix>

Penutup

Sampai disini Anda sudah memiliki dasar yang cukup untuk menggunakan WiX Toolset. Pada artikel berikutnya akan dibahas cara membuat setup sederhana yang dapat menginstall program pada sistem.

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *

This site uses Akismet to reduce spam. Learn how your comment data is processed.