Пошаговое руководство. Развертывание вручную приложения ClickOnceWalkthrough: Manually deploy a ClickOnce application

Если Visual Studio нельзя использовать для развертывания вашего ClickOnceClickOnce приложения, или если необходимо использовать дополнительные функции развертывания, например технологии развертывания доверенных приложений следует использовать Mage.exe средство командной строки для создания вашего ClickOnceClickOnce манифесты.If you cannot use Visual Studio to deploy your ClickOnceClickOnce application, or you need to use advanced deployment features, such as Trusted Application Deployment, you should use the Mage.exe command-line tool to create your ClickOnceClickOnce manifests. В этом пошаговом руководстве описывается создание ClickOnceClickOnce развертывания с помощью командной строки версии (Mage.exe) или графической версии (MageUI.exe) создания манифеста и Средства изменения.This walkthrough describes how to create a ClickOnceClickOnce deployment by using either the command-line version (Mage.exe) or the graphical version (MageUI.exe) of the Manifest Generation and Editing Tool.

Предварительные требованияPrerequisites

В этом пошаговом руководстве имеет некоторые предварительные условия и параметры, которые необходимо выбрать до создания развертывания.This walkthrough has some prerequisites and options that you need to choose before building a deployment.

  • Установка Mage.exe и MageUI.exe.Install Mage.exe and MageUI.exe.

    Mage.exe и MageUI.exe являются частью Windows SDKWindows Software Development Kit (SDK).Mage.exe and MageUI.exe are part of the Windows SDKWindows Software Development Kit (SDK). Вы должны либо иметь Windows SDKWindows SDK установлен или версию Windows SDKWindows SDK поставляемой с Visual Studio.You must either have the Windows SDKWindows SDK installed or the version of the Windows SDKWindows SDK included with Visual Studio. Дополнительные сведения см. в разделе пакета Windows SDK на сайте MSDN.For more information, see Windows SDK on MSDN.

  • Создать приложения для развертывания.Provide an application to deploy.

    В этом пошаговом руководстве предполагается, что это приложение Windows, которое вы готовы к развертыванию.This walkthrough assumes that you have a Windows application that you are ready to deploy. Это приложение будет называться AppToDeploy.This application will be referred to as AppToDeploy.

  • Определите, как будут распределяться развертывания.Determine how the deployment will be distributed.

    Возможны следующие варианты: Интернет, файловый ресурс или компакт-диска.The distribution options include: Web, file share, or CD. Для получения дополнительной информации см. ClickOnce Security and Deployment.For more information, see ClickOnce Security and Deployment.

  • Определите, требуется ли приложению повышенного уровня доверия.Determine whether the application requires an elevated level of trust.

    Если приложение требует полного доверия, например, полный доступ к системе пользователя, можно использовать -TrustLevel параметр Mage.exe для этого.If your application requires Full Trust—for example, full access to the user's system—you can use the -TrustLevel option of Mage.exe to set this. Если вы хотите определить пользовательский набор разрешений для приложения, можно скопировать в разделе разрешения в Интернете или интрасети из другого манифеста, изменить его в соответствии с потребностями и его добавления в манифест приложения, используя любой текстовый редактор или MageUI.exe.If you want to define a custom permission set for your application, you can copy the Internet or intranet permission section from another manifest, modify it to suit your needs, and add it to the application manifest using either a text editor or MageUI.exe. Для получения дополнительной информации см. раздел Общие сведения о развертывании доверенных приложений.For more information, see Trusted Application Deployment overview.

  • Получите сертификат Authenticode.Obtain an Authenticode certificate.

    Следует подписать развертывание с помощью сертификата Authenticode.You should sign your deployment with an Authenticode certificate. Можно создать тестовый сертификат с помощью Visual Studio MageUI.exe, или MakeCert.exe и Pvk2Pfx.exe средств, или вы можете получить сертификат из сертификата Центр сертификации (ЦС).You can generate a test certificate by using Visual Studio, MageUI.exe, or MakeCert.exe and Pvk2Pfx.exe tools, or you can obtain a certificate from a Certificate Authority (CA). Если вы решили использовать развертывание доверенных приложений, необходимо также выполнить однократную установку сертификата на всех клиентских компьютерах.If you choose to use Trusted Application Deployment, you must also perform a one-time installation of the certificate onto all client computers. Для получения дополнительной информации см. Trusted Application Deployment Overview.For more information, see Trusted Application Deployment Overview.

    Note

    Также можно подписать развертывание с сертификатом CNG, который можно получить в центре сертификации.You can also sign your deployment with a CNG certificate that you can obtain from a Certificate Authority.

  • Убедитесь, что у приложения нет манифеста с помощью сведений об UAC.Make sure that the application does not have a manifest with UAC information.

    Необходимо определить, содержит ли приложение манифест со сведениями контроля учетных записей (UAC), такие как <dependentAssembly> элемент.You need to determine whether your application contains a manifest with User Account Control (UAC) information, such as an <dependentAssembly> element. Чтобы просмотреть манифест приложения, можно использовать Windows Sysinternals Sigcheck служебной программы.To examine an application manifest, you can use the Windows Sysinternals Sigcheck utility.

    Если приложение содержит манифест с подробными сведениями контроля учетных Записей, необходимо повторно создать его без сведений об UAC.If your application contains a manifest with UAC details, you must re-build it without the UAC information. Для проекта C# в Visual Studio откройте свойства проекта и выберите вкладку "приложения". В манифеста стрелку раскрывающегося списка выберите создать приложение без манифеста.For a C# project in Visual Studio, open the project properties and select the Application tab. In the Manifest drop-down list, select Create application without a manifest. Для проекта Visual Basic в Visual Studio, откройте свойства проекта, выберите вкладку "приложения" и нажмите кнопку параметров контроля учетных Записей представление.For a Visual Basic project in Visual Studio, open the project properties, select the Application tab, and click View UAC Settings. В открытом файле манифеста, удалите все элементы с одним <asmv1:assembly> элемент.In the opened manifest file, remove all elements within the single <asmv1:assembly> element.

  • Определите, требуется ли приложению необходимые компоненты на клиентском компьютере.Determine whether the application requires prerequisites on the client computer.

    ClickOnceClickOnce приложения, развертываемые из Visual Studio могут включать предварительные условия для установки загрузчика (setup.exe) с развертыванием.applications deployed from Visual Studio can include a prerequisite installation bootstrapper (setup.exe) with your deployment. В этом пошаговом руководстве создается два манифеста, необходимые для ClickOnceClickOnce развертывания.This walkthrough creates the two manifests required for a ClickOnceClickOnce deployment. Загрузчик необходимых компонентов можно создать с помощью задача GenerateBootstrapper.You can create a prerequisite bootstrapper by using the GenerateBootstrapper task.

