Contoh Penulisan Paket Tunggal

Contoh PUASample.msi adalah contoh paket Windows Installer 5.0 tujuan ganda yang mampu diinstal baik dalam konteks penginstalan per pengguna atau per mesin pada Windows Server 2008 R2 dan Windows 7. Paket sampel ini mengikuti panduan pengembangan yang dijelaskan dalam Penulisan Paket Tunggal.

Mendapatkan salinan sampel

Salinan sampel ini dan editor tabel database Windows Installer, Orca.exe, ada di Komponen Windows SDK untuk Pengembang Windows Installer. Editor sampel dan tabel disediakan dengan Windows Software Development Kit untuk Windows Server 2008 R2 dan Windows 7 sebagai file penginstalan Windows Installer PUASample1.msi dan Orca.msi.

Persyaratan Sistem

Editor database, Orca.exe, memerlukan Windows Server 2008 R2 atau yang lebih lama dan Windows 7 atau versi sebelumnya. Paket tujuan ganda, PUASample1.msi, dapat diinstal dalam konteks penginstalan per mesin atau per pengguna pada Windows Server 2008 R2 dan Windows 7. PUASample1.msi hanya dapat diinstal dalam konteks per komputer pada Windows Server 2008 dan yang lebih lama dan Windows Vista dan yang lebih lama. Anda dapat menginstal editor database untuk memeriksa konten PUASample1.msi tanpa menginstal sampel. Untuk menginstal paket sampel atau editor, pastikan bahwa kebijakan DisableMSI tidak diatur ke nilai yang memblokir penginstalan aplikasi.

Mengidentifikasi Paket Dual-Purpose

Paket tujuan ganda harus menginisialisasi nilai properti MSIINSTALLPERUSER ke 1. Ini mengidentifikasi paket sebagai mampu diinstal dalam konteks per mesin atau per pengguna pada Windows Server 2008 R2 dan Windows 7. Atur properti MSIINSTALLPERUSER dalam paket hanya jika telah ditulis mengikuti panduan pengembangan yang dijelaskan dalam Penulisan Paket Tunggal dan jika Anda bermaksud memberi pengguna opsi untuk menginstal paket dalam konteks per pengguna atau per mesin. Paket tujuan ganda juga harus menginisialisasi nilai dari properti ALLUSERS menjadi 2. Ini menentukan untuk setiap pengguna sebagai konteks penginstalan default untuk aplikasi. Jika nilai properti ALLUSERS adalah nilai selain 2, Penginstal Windows mengabaikan properti MSIINSTALLPERUSER.

Gunakan editor database Penginstal Windows, seperti Orca.exe, untuk memeriksa konten PUASample1.msi. Tabel Properti dalam paket sampel berisi dua entri berikut.

Tabel Properti (parsial)

Kotak Dialog Kustom untuk Konteks Penginstalan

Antarmuka pengguna paket sampel menyertakan contoh kotak dialog kustom, VerifyReadyDialog, yang memungkinkan pengguna untuk memilih konteks penginstalan per pengguna atau per mesin pada waktu penginstalan. Tabel Dialog berisi rekaman yang menjelaskan kotak dialog VerifyReadyDialog. Nilai yang dimasukkan di bidang Atribut adalah 39 karena kotak dialog ini menggunakan msidbDialogAttributesVisible (1), msidbDialogAttributesModal (2), msidbDialogAttributesMinimize (4), dan msidbDialogAttributesTrackDiskSpace (32) bit gaya dialog. Bilah judul kotak dialog menampilkan judul yang diberikan oleh nilai properti ProductName.

Dialog Tabel (parsial)

