Membuat paket bootstrapper

  • Artikel

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>

Konten terkait