Create Installation Packages in Visual Studio

Transcription

1 Create Installation Packages in Visual Studio Step by step Exercises Hans-Petter Halvorsen, M.Sc.

2 Maintenance Developers Developers & Testers Customers Development Testing Production Deployment & Installation Support Typically the Developers Personal A Clean PC/Server (or a network The Customers Computer with Database, Web with PCs and Servers) where you environment where you Server and Programming install and test your Software. unstall the final software Software Today we typically set-up a Virtual Test Environment Development Environment Test Environment (Servers and Clients) Production Environment Programming environments such as Visual Studio, etc. should not be installed in this environment. You need to create.exe files etc. in order to make your software run.

3 Test/Production Environment Infrastructure with Servers, Virtual Servers, Database Servers, Web Servers, etc. Local Infrastructure with Servers & Virtualization Cloud-based Infrastructure (monthly payment), e.g.: Windows Azure (Visual Studio has built-in support for Deploying to Windows Azure) Amazon Web Services (AWS) Google Cloud Platform etc. 3

4 Deployment Is it a Generic Software Product or a Tailor-made Software Solution? Different Deployment/Installation preparations required!! Generic Software: Many Customers The Customers install the Software itself Tailor-made: Typically only one Customer The Developer Company typically installs the software (at least server-side components) If many Desktop Clients: A Setup is required 4

5 Desktop Apps Web Apps Setup & Deployment You need to create an.exe file and a Setup Package Setup packages can then be distributed on CDs/DVDs or downloaded from a Web Page, etc. You use the Setup in order to install the software on all the clients Time consuming, cumbersome, depends on local components that might not be installed, version conflicts, etc. This makes it difficult (and a lot of work and testing) to create robust setup packages Mac: You can deploy to Mac App Store, Windows 10: You can deploy to Windows Store No client installation needed! Installed on a Web Server (IIS, Apache) Accessed on the Clients using only a Web Browser Easy, simple to deploy new versions, bugfixes, etc. (Customer dont need to do anything) But make sure you App supports all major Web Browsers (Internet Explorer, Chrome, FireFox, Opera, Safari) Mobile Apps Deployed to "App Stores" like Apple App Store, Google Play, Windows Store (Windows 8) Server-side (Database, Web Services, etc.) Typically a setup package that installs this, or manually if it is a tailor-made solution Different Deployment/Installation preparations required depending on what type of Apps you are Developing. 5

