Пошаговое руководство. Создание пользовательского загрузчика с предупреждением о конфиденциальности

Вы можете настроить приложения ClickOnce для автоматического обновления при наличии новых версий файлов и версий сборок. Чтобы убедиться, что ваши клиенты согласны с этим поведением, вы можете отобразить для них запрос конфиденциальности. Затем они могут выбрать, следует ли предоставлять приложению разрешение на автоматическое обновление. Если приложению не разрешено автоматически обновляться, она не устанавливается.

Примечание.

Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в этой статье. Возможно, вы используете другой выпуск Visual Studio или разные параметры среды. Дополнительные сведения см. в разделе Персонализация среды IDE.

Диалоговое окно "Создание согласия на обновление"

Чтобы отобразить запрос на конфиденциальность, создайте приложение, которое запрашивает читателя согласие на автоматическое обновление приложения.

Диалоговое окно создания согласия

1. В меню Файл укажите Создать, затем нажмите Проект.

2. В диалоговом окне "Создать проект" щелкните Windows и щелкните WindowsFormsApplication.

3. В поле "Имя" введите ConsentDialog и нажмите кнопку "ОК".

4. В конструкторе щелкните форму.

5. В окне "Свойства" измените свойство Text на "Обновить диалоговое окно согласия".

6. На панели элементов разверните все windows Forms и перетащите элемент управления Label в форму.

7. В конструкторе щелкните элемент управления меткой.

8. В окне "Свойства" измените свойство Text в разделе "Внешний вид" следующим образом:

   Приложение, которое вы хотите установить проверка для последних обновлений в Интернете. Щелкнув "Я согласен", вы авторизуете приложение, чтобы проверка и автоматически устанавливать обновления из Интернета.

9. На панели элементов перетащите элемент управления "Флажок" в середину формы.

10. В окне "Свойства" измените свойство Text в разделе "Макет" на "Я согласен".

11. На панели элементов перетащите элемент управления Button влево от формы.

12. В окне "Свойства" измените свойство Text в разделе "Макет" на "Продолжить".

13. В окне "Свойства" измените свойство (Name) в разделе Конструктор на ProceedButton.

14. На панели элементов перетащите элемент управления Button вправо от формы.

15. В окне "Свойства" измените свойство Text в разделе "Макет" на "Отмена".

16. В окне "Свойства" измените свойство (Name) в разделе Конструктор на CancelButton.

17. В конструкторе дважды щелкните поле "Я согласен проверка", чтобы создать обработчик событий CheckedChanged.

18. В файле кода Form1 добавьте следующий код для обработчика событий CheckedChanged.

    C#

    private void checkBox1_CheckedChanged(object sender, EventArgs e)
    {
        ProceedButton.Enabled = !ProceedButton.Enabled;
    }
    

    VB

    Private Sub CheckBox1_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged
        ProceedButton.Enabled = Not ProceedButton.Enabled
    End Sub
    

19. Обновите конструктор класса, чтобы отключить кнопку "Продолжить " по умолчанию.

    C#

    public Form1()
    {
        InitializeComponent();
        ProceedButton.Enabled = false;
    }
    

    VB

    Public Sub New()
        InitializeComponent()
        ProceedButton.Enabled = False
    End Sub
    

20. В файле кода Form1 добавьте следующий код для логическое значение переменной, чтобы отслеживать, предоставил ли конечный пользователь согласие на обновление через Интернет.

    C#

    public bool accepted = false;
    

    VB

    Public accepted As Boolean = False
    

21. В конструкторе дважды нажмите кнопку "Продолжить" , чтобы создать обработчик событий Click.

22. В файле кода Form1 добавьте следующий код в обработчик событий Click для кнопки "Продолжить ".

    C#

    private void ProceedButton_Click(object sender, EventArgs e)
    {
        if (ProceedButton.Enabled)
        {
            accepted = true;
            this.Close();
        }
    }
    

    VB

    Private Sub ProceedButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles ProceedButton.Click
        If ProceedButton.Enabled Then
            accepted = True
            Me.Close()
        End If
    End Sub
    

23. В конструкторе дважды нажмите кнопку "Отмена ", чтобы создать обработчик событий Click.

24. В файле кода Form1 добавьте следующий код для обработчика событий Click для кнопки "Отмена ".

    C#

    private void CancelButton_Click(object sender, EventArgs e)
    {
        this.Close();
    }
    

    VB

    Private Sub CancelButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CancelButton.Click
        Me.Close()
    End Sub
    

