Procédure pas à pas : création d'un programme d'amorçage personnalisé pour afficher une invite de confidentialité

Article
02/19/2013

Vous pouvez configurer des applications ClickOnce de façon à ce qu'elles soient automatiquement mises à jour lorsque de nouvelles versions d'assemblys ou des assemblys comportant de nouvelles versions de fichiers sont disponibles.Afin de vous assurer que vos clients acceptent ce comportement, vous pouvez afficher une invite de confidentialité à leur intention.Ils peuvent ainsi choisir d'accorder l'autorisation de mise à jour automatique à l'application.S'ils n'autorisent pas cette mise à jour automatique, l'installation n'est pas effectuée.

[!REMARQUE]

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

Visual Studio 2010.

Création d'une boîte de dialogue de consentement de mise à jour

Pour afficher une invite de confidentialité, créez une application qui demande à l'utilisateur de consentir aux mises à jour automatiques de l'application.

Pour créer une boîte de dialogue de consentement

Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans la boîte de dialogue Nouveau projet, cliquez sur Windows, puis sur Application Windows Forms.
Dans Nom, tapez BoîteDialogueConsentement, puis cliquez sur OK.
Dans le concepteur, cliquez sur le formulaire.
Dans la fenêtre Propriétés, remplacez la propriété Text par Boîte de dialogue de consentement de mise à jour.
Dans la Boîte à outils, développez Tous les Windows Forms et faites glisser un contrôle Label vers le formulaire.
Dans le concepteur, cliquez sur le contrôle Label.
Dans la fenêtre Propriétés, remplacez la propriété Text sous Apparence par le texte suivant :

L'application que vous allez installer recherche les mises à jour les plus récentes sur le Web.En cliquant sur "J'accepte", vous autorisez l'application à rechercher et à installer automatiquement des mises à jour à partir d'Internet.
Dans la Boîte à outils, faites glisser un contrôle Checkbox au milieu du formulaire.
Dans la fenêtre Propriétés, remplacez la propriété Text sous Disposition par J'accepte.
Dans la Boîte à outils, faites glisser un contrôle Button vers la partie inférieure gauche du formulaire.
Dans la fenêtre Propriétés, remplacez la propriété Text sous Disposition par Continuer.
Dans la fenêtre Propriétés, remplacez la propriété (Name) sous Design par ProceedButton.
Dans la Boîte à outils, faites glisser un contrôle Button vers la partie inférieure droite du formulaire.
Dans la fenêtre Propriétés, remplacez la propriété Text sous Disposition par Annuler.
Dans la fenêtre Propriétés, remplacez la propriété (Name) sous Design par CancelButton.
Dans le concepteur, double-cliquez sur la case à cocher J'accepte pour générer le gestionnaire d'événements CheckedChanged.

Dans le fichier de code Form1, ajoutez le code suivant pour le gestionnaire d'événements CheckedChanged.

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

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

Mettez à jour le constructeur de classe afin de désactiver le bouton Continuer par défaut.

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

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

Dans le fichier de code Form1, ajoutez le code suivant pour une variable booléenne permettant de déterminer si l'utilisateur final a consenti aux mises à jour en ligne.
```
Public accepted As Boolean = False
```
```
public bool accepted = false;
```
Dans le concepteur, double-cliquez sur le bouton Continuer pour générer le gestionnaire d'événements Click.

Dans le fichier de code Form1, ajoutez le code suivant au gestionnaire d'événements Click pour le bouton Continuer.

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

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

Dans le concepteur, double-cliquez sur le bouton Annuler pour générer le gestionnaire d'événements Click.

Dans le fichier de code Form1, ajoutez le code suivant au gestionnaire d'événements Click pour le bouton Annuler.

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

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

Mettez à jour l'application afin qu'elle retourne une erreur si l'utilisateur final ne consent pas aux mises à jour en ligne.

Pour les développeurs Visual Basic uniquement :
1. Dans l'Explorateur de solutions, cliquez sur BoîteDialogueConsentement.
2. Dans le menu Projet, cliquez sur Ajouter un module, puis sur Ajouter.
3. Dans le fichier de code Module1.vb, ajoutez le code suivant.
```
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. Dans le menu Projet, cliquez sur Propriétés BoîteDialogueConsentement, puis cliquez sur l'onglet Application.
5. Désactivez Activer l'infrastructure de l'application.
6. Dans le menu déroulant Objet de démarrage, sélectionnez Module1.
  
  [!REMARQUE]
  
  La désactivation de l'infrastructure de l'application désactive des fonctionnalités telles que les styles visuels Windows XP, les événements d'application, l'écran de démarrage, l'application à instance unique, etc.Pour plus d'informations, consultez Application, page du Concepteur de projets (Visual Basic).
Pour les développeurs Visual C# uniquement :

Ouvrez le fichier de code Program.cs et ajoutez le code suivant.
```
static int Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Form1 f = new Form1();
    Application.Run(f);
    if (!f.accepted)
        return -1;
    else
        return 0;
}
```
Dans le menu Générer, cliquez sur Générer la solution.

Création du package du programme d'amorçage personnalisé

Pour afficher l'invite de confidentialité destinée aux utilisateurs finaux, vous pouvez créer un package du programme d'amorçage personnalisé pour l'application de la boîte de dialogue de consentement de mise à jour et l'inclure en tant que composant requis dans toutes vos applications ClickOnce.

Cette procédure montre comment créer un package du programme d'amorçage personnalisé en créant les documents suivants :

Un fichier manifeste product.xml pour décrire le contenu du programme d'amorçage.
Un fichier manifeste package.xml pour répertorier les aspects spécifiques à la localisation de votre package, tels que les chaînes et les termes du contrat de licence.
Un document pour les termes du contrat de licence.

Étape 1 : Pour créer le répertoire du programme d'amorçage

Créez un répertoire nommé UpdateConsentDialog dans %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages.

[!REMARQUE]

Il se peut que vous deviez disposer des privilèges d'administrateur pour créer ce dossier.
Dans le répertoire UpdateConsentDialog, créez un sous-répertoire nommé en.

[!REMARQUE]

Créez un répertoire pour chaque paramètre régional.Par exemple, vous pouvez ajouter des sous-répertoires pour les paramètres régionaux fr et de.Ces répertoires contiendront les chaînes et modules linguistiques du français et de l'allemand, si nécessaire.

Étape2 : pour créer le fichier manifeste product.xml

Créez un fichier texte appelé product.xml.

Dans le fichier product.xml, ajoutez le code XML suivant.Veillez à ne pas remplacer le code XML existant.

<Product
  xmlns="https://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>

Enregistrez le fichier dans le répertoire du programme d'amorçage UpdateConsentDialog.

Étape 3 : pour créer le fichier manifeste package.xml et les termes du contrat de licence

Créez un fichier texte appelé package.xml.

Dans le fichier package.xml, ajoutez le code XML suivant pour définir les paramètres régionaux et inclure les termes du contrat de licence.Veillez à ne pas remplacer le code XML existant.

<Package 
  xmlns="https://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>

Enregistrez le fichier dans le sous-répertoire en, dans le répertoire du programme d'amorçage UpdateConsentDialog.
Créez un document appelé eula.rtf pour les termes du contrat de licence logiciel.

[!REMARQUE]

Les termes du contrat de licence logiciel doivent inclure les informations relatives aux licences, garanties, responsabilités et réglementations régionales en vigueur.Ces fichiers doivent être spécifiques aux paramètres régionaux ; vous devez donc vous assurer que le fichier est enregistré dans un format qui prend en charge les caractères MBCS ou UNICODE.Consultez votre service juridique sur le contenu des termes du contrat de licence logiciel.
Enregistrez le document dans le sous-répertoire en, dans le répertoire du programme d'amorçage UpdateConsentDialog.
Si nécessaire, créez un nouveau fichier manifeste package.xml et un nouveau document eula.rtf pour les termes du contrat de licence logiciel pour chaque paramètre régional.Par exemple, si vous avez créé des sous-répertoires pour les paramètres régionaux fr et de, créez des fichiers manifeste package.xml et des termes de contrat de licence distincts, puis enregistrez-les dans les sous-répertoires fr et de.

Définition de l'application de consentement de mise à jour en tant que composant requis

Dans Visual Studio, vous pouvez définir l'application de consentement de mise à jour en tant que composant requis.

Pour définir l'application de consentement de mise à jour en tant que composant requis

Dans l'Explorateur de solutions, cliquez sur le nom de l'application que vous voulez déployer.
Dans le menu Projet, cliquez sur Propriétés de NomProjet.
Cliquez sur la page Publier, puis sur Composants requis.
Sélectionnez Boîte de dialogue de consentement de mise à jour.

[!REMARQUE]

Vous devrez peut-être fermer et rouvrir Visual Studio pour afficher la Boîte de dialogue de consentement de mise à jour dans la boîte de dialogue Composants requis.
Cliquez sur OK.

Création et test du programme d'installation

Après avoir défini l'application de consentement de mise à jour en tant que composant requis, vous pouvez générer le programme d'installation et le programme d'amorçage pour votre application.

Pour créer et tester le programme d'installation sans cliquer sur J'accepte

Dans l'Explorateur de solutions, cliquez sur le nom de l'application que vous voulez déployer.
Dans le menu Projet, cliquez sur Propriétés de NomProjet.
Cliquez sur la page Publier, puis sur Publier maintenant.
Si la sortie publiée ne s'ouvre pas automatiquement, naviguez jusqu'à celle-ci.
Exécutez le programme Setup.exe.

Le programme d'installation affiche le contrat de licence logiciel de la Boîte de dialogue de consentement de mise à jour.
Lisez le contrat de licence logiciel, puis cliquez sur Accepter.

L'application Boîte de dialogue de consentement de mise à jour s'affiche avec le texte suivant : L'application que vous allez installer recherche les mises à jour les plus récentes sur le Web.En cliquant sur J'accepte, vous autorisez l'application à rechercher des mises à jour automatiquement sur Internet.
Fermez l'application ou cliquez sur Annuler.

L'application affiche une erreur : Une erreur s'est produite lors de l'installation des composants systèmes pour NomApplication.Le programme d'installation ne peut pas continuer tant que tous les composants système n'ont pas été correctement installés.
Cliquez sur Détails pour afficher le message d'erreur suivant : L'installation du composant Boîte de dialogue de consentement de mise à jour a échoué avec le message d'erreur suivant : "L'accord de mise à jour automatique n'a pas été accepté." Les composants suivants n'ont pas été installés : - Boîte de dialogue de consentement de mise à jour
Cliquez sur Fermer.

Pour créer et tester le programme d'installation en cliquant sur J'accepte

Dans l'Explorateur de solutions, cliquez sur le nom de l'application que vous voulez déployer.
Dans le menu Projet, cliquez sur Propriétés de NomProjet.
Cliquez sur la page Publier, puis sur Publier maintenant.
Si la sortie publiée ne s'ouvre pas automatiquement, naviguez jusqu'à celle-ci.
Exécutez le programme Setup.exe.

Le programme d'installation affiche le contrat de licence logiciel de la Boîte de dialogue de consentement de mise à jour.
Lisez le contrat de licence logiciel, puis cliquez sur Accepter.

L'application Boîte de dialogue de consentement de mise à jour s'affiche avec le texte suivant : L'application que vous allez installer recherche les mises à jour les plus récentes sur le Web.En cliquant sur J'accepte, vous autorisez l'application à rechercher des mises à jour automatiquement sur Internet.
Cliquez sur J'accepte, puis sur Continuer.

L'installation de l'application démarre.
Si la boîte de dialogue d'installation d'application apparaît, cliquez sur Installer.

Voir aussi

Partager via