Tabel Kontrol berisi entri untuk kontrol ditampilkan oleh kotak dialog VerifyReadyDialog. Kotak dialog menampilkan kontrol PushButton dan kontrol Teks. Semua kontrol menggunakan atribut kontrol msidbControlAttributesEnabled (2) dan msidbControlAttributesVisible (1), serta atribut kontrol dan. Kontrol InstallPerMachine juga menggunakan atribut kontrol ElevationShield, msidbControlAttributesElevationShield (8388608.) Atribut kontrol ini menambahkan ikon elevasiKontrol Akun Pengguna (UAC)(ikon perisai) ke kontrol InstallPerMachine dan memberi tahu pengguna bahwa kredensial UAC diperlukan untuk menginstal aplikasi dalam konteks per mesin. Nilai di bidang Teks tabel Kontrol adalah gaya teks dan teks yang ditampilkan oleh kontrol. Lihat deskripsi bidang Teks dalam topik tabel Kontrol untuk informasi selengkapnya tentang menambahkan teks ke kontrol menggunakan gaya yang telah ditentukan sebelumnya.

Tabel Kontrol (parsial)

Tabel ControlEvent menentukan ControlEvents, atau tindakan, yang dilakukan penginstal ketika pengguna berinteraksi dengan kontrol. Saat pengguna mengaktifkan tombol dorong InstallPerUser, antarmuka pengguna menampilkan kotak dialog OutOfDisk jika properti OutOfDiskSpace adalah 1, mengatur nilai properti MSIINSTALLPERUSER ke 1, mengatur nilai properti ALLUSERS ke 2, mengatur properti MSIFASTINSTALL ke 1, dan mengembalikan . Karena properti MSIFASTINSTALL dikonfigurasi, tidak ada titik Pemulihan Sistem yang dihasilkan untuk penginstalan. Saat pengguna mengaktifkan tombol push InstallPerMachine, antarmuka pengguna akan menampilkan kotak dialog OutOfDisk jika properti OutOfDiskSpace adalah 1, kemudian mengatur nilai properti ALLUSERS ke 1, dan mengembalikan.

AcaraKendali Tabel (parsial)

Kontrol InstallPerUser harus dihapus dari antarmuka pengguna untuk penginstalan apa pun yang menggunakan versi Windows Installer yang lebih lama dari Windows Installer 5.0. Tabel ControlCondition dalam paket sampel berisi empat entri yang menonaktifkan dan menyembunyikan kontrol InstallPerUser jika versi saat ini kurang dari Windows Installer 5.0. Tabel menggunakan nilai properti VersionMsi dan sintaks pernyataan kondisi untuk menentukan kondisi ini. Tindakan yang ditentukan di bidang Tindakan dilakukan hanya jika pernyataan di bidang Kondisi benar.

KondisiKontrol Tabel (sebagian)

Menentukan Struktur Direktori

Gunakan editor database untuk memeriksa tabel Direktori dari PUASample1.msi. Rekaman Tabel Direktori yang memiliki string kosong di bidang Directory_Parent mewakili direktori akar dari pohon direktori sumber dan target. Jika propertiTARGETDIR tidak terdefinisi, alat penginstal menetapkan nilainya pada waktu penginstalan ke nilai propertiROOTDRIVE. Jika propertiSourceDir tidak terdefinisi, alat penginstal mengatur nilainya ke lokasi direktori yang berisi paket Penginstal Windows (file.msi.) Nama direktori ditentukan menggunakan format pendek|panjang.

Direktori Tabel (parsial)

Pada sumbernya, tabel Direktori ini menghasilkan jalur direktori berikut.

\[SourceDir\]\\Msft\\Sample1 \[SourceDir\]

Pada target, tabel Direktori menunjukkan jalur-jalur dalam tabel berikut. Alat penginstal mengatur nilai ProgramFilesFolder dan properti ProgramMenuFolder ke lokasi yang bergantung pada konteks pemasangan dan apakah sistem adalah versi 32-bit atau 64-bit dari Windows Server 2008 R2 dan Windows 7. Jalur ke folder target bergantung pada apakah pengguna memilih penginstalan per pengguna atau per komputer.

Aplikasi per pengguna harus disimpan dalam subfolder di bawah folder Program yang ditentukan oleh nilai propertiProgramFilesFolder. Biasanya, jalur menuju aplikasi memiliki bentuk berikut.

%LOCALAPPDATA%\Programs\nama ISV\AppName.

Data konfigurasi per pengguna harus disimpan di folder Program yang ditentukan oleh nilai propertiProgramMenuFolder. Biasanya, folder ini terletak di jalur berikut.

%APPDATA%\Microsoft\Windows\Start Menu\Programs