25. Обновите приложение, чтобы вернуть ошибку, если конечный пользователь не дает согласия на веб-обновления.

    Только для разработчиков Visual Basic:

    1. В Обозреватель решений щелкните ConsentDialog.

    2. В меню "Проект" нажмите кнопку "Добавить модуль" и нажмите кнопку "Добавить".

    3. В файле кода Module1.vb добавьте следующий код.

       Module Module1
       
           Function Main() As Integer
               Application.EnableVisualStyles()
               Application.SetCompatibleTextRenderingDefault(False)
               Dim f As New Form1()
               Application.Run(f)
               If (Not f.accepted) Then
                   Return -1
               Else
                   Return 0
               End If
           End Function
       
       End Module
       

    4. В меню "Проект" щелкните "Свойства ConsentDialog" и перейдите на вкладку "Приложение".

    5. Un проверка Включить платформу приложений.

    6. В раскрывающемся меню "Объект запуска" выберите Module1.

       Примечание.

       Отключение платформы приложений отключает такие функции, как визуальные стили, события приложения, экран-заставка, приложение одного экземпляра и многое другое. Дополнительные сведения см. в разделе Application Page, Project Designer (Visual Basic).

       Только для разработчиков Visual C#:

       Откройте файл кода Program.cs и добавьте следующий код.

       static int Main()
       {
           Application.EnableVisualStyles();
           Application.SetCompatibleTextRenderingDefault(false);
           Form1 f = new Form1();
           Application.Run(f);
           if (!f.accepted)
               return -1;
           else
               return 0;
       }
       

26. В меню "Сборка " щелкните BuildSolution.

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

Чтобы отобразить запрос конфиденциальности конечным пользователям, можно создать пользовательский пакет начальной загрузки для приложения диалогового окна "Согласие обновления" и включить его в качестве необходимых компонентов во всех приложениях ClickOnce.

В этой процедуре показано, как создать пользовательский пакет начальной загрузки, создав следующие документы:

• Файл манифеста product.xml для описания содержимого загрузчика.

• Файл манифеста package.xml для перечисления аспектов локализации пакета, таких как строки и условия лицензионного соглашения на программное обеспечение.

• Документ для условий лицензионного соглашения на программное обеспечение.

Шаг 1. Создание каталога начального загрузчика

1. Создайте каталог с именем UpdateConsentDialog в папке %PROGRAMFILES%\Microsoft SDK\Windows\v7.0A\Bootstrapper\Packages.

   Примечание.

   Для создания этой папки могут потребоваться права администратора.

2. В каталоге UpdateConsentDialog создайте подкаталог с именем en.

   Примечание.

   Создайте новый каталог для каждого языкового стандарта. Например, можно добавить подкаталоги для языков fr и de locales. При необходимости эти каталоги будут содержать французские и немецкие строки и языковые пакеты.

Шаг 2. Создание файла манифеста product.xml

1. Создайте текстовый файл с именем product.xml.

2. В файле product.xml добавьте следующий XML-код. Убедитесь, что существующий XML-код не перезаписывается.

   <Product
     xmlns="http://schemas.microsoft.com/developer/2004/01/bootstrapper"
     ProductCode="Microsoft.Sample.EULA">
     <!-- Defines the list of files to be copied on build. -->
     <PackageFiles CopyAllPackageFiles="false">
       <PackageFile Name="ConsentDialog.exe"/>
     </PackageFiles>
   
     <!-- Defines how to run the Setup package.-->
     <Commands >
       <Command PackageFile = "ConsentDialog.exe" Arguments=''>
         <ExitCodes>
           <ExitCode Value="0" Result="Success" />
           <ExitCode Value="-1" Result="Fail" String="AU_Unaccepted" />
           <DefaultExitCode Result="Fail"
             FormatMessageFromSystem="true" String="GeneralFailure" />
         </ExitCodes>
       </Command>
     </Commands>
   
   </Product>
   

3. Сохраните файл в каталог загрузчика UpdateConsentDialog.

Шаг 3. Создание файла манифеста package.xml и условий лицензионного соглашения на программное обеспечение

1. Создайте текстовый файл с именем package.xml.

2. В файле package.xml добавьте следующий XML-код, чтобы определить языковой стандарт и включить условия лицензионного соглашения на программное обеспечение. Убедитесь, что существующий XML-код не перезаписывается.

   <Package
     xmlns="http://schemas.microsoft.com/developer/2004/01/bootstrapper"
     Name="DisplayName"
     Culture="Culture"
     LicenseAgreement="eula.rtf">
     <PackageFiles>
       <PackageFile Name="eula.rtf"/>
     </PackageFiles>
   
     <!-- Defines a localizable string table for error messages. -->
     <Strings>
       <String Name="DisplayName">Update Consent Dialog</String>
       <String Name="Culture">en</String>
       <String Name="AU_Unaccepted">The automatic update agreement is not accepted.</String>
       <String Name="GeneralFailure">A failure occurred attempting to launch the setup.</String>
     </Strings>
   </Package>
   

3. Сохраните файл в подкаталоге в каталоге UpdateConsentDialog bootstrapper.

