\ Smart Client 0" Deploymentwith v^ ClickOnce

Transcription

1 \ Smart Client 0" Deploymentwith v^ ClickOnce Deploying Windows Forms Applications with ClickOnce Brian Noyes TT fr Addison-Wesley Upper Saddle River, NJ Boston Indianapolis San Francisco New York Toronto Montreal «London Munich Paris Madrid Capetown Sydney Tokyo «Singapore Mexico City

2 Contents Figures xv Foreword xxi Preface xxiii Acknowledgments About the Author xxxiii 1 Introduction to ClickOnce 1 What Is a Smart Client Application? 2 Smart Clients Are Rieh Client Applications 3 Smart Clients Are Typically Distributed Applications 4 Smart Clients Run Securely on the Client Machine 4 Smart Clients Support Offline Operations 4 Smart Clients Are Automatically Network Deployed and Updated 6 Why Choose Smart Clients? 6 Smart Client Deployment Challenges 7 Design Goals of ClickOnce 8 ClickOnce Features 9 Terminology 10 ClickOnce Deployment Modes 12 ClickOnce Deployment Architecture 14 ClickOnce Deployment Process Overview 16 First ClickOnce Deployment: ClickOnce Hello World 17 Creating an Application to Deploy 18 Publishing the Application 18 ix

3 Contents Deploying the Application with ClickOnce 20 Creating an Updated Application Version 23 Publishing the Update 24 Applying the Update from the Client 25 HelloWorld Wrap Up 26 Software Requirements for ClickOnce 26 Client Requirements 27 Server Requirements 27 What to Deploy (and What Not to Deploy) with ClickOnce 28 ClickOnce Versus Other Deployment Technologies 30 Smart Client Architecture Overview 32 Where Are We? 34 Initial Deployment with ClickOnce 37 Publishing an Application with Visual Studio ClickOnce Publishing Options 38 Deployment Protocols or Media 39 Publishing Location 40 Installation URL 42 Install Mode 43 Update Policy 45 Publish Version 46 Publish Options 46 Security Settings 49 Publisher Certificate 49 Visual Studio Publishing Step by Step 50 Designing the Application 51 Publishing the Application via HTTP from Visual Studio 53 Publishing the Application to CD 55 Publishing Location Polder Structure 57 Manifest Generation and Signing 59 Deployment Manifest 60 Application Manifest 62 Setup.exe File 63 Publish.htm Test Page 63

4 Contents m *i ClickOnce Application Initial Deployment Step by Step 64 Installation Prerequisites 65 Launching the Application 67 Manifest Validation 70 Install and Runtime Secufity 71 User Cache 72 Start Menü Item 74 Add or Remove Programs 75 Moving an Application to Production 76 Moving a Published Application into Production voith Visual Studio 76 Moving an Application into Production with Mage 77 Where Are We? 80 3 Automatic Application Updates 83 Automatic Update Walkthrough 84 Publishing an Update 84 Updating the Application on the Client 86 Manually Publishing the Update with Mage 88 ClickOnce Update Options 91 Install Mode and Updates 93 Checkingfor Updates 94 Checkingfor Updates Before the Application Launches 95 Checkingfor Updates öfter the Application Launches 95 Scheduled Update Checking 96 Setting Minimum Reauired Version 96 Specifying an Update Location 98 Behind the Scenes on the Deployment Server 99 Behind the Scenes of an Update on the Client Machine 100 File Validation 102 Transactions 103 Client Cache Scavenging 103 Removing or Restoring Applications on the Client 104 Restoring an Application Version from the Deployment Server 105 Republishing a Previous Version 105 Where Are We? 106

5 Contents On-Demand Updates 107 When Do On-Demand Updates Make Sense? 108 Introducing the ClickOnce API 109 Adding Synchronous On-Demand Updates 110 Performing Updates Asynchronously 114 Using the BackgroundWorker Componentfor Asynchronous Updates 116 Asynchronous Updates Through the ApplicationDeployment API 120 Update Progress Notifications 122 Combining On-Demand Updates with Automatic Updates 123 Checking Detailed Update Information 125 Gathering Information about the Current Deployment 126 Where Are We? 128 Application and Data File Management 131 Application Executable Deployment 132 Adding Application Files in Visual Studio 134 Configuring ClickOnce Application Files 135 Embedding Files in the Assembly 138 Localizing Your ClickOnce Deployment 141 Publishing for a Single Target Language 143 Publishing for Multiple Target Cultures 145 Publishing for On-Demand Download ofother Cultures 146 Programmatic Download of Application Files 147 Deploying Extensible Plug-in Applications with ClickOnce 151 Managing Application Files with Mage 157 Managing Data Files Through Visual Studio 160 Dealing with Data Files on the Client 161 Data File Update Process 164 Deploying a Client Database with Your Application 167 Migrating SQL Compact Edition Database Files 168 Where Are We? 174 ClickOnce Security 177 ClickOnce Security Overview 177 ClickOnce Deployment-Time Protections 178 ClickOnce Runtime Protections 179

6 ClickOnce Size Limitations for Online-Only Applications 186 ClickOnce Tamper Protections 186 Internet Explorer Security Settings Affecting ClickOnce 188 Configuring ClickOnce Security Permissions 189 Configuring ClickOnce Security Permissions with Visual Studio 190 Calculating Permissions with Visual Studio 194 Configuring ClickOnce Security Permissions with Mage 195 Understanding and Managing Publisher Certificates 197 Contents " xiii Generating or Configuring a Publisher Certificate with Visual Studio Installing a Certificate in a Store with Visual Studio Command Line Certificate Tools 207 Signing Application Updates 208 User Prompting 210 Low-Risk Install 211 Medium-Risk Install 212 High-Risk Install 213 User Prompting for Online-Only Applications 214 Trusted Applications' User Security Policies 215 Trusted Publishers' Permission Elevation 216 Adding Restricted Code Sections 219 Securing the Application Based on User Roles 221 Securing Access to ClickOnce Application Files on the Server 222 Where Are We? Prerequisite Deployment with the Bootstrapper 225 Bootstrapper Features 226 Flexible Launch Capabilities 227 Prerequisite Download Options 227 Minimal Dependencies 228 Installer Requirements Detection 228 Reboot Management 228 License Presentation 228 Bootstrapper and ClickOnce Sample Deployment 229 Adding Items to the Bootstrapper 234 Creating a Shared Assembly Project 235 Creating a Windows Installer Package 237

7 xiv *n Contents Creating the Bootstrapper Manifests 239 Deploying the Shared Assembly with the Bootstrapper 242 Generating Bootstrapper Manifests 245 WhereAreWe? Advanced ClickOnce Topics 249 Using URL Query String Parameters 249 Enabüng URL Parameters 251 Using URL Parameters 253 Executing Custom Install/Initialization Code 255 Debugging ClickOnce Applications 256 Debug in Zone 256 Attaching the Debugger to a ClickOnce Application 257 Using Debugger.Break to Debug ClickOnce Startup Code 260 Deploying Unmanaged Applications with ClickOnce 261 Reg-Free COM 264 Deploying ClickOnce Applications with Firefox 266 Launching a ClickOnce Application Programmatically 267 Pushing ClickOnce Installations to the Client Machine 268 Web Server ClickOnce Configuration 272 MSBuild ClickOnce Publishing 273 Where Are We? 274 Ä ClickOnce Deployment ofwpf Applications 277 WPF Anatomy ClickOnce Deployment of WPF Applications 280 Sample Web Browser Application Walkthrough 281 Creating the Application 281 Publishing the Application 283 Where Are We? 284 Index 287