Jika menginstal komponen Paket Penginstal Windows 32-bit, gunakan properti ProgramFilesFolder dan CommonFilesFolder di tabel Direktori. Jika menginstal komponen Paket Penginstal Windows 64-bit , gunakan properti ProgramFiles64Folder dan CommonFiles64Folder . Jika aplikasi Anda berisi versi 32-bit dan 64-bit dari komponen yang sama, dengan nama yang sama, pastikan bahwa versi ini disimpan di direktori yang berbeda atau beri nama yang berbeda.

Tabel Direktori berikut ini menyediakan contoh tata letak direktori yang kompatibel dengan paket yang mencakup komponen 32-bit dan 64-bit dan menyertakan beberapa komponen yang dibagikan di seluruh aplikasi.

Di sumber, tabel Direktori ini mengarah ke jalur direktori berikut.

\[SourceDir\]Prog32\\Msft\\Sample1\\x32\\myapp \[SourceDir\]Share32\\Common Files\\Msft\\Sample1\\x32\\shared \[SourceDir\]Prog64\\Msft\\Sample1\\x64\\myapp \[SourceDir\]Share64\\Common Files\\Msft\\Sample1\\x64\\shared \[SourceDir\]Sample1

Pada target, tabel Direktori ini dipetakan ke jalur direktori berikut. Jalur target bergantung pada konteks penginstalan dan sistem.

Pendaftaran Aplikasi

PUASample.msi menambahkan subkunci ke kunci registri App Paths untuk aplikasi dan melakukan registrasi yang memungkinkan informasi aplikasi disimpan di registri di bawah kunci ini. Untuk informasi selengkapnya tentang Jalur Aplikasi dan pendaftaran aplikasi, lihat bagian PerceivedTypes, SystemFileAssociations, dan Pendaftaran Aplikasi di bagian ekstensibilitas shell dari Panduan Pengembang Shell . Pada waktu penginstalan, pengguna membuat keputusan untuk menginstal aplikasi dalam konteks penginstalan per pengguna atau per mesin. Pada saat paket tujuan ganda ditulis, pengembang paket tidak dapat mengetahui apakah pendaftaran harus dilakukan di bawah kunci HKEY_LOCAL_MACHINE atau HKEY_CURRENT_USER.

Pengembang paket menentukan identitas file untuk file aplikasi yang dapat dieksekusi di bidang File Tabel File File.

File Tabel (parsial)

Nilai yang akan disimpan dalam registri dapat ditentukan di bidang Nilai tabel Registri sebagai string Yang Diformat. Gunakan pengenal file yang ditentukan di kolom File dari tabel File , dan gunakan konvensi [#filekey] dari jenis Terformat, untuk menetapkan nilai default untuk kunci registri App Paths. Tindakan tingkat atas INSTALL melakukan tindakan dalam tabel InstallExecuteSequence. Setelah tindakan CostInitialize, FileCost, , dan InstallFinalize dalam tabel ini telah selesai, Penginstal Windows menggantikan substring yang diformat [#MyAppFile] dalam tabel Registri dengan jalur lengkap ke file aplikasi.

Sampel mendefinisikan properti kustom, RegRoot, untuk berisi lokasi kunci akar dan menggunakan tindakan kustom untuk mengatur ulang nilai properti jika pengguna memilih penginstalan per komputer. Gunakan properti kustom, RegRoot, dalam nilai string berformat apa pun yang mereferensikan lokasi akar. Dalam tabel properti paket PUASample.msi menentukan properti kustom dan mengatur nilai RegRoot ke HKCU. Ini menginisialisasi nilai properti untuk konteks instalasi per pengguna, konteks default yang direkomendasikan untuk paket dengan tujuan ganda.

Tabel Properti (parsial)

Dalam tabel CustomAction paket menentukan tindakan kustom bernama Set_RegRoot_HKLM. Nilai di kolom Tipe menandai ini sebagai Tipe Tindakan Kustom 51 tindakan kustom standar. Arti bidang Sumber dan Target dalam tabel CustomAction bergantung pada jenis tindakan kustom. Untuk informasi selengkapnya tentang jenis standar tindakan kustom, lihat Jenis Tindakan Kustom. Kolom Sumber untuk tindakan kustom Set_RegRoot_HKLM menunjukkan bahwa nilai properti RegRoot. Jika alat penginstal melakukan tindakan kustom Set_RegRoot_HKLM, ini mengatur ulang nilai properti RegRoot ke HKLM.

CustomAction Tabel (parsial)

Aksi level teratas INSTALL melaksanakan aksi-aksi dalam tabel InstallExecuteSequence, sesuai urutan yang ditentukan dalam kolom Urutan tabel tersebut. Nilai yang ditulis di bidang Urutan untuk tindakan kustom Set_RegRoot_HKLM (1501) menentukan bahwa tindakan kustom ini dilakukan setelah tindakan InstallInitialize (1500) dan sebelum tindakan ProcessComponents (1600.) Urutan ini memastikan bahwa rekaman untuk tindakan kustom Set_RegRoot_HKLM dievaluasi pada waktu penginstalan. Untuk informasi selengkapnya tentang urutan tindakan yang direkomendasikan dalam tabel InstallExecuteSequence, lihat topik Suggested InstallExecuteSequence. Sintaks pernyataan bersyarat yang ditentukan di bidang Kondisi menentukan bahwa tindakan Set_RegRoot_HKLM dilakukan hanya jika nilai properti ALLUSERS dievaluasi menjadi 1 pada waktu penginstalan. ALLUSERS nilai properti 1 menentukan penginstalan untuk setiap komputer.

InstallExecuteSequence Table (sebagian)

Berikut adalah rekaman dalam tabel Registri yang melakukan pendaftaran jika komponen ProductComponent diinstal. Nilai -1 di bidang Akar diperlukan untuk melakukan pendaftaran di bawah HKEY_LOCAL_MACHINE untuk penginstalan per pengguna dan di bawah HKEY_CURRENT_USER untuk penginstalan per pengguna. Rekaman dengan string kosong di kolom Registri menambahkan subkunci untuk aplikasi di bawah kunci registri AppPaths dan mengatur nilai "(Bawaan)" ke jalur lengkap file yang dapat dieksekusi aplikasi. Pendaftaran MyAppPathAlias memetakan file yang dapat dieksekusi ke alias aplikasi dan memungkinkan aplikasi diluncurkan jika pengguna mengetik alias "puapct" pada prompt baris perintah. Pendaftaran MyAppPathRegistration memetakan nama file yang dapat dieksekusi ke jalur lengkap file.

Pembatalan Pendaftaran AutoPlay

PUASample.msi melakukan pendaftaran yang memungkinkan pengguna aplikasi mencegah Pemutaran Otomatis Perangkat Keras diluncurkan untuk perangkat yang dipilih. Untuk informasi tentang mendaftarkan handler untuk membatalkan AutoPlay sebagai respons terhadap suatu peristiwa, lihat topik Menyiapkan Perangkat Keras dan Perangkat Lunak untuk Digunakan dengan AutoPlay di bagian ekstensibilitas shell dari Panduan Pengembang Shell . Catatan berikut mendaftarkan handler yang ditentukan di bidang Nama saat komponen ProductComponent diinstal. Nilai -1 di bidang Akar diperlukan untuk menentukan ke Penginstal Windows bahwa pendaftaran harus dialihkan ke lokasi yang bergantung pada konteks penginstalan.

Tabel Registri

Pendaftaran Handler Pratinjau

PUASample.msi melakukan pendaftaran yang diperlukan untuk menginstal handler pratinjau yang memungkinkan pratinjau hanya-baca file .pua tanpa meluncurkan aplikasinya. Untuk informasi tentang mendaftarkan handler pratinjau, lihat topik Pendaftaran Handler Pratinjau di bagian Ekstensibilitas Shell dalam Panduan Pengembang Shell. Rekaman berikut dalam tabel Registry mendaftarkan handler saat komponen ProductComponent diinstal. Nilai -1 di bidang Akar diperlukan untuk menentukan ke Penginstal Windows bahwa pendaftaran harus dialihkan ke lokasi yang bergantung pada konteks penginstalan.

Tabel Registri