Cara: Menambahkan Alat Penginstal ke Aplikasi Layanan Anda

Peringatan

Dokumentasi ini bukan untuk Layanan Windows versi terbaru. Untuk konten terbaru tentang Layanan Windows yang menggunakan BackgroundService dan templat Layanan Pekerja, lihat:

Visual Studio mengirimkan komponen penginstalan yang dapat menginstal sumber daya yang terkait dengan aplikasi layanan Anda. Komponen penginstalan mendaftarkan layanan individual pada sistem tempat komponen tersebut diinstal dan memberi tahu Manajer Kontrol Layanan bahwa layanan ada. Saat bekerja dengan aplikasi layanan, Anda dapat memilih tautan di jendela Properti untuk menambahkan alat penginstal yang sesuai secara otomatis ke proyek Anda.

Catatan

Nilai properti untuk layanan Anda disalin dari kelas layanan ke kelas alat penginstal. Jika Anda memperbarui nilai properti pada kelas layanan, nilai tersebut tidak diperbarui secara otomatis di alat penginstal.

Saat Anda menambahkan alat penginstal ke proyek Anda, kelas baru (yang, secara default, diberi nama ProjectInstaller) dibuat dalam proyek, dan instans komponen penginstalan yang sesuai dibuat di dalamnya. Kelas ini bertindak sebagai titik pusat untuk semua komponen penginstalan yang dibutuhkan proyek Anda. Misalnya, jika Anda menambahkan layanan kedua ke aplikasi Anda dan mengklik tautan Tambahkan Alat Penginstal, kelas alat penginstal kedua tidak dibuat; sebaliknya, komponen penginstalan tambahan yang diperlukan untuk layanan kedua ditambahkan ke kelas yang ada.

Anda tidak perlu melakukan pengkodean khusus dalam alat penginstal untuk membuat layanan Anda diinstal dengan benar. Namun, terkadang Anda mungkin perlu memodifikasi konten alat penginstal jika Anda perlu menambahkan fungsionalitas khusus ke proses penginstalan.

Catatan

Kotak dialog dan perintah menu yang Anda lihat mungkin berbeda dari yang dijelaskan dalam Bantuan tergantung pada pengaturan atau edisi aktif Anda. Untuk mengubah pengaturan Anda, pilih Pengaturan Impor dan Ekspor pada menu Alat. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE Visual Studio.

Untuk menambahkan alat penginstal ke aplikasi layanan Anda

  1. Di Penjelajah Solusi, akses tampilan Desain untuk layanan yang ingin Anda tambahkan komponen penginstalannya.

  2. Klik latar belakang perancang untuk memilih layanan itu sendiri, bukan kontennya.

  3. Dengan perancang dalam fokus, klik kanan, lalu klik Tambahkan Alat Penginstal.

    Kelas baru, ProjectInstaller, dan dua komponen penginstalan, ServiceProcessInstaller dan ServiceInstaller, ditambahkan ke proyek Anda, dan nilai properti untuk layanan disalin ke komponen.

  4. Klik komponen ServiceInstaller dan verifikasi bahwa nilai properti ServiceName diatur ke nilai yang sama dengan properti ServiceName pada layanan itu sendiri.

  5. Untuk menentukan bagaimana layanan Anda akan dimulai, klik komponen ServiceInstaller dan atur properti StartType ke nilai yang sesuai.

    Nilai Hasil
    Manual Layanan harus dimulai secara manual setelah penginstalan. Untuk informasi selengkapnya, lihat Cara: Memulai Layanan.
    Automatic Layanan akan dimulai dengan sendirinya setiap kali komputer di-boot ulang.
    Disabled Layanan tidak dapat dimulai.
  6. Untuk menentukan konteks keamanan tempat layanan Anda akan berjalan, klik komponen ServiceProcessInstaller dan atur nilai properti yang sesuai. Untuk informasi selengkapnya, lihat Cara: Menentukan Konteks Keamanan untuk Layanan.

  7. Ambil alih metode apa pun yang Anda butuhkan untuk melakukan pemrosesan kustom.

  8. Lakukan langkah 1 hingga 7 untuk setiap layanan tambahan dalam proyek Anda.

    Catatan

    Untuk setiap layanan tambahan dalam proyek, Anda harus menambahkan komponen ServiceInstaller tambahan ke kelas ProjectInstaller proyek. Komponen ServiceProcessInstaller yang ditambahkan pada langkah ketiga berfungsi dengan semua penginstal layanan individual dalam proyek.

Lihat juga