Bagikan melalui

Membuat paket bootstrapper

Program Penyiapan adalah alat penginstal generik yang dapat dikonfigurasi untuk mendeteksi dan menginstal komponen yang dapat didistribusikan ulang seperti file Windows Installer (.msi) dan program yang dapat dieksekusi. Alat penginstal ini juga dikenal sebagai bootstrapper. Ini diprogram melalui sekumpulan manifes XML yang menentukan metadata untuk mengelola penginstalan komponen. Setiap komponen yang dapat didistribusikan ulang, atau prasyarat, yang muncul di kotak dialog Prasyarat untuk ClickOnce adalah paket bootstrapper. Paket bootstrapper adalah sekelompok direktori dan file yang berisi file manifes yang menjelaskan bagaimana prasyarat harus diinstal.

Bootstrapper pertama kali mendeteksi apakah salah satu prasyarat sudah diinstal. Jika prasyarat tidak diinstal, sebagai langkah pertama bootstrapper menunjukkan perjanjian lisensi. Kedua, setelah pengguna akhir menerima perjanjian lisensi, penginstalan dimulai untuk prasyarat. Jika semua prasyarat terdeteksi, bootstrapper akan memulai penginstal aplikasi.

Membuat paket bootstrapper kustom

Anda dapat membuat manifes bootstrapper dengan menggunakan Editor XML di Visual Studio. Untuk melihat contoh pembuatan paket bootstrapper, lihat Panduan: Membuat bootstrapper kustom dengan perintah privasi.

Untuk membuat paket bootstrapper, Anda harus membuat manifes produk dan, untuk setiap versi komponen yang dilokalkan, manifes paket juga.

  • Manifest produk, product.xml, berisi metadata yang tidak bergantung pada bahasa untuk paket. Ini berisi metadata umum untuk semua versi komponen yang dapat didistribusikan ulang yang dilokalkan. Untuk membuat file ini, lihat Cara: Membuat Manifes Produk.

  • Manifes paket, package.xml, berisi metadata khusus bahasa; biasanya berisi pesan kesalahan yang dilokalkan. Komponen harus memiliki setidaknya satu manifes paket untuk setiap versi komponen yang dilokalkan. Untuk membuat file ini, lihat Cara: Membuat Manifes Paket.

Setelah file ini dibuat, masukkan file manifes produk ke dalam folder bernama untuk bootstrapper kustom. File manifes paket masuk ke folder yang dinamai sesuai dengan lokal. Misalnya, jika file manifes paket adalah untuk redistribusi bahasa Inggris, masukkan file ke dalam folder yang disebut en. Ulangi proses ini untuk setiap lokal, seperti ja untuk jepang dan de untuk Jerman. Paket bootstrapper kustom akhir dapat memiliki struktur folder berikut.

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

Selanjutnya, salin file yang dapat didistribusikan ulang ke lokasi folder bootstrapper. Untuk informasi selengkapnya, lihat Cara: Membuat paket bootstrapper yang dilokalkan.

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*

atau

*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*

Nota

Jalur yang tercantum di atas di bawah jalur penginstalan Visual Studio berfungsi dimulai dengan rilis Visual Studio 2019 Update 7.

Anda juga dapat menemukan lokasi folder bootstrapper dari nilai Jalur di kunci registri berikut:

*HKLM\Software\Microsoft\GenericBootstrapper*

Pada sistem 64-bit, gunakan kunci registri berikut:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Setiap komponen yang dapat didistribusikan ulang muncul di subfoldernya sendiri di bawah direktori paket. Manifes produk dan file yang dapat didistribusikan ulang harus dimasukkan ke dalam subfolder ini. Versi komponen dan manifes paket yang dilokalkan harus dimasukkan ke dalam subfolder bernama sesuai dengan Nama Budaya.

Setelah file-file ini disalin ke folder bootstrapper, paket bootstrapper secara otomatis muncul di kotak dialog Prasyarat Visual Studio. Jika paket bootstrapper kustom Anda tidak muncul, tutup lalu buka kembali kotak dialog Prasyarat . Untuk informasi selengkapnya, lihat Kotak dialog Prasyarat.

Tabel berikut memperlihatkan properti yang diisi otomatis oleh bootstrapper.

Harta benda Deskripsi
Nama Aplikasi Nama aplikasi.
Arsitektur Prosesor Prosesor dan bit per kata dari platform yang ditargetkan oleh berkas eksekusi. Nilai mencakup yang berikut:

-Intel
- IA64
- AMD64
VersionNT Nomor versi untuk sistem operasi Windows. Sintaks versinya adalah Major.Minor.ServicePack.
VersionMSI Versi komponen Penginstal Windows (msi.dll) untuk dijalankan selama penginstalan.
AdminUser Properti ini diatur jika pengguna memiliki hak istimewa administrator. Nilai benar atau salah.
Mode Instalasi Mode penginstalan menunjukkan dari mana komponen perlu diinstal. Nilai mencakup yang berikut:

- HomeSite - prasyarat diinstal dari situs Web vendor.
- SpecificSite - prasyarat akan dipasang dari lokasi yang Anda pilih.
- SameSite - prasyarat diinstal dari lokasi yang sama dengan aplikasi.

Memisahkan redistributable dari penginstalan aplikasi

Anda dapat mencegah file yang dapat didistribusikan ulang dikerahkan dalam proyek penyiapan. Untuk melakukan ini, buat daftar yang dapat didistribusikan ulang di folder RedistList di direktori .NET Framework Anda:

%ProgramFiles%\Microsoft.NET\RedistList

Daftar yang dapat didistribusikan ulang adalah file XML yang harus Anda beri nama menggunakan format berikut: <Nama> Perusahaan.<Nama> Komponen.RedistList.xml. Jadi, misalnya, jika komponen disebut DataWidgets yang dibuat oleh Acme, gunakan Acme.DataWidgets.RedistList.xml. Contoh konten daftar yang dapat didistribusikan ulang mungkin menyerupai ini:

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>

Konten terkait

  • Last updated on