4. Создайте документ с именем eula.rtf для условий лицензионного соглашения на программное обеспечение.

   Примечание.

   Условия лицензионного соглашения на программное обеспечение должны содержать сведения о лицензировании, гарантии, обязательствах и местных законах. Эти файлы должны быть языковым стандартом, поэтому убедитесь, что файл сохраняется в формате, поддерживающем МБ CS или символы ЮНИКОДа. Обратитесь к юридическому отделу по поводу содержимого условий лицензионного соглашения на программное обеспечение.

5. Сохраните документ в подкаталоге в каталоге UpdateConsentDialog bootstrapper.

6. При необходимости создайте новый файл манифеста package.xml и новый документ eula.rtf для условий лицензионного соглашения на программное обеспечение для каждого языкового стандарта. Например, если вы создали подкаталоги для языков fr и de locales, создайте отдельные файлы манифеста package.xml и условия лицензионного соглашения программного обеспечения и сохраните их в подкаталогах fr и de localdirectory.

Установка приложения согласия на обновление в качестве предварительных требований

В Visual Studio можно задать приложение "Согласие на обновление" в качестве необходимых компонентов.

Установка приложения согласия на обновление в качестве предварительных требований

1. В Обозреватель решений щелкните имя приложения, которое требуется развернуть.

2. В меню Проект выберите пункт Имя проектаСвойства.

3. Щелкните страницу публикации и выберите необходимые компоненты.

4. Диалоговое окно "Обновление согласия".

   Примечание.

   Возможно, вам придется закрыть и повторно открыть Visual Studio, чтобы увидеть диалоговое окно "Согласие на обновление" в диалоговом окне "Предварительные требования".

5. Щелкните OK.

Создание и проверка программы установки

После установки приложения "Согласие на обновление" в качестве обязательного условия можно создать установщик и загрузчик для приложения.

Чтобы создать и проверить программу установки, не нажав кнопку "Я согласен"

1. В Обозреватель решений щелкните имя приложения, которое требуется развернуть.

2. В меню Проект выберите пункт Имя проектаСвойства.

3. Щелкните страницу "Опубликовать " и нажмите кнопку "Опубликовать сейчас".

4. Если выходные данные публикации не открываются автоматически, перейдите к выходным данным публикации.

5. Запустите программу Setup.exe.

   Программа установки отображает лицензионное соглашение "Диалоговое окно согласия обновления".

6. Прочитайте лицензионное соглашение по программному обеспечению и нажмите кнопку "Принять".

   Откроется диалоговое окно "Согласие обновления" и отображается следующий текст: приложение, которое вы будете устанавливать проверка для последних обновлений в Интернете. Щелкнув "Я согласен", вы авторизуете приложение, чтобы проверка для обновлений автоматически в Интернете.

7. Закройте приложение или нажмите кнопку "Отменить".

   Приложение отображает ошибку: при установке системных компонентов для ApplicationName произошла ошибка. Установка не может продолжаться до тех пор, пока все системные компоненты не будут успешно установлены.

8. Щелкните "Сведения", чтобы отобразить следующее сообщение об ошибке: диалоговое окно согласия на обновление компонентов не удалось установить со следующим сообщением об ошибке: "Соглашение об автоматическом обновлении не принимается". Не удалось установить следующие компоненты: — диалоговое окно "Обновление согласия"

9. Нажмите кнопку Закрыть.

Чтобы создать и проверить программу установки, нажав кнопку "Я согласен"

1. В Обозреватель решений щелкните имя приложения, которое требуется развернуть.

2. В меню Проект выберите пункт Имя проектаСвойства.

3. Щелкните страницу "Опубликовать " и нажмите кнопку "Опубликовать сейчас".

4. Если выходные данные публикации не открываются автоматически, перейдите к выходным данным публикации.

5. Запустите программу Setup.exe.

   Программа установки отображает лицензионное соглашение "Диалоговое окно согласия обновления".

6. Прочитайте лицензионное соглашение по программному обеспечению и нажмите кнопку "Принять".

   Откроется диалоговое окно "Согласие обновления" и отображается следующий текст: приложение, которое вы будете устанавливать проверка для последних обновлений в Интернете. Щелкнув "Я согласен", вы авторизуете приложение, чтобы проверка для обновлений автоматически в Интернете.

7. Нажмите кнопку " Я согласен", а затем нажмите кнопку "Продолжить".

   Приложение начинает устанавливаться.

8. Если появится диалоговое окно "Установка приложения", нажмите кнопку "Установить".

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

• Обязательные требования к развертыванию приложений
• Создание пакетов начального загрузчика
• Практическое руководство. Создание манифеста продукта
• Практическое руководство. Создание манифеста пакета
• Справочные сведения о схеме пакетов и продуктов