Creare un programma di installazione del servizio Windows

Per iniziare, installa il set di strumenti Wix. Il set di strumenti Wix è un set di strumenti che compila pacchetti di installazione di Windows dal codice sorgente XML.

dotnet tool install --global wix

Installa quindi l'estensione HeatWave per VS2022. Dopo l'installazione, riavvia Visual Studio e verranno visualizzati nuovi modelli di progetto disponibili.

Installa l'estensione Progetti di programmi di installazione di Microsoft Visual Studio. Dopo l'installazione, riavvia Visual Studio e verranno visualizzati nuovi modelli di progetto disponibili.

Apri la soluzione in Visual Studio e seleziona F5 per assicurarti che l'app venga compilata ed eseguita come previsto. Premi Ctrl+C per arrestare l'app.

Apri la soluzione in Visual Studio e seleziona F5 per assicurarti che l'app venga compilata ed eseguita come previsto. Premi Ctrl+C per arrestare l'app.

Gestire i commutatori di installazione

L'app del servizio Windows deve gestire i commutatori di installazione. Il progetto di installazione chiamerà rispettivamente nell'app del servizio Windows con i commutatori /Install e /Uninstall durante l'installazione e la disinstallazione. Quando questi commutatori sono presenti, l'app si comporta in modo diverso, in quanto eseguirà solo l'installazione o la disinstallazione usando l'eseguibile Gestione controllo servizi di Windows (sc.exe).

Per consentire all'app di chiamare un processo separato, installa il pacchetto NuGet CliWrap come comodità. Per installare il pacchetto CliWrap, usa il comando dotnet add package:

dotnet add App.WindowsService.csproj package CliWrap

Per altre informazioni, fai riferimento a dotnet add package.

Dopo aver installato CliWrap, apri il file Program.cs del progetto App.WindowsService. Dopo le istruzioni using, ma prima della creazione di IHost, aggiungi il codice seguente:

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;
}

Il codice precedente:

• Dichiara il nome del servizio come valore const string.
• Controlla la presenza di un singolo valore in args.
• Ottiene il percorso eseguibile da AppContext.BaseDirectory.
• Quando il commutatore "/Install" è presente, sc create ".NET Joke Service" binPath="path/to/App.WindowsService.exe" start=auto viene chiamata.
• Quando il commutatore "/Uninstall" è presente, sc stop ".NET Joke Service" e sc delete ".NET Joke Service" vengono chiamate.

Quando non sono presenti commutatori di installazione, l'app si comporta come in precedenza, ma ora include funzionalità di installazione.

Per aggiungere un nuovo progetto di installazione Wix, fai clic con il pulsante destro del mouse in Esplora soluzioni e scegli Aggiungi > Nuovo progetto:

Seleziona Pacchetto MSI (Wix v4) nei modelli disponibili e quindi seleziona Avanti. Specifica il Nome e il Percorsodesiderati, quindi seleziona Crea.

Per aggiungere un nuovo progetto di installazione, fai clic con il pulsante destro del mouse in Esplora soluzioni e scegli Aggiungi > Nuovo progetto:

Seleziona Configura progetto nei modelli disponibili e quindi seleziona Avanti. Specifica il Nome e il Percorsodesiderati, quindi seleziona Crea.

Per configurare il progetto di installazione, è prima necessario aggiungere un riferimento al progetto App.WindowsService. Fai clic con il pulsante destro del mouse sul progetto di configurazione in Esplora soluzioni e quindi scegli Aggiungi > riferimento al progetto.

Il modello include file di componenti di esempio e di localizzazione. Elimina questi file, lasciando solo il file Package.wxs. Il progetto dovrebbe ora includere un elemento ProjectReference, simile al seguente:

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

Dopo aver aggiunto il riferimento al progetto, configura il file Package.wxs. Apri il file nell'editor e quindi sostituisci il contenuto con quanto segue:

<?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 -->
        <Directory Id="TARGETDIR" Name="SourceDir">
            <Directory Id="ProgramFiles64Folder">

                <!-- 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>
            </Directory>
        </Directory>

        <!-- 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"
                                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>

Quando si compila il progetto, l'output è un file MSI che può essere usato per installare e disinstallare il servizio.

Per configurare il progetto del programma di installazione, seleziona il progetto in Esplora soluzioni. Seleziona F4 per aprire il riquadro delle proprietà del progetto. Puoi configurare le icone "add" e "remove" dell'app, autore, produttore, nome del prodotto, titolo, piattaforma di destinazione e così via.

Il progetto del programma di installazione deve definire due azioni personalizzate per il comportamento di installazione. Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, quindi seleziona Visualizza > Azioni personalizzate.

Nella finestra Azioni personalizzate, seleziona Installa > Aggiungi azione personalizzata.

Fai doppio clic sulla cartella dell'applicazione (o seleziona Aggiungi output... con la cartella dell'applicazione selezionata) e seleziona Pubblica elementi da App.WindowsService (attivo).

Seleziona OK per confermare la selezione. Fai clic con il pulsante destro del mouse sul nodo Pubblica elementi da App.WindowsService (attivo) aggiunto in Installa e quindi scegli Proprietà.

Aggiungi /Install agli argomenti. Segui questi stessi passaggi per la disinstallazione, aggiungendo /Uninstall agli argomenti.

Al termine di entrambe le operazioni, verrà visualizzato quanto segue:

Con questi aggiornamenti, il progetto di installazione è stato configurato per delegare le azioni Installa e Disinstalla per chiamare nell'app del servizio Windows con argomenti appropriati.

Per testare il programma di installazione, pubblica il progetto App.WindowsService. Fai clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegli Pubblica. Dopo la pubblicazione con il profilo creato nell'esercitazione precedente, l'eseguibile si troverà nella directory di pubblicazione. Successivamente, compila il progetto di installazione ed esegui il programma di installazione.

È necessario eseguire l'installazione come amministratore. A tale scopo, fai clic con il pulsante destro del mouse sul file MSI e scegli Esegui come amministratore.

Dopo aver installato il servizio, è possibile aprire Servizi per visualizzare il servizio in esecuzione. Per disinstallare il servizio, usare la funzionalità Installazione applicazioni di Windows per chiamare il programma di installazione.

Per testare il programma di installazione, espandi Configurazioni della soluzione in Visual Studio e seleziona Release (presupponendo che sia stato selezionato Debug). Compila la soluzione e quindi fai clic con il pulsante destro del mouse sul progetto di installazione e scegli Compila. Per impostazione predefinita, i progetti di installazione non fanno parte della compilazione.

Seleziona Visualizza > Output e assicurati che l'elenco a discesa Mostra output da abbia Compilazione selezionata. Viene visualizzato il percorso del file Microsoft Installer (MSI). Copia il percorso e apri il programma di installazione. Eseguire il programma di installazione.

È necessario eseguire l'installazione come amministratore. A tale scopo, fai clic con il pulsante destro del mouse sul file MSI e scegli Esegui come amministratore.

Dopo aver installato il servizio, è possibile aprire Servizi per avviare il servizio. Per disinstallare il servizio, usare la funzionalità Installazione applicazioni di Windows per chiamare il programma di installazione.