Windows Hizmeti yükleyicisi oluşturma

Bir .NET Windows Hizmeti oluşturduğunuzda (.NET Framework Windows Hizmeti ile karıştırılmamalıdır), hizmetiniz için bir yükleyici oluşturmak isteyebilirsiniz. Yükleyici olmadan, kullanıcıların hizmetinizi nasıl yükleyip yapılandıracaklarını bilmesi gerekir. Yükleyici, uygulamanızın yürütülebilir dosyaları paketler ve özelleştirilebilir bir yükleme kullanıcı deneyimi sunar. Bu öğretici, Windows Hizmeti Oluşturma öğreticisinin devamıdır. .NET Windows Hizmetiniz için nasıl bir yükleyici oluşturacağınızı gösterir.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

Visual Studio Yükleyici Projeleri uzantısını yükleyin.
Bir kurulum projesi oluşturun.
Var olan bir .NET Worker projesini kurulum desteği vermesi için güncelleyin.
Windows Hizmet Kontrol Yöneticisi ile yükleme ve kaldırmayı otomatikleştirin.

Önkoşullar

"Windows Servisi Oluşturma eğitimini tamamlamış olmanız veya örnek depo klonlamaya hazır olmanız beklenmektedir."
.NET 8.0 SDK veya üzeri
Windows işletim sistemi
.NET tümleşik geliştirme ortamı (IDE)
- Visual Studio'yu kullanmaktan çekinmeyin
Mevcut bir .NET Windows Hizmeti

Wix Araç Seti'ni kurarak başlayın. Wix Araç Takımı, XML kaynak kodundan Windows kurulum paketleri oluşturmak için bir dizi araçtır.

dotnet tool install --global wix

Ardından , VS2022 için HeatWave uzantısını yükleyin. Yüklemeyi tamamladıktan sonra, Visual Studio'yu yeniden başlatın ve yeni proje şablonlarının kullanılabildiğini göreceksiniz.

Mevcut projeyi alma

Bu öğretici, BackgroundService Kullanarak Bir Windows Hizmeti Oluşturma öğreticisinin bir parçası olarak oluşturulan uygulamaya dayanmaktadır. Örnek depoyu klonlayabilir veya önceki öğreticide oluşturduğunuz uygulamayı kullanabilirsiniz.

Tavsiye

".NET'te Çalışanlar" örnek kaynak kodunun tümü, indirilebilmeniz için Samples Browser'da bulunur. Daha fazla bilgi için bkz . Kod örneklerine göz atma: .NET'te çalışanlar.

Wix Araç Takımı
Microsoft yükleyici uzantısı

Çözümü Visual Studio'da açın ve uygulamanın beklendiği gibi derlenip çalıştığını doğrulamak için F5 tuşuna basın. Uygulamayı durdurmak için Ctrl+C tuşlarına basın.

Kurulum anahtarlarını ele al

Windows Hizmeti uygulamasının yükleme anahtarlarını işlemesi gerekir. Kurulum projesi, kurulum ve kaldırma sırasında sırasıyla /Install ve /Uninstall geçişleriyle Windows Hizmet uygulamasına çağrı yapacaktır. Bu anahtarlar mevcut olduğunda, uygulama farklı bir şekilde davranacaktır, yani yalnızca Windows Hizmet Kontrol Yöneticisi çalıştırılabilir dosyasını (sc.exe) kullanarak kurulum veya kaldırma işlemi gerçekleştirecektir.

Uygulamanın ayrı bir işlemi çağırması için, kolaylık olması amacıyla CliWrap NuGet paketini yükleyin. Paketi yüklemek CliWrap için aşağıdaki komutu kullanın.

dotnet add App.WindowsService.csproj package CliWrap

Daha fazla bilgi için bkz. dotnet package add.

Yüklü olan CliWrap ile projesinin App.WindowsService dosyasını açın. using yönergelerinden sonra, ancak IHost oluşturulmadan önce, aşağıdaki kodu ekleyin:

using CliWrap;

const string ServiceName = ".NET Joke Service";

if (args is { Length: 1 })
{
    try
    {
        string executablePath =
            Path.Combine(AppContext.BaseDirectory, "App.WindowsService.exe");

        if (args[0] is "/Install")
        {
            await Cli.Wrap("sc")
                .WithArguments(new[] { "create", ServiceName, $"binPath={executablePath}", "start=auto" })
                .ExecuteAsync();
        }
        else if (args[0] is "/Uninstall")
        {
            await Cli.Wrap("sc")
                .WithArguments(new[] { "stop", ServiceName })
                .ExecuteAsync();

            await Cli.Wrap("sc")
                .WithArguments(new[] { "delete", ServiceName })
                .ExecuteAsync();
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex);
    }

    return;
}

