Пошаговое руководство. Создание пользовательского установщика для приложения ClickOnce

Любое приложение ClickOnce, основанное на .exe файле, может быть тихо установлено и обновлено с помощью пользовательского установщика. Пользовательский установщик может реализовать пользовательский интерфейс во время установки, включая пользовательские диалоговые окна для операций безопасности и обслуживания. Для выполнения операций установки настраиваемый установщик использует класс <xref:System.Deployment.Application.InPlaceHostingManager>. В этом пошаговом руководстве показано, как создать пользовательский установщик, который автоматически устанавливает приложение ClickOnce.

Предпосылки

Создание пользовательского установщика приложений ClickOnce

1. В приложении ClickOnce добавьте ссылки на System.Deployment и System.Windows.Forms.

2. Добавьте новый класс в приложение и укажите любое имя. В этом пошаговом руководстве используется имя MyInstaller.

3. Добавьте следующие Imports или using директивы в начало нового класса.

   • C#
   • VB

   using System.Deployment.Application;
   using System.Windows.Forms;
   

4. Добавьте в класс следующие методы.

   Эти методы вызывают <xref:System.Deployment.Application.InPlaceHostingManager> методы для скачивания манифеста развертывания, подтверждения соответствующих разрешений, попросить пользователя предоставить разрешение на установку, а затем скачать и установить приложение в кэш ClickOnce. Настраиваемый установщик может указать, что приложение ClickOnce предварительно доверено, или перенести принятие решения о доверии на вызов метода <xref:System.Deployment.Application.InPlaceHostingManager.AssertApplicationRequirements%2A>. Этот код предварительно доверяет приложению.

   Замечание

   Разрешения, назначенные предварительно доверенным кодом, не могут превышать разрешения пользовательского кода установщика.

   • C#
   • VB

   InPlaceHostingManager iphm = null;
   
   public void InstallApplication(string deployManifestUriStr)
   {
       try
       {
           Uri deploymentUri = new Uri(deployManifestUriStr);
           iphm = new InPlaceHostingManager(deploymentUri, false);
       }
       catch (UriFormatException uriEx)
       {
           MessageBox.Show("Cannot install the application: " + 
               "The deployment manifest URL supplied is not a valid URL. " +
               "Error: " + uriEx.Message);
           return;
       }
       catch (PlatformNotSupportedException platformEx)
       {
           MessageBox.Show("Cannot install the application: " + 
               "This program requires Windows XP or higher. " +
               "Error: " + platformEx.Message);
           return;
       }
       catch (ArgumentException argumentEx)
       {
           MessageBox.Show("Cannot install the application: " + 
               "The deployment manifest URL supplied is not a valid URL. " +
               "Error: " + argumentEx.Message);
           return;
       }
   
       iphm.GetManifestCompleted += new EventHandler<GetManifestCompletedEventArgs>(iphm_GetManifestCompleted);
       iphm.GetManifestAsync();
   }
   
   void iphm_GetManifestCompleted(object sender, GetManifestCompletedEventArgs e)
   {
       // Check for an error.
       if (e.Error != null)
       {
           // Cancel download and install.
           MessageBox.Show("Could not download manifest. Error: " + e.Error.Message);
           return;
       }
   
       // bool isFullTrust = CheckForFullTrust(e.ApplicationManifest);
   
       // Verify this application can be installed.
       try
       {
           // the true parameter allows InPlaceHostingManager
           // to grant the permissions requested in the application manifest.
           iphm.AssertApplicationRequirements(true) ; 
       }
       catch (Exception ex)
       {
           MessageBox.Show("An error occurred while verifying the application. " +
               "Error: " + ex.Message);
           return;
       }
   
       // Use the information from GetManifestCompleted() to confirm 
       // that the user wants to proceed.
       string appInfo = "Application Name: " + e.ProductName;
       appInfo += "\nVersion: " + e.Version;
       appInfo += "\nSupport/Help Requests: " + (e.SupportUri != null ?
           e.SupportUri.ToString() : "N/A");
       appInfo += "\n\nConfirmed that this application can run with its requested permissions.";
       // if (isFullTrust)
       // appInfo += "\n\nThis application requires full trust in order to run.";
       appInfo += "\n\nProceed with installation?";
   
       DialogResult dr = MessageBox.Show(appInfo, "Confirm Application Install",
           MessageBoxButtons.OKCancel, MessageBoxIcon.Question);
       if (dr != System.Windows.Forms.DialogResult.OK)
       {
           return;
       }
   
       // Download the deployment manifest. 
       iphm.DownloadProgressChanged += new EventHandler<DownloadProgressChangedEventArgs>(iphm_DownloadProgressChanged);
       iphm.DownloadApplicationCompleted += new EventHandler<DownloadApplicationCompletedEventArgs>(iphm_DownloadApplicationCompleted);
   
       try
       {
           // Usually this shouldn't throw an exception unless AssertApplicationRequirements() failed, 
           // or you did not call that method before calling this one.
           iphm.DownloadApplicationAsync();
       }
       catch (Exception downloadEx)
       {
           MessageBox.Show("Cannot initiate download of application. Error: " +
               downloadEx.Message);
           return;
       }
   }
   
   /*
   private bool CheckForFullTrust(XmlReader appManifest)
   {
       if (appManifest == null)
       {
           throw (new ArgumentNullException("appManifest cannot be null."));
       }
   
       XAttribute xaUnrestricted =
           XDocument.Load(appManifest)
               .Element("{urn:schemas-microsoft-com:asm.v1}assembly")
               .Element("{urn:schemas-microsoft-com:asm.v2}trustInfo")
               .Element("{urn:schemas-microsoft-com:asm.v2}security")
               .Element("{urn:schemas-microsoft-com:asm.v2}applicationRequestMinimum")
               .Element("{urn:schemas-microsoft-com:asm.v2}PermissionSet")
               .Attribute("Unrestricted"); // Attributes never have a namespace
   
       if (xaUnrestricted != null)
           if (xaUnrestricted.Value == "true")
               return true;
   
       return false;
   }
   */
   
   void iphm_DownloadApplicationCompleted(object sender, DownloadApplicationCompletedEventArgs e)
   {
       // Check for an error.
       if (e.Error != null)
       {
           // Cancel download and install.
           MessageBox.Show("Could not download and install application. Error: " + e.Error.Message);
           return;
       }
   
       // Inform the user that their application is ready for use. 
       MessageBox.Show("Application installed! You may now run it from the Start menu.");
   }
   
   void iphm_DownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)
   {
       // you can show percentage of task completed using e.ProgressPercentage
   }
   

5. Чтобы попытаться выполнить установку из вашего кода, вызовите метод InstallApplication. Например, если вы назвали класс MyInstaller, можно вызвать InstallApplication следующим образом.

   • C#
   • VB

   MyInstaller installer = new MyInstaller();
   installer.InstallApplication(@"\\myServer\myShare\myApp.application");
   MessageBox.Show("Installer object created.");
   

Дальнейшие шаги

Приложение ClickOnce также может добавить пользовательскую логику обновления, включая пользовательский интерфейс для отображения во время процесса обновления. Дополнительные сведения см. в разделе <xref:System.Deployment.Application.UpdateCheckInfo>. Элемент <customUX> также может отключить стандартную запись в меню "Пуск", ярлык и запись "Добавить или удалить программы" в приложении ClickOnce. Дополнительные сведения смотрите в элементе <entryPoint> и <xref:System.Deployment.Application.DownloadApplicationCompletedEventArgs.ShortcutAppId%2A>.

Связанный контент

• Манифест приложения ClickOnce
• <элемент «entryPoint»>