Membuat paket bootstrapper
Program konfigurasi adalah alat penginstal generik yang dapat dikonfigurasi untuk mendeteksi dan menginstal komponen yang dapat didistribusikan ulang seperti file Pemasang Windows (.msi) dan program yang dapat dieksekusi. Alat penginstal juga dikenal sebagai bootstrapper. Alat ini diprogram melalui kumpulan 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 grup direktori dan file yang memuat file manifes yang menjelaskan cara prasyarat harus dipasang.
Bootstrapper pertama kali mendeteksi apakah salah satu prasyarat sudah dipasang. Jika prasyarat tidak dipasang, bootstrapper pertama kali menunjukkan perjanjian lisensi. Kedua, setelah pengguna akhir menerima perjanjian lisensi, penginstalan dimulai untuk prasyarat. Jika tidak, jika semua prasyarat terdeteksi, bootstrapper hanya memulai alat 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.
Manifes produk, product.xml, memuat metadata netral bahasa apa pun untuk paket. Memuat 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, memuat metadata khusus bahasa; biasanya memuat pesan kesalahan yang dilokalkan. Komponen harus memiliki minimal satu manifes paket untuk setiap versi komponen yang dilokalkan. Untuk membuat file ini, lihat Cara: Membuat Manifes Paket.
Setelah file-file ini dibuat, masukkan file manifes produk ke folder bernama untuk bootstrapper kustom. File manifes paket masuk ke folder bernama untuk lokal. Contohnya, jika file manifes paket adalah untuk distribusi ulang bahasa Inggris, masukkan file ke 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
Berikutnya, salin file yang dapat didistribusikan ulang ke lokasi folder bootstrapper. Untuk mendapatkan informasi selengkapnya, lihat Cara: Membuat paket bootstrapper yang dilokalkan.
*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*
or
*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*
Catatan
Jalur yang tercantum di atas berdasarkan jalur penginstalan Visual Studio berfungsi dimulai dengan rilis Pembaruan 7 Visual Studio 2019.
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 berdasarkan direktori paket. Manifes produk dan file yang dapat didistribusikan ulang harus dimasukkan ke subfolder ini. Versi yang dilokalkan dari manifes komponen dan paket harus dimasukkan ke 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 mendapatkan informasi selengkapnya, lihat Kotak dialog prasyarat.
Tabel berikut memperlihatkan properti yang secara otomatis diisi oleh bootstrapper.
Properti | Deskripsi |
---|---|
ApplicationName | Nama aplikasi. |
ProcessorArchitecture | Prosesor dan bit per kata platform yang ditargetkan dengan dapat dijalankan. Nilai mencakup yang berikut: - Intel - IA64 - AMD64 |
VersionNT | Nomor versi untuk sistem operasi Windows. Sintaks versinya adalah Major.Minor.ServicePack. |
VersionMSI | Versi rakitan Pemasang Windows (msi.dll) untuk dijalankan selama penginstalan. |
AdminUser | Properti ini diatur jika pengguna memiliki hak istimewa administrator. Nilainya adalah true atau false. |
InstallMode | Mode penginstalan menunjukkan tempat komponen perlu diinstal. Nilai mencakup yang berikut: - HomeSite - prasyarat dipasang dari Situs web vendor. - SpecificSite - prasyarat dipasang dari lokasi yang Anda pilih. - SameSite - prasyarat dipasang dari lokasi yang sama dengan aplikasi. |
Memisahkan dapat didistribusikan ulang dari penginstalan aplikasi
Anda dapat mencegah file yang dapat didistribusikan ulang agar tidak disebarkan dalam Proyek penyiapan. Untuk melakukan hal ini, buat daftar yang dapat didistribusikan ulang di folder RedistList pada 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, contohnya, jika komponen disebut DataWidgets yang dibuat oleh Acme, gunakan Acme.DataWidgets.RedistList.xml. Contoh konten daftar yang dapat didistribusikan ulang dapat menyerupai:
<?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>