Delen via

Overzicht: Een aangepaste bootstrapper maken met een privacyprompt

U kunt ClickOnce-toepassingen zo configureren dat deze automatisch worden bijgewerkt wanneer assembly's met nieuwere bestandsversies en assemblyversies beschikbaar komen. Om ervoor te zorgen dat uw klanten akkoord gaan met dit gedrag, kunt u een privacyprompt aan hen weergeven. Vervolgens kunnen ze kiezen of ze toestemming moeten verlenen aan de toepassing om automatisch bij te werken. Als de toepassing niet automatisch mag worden bijgewerkt, wordt deze niet geïnstalleerd.

Opmerking

De instructies in dit artikel illustreren de meest recente versie van de interactieve ontwikkelervaring (IDE) die beschikbaar is in Visual Studio. Uw computer kan verschillende namen of locaties weergeven voor sommige elementen van de gebruikersinterface. Mogelijk gebruikt u een andere versie van Visual Studio of andere omgevingsinstellingen. Zie De IDE-personaliseren voor meer informatie.

Als u een privacyprompt wilt weergeven, maakt u een toepassing waarin de lezer wordt gevraagd om toestemming te geven voor automatische updates voor de toepassing.

  1. Wijs in het menu Bestand naar Nieuw en klik vervolgens op Project.

  2. Klik in het dialoogvenster Nieuw project op Windows en klik vervolgens op WindowsFormsApplication.

  3. Typ ConsentDialog voor de naam en klik op OK.

  4. Klik in de ontwerpfunctie op het formulier.

  5. Wijzig in het venster Eigenschappen de eigenschap Tekst naar Update Consent Dialog.

  6. Vouw in de werksetAlle Windows-formulieren uit en sleep een besturingselement Label naar het formulier.

  7. Klik in de ontwerper op de labelcontrole.

  8. Wijzig in het venster Eigenschappen de eigenschap Tekst onder Vormgeving in het volgende:

    De toepassing die u gaat installeren, controleert op de meest recente updates op het web. Door op 'Ik ga akkoord' te klikken, autoriseert u de toepassing om automatisch vanaf internet op updates te controleren en te installeren.

  9. Sleep in de toolbox een Selectievakje-besturingselement naar het midden van het formulier.

  10. Wijzig in het venster Eigenschappen de eigenschap Tekst onder Indeling in Ik ga akkoord.

  11. Sleep in de Toolbox een knopbesturingselement naar de linkerbenedenhoek van het formulier.

  12. Wijzig in het venster Eigenschappen de eigenschap Tekst onder Indeling in Doorgaan.

  13. Wijzig in het venster Eigenschappen de eigenschap (Naam) onder Ontwerpen in ProceedButton.

  14. Sleep in de werkset een knopbesturingselement naar de rechterbenedenhoek van het formulier.

  15. Wijzig in het venster Eigenschappen de eigenschap Tekst onder Indeling in Annuleren.

  16. Wijzig in het venster Eigenschappen de eigenschap (Naam) onder Ontwerpen in CancelButton.

  17. Dubbelklik in de designer op het selectievakje I Agree om de CheckedChanged-gebeurtenis-handler te genereren.

  18. Voeg in het codebestand Form1 de volgende code toe voor de CheckedChanged-gebeurtenis-handler.

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

  19. Werk de klasseconstructor bij om de knop Doorgaan standaard uit te schakelen.

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

  20. Voeg in het codebestand Form1 de volgende code toe voor een Booleaanse variabele om bij te houden of de eindgebruiker toestemming heeft gegeven voor online updates.

    public bool accepted = false;

  21. Dubbelklik in de ontwerper op de knop Doorgaan om de Click-gebeurtenishandler te genereren.

  22. Voeg in het Form1-codebestand de volgende code toe aan de Click-eventhandler voor de knop Doorgaan.

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

  23. Dubbelklik in de ontwerper op de knop Annuleren om de gebeurtenishandler Klikken te genereren.

  24. Voeg in het Formulier1-codebestand de volgende code toe voor de eventhandler van de Klik-gebeurtenis voor de knop Annuleren.

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

  25. Werk de toepassing bij om een fout te retourneren als de eindgebruiker geen toestemming geeft voor online updates.

    Alleen voor Visual Basic-ontwikkelaars:

    1. Klik in Solution Explorer op ConsentDialog.

    2. Klik in het menu Project op Module toevoegen en klik vervolgens op Toevoegen.

    3. Voeg in het codebestand Module1.vb de volgende code toe.

      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. Klik in het menu Project op ConsentDialog-eigenschappen en klik vervolgens op het tabblad Toepassing .

    5. Schakel het selectievakje Toepassingsframework inschakelen uit.

    6. Selecteer Module1 in de vervolgkeuzelijst Opstartobject.

      Opmerking

      Als u het toepassingsframework uitschakelt, worden functies zoals visuele stijlen, toepassingsgebeurtenissen, welkomstscherm, toepassing met één exemplaar en meer uitgeschakeld. Zie Application Page, Project Designer (Visual Basic) voor meer informatie.

      Alleen voor Visual C#-ontwikkelaars:

      Open het codebestand Program.cs en voeg de volgende code toe.

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

  26. Klik in het menu Opbouwen op BuildSolution.