Чтобы развернуть приложение с помощью средства командной строки Mage.exeTo deploy an application with the Mage.exe command-line tool

  1. Создайте каталог, где будут храниться ваши ClickOnceClickOnce файлы развертывания.Create a directory where you will store your ClickOnceClickOnce deployment files.

  2. В каталоге развертывания, который вы только что создали создайте подпапку версии.In the deployment directory you just created, create a version subdirectory. Если это первый раз, что вы развертываете приложение, имя, которое в подпапку версии 1.0.0.0.If this is the first time that you are deploying the application, name the version subdirectory 1.0.0.0.

    Note

    Версия развертывания может отличаться от версии приложения.The version of your deployment can be distinct from the version of your application.

  3. Скопируйте все файлы приложения в подпапку версии, включая исполняемые файлы, сборки, ресурсы и файлы данных.Copy all of your application files to the version subdirectory, including executable files, assemblies, resources, and data files. При необходимости можно создать дополнительные вложенные каталоги, содержащие дополнительные файлы.If necessary, you can create additional subdirectories that contain additional files.

  4. Откройте Windows SDKWindows SDK или команды Visual Studio и замените в подпапку версии.Open the Windows SDKWindows SDK or Visual Studio command prompt and change to the version subdirectory.

  5. Создайте манифест приложения с помощью вызова Mage.exe.Create the application manifest with a call to Mage.exe. Следующая инструкция создает манифест приложения для кода, скомпилированного для выполнения на процессоре Intel x86.The following statement creates an application manifest for code compiled to run on the Intel x86 processor.

    mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .
    

    Note

    Не забудьте включить точку (.) после -FromDirectory параметр, который указывает на текущий каталог.Be sure to include the dot (.) after the -FromDirectory option, which indicates the current directory. Если точка не будет включен, необходимо указать путь к файлам приложения.If you do not include the dot, you must specify the path to your application files.

  6. Подписать манифест приложения с помощью сертификата Authenticode.Sign the application manifest with your Authenticode certificate. Замените mycert.pfx с путем к файлу сертификата.Replace mycert.pfx with the path to your certificate file. Замените passwd с паролем для файла сертификата.Replace passwd with the password for your certificate file.

    mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
    

    Начиная с пакета SDK .NET Framework 4.6.2, который распространяется с Visual Studio и пакета SDK для Windows, mage.exe подписывает манифесты с CNG, а также с использованием сертификатов Authenticode.Starting with the .NET Framework 4.6.2 SDK, which is distributed with Visual Studio and with the Windows SDK, mage.exe signs manifests with CNG as well as with Authenticode certificates. Используйте те же параметры командной строки с помощью сертификатов Authenticode.Use the same command line parameters as with Authenticode certificates.

  7. Измените корневой каталог развертывания.Change to the root of the deployment directory.

  8. Создайте манифест развертывания с помощью вызова Mage.exe.Generate the deployment manifest with a call to Mage.exe. По умолчанию Mage.exe пометит вашей ClickOnceClickOnce развертывания как установленное приложение, так что он может выполняться как в интерактивном и автономном режиме.By default, Mage.exe will mark your ClickOnceClickOnce deployment as an installed application, so that it can be run both online and offline. Чтобы сделать приложение доступным только в том случае, если пользователь находится в сети, используйте -Install параметр со значением false.To make the application available only when the user is online, use the -Install option with a value of false. Если пользователи будут устанавливать приложение из веб-сайт или общую папку по умолчанию, убедитесь, что значение -ProviderUrl манифеста указывает расположение приложения на веб-сервер или общую папку.If you use the default, and users will install your application from a Web site or file share, make sure that the value of the -ProviderUrl option points to the location of the application manifest on the Web server or share.

    mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
    
  9. Подписать манифест развертывания с помощью сертификата Authenticode или CNG.Sign the deployment manifest with your Authenticode or CNG certificate.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
    
  10. Скопируйте все файлы в каталоге развертывания назначение развертывания или носителя.Copy all of the files in the deployment directory to the deployment destination or media. Это может быть папка на веб-сайта или сайта FTP, общей папки или компакт-диска.This may be either a folder on a Web site or FTP site, a file share, or a CD-ROM.

  11. Предоставить пользователям URL-адрес, UNC-путь или носитель, необходимые для установки приложения.Provide your users with the URL, UNC, or physical media required to install your application. Если указать URL-адрес или UNC-путь, необходимо предоставить пользователям полный путь к манифесту развертывания.If you provide a URL or a UNC, you must give your users the full path to the deployment manifest. Например, если развертывается AppToDeploy http://webserver01/ в каталоге AppToDeploy полный путь URL-адрес будет иметь http://webserver01/AppToDeploy/AppToDeploy.application.For example, if AppToDeploy is deployed to http://webserver01/ in the AppToDeploy directory, the full URL path would be http://webserver01/AppToDeploy/AppToDeploy.application.