Önceki kod:

Hizmet adını const string değeri olarak bildirir.
args'yi tek bir değer için kontrol eder.
Yürütülebilir dosya yolunu AppContext.BaseDirectory.
"/Install" anahtarı mevcut olduğunda, sc create ".NET Joke Service" binPath="path/to/App.WindowsService.exe" start=auto çağrılır.
Anahtar "/Uninstall" mevcut olduğunda, sc stop ".NET Joke Service" ve sc delete ".NET Joke Service" çağrılır.

Kurulum anahtarları bulunmadığında, uygulama önceden olduğu gibi davranır, ancak artık kurulum işlevselliği içerir.

Uyarı

Özel eylemleri tanımlamak ve kurulum anahtarlarını manuel olarak yönetmek, bir anti-pattern olarak kabul edilir. Bu belgede nasıl yapılacağı gösterilmiş olsa da, bunun yerine üçüncü taraf Wix Toolset'i kullanmayı düşünebilirsiniz.

Yeni kurulum projesi ekle

Wix Araç Takımı
Microsoft yükleyici uzantısı

Yeni bir Wix kurulum projesi eklemek için, Çözüm Gezgini'nde çözüm üzerine sağ tıklayın ve Yeni Proje Ekle >'yi seçin:

Yeni proje ekleme iletişim kutusu: Yeni MSI Paketi (Wix v4) Projesi.

Kullanılabilir şablonlardan MSI Paketi (Wix v4) öğesini ve ardından İleri'yi seçin. İstenen Ad ve Konum bilgilerini girin, ardından Oluştur'u seçin.

Kurulum projesini yapılandır

Wix Araç Takımı
Microsoft yükleyici uzantısı

Kurulum projesini yapılandırmak için önce App.WindowsService projesine bir referans eklemeniz gerekir. Kurulum projesine Çözüm Gezgini üzerinde sağ tıklayın ve ardından >'yi seçin.

Şablon, örnek bileşen ve yerelleştirme dosyalarını içerir. Bu dosyaları silip yalnızca Package.wxs dosyasını bırakın. Artık projenizin, aşağıdakine benzer bir ProjectReference öğesi içermesi gerekiyor.

<Project Sdk="WixToolset.Sdk/4.0.0">
  <ItemGroup>
    <ProjectReference Include="..\App.WindowsService.csproj" />
  </ItemGroup>
</Project>

Proje referansı eklendikten sonra, Package.wxs dosyasını yapılandırın. Dosyayı editörde açın, ardından içeriği aşağıdakilerle değiştirin:

<?xml version="1.0" encoding="UTF-8"?>

<!-- Define the variables in "$(var.*) expressions" -->
<?define Name = ".NET Joke Service" ?>
<?define Manufacturer = "Microsoft" ?>
<?define Version = "1.0.0.0" ?>
<?define UpgradeCode = "9ED3FF33-8718-444E-B44B-69A2344B7E98" ?>

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
    <Package Name="$(Name)"
             Manufacturer="$(Manufacturer)"
             Version="$(Version)"
             UpgradeCode="$(var.UpgradeCode)"
             Compressed="true">

        <!-- Allow upgrades and prevent downgrades -->
        <MajorUpgrade DowngradeErrorMessage="A later version of [ProductName] is already installed. Setup will now exit." />

        <!-- Define the directory structure -->
        <StandardDirectory Id="ProgramFiles6432Folder">

            <!-- Create a folder inside program files -->
            <Directory Id="ROOTDIRECTORY" Name="$(var.Manufacturer)">

                <!-- Create a folder within the parent folder given the name -->
                <Directory Id="INSTALLFOLDER" Name="$(Name)" />
            </Directory>
        </StandardDirectory>

        <!-- The files inside this DirectoryRef are linked to
             the App.WindowsService directory via INSTALLFOLDER -->
        <DirectoryRef Id="INSTALLFOLDER">

            <!-- Create a single component which is the App.WindowsService.exe file -->
            <Component Id="ServiceExecutable" Bitness="always64">

                <!-- Copies the App.WindowsService.exe file using the
                     project reference preprocessor variables -->
                <File Id="App.WindowsService.exe"
                      Source="$(var.App.WindowsService.TargetDir)publish\App.WindowsService.exe"
                      KeyPath="true" />

                <!-- Remove all files from the INSTALLFOLDER on uninstall -->
                <RemoveFile Id="ALLFILES" Name="*.*" On="both" />

                <!-- Tell WiX to install the Service -->
                <ServiceInstall Id="ServiceInstaller"
                                Type="ownProcess"
                                Name="App.WindowsService"
                                DisplayName="$(Name)"
                                Description="A joke service that periodically logs nerdy humor."
                                Start="auto"
                                Account="LocalService"
                                ErrorControl="normal" />

                <!-- Tell WiX to start the Service -->
                <ServiceControl Id="StartService"
                                Start="install"
                                Stop="both"
                                Remove="uninstall"
                                Name="App.WindowsService"
                                Wait="true" />
            </Component>
        </DirectoryRef>

        <!-- Tell WiX to install the files -->
        <Feature Id="Service" Title="App.WindowsService Setup" Level="1">
            <ComponentRef Id="ServiceExecutable" />
        </Feature>

    </Package>