Het aangepaste bootstrapper-pakket maken

Als u de privacyprompt aan eindgebruikers wilt weergeven, kunt u een aangepast bootstrapper-pakket maken voor de toepassing Toestemming bijwerken en opnemen als een vereiste in al uw ClickOnce-toepassingen.

Deze procedure laat zien hoe u een aangepast bootstrapper-pakket maakt door de volgende documenten te maken:

  • Een product.xml manifestbestand om de inhoud van de bootstrapper te beschrijven.

  • Een package.xml manifestbestand om de lokalisatiespecifieke aspecten van uw pakket weer te geven, zoals tekenreeksen en de licentievoorwaarden voor software.

  • Een document voor de licentievoorwaarden voor software.

Stap 1: De bootstrapper-map maken

  1. Maak een map met de naam UpdateConsentDialog in de %PROGRAMFILES%\Microsoft SDK's\Windows\v7.0A\Bootstrapper\Packages.

    Opmerking

    Mogelijk hebt u beheerdersbevoegdheden nodig om deze map te maken.

  2. Maak in de map UpdateConsentDialog een submap met de naam en.

    Opmerking

    Maak een nieuwe directory voor elke locatie. U kunt bijvoorbeeld submappen toevoegen voor de fr- en de de-locaties. Deze mappen zouden de Franse en Duitse strings en taalpakketten bevatten, indien nodig.

Stap 2: het product.xml manifestbestand maken

  1. Maak een tekstbestand met de naamproduct.xml.

  2. Voeg in het bestandproduct.xml de volgende XML-code toe. Zorg ervoor dat u de bestaande XML-code niet overschrijft.

    <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. Sla het bestand op in de map UpdateConsentDialog bootstrapper.

Stap 3: het package.xml manifestbestand en de licentievoorwaarden voor software maken

  1. Maak een tekstbestand met de naampackage.xml.

  2. Voeg in het bestandpackage.xml de volgende XML-code toe om de landinstelling te definiëren en de licentievoorwaarden voor software op te nemen. Zorg ervoor dat u de bestaande XML-code niet overschrijft.

    <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. Sla het bestand op in de en-submap in de map UpdateConsentDialog bootstrapper.

  4. Maak een document met de naam eula.rtf voor de licentievoorwaarden voor software.

    Opmerking

    De licentievoorwaarden voor software moeten informatie bevatten over licenties, garanties, verplichtingen en lokale wetgeving. Deze bestanden moeten specifiek zijn voor landinstellingen, dus zorg ervoor dat het bestand is opgeslagen in een indeling die MBCS- of UNICODE-tekens ondersteunt. Raadpleeg uw juridische afdeling over de inhoud van de licentievoorwaarden voor software.

  5. Sla het document op in de en-submap in de map UpdateConsentDialog bootstrapper.

  6. Maak indien nodig een nieuw package.xml manifestbestand en een nieuw eula.rtf document voor de licentievoorwaarden voor software voor elke landinstelling. Als u bijvoorbeeld submappen voor de fr- en de landinstellingen hebt gemaakt, maakt u afzonderlijke package.xml manifestbestanden en softwarelicentievoorwaarden en slaat u deze op in de fr- en de submappen.

