DEV Community

Olabamiji Oyetubo
Olabamiji Oyetubo

Posted on

How to create an Installer for a Winforms application using Visual Studio 2022 Installer project

In this tutorial, we’ll look at creating an installer for a Winforms desktop application using Visual Studio 2022 that we can share with people.

Prerequisites:
The only prerequisite for this tutorial is Visual Studio Community edition, go ahead and download the installer here

After downloading, go ahead and open Visual Studio.

Next, we want to create a project, we will create a small Winforms application for this demo.
Click on Create a new project and search for Winforms App with C#

Search Winforms

Give your project a name, I have called mine SetupInstallerTutorial

Name project

Choose .NET 8 as your Framework and click on Create.

Your project is created. It might take some time for your designer to be loading so be patient.

While we wait for the designer to finish setting up, let’s go ahead and install the extension we’ll use to setup our installer. Go ahead and click extensions and then click Manage extensions
Search for installer projects, You will see Microsoft Visual Studio Installer project, click download

Install Setup extension

After downloading, Close your Visual Studio instance.
The VSIX installer comes up, go ahead and click modify

VSIX installer

After the modification is done, go ahead and reopen your project again in Visual Studio. The extension should be added to your installed extensions.

Our Winforms app has also finished loading, so your project should look something like this.

Project structure

Now, let’s make a small adjustment to our app, so it at least does something.
Click on the toolbox to the left

Toolbox

You will see a list of components, go ahead and drag a label and a button onto your form designer

Label and Button

Your form designer should look like this after.

Project overview

Great now, we just want to change a few things. We want to make it so that when we click on the button the label displays some text. So go ahead and double-click on the button.
After clicking, a method called button1_Click is generated. Add this code inside it like so;

Button modification

Great, so if you run your application now using fn + f5 and click on button1, your text appears.

Okay, our application is complete, let's create an installer for it.
Before we do that, we will change our configuration to Release since we are configuring an application we want to share/ release to outsiders.

Release configuration

Alright so, right click on your solution in the solution explorer, click on add, and then click Add new project

Add new Project

In the Add project modal, we will see a list of new projects that have been installed. Go ahead and click Setup project

Add SetUp project
Give your project a name, I have called mine SetupInstaller and click Create.

Setup Project created

Great, a new interface was generated with a couple of folders, let's run through them;

  • Application folder: This is where your application’s libraries are going to be stored.
  • User’s Desktop: This is the folder we can define if we want to add a shortcut of our application to the desktop.
  • User’s Program menu: This is inside our program files in our C drive. Let’s begin, click on the Application folder on the left Application folder

Next, right-click on the right pane, and click add, then click project output

Project Output

We will see an Add project output modal, select publish items, then make sure Configuration is set to active and click Ok.

Add project output
After clicking Okay, we see our publish item has been added to our output along with a properties pane.

Added publish items

Next, we want to create a shortcut for our application, so right-click on the Publish item we just created and click on Create shortcut for publish item

Add shortcut for application

After the shortcut is created, go ahead and rename it, I have called mine SetupTutorial

Rename Shortcut

Now, we need to add an icon for our application, you can add any icon you like but I am using a tools picture icon from here

Next, right-click your right pane again, click on Add, and click on file, then add the file you want.

Add Icon

After adding your icon,

Icon added
Next, to add your icon to your project shortcut, right-click on your shortcut and click the properties window

Add icon to shortcut

Then in the properties window, click on the drop-down for icon and click browse

Click Icon in dropdown

When the icon modal comes up, click on browse
Next double click your applications folder

Click applications folder

Then click on the icon you added to your application folder and click ok

Select Icon

Next, we want to add our shortcut to our desktop, right click on the shortcut, click cut

Cut shortcut

Then click on the User’s Desktop folder and paste it there

Paste in desktop folder

To add your shortcut to the User’s programs menu, simply create the shortcut again in the Application folder and follow all the steps, but this time, paste the shortcut you cut in the User’s program menu.

Next, we want to change the Author and manufacturer of our application, so click on the setup project, click on properties then change the author and manufacturer from HP to your name

Change Author and Manufacturer

NB: The project structure of your setup project must mirror the project structure of your actual application, in terms of placement of folders and naming.

Now, our setup project is ready, right click on your Setup project and click build.

Build project

After successfully building right-click on your setup project and click Open folder in File Explorer

Open file explorer of setup project

The File Explorer opens showing 2 folders Debug and Release

Debug and Release

Since we configured our setup project to be built under release, our installer will be inside the release folder, so click on that.

Installer has been configure

And that’s it. Our installer for our application has been built, you can go ahead and run either file to install your WinForms application.

The source code for this tutorial can be found here

Happy coding everyone.

Top comments (7)

Collapse
 
ian_stone_3b39b94a6a80381 profile image
Ian Stone

A nice tutorial but I want to create an installer for a .NET Framework 4.8.1 project. The reason why is I need to use the Crystal Reports Viewer which like the Microsoft Reports Viewer will not work on higher versions of .NET. The File System (SetupInstaller) > Add Project Output Group dropdown does not contain “Publish Items”

Collapse
 
bigboybamo profile image
Olabamiji Oyetubo

Hi Ian, Is it a Winforms project you're working on? You did'nt mention that

Collapse
 
ian_stone_3b39b94a6a80381 profile image
Ian Stone

Hello Olabamiji,

Yes it is a Winform app. I've been trying various solutions and guess it can't be done.

Regards
Ian

Thread Thread
 
bigboybamo profile image
Olabamiji Oyetubo

If "Publish Items" does not exist for the installer you want to create, which options appear when you click the dropdown? While I am not 100% sure which particular option you'd choose when you want to use Crystal Reports, maybe source or content files? I am not very sure

Collapse
 
lijisibin profile image
Liji

Thank You so much

Collapse
 
fox2k24 profile image
Fire

Nice tutorial, I'm usually use such tool to do my app installer, I've a question, it is possibile to implement an update feature from remote URL like ClickOnce?
Thanks and best regards!!

Collapse
 
bigboybamo profile image
Olabamiji Oyetubo

You can check out my ClickOnce Tutorial Here
dev.to/bigboybamo/how-to-create-an...

And Yes it's quite straightforward, there's a microsoft doc that explains that here
learn.microsoft.com/en-us/visualst...