</Wix>

öğesinin ServiceInstallAccount özniteliği, hizmetin altında çalıştığı hesabı belirtir. Hesap LocalService , çoğu hizmet için uygun olan azaltılmış ayrıcalıklara sahip yerleşik bir hesaptır. Ortak değerler şunlardır:

LocalService: Azaltılmış ayrıcalıklara ve ağ kimlik bilgilerine sahip olmayan yerleşik bir hesap.
NetworkService: LocalService'e benzer ancak ağ kimlik bilgilerine sahiptir.
LocalSystem: En yüksek ayrıcalık düzeyi (dikkatli kullanın).

Projeyi oluşturduğunuzda çıkış, hizmeti yüklemek ve kaldırmak için kullanılabilecek bir MSI dosyasıdır.

Kurulum projesini yapılandırmak için, Çözüm Gezgini'nde projeyi seçin. F4 tuşuna basarak proje özellikleri panelini açın. Uygulamanın "ekle" ve "kaldır" simgelerini, yazarını, üreticisini, ürün adını, başlığını, hedef platformunu ve benzerlerini yapılandırabilirsiniz.

Yükleyici proje özellikleri bölmesi.

Yükleyici projesinin kurulum davranışı için iki özel eylem tanımlaması gerekir. Çözüm Gezgini'nde projeye sağ tıklayın, ardından Özel Eylemleri Görüntüle'yi seçin.

Yükleyici projesi Özel Hareketler bağlam menüsü.

Özel İşlemler penceresinden, > seçin.

Özel Eylemler özellikleri iletişim kutusu: öğeyi seç.

Uygulama Klasörüne çift tıklayın (veya Uygulama Klasörü seçiliyken Çıktı Ekle... seçeneğine tıklayın) ve App.WindowsService (Etkin) Yayın Öğelerini seçin.

Özel Eylemler özellikleri iletişim kutusu: öğe uygulama klasörü seç.

Seçimi onaylamak için Ok'i seçin. Eklenen Publish Items from App.WindowsService (Active) düğümünün altında, Install öğesine sağ tıklayın, ardından Özellikler'i seçin.

Öğe özelliklerini yayınla.

/Install öğesini Argümanlar bölümüne ekleyin. Aynı adımları, 'i /Uninstall'e ekleyerek Uninstall için de izleyin.

Her ikisini de tamamladıktan sonra, aşağıdakileri görmelisiniz:

Özel Eylemlerle, Kurulum ve Kaldırma eylemleri tanımlanmıştır.

Güncellemelerle birlikte, kurulum projesi, Install ve Uninstall işlemlerini uygun argümanlarla Windows Hizmet uygulamasını çağırmaya yönlendirecek şekilde yapılandırıldı.

Test kurulum

Wix Araç Takımı
Microsoft yükleyici uzantısı

Yükleyiciyi test etmek için, App.WindowsService projesini yayınlayın. Çözüm Gezgini'nde projeye sağ tıklayın ve yayımla'yı seçin. Önceki öğreticide oluşturduğunuz profil ile yayınlandığında, çalıştırılabilir dosya yayın dizininde bulunacaktır. Ardından, kurulum projesini inşa edin ve yükleyiciyi çalıştırın.

Kurulumu yönetici olarak çalıştırmanız gerekiyor. Bu işlemi yapmak için, MSI dosyasına sağ tıklayın ve ardından Yönetici olarak çalıştır seçeneğini seçin.

Hizmet yüklendikten sonra, hizmetin çalıştığını görmek için Hizmetleri açabilirsiniz. Servisi kaldırmak için yükleyiciyi çalıştırmak amacıyla Windows Program Ekle veya Kaldır özelliğini kullanın.

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-12-19