6 Setup Creation Software InstallShield Professional/Premium InstallShield is a professional software for creating installers, Price WiX Toolset (Windows Installer XML) (Free) Used to create Windows Installer packages ("MSI files) The WiX toolset builds Windows installation packages from XML source code. Free and Open Source Used by e.g., Microsoft to create Setup packages for Office, SQL Server, Visual Studio, etc. Apple, etc. also use it. Inno Setup Free of charge Installer for Windows programs NSIS (Nullsoft Scriptable Install System) Professional open source system to create Windows installers. etc. 6

7 Setup & Deployment in Visual Studio InstallShield Limited Edition (InstallShield Professional is a professional software for creating installers, Price 2000+) Tool for creating setup packages "Included" (free), but needs to be enabled and downloaded Integrates with Visual Studio (Prof. ed can be used independently) WiX Toolset (Windows Installer XML) Used to create Windows Installer packages ("MSI files) Can be used in Visual Studio or independently ClickOnce Deployment. Publishing Desktop Apps to a Web Server. Users can then install them with a single click. Deployment to Windows Azure ("Windows in the Cloud"). Monthly Payment Web Apps (Web Deploy) Create a Web Deployment Package which can be imported using IIS Mobile Apps: Windows Store Apps Built-in Deployment inside Visual Studio to Windows Store 7

8 Setup & Deployment in Visual Studio Deploying Applications, Services, and Components: 8

9 4 Exercises A. Create Setup Packages/Installers: Can be used to install all kind of software/components 1. InstallShield LE (Limited Edition) 2. WiX B. Deploy Web Sites on IIS: 3. Web Package Deployment C. WinForm or WPF Apps: 4. ClickOnce Deployment 9

10 1 InstallShield LE Limited Edition for Visual Studio Hans-Petter Halvorsen, M.Sc.

11 Create a WinForm App This is the App that shall be installed from a Setup 11

12 Create a WinForm App This is the App that shall be installed from a Setup This is just an example create what ever you like Build your App and make sure it works! 12

13 InstallShield Limited Edition for Visual Studio To enable InstallShield Limited Edition: 1. On the menu bar, choose File, New, Project. 2. In the New Project dialog box, expand the Other Project Types node, and then choose the Setup and Deployment node. 3. In the template list, choose Enable InstallShield Limited Edition, and then choose the OK button. 4. In the browser window that opens, read the instructions, and then choose the Go to the download web site link. See next slide for screen shot... 13

14 InstallShield Limited Edition for Visual Studio Installation 14

15 InstallShield Limited Edition Start Creating your Setup for Visual Studio Select a proper Name 15

16 InstallShield Limited Edition for Visual Studio 16

17 InstallShield Limited Edition Step 1: Application Information for Visual Studio 17

18 InstallShield Limited Edition Step 2: Installation Requirements for Visual Studio 18

19 InstallShield Limited Edition Step 3: Application Files for Visual Studio Select your.exe File 19

20 InstallShield Limited Edition Step 4: Application Shortcuts for Visual Studio 20

21 InstallShield Limited Edition for Visual Studio etc., Go through all the steps in the Wizard Finally: Build the Setup Project Test you Setup (preferably on a Virtual Machine or a separate test computer (why?)) 21

22 InstallShield Limited Edition for Visual Studio This is your Setup Files/Setup Package Copy the Setup Package to the Computer where you want to test it and Run Setup.exe 22

23 InstallShield Limited Edition Your Final Setup for Visual Studio 23

24 InstallShield Limited Edition for Visual Studio 24

25 You are finished with the Exercise 25

26 2 WiX Toolset Windows Installer XML Hans-Petter Halvorsen, M.Sc.

27 Download WiX Toolset 27

28 WiX Documentation WiX Manual: / WiX Tutorial: 28

29 WiX Example In this example, we will create a C# Windows Form Application and then use WiX to create an installer for the application. Step 1: Create the C# Windows Form Application Click File, then select New, then select Project. Choose the Visual C# node in the Project Types tree, then select Windows Forms Application. Name your application e.g., "MyApplication (Use whatever you want) and press OK. Step 2: Create the Installer for the application Click File, then click New, then click Project. Choose the Windows Installer XML node in the Project types tree, then select WiX Project Name your project "MySetup" and press OK. In the MySetup project, right-click on the References node and choose Add Reference... Navigate to the Projects tab, click on the MyApplication project, and click the Add button, and then press OK. Find the comment that says: <!-- TODO: Insert your files, registry keys, and other resources here. --> Delete that line and replace it with the following lines of code: <File Source="$(var.MyApplication.TargetPath)" /> Build the Wix project

30 Create a WinForm App This is the App that shall be installed from a Setup 30

31 Create a WinForm App This is the App that shall be installed from a Setup This is just an example create what ever you like 31

32 Create WiX Setup Project 32

33 Installer XML Code 33

34 <?xml version="1.0" encoding="utf-8"?> <Wix xmlns=" <Product Id="*" Name="MySetup" Language="1033" Version=" " Manufacturer="Telemark University College" UpgradeCode="2ee9a35c-e8ba-4197-a97f- 192b80a1d6bf"> <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" /> <MajorUpgrade DowngradeErrorMessage="A newer version of [ProductName] is already installed." /> <MediaTemplate /> <Feature Id="ProductFeature" Title="MySetup" Level="1"> <ComponentGroupRef Id="ProductComponents" /> </Feature> </Product> <Fragment> </Fragment> <Directory Id="TARGETDIR" Name="SourceDir"> <Directory Id="ProgramFilesFolder"> <Directory Id="INSTALLFOLDER" Name="MySetup" /> </Directory> </Directory> <Fragment> <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER"> <Component Id="ProductComponent"> <File Source="$(var.WinFormApp.TargetPath)" /> </Component> </ComponentGroup> </Fragment> </Wix>

35 The Installer/Setup is Ready Run the Installer ( MySetup.msi ) in order to install your Software Note! This Setup has no GUI it just installs your software (more advanced setups can of course be created) 35

36 After Installation As you see it has been properly installed Double-click to open your App 36

37 Uninstallation You may Uninstall it if you want 37

38 That's it! Now you have a working installer that installs and uninstalls the application. This was a very simple Installer with no Wizard or interaction with the user during Installation. With Wix you can do all this and more. For more information about WiX, se the online documentation. WiX Manual: WiX Tutorial: 38

39 Example with User Interface 39

40 Example with User Interface 40

41 You are finished with the Exercise 41

42 3 Web Package Deployment Hans-Petter Halvorsen, M.Sc.

43 Web Deployment Alternatives: - Create a Installation Package that you or the Customer need to install on the server (Web Deploy Package) - Deploy directly to the server using Web Deploy (You need to have online access to the server) - Deploy directly to the server using FTP (You need to have online access to the server)

44 On the Development Computer 44

45 Web Package Deployment Note! In order to start on this Exercise, you need to create an ASP.NET project or use an existing ASP.NET Project. Right-click on the ASP.NET Project in the Solution Explorer in Visual Studio and select Publish... 45

46 If you miss the Deploy option, make sure to install the Web Deploy features. You may download and install it from WebPI (Web Platform Installer) (Google it and download it) 46

47 Create Web Package Wizard 47

48 Create Web Package Wizard If your Web App uses a Database connection in Web.config, you may setup the Connection String on the Server here. xxx 48

49 On the Test or Production Server 49

50 Preparation You need to install the Web Deploy software on the Server Download WebPI (Web Platform Installer) and then select to Install Web Deploy for Hosting Servers 50

51 Import Package in IIS 51

52 Import Package in IIS Make sure you have copied the Installation Package to the Server 52

53 Web Package Deployment 53

54 Test It If your Web App uses a Database, you need to setup/configure the database. 54

55 You are finished with the Exercise 55

56 4 ClickOnce Deployment Easy Deployment of WinForm Apps and WPF Apps Hans-Petter Halvorsen, M.Sc.

57 ClickOnce Deployment Easy Deployment of WinForm Apps and WPF Apps

58 ClickOnce Deployment ClickOnce is a deployment technology that enables you to create self-updating Windows-based applications that can be installed and run with minimal user interaction. A ClickOnce application is any Windows Presentation Foundation (.xbap), Windows Forms (.exe), console application (.exe), or Office solution (.dll) published using ClickOnce technology. You can publish a ClickOnce application in three different ways: from a Web page from a network file share from media such as a CD-ROM. 58

59 Right-click on your WinForm or WPF Project in the Solution Explorer Select where you want to store the Installer. Then you can distribute the link to the Users that need to install the application 59

60 60

61 The Installation Pacckage was created: Copy the Installation Pakage to the Server Give the link to the Users that shall to Install and use the Software 61

62 Give the link to the Users that shall to Install and use the Software 62

63 You are finished with the Exercise 63

64 Hans-Petter Halvorsen, M.Sc. University College of Southeast Norway Blog: