Cara: Menambahkan Penginstal ke Aplikasi Layanan Anda

Nota

Artikel ini tidak berlaku untuk layanan yang dihosting di .NET. Untuk konten terbaru tentang layanan Windows menggunakan Microsoft.Extensions.Hosting.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 tersebut ada. Saat bekerja dengan aplikasi layanan, Anda dapat memilih tautan di jendela Properti untuk menambahkan penginstal yang sesuai secara otomatis ke proyek Anda.

Nota

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, dinamai 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 Penginstal, kelas penginstal kedua tidak dibuat; sebaliknya, komponen penginstalan tambahan yang diperlukan untuk layanan kedua ditambahkan ke kelas yang ada.

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

Nota

Kotak dialog dan perintah menu yang Anda lihat mungkin berbeda dari yang dijelaskan dalam Bantuan bergantung 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 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 properti ServiceName diatur ke nilai yang sama dengan properti ServiceName pada layanan itu sendiri.

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

    Nilai Result
    Manual Layanan harus dimulai secara manual setelah penginstalan. Untuk informasi selengkapnya, lihat Cara: Memulai Layanan.
    Automatic Layanan akan dimulai dengan sendirinya setiap kali komputer memulai ulang.
    Disabled Layanan tidak dapat dimulai.

  6. Untuk menentukan konteks keamanan tempat layanan Anda akan berjalan, klik ServiceProcessInstaller komponen 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.

    Nota

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

Baca juga

  • Last updated on