Чтобы развернуть приложение с помощью графического средства MageUI.exeTo deploy an application with the MageUI.exe graphical tool

  1. Создайте каталог, где будут храниться ваши ClickOnceClickOnce файлы развертывания.Create a directory where you will store your ClickOnceClickOnce deployment files.

  2. В каталоге развертывания, который вы только что создали создайте подпапку версии.In the deployment directory you just created, create a version subdirectory. Если это первый раз, что вы развертываете приложение, имя, которое в подпапку версии 1.0.0.0.If this is the first time that you are deploying the application, name the version subdirectory 1.0.0.0.

    Note

    Версия развертывания может отличаться от версии приложения.The version of your deployment is probably distinct from the version of your application.

  3. Скопируйте все файлы приложения в подпапку версии, включая исполняемые файлы, сборки, ресурсы и файлы данных.Copy all of your application files to the version subdirectory, including executable files, assemblies, resources, and data files. При необходимости можно создать дополнительные вложенные каталоги, содержащие дополнительные файлы.If necessary, you can create additional subdirectories that contain additional files.

  4. Запуск MageUI.exe графическое средство.Start the MageUI.exe graphical tool.

    MageUI.exe
    
  5. Создайте новый манифест приложения, выбрав файл, New, манифест приложения в меню.Create a new application manifest by selecting File, New, Application Manifest from the menu.

  6. По умолчанию имя вкладке, введите имя и номер версии данного развертывания.On the default Name tab, type the name and version number of this deployment. Также укажите процессора , сборки приложения, например x86.Also specify the Processor that your application is built for, such as x86.

  7. Выберите файлы и нажмите кнопку с многоточием (... ) рядом с пунктом каталога приложения текстовое поле.Select the Files tab and click the ellipsis (...) button next to the Application directory text box. Объект Обзор папок откроется диалоговое окно.A Browse For Folder dialog box appears.

  8. Выберите в подпапку версии, содержащий файлы приложения и нажмите кнопку ОК.Select the version subdirectory containing your application files, and then click OK.

  9. Если вы развернете из Internet Information Services (IIS), выберите при заполнении добавить расширение .deploy любой файл, который не имеет "флажок".If you will deploy from Internet Information Services (IIS), select the When populating add the .deploy extension to any file that does not have it check box.

  10. Нажмите кнопку заполнить кнопку, чтобы добавить все файлы приложения в список файлов.Click the Populate button to add all your application files to the file list. Если приложение содержит более одного исполняемого файла, пометьте главный исполняемый файл для этого развертывания в качестве запускаемого приложения, выбрав точки входа из тип файла стрелку раскрывающегося списка.If your application contains more than one executable file, mark the main executable file for this deployment as the startup application by selecting Entry Point from the File Type drop-down list. (Если приложение содержит только один исполняемый файл, MageUI.exe пометит его автоматически.)(If your application contains only one executable file, MageUI.exe will mark it for you.)

  11. Выберите разрешения, необходимые и выберите уровень доверия, что требуется приложению.Select the Permissions Required tab and select the level of trust that you need your application to assert. По умолчанию используется FullTrust, которое подойдет для большинства приложений.The default is FullTrust, which will be suitable for most applications.

  12. Выберите файл, Сохранить как в меню.Select File, Save As from the menu. Параметры создания подписей диалоговое окно появляется при попытке подписать манифест приложения.A Signing Options dialog box appears prompting you to sign the application manifest.

  13. При наличии сертификата, хранящегося в виде файла в файловой системе, используйте подписывать с файлом сертификата и выберите сертификат из файловой системы, нажав кнопку с многоточием (... ) кнопку.If you have a certificate stored as a file on your file system, use the Sign with certificate file option, and select the certificate from the file system by using the ellipsis (...) button. Затем введите пароль сертификата.Then type your certificate password.

    -или--or-

    Если сертификат содержится в хранилище сертификатов, доступном с компьютера, выберите входа, сохраненным сертификатом и выберите сертификат из предоставленного списка.If your certificate is kept in a certificate store accessible from your computer, select the Sign with stored certificate option, and select the certificate from the provided list.

  14. Нажмите кнопку ОК чтобы подписать манифест приложения.Click OK to sign your application manifest. Сохранить как откроется диалоговое окно.The Save As dialog box appears.

  15. В Сохранить как диалоговом окне укажите каталог версии, а затем нажмите кнопку Сохранить.In the Save As dialog box, specify the version directory, and then click Save.

  16. Выберите файл, New, манифест развертывания меню, чтобы создать манифест развертывания.Select File, New, Deployment Manifest from the menu to create your deployment manifest.

  17. На имя задайте имя и номер версии для этого развертывания (1.0.0.0 в этом примере).On the Name tab, specify a name and version number for this deployment (1.0.0.0 in this example). Также укажите процессора , сборки приложения, например x86.Also specify the Processor that your application is built for, such as x86.

  18. Выберите описание и укажите значения для издателя и продукта.Select the Description tab, and specify values for Publisher and Product. (Продукта — это имя, данное приложение в меню Пуск в Windows при установке приложения на клиентский компьютер для автономного использования.)(Product is the name given to your application on the Windows Start menu when your application installs on a client computer for offline use.)

  19. Выберите варианты развертывания вкладку и в начальное расположение текстовом окне укажите расположение манифеста приложения на веб-сервера или общей папки.Select the Deployment Options tab, and in the Start Location text box, specify the location of the application manifest on the Web server or share. Например \\myServer\myShare\AppToDeploy.application.For example, \\myServer\myShare\AppToDeploy.application.

  20. Если вы добавили .deploy расширения на предыдущем шаге, также выберите использовать расширение .deploy здесь.If you added the .deploy extension in a previous step, also select Use .deploy file name extension here.

  21. Выберите параметры обновления вкладке и укажите частоту обновления приложения.Select the Update Options tab, and specify how often you would like this application to update. Если приложение использует UpdateCheckInfo для самостоятельной проверки обновлений, снимите это приложение должно проверять наличие обновлений "флажок".If your application uses UpdateCheckInfo to check for updates itself, clear the This application should check for updates check box.

  22. Выберите ссылка приложения вкладке и нажмите кнопку выбрать манифест кнопки.Select the Application Reference tab and then click the Select Manifest button. Откройте диалоговое окно.An open dialog box appears.

  23. Выберите манифест приложения, который был создан ранее и нажмите кнопку откройте.Select the application manifest that you created earlier and then click Open.

  24. Выберите файл, Сохранить как в меню.Select File, Save As from the menu. Объект параметры создания подписей диалоговое окно появляется при попытке подписать манифест развертывания.A Signing Options dialog box appears prompting you to sign the deployment manifest.

  25. При наличии сертификата, хранящегося в виде файла в файловой системе, используйте подписывать с файлом сертификата и выберите сертификат из файловой системы, нажав кнопку с многоточием (... ) кнопку.If you have a certificate stored as a file on your file system, use the Sign with certificate file option, and select the certificate from the file system by using the ellipsis (...) button. Затем введите пароль сертификата.Then type your certificate password.

    -или--or-

    Если сертификат содержится в хранилище сертификатов, доступном с компьютера, выберите входа, сохраненным сертификатом и выберите сертификат из предоставленного списка.If your certificate is kept in a certificate store accessible from your computer, select the Sign with stored certificate option, and select the certificate from the provided list.

  26. Нажмите кнопку ОК чтобы подписать манифест развертывания.Click OK to sign your deployment manifest. Сохранить как откроется диалоговое окно.The Save As dialog box appears.

  27. В Сохранить как диалоговое окно, перемещение на один уровень выше в корневой каталог развертывания и нажмите кнопку Сохранить.In the Save As dialog box, move up one directory to the root of your deployment and then click Save.

  28. Скопируйте все файлы в каталоге развертывания назначение развертывания или носителя.Copy all of the files in the deployment directory to the deployment destination or media. Это может быть папка на веб-сайта или сайта FTP, общей папки или компакт-диска.This may be either a folder on a Web site or FTP site, a file share, or a CD-ROM.

  29. Предоставить пользователям URL-адрес, UNC-путь или носитель, необходимые для установки приложения.Provide your users with the URL, UNC, or physical media required to install your application. Если указать URL-адрес или UNC-путь, необходимо предоставить пользователям полный путь манифеста развертывания.If you provide a URL or a UNC, you must give your users the full path the deployment manifest. Например, если развертывается AppToDeploy http://webserver01/ в каталоге AppToDeploy полный путь URL-адрес будет иметь http://webserver01/AppToDeploy/AppToDeploy.application.For example, if AppToDeploy is deployed to http://webserver01/ in the AppToDeploy directory, the full URL path would be http://webserver01/AppToDeploy/AppToDeploy.application.

Следующие шагиNext steps

Если необходимо развернуть новую версию приложения, создайте новый каталог с именем новой версии — например, 1.0.0.1—and скопируйте файлы нового приложения в новый каталог.When you need to deploy a new version of the application, create a new directory named after the new version—for example, 1.0.0.1—and copy the new application files into the new directory. Далее необходимо выполнить приведенные выше шаги, чтобы создать и подписать новый манифест приложения и обновить и подписать манифест развертывания.Next, you need to follow the previous steps to create and sign a new application manifest, and update and sign the deployment manifest. Укажите ту же версию, более поздней версии в обоих Mage.exe -New и -Update вызовы, как ClickOnceClickOnce обновляет только новые версии с наибольшее целое число слева.Be careful to specify the same higher version in both the Mage.exe -New and -Update calls, as ClickOnceClickOnce only updates higher versions, with the left-most integer most significant. Если вы использовали MageUI.exe, можно обновить манифест развертывания, открыв его, выбрав ссылка приложения вкладки, щелкнув выбрать манифест кнопку, и выбрав обновленный манифест приложения.If you used MageUI.exe, you can update the deployment manifest by opening it, selecting the Application Reference tab, clicking the Select Manifest button, and then selecting the updated application manifest.

См. такжеSee also