In Visual Studio kunt u de toepassing Toestemming bijwerken instellen als een vereiste.

  1. Klik in Solution Explorer op de naam van uw toepassing die u wilt implementeren.

  2. Klik in het menu Project op ProjectNameProperties.

  3. Klik op de pagina Publiceren en klik vervolgens op Vereisten.

  4. Selecteer het dialoogvenster Toestemming bijwerken.

    Opmerking

    Mogelijk moet u Visual Studio sluiten en opnieuw openen om het dialoogvenster Bijwerken van toestemming te zien in het Dialoogvenster Vereisten.

  5. Klik op OK.

Het installatieprogramma maken en testen

Nadat u de updatetoestemmingstoepassing hebt ingesteld als een vereiste, kunt u het installatieprogramma en de bootstrapper voor uw toepassing genereren.

Het installatieprogramma maken en testen door niet te klikken op Ik ga akkoord

  1. Klik in Solution Explorer op de naam van uw toepassing die u wilt implementeren.

  2. Klik in het menu Project op ProjectNameProperties.

  3. Klik op de pagina Publiceren en klik vervolgens op Nu publiceren.

  4. Als de publicatie-uitvoer niet vanzelf opent, navigeer dan naar de publicatie-uitvoer.

  5. Voer het Setup.exe-programma uit.

    In het installatieprogramma wordt de licentieovereenkomst voor het updatetoestemmingsdialoogvenster weergegeven.

  6. Lees de softwarelicentieovereenkomst en klik vervolgens op Accepteren.

    De toepassing Update Toestemmingsdialoog wordt weergegeven en toont de volgende tekst: De toepassing die u op het punt staat te installeren, controleert op de meest recente updates op het web. Door op Ik ga akkoord te klikken, autoriseert u de toepassing om automatisch op updates op internet te controleren.

  7. Sluit de toepassing of klik op Annuleren.

    De toepassing toont een fout: er is een fout opgetreden tijdens het installeren van systeemonderdelen voor ApplicationName. Setup kan pas worden voortgezet als alle systeemonderdelen zijn geïnstalleerd.

  8. Klik op Details om het volgende foutbericht weer te geven: het dialoogvenster voor toestemming voor componentupdate is mislukt bij het installeren met de volgende foutmelding: 'De automatische updateovereenkomst is niet geaccepteerd.' De volgende componenten konden niet worden geïnstalleerd: - Toestemmingsdialoog bijwerken.

  9. Klik op sluiten.

Om het installatieprogramma te maken en te testen, klik op 'Ik ga akkoord'

  1. Klik in Solution Explorer op de naam van uw toepassing die u wilt implementeren.

  2. Klik in het menu Project op ProjectNameProperties.

  3. Klik op de pagina Publiceren en klik vervolgens op Nu publiceren.

  4. Als de publicatie-uitvoer niet vanzelf opent, navigeer dan naar de publicatie-uitvoer.

  5. Voer het Setup.exe-programma uit.

    In het installatieprogramma wordt de licentieovereenkomst voor het updatetoestemmingsdialoogvenster weergegeven.

  6. Lees de softwarelicentieovereenkomst en klik vervolgens op Accepteren.

    De toepassing Update Toestemmingsdialoog wordt weergegeven en toont de volgende tekst: De toepassing die u op het punt staat te installeren, controleert op de meest recente updates op het web. Door op Ik ga akkoord te klikken, autoriseert u de toepassing om automatisch op updates op internet te controleren.

  7. Klik op Akkoord en klik vervolgens op Doorgaan.

    De toepassing wordt geïnstalleerd.

  8. Als het dialoogvenster Toepassing installeren wordt weergegeven, klikt u op Installeren.

Verwante inhoud