Delen via

MageUI.exe (hulpprogramma voor het genereren en bewerken van manifesten, grafische client)

  • Artikel

MageUI.exe ondersteunt dezelfde functionaliteit als het opdrachtregelprogramma Mage.exe, maar met een Windows-gebruikersinterface (UI). Met dit hulpprogramma kunt u implementatie- en toepassingsmanifesten maken, bewerken en ondertekenen. Nieuwe manifesten die zijn gemaakt met MageUI.exe zijn gericht op het clientprofiel .NET Framework 4. Eerdere versies van MageUI.exe moeten worden gebruikt voor eerdere .NET Framework versies. Wanneer u assembly's toevoegt aan of verwijdert uit een manifest of bestaande manifesten opnieuw ondertekent, wordt MageUI.exe het manifest niet bijgewerkt met het doel .NET Framework 4-clientprofiel. Zie Mage.exe (hulpprogramma voor het genereren en bewerken van manifesten) voor meer informatie.

Dit hulpprogramma wordt automatisch geïnstalleerd met Visual Studio. Als u het hulpprogramma wilt uitvoeren, gebruikt u Visual Studio Developer Command Prompt of Visual Studio Developer PowerShell.

Twee versies van Mage.exe en MageUI.exe zijn opgenomen als onderdeel van Visual Studio. Als u versie-informatie wilt zien, voert u MageUI.exe uit, selecteert u Help en selecteert u Info. In deze documentatie wordt versie 4.0.x.x van Mage.exe en MageUI.exe beschreven.

Notitie

MageUI.exe biedt geen ondersteuning voor het element compatibleFrameworks bij het opslaan van een toepassingsmanifest dat al is ondertekend met een certificaat met behulp van MageUI.exe. In plaats daarvan moet u Mage.exegebruiken.

UIElement-lijst

De volgende tabel bevat de menu- en werkbalkitems die beschikbaar zijn.

Opdracht Menu Toetsencombinatie Beschrijving
Toepassingsmanifest Bestand, Nieuw Hiermee maakt u een nieuw toepassingsmanifest.
Implementatiemanifest Bestand, Nieuw Hiermee maakt u een nieuw implementatiemanifest.
Openen File Ctrl+O Hiermee opent u een bestaand implementatiemanifest, toepassingsmanifest of vertrouwenslicentie voor bewerken.
Sluiten File Ctrl+F4 Hiermee sluit u een geopend bestand.

Als u een bestand wijzigt voordat u het sluit, wordt u MageUI.exe gevraagd het bestand opnieuw te ondertekenen met een openbare sleutel, sleutelpaar of opgeslagen certificaat.
Opslaan File CTRL+S Hiermee wordt het document dat momenteel de focus van gebruikersinvoer heeft, op schijf opgeslagen.
Opslaan als File Slaat een bestand op schijf op, zodat u een nieuwe bestandsnaam en/of locatie kunt opgeven.
Alles opslaan File Hiermee worden de wijzigingen opgeslagen die zijn aangebracht in alle bestanden die momenteel zijn geopend in MageUI.exe.
Voorkeuren File Hiermee opent u het dialoogvenster Voorkeuren . Zie de volgende sectie voor meer informatie.
Afsluiten File ALT+F4 Sluit MageUI.exe.
Knippen Bewerken Ctrl+X Hiermee verwijdert u de geselecteerde tekst uit de toepassing en verplaatst u deze naar het klembord van het systeem.
Kopiëren Bewerken Ctrl + C Kopieert de geselecteerde tekst naar het klembord van het systeem.
Plakken Bewerken Ctrl + V Hiermee plakt u tekst van het klembord van het systeem in het actieve tekstelement.
Verwijderen Bewerken Hiermee verwijdert u een element dat momenteel in een lijst is geselecteerd, zoals een vertrouwenslicentie op het tabblad Implementatiemanifest .
Alles sluiten Venster Hiermee sluit u alle bestanden die momenteel zijn geopend in MageUI.exe. Als een of meer bestanden moeten worden opgeslagen, wordt u MageUI.exe gevraagd deze op te slaan. MageUI.exe vraagt u ook om een ondertekeningssleutel te selecteren voor elk niet-ondertekend of gewijzigd bestand.
Over Help Geeft informatie over versie en copyright weer over MageUI.exe.

Dialoogvenster Voorkeuren

Het dialoogvenster Voorkeuren bevat de volgende elementen.

UI-element Beschrijving
Aanmelden bij opslaan U wordt gevraagd een bestand te ondertekenen wanneer u uw wijzigingen opslaat.
Standaardondertekeningscertificaat gebruiken Hiermee wordt de sleutel gebruikt die is ingevoerd in het tekstvak Certificaatbestand om alle bestanden te ondertekenen. Dit elimineert de ondertekeningsprompt die meestal wordt weergegeven wanneer u een bestand opslaat en Aanmelden opslaan is geselecteerd. Gebruik de knop met het beletselteken (...) naast het tekstvak Certificaatbestand om een sleutelbestand te selecteren.
Samenvattingsalgoritmen Hiermee geeft u het algoritme waarmee afhankelijkheidsamenvatten worden gegenereerd. De waarde moet 'sha256RSA' of 'sha1RSA' zijn. Maakt gebruik van SHA1 als de standaardinstelling. Wordt zowel gebruikt in toepassings- als implementatiemanifesten. Als de gebruiker een certificaat opgeeft bij het opslaan van het manifest, gebruikt u de algoritmen in het certificaat om afhankelijkheidssamenvatten met te genereren.

Dialoogvenster Opties voor ondertekening

Het dialoogvenster Opties voor ondertekening wordt weergegeven wanneer u een manifest of vertrouwenslicentie voor de eerste keer opslaat of wanneer u een manifest- of vertrouwenslicentie wijzigt. Deze optie wordt alleen weergegeven als de optie Aanmelden opslaan in het dialoogvenster Voorkeuren is geselecteerd. U moet verbinding hebben met internet wanneer u een manifest ondertekent dat een waarde opgeeft in het tekstvak TimeStamping-URI .

Dit dialoogvenster bevat de volgende elementen.

UI-element Beschrijving
Aanmelden met certificaatbestand Ondertekent het manifest met een digitaal certificaat dat is opgeslagen in het bestandssysteem.
File Biedt een gebied voor het typen van het pad naar het PFX-bestand dat het certificaat vertegenwoordigt.
... Hiermee opent u het dialoogvenster Bestand kiezen voor het selecteren van een bestaand PFX-bestand.
Nieuw Hiermee wordt een nieuwe PFX gegenereerd die niet kan worden verifieerbaar via een certificeringsinstantie (CA). Zie Trusted Application Deployment Overview (Overzicht van implementatie van vertrouwde toepassingen) voor meer informatie over de typen certificaten die worden gebruikt voor het ondertekenen van ClickOnce-implementaties.
Wachtwoord Biedt een gebied voor het typen van het wachtwoord dat wordt gebruikt voor ondertekening met dit certificaat. Indien niet van toepassing, kan leeg worden gelaten.
Aanmelden met opgeslagen certificaat Geeft een selecteerbare lijst weer met digitale certificaten die zijn opgeslagen in het certificaatarchief van uw computer.
TimeStamping-URI Geeft de URI (Uniform Resource Locator) van een digitale tijdstempelservice weer. Door de manifesten te timestampen voorkomt u dat u de manifesten opnieuw moet ondertekenen als uw digitale certificaat verloopt voordat u de volgende versie van uw toepassing implementeert. Zie Leden van het Windows-basiscertificaatprogramma en ClickOnce en Authenticode voor meer informatie.
Niet ondertekenen Hiermee kunt u het manifest opslaan zonder een handtekening uit een digitaal certificaat toe te voegen.

Beschrijvingen van tabbladen en deelvensters

Wanneer u een document met MageUI.exe opent, wordt het op een eigen tabblad weergegeven. Elk tabblad bevat een set eigenschappenvensters. De deelvensters bevatten gegroepeerde subsets van de gegevens van het document.

Tabblad Toepassingsmanifest

Op het tabblad Toepassingsmanifest wordt de inhoud van een toepassingsmanifest weergegeven. Het toepassingsmanifest beschrijft alle bestanden die deel uitmaken van de implementatie en de machtigingen die vereist zijn om de toepassing uit te voeren op de client.

Het tabblad Toepassingsmanifest bevat de volgende tabbladen.

UI-element Beschrijving
Naam Hiermee geeft u identificerende informatie over deze implementatie op.
Beschrijving Hiermee geeft u informatie over uitgever, product en ondersteuning op.
Toepassingsopties Hiermee geeft u op of dit een browsertoepassing is en of dit manifest de bron van vertrouwensinformatie is.
Bestanden Hiermee geeft u alle bestanden waaruit deze implementatie bestaat.
Vereiste machtigingen Hiermee geeft u de minimale machtigingenset op die is vereist voor de toepassing om te worden uitgevoerd op een client.

Tabblad Naam

Het tabblad Naam wordt weergegeven wanneer u voor het eerst een toepassingsmanifest maakt of opent. Het identificeert de implementatie op unieke wijze en geeft desgewenst een geldig doelplatform op.

UI-element Beschrijving
Naam Vereist. De naam van het toepassingsmanifest. Meestal hetzelfde als de bestandsnaam.
Versie Vereist. Het versienummer van de implementatie in de notatie N.N.N.N. Alleen het eerste primaire buildnummer is vereist. Voor versie 1.0 van een toepassing zijn 1geldige waarden bijvoorbeeld , 1.0, 1.0.0en 1.0.0.0.
Processor Optioneel. De machinearchitectuur waarop deze implementatie kan worden uitgevoerd. De standaardinstelling is msil, of Microsoft Intermediate Language. Dit is de standaardindeling van alle beheerde assembly's. Wijzig dit veld als u de assembly's in uw toepassing vooraf hebt gecompileerd voor een specifieke architectuur. Zie Ngen.exe (Native Image Generator) voor meer informatie over precompilatie.
Cultuur Optioneel. De tweedelige ISO-land- en regiocode waarin deze toepassing wordt uitgevoerd. De standaardwaarde is neutral.
Token voor openbare sleutel Optioneel. De openbare sleutel waarmee dit toepassingsmanifest is ondertekend. Als dit een nieuw of niet-ondertekend manifest is, wordt dit veld weergegeven als Unsigned.

Tabblad Beschrijving

Deze informatie wordt meestal opgegeven in het implementatiemanifest. Deze velden kunnen alleen worden gewijzigd als het selectievakje Vertrouwensgegevens van toepassingsmanifest gebruiken is ingeschakeld op het tabblad Toepassingsopties .

UI-element Beschrijving
Publisher De naam van de persoon of organisatie die verantwoordelijk is voor de toepassing. Deze waarde wordt gebruikt als de mapnaam van het Startmenu.
Product De volledige productnaam. Als u Lokaal installeren hebt geselecteerd voor het element Toepassingstype op het tabblad Implementatieopties van het implementatiemanifest, wordt deze naam weergegeven in de koppeling startmenu en in Programma's voor deze toepassing toevoegen of verwijderen .
Ondersteuningslocatie De URL van waaruit klanten hulp en ondersteuning voor de toepassing kunnen krijgen.

Tabblad Toepassingsopties

UI-element Beschrijving
Windows Presentation Foundation browsertoepassing Hiermee geeft u op of dit een WPF-toepassing is die in de browser wordt uitgevoerd als een XAML-browsertoepassing (XBAP).
Vertrouwensinformatie van toepassingsmanifest gebruiken Hiermee geeft u op of dit manifest vertrouwensinformatie bevat.

Tabblad Bestanden

UI-element Beschrijving
Toepassingsmap De map waarin de bestanden van de toepassing zich bevinden. Gebruik de knop met het beletselteken (...) om de map te selecteren.
Vullen Hiermee voegt u alle bestanden in de toepassingsmap en submappen toe aan het toepassingsmanifest. Als MageUI.exe één uitvoerbaar bestand in de map vindt, wordt dit automatisch gemarkeerd als het ingangspunt. Dit is het bestand dat voor het eerst wordt uitgevoerd wanneer de ClickOnce-toepassing op de client wordt gestart.
Toepassingsbestanden Een lijst met alle bestanden in de toepassing. Elk bestand heeft drie bewerkbare kenmerken, die hieronder worden besproken.
Bestandstype Bestandstype kan een van de vier waarden zijn:

-Geen.
- Ingangspunt. Het primaire uitvoerbare bestand van de toepassing. Er kan slechts één uitvoerbaar bestand worden gemarkeerd als ingangspunt.
- Gegevensbestand. Een bestand, zoals een XML-bestand, waarmee gegevens aan de toepassing worden geleverd.
- Pictogrambestand. Een toepassingspictogram, zoals wordt weergegeven op het bureaublad of in de hoek van het venster van een toepassing.
Optioneel Bestanden die als optioneel zijn gemarkeerd, worden niet gedownload bij de eerste installatie of update, maar kunnen tijdens runtime worden gedownload met behulp van de System.Deployment On-Demand API. Zie Walkthrough: Assembly's op aanvraag downloaden met de ClickOnce Deployment API met behulp van de designer voor meer informatie.
Groep Een label voor een set optionele bestanden. U kunt een groepslabel toepassen op een set bestanden en de API op aanvraag gebruiken om een batch bestanden te downloaden met één API-aanroep.

Tabblad Machtigingen vereist

Gebruik het tabblad Machtigingen vereist als u uw toepassing meer toegang tot de lokale computer wilt verlenen dan standaard wordt verleend. Zie ClickOnce-toepassingen beveiligen voor meer informatie.

UI-element Beschrijving
Type machtigingenset De minimale machtigingenset die vereist is voor deze toepassing om op de client uit te voeren. Zie Benoemde machtigingensets voor een beschrijving van deze machtigingensets en welke machtigingen ze wel of niet nodig hebben.
Details De XML die is gemaakt voor het toepassingsmanifest om de machtigingenset weer te geven. Tenzij u een goed begrip hebt van de XML-indeling van het toepassingsmanifest, moet u deze XML niet handmatig bewerken. Zie ClickOnce-toepassingsmanifest voor meer informatie.

Tabblad Implementatiemanifest

Het tabblad Implementatiemanifest bevat de volgende tabbladen.

UI-element Beschrijving
Naam Hiermee geeft u identificerende informatie over deze implementatie op.
Beschrijving Hiermee geeft u informatie over uitgever, product en ondersteuning op.
Implementatieopties Hiermee geeft u aanvullende informatie over de implementatie op, zoals het toepassingstype en de beginlocatie.
Bijwerkopties Hiermee geeft u op hoe vaak ClickOnce moet controleren op toepassingsupdates.
Toepassingsreferentie Hiermee geeft u het toepassingsmanifest voor deze implementatie.

Tabblad Naam

Het tabblad Naam wordt weergegeven wanneer u voor het eerst een implementatiemanifest maakt of opent. Het identificeert de implementatie op unieke wijze en geeft desgewenst een geldig doelplatform op.

UI-element Beschrijving
Naam Vereist. De naam van het implementatiemanifest. Meestal hetzelfde als de bestandsnaam.
Versie Vereist. Het versienummer van de implementatie in de notatie N.N.N.N. Alleen het eerste primaire buildnummer is vereist. Voor versie 1.0 van een toepassing zijn 1geldige waarden bijvoorbeeld , 1.0, 1.0.0en 1.0.0.0.
Processor Optioneel. De machinearchitectuur waarop deze implementatie kan worden uitgevoerd. De standaardinstelling is msil, of Microsoft Intermediate Language, de standaardindeling van alle beheerde assembly's. Wijzig dit veld als u de assembly's in uw toepassing hebt gecompileerd voor een specifieke architectuur.
Cultuur Optioneel. De tweedelige ISO-land-/regiocode waarin deze toepassing wordt uitgevoerd. De standaardwaarde is neutral.
Token voor openbare sleutel Optioneel. De openbare sleutel waarmee dit implementatiemanifest is ondertekend. Als dit een nieuw of niet-ondertekend manifest is, wordt dit veld weergegeven als Unsigned.

Tabblad Beschrijving

UI-element Beschrijving
Publisher Vereist. De naam van de persoon of organisatie die verantwoordelijk is voor de toepassing. Deze waarde wordt gebruikt als de mapnaam van het Startmenu.
Product Vereist. De volledige productnaam. Als u Lokaal installeren hebt geselecteerd voor het element Toepassingstype op het tabblad Implementatieopties , wordt deze naam weergegeven in de koppeling startmenu en in Programma's voor deze toepassing toevoegen of verwijderen .
Ondersteuningslocatie Optioneel. De URL van waaruit klanten hulp en ondersteuning voor de toepassing kunnen krijgen.

Tabblad Implementatieopties

UI-element Beschrijving
Toepassingstype Optioneel. Hiermee geeft u op of deze toepassing zichzelf installeert op de clientcomputer (Lokaal installeren), online wordt uitgevoerd (alleen online) of een WPF-toepassing is die wordt uitgevoerd in de browser (WPF-browsertoepassing). De standaardwaarde is Lokaal installeren.
Beginlocatie Optioneel. De URL van waaruit de toepassing daadwerkelijk moet worden gestart. Handig bij het implementeren van een toepassing vanaf een cd die zichzelf moet bijwerken vanaf het web.
Beginlocatie (ProviderURL) opnemen in het manifest Optioneel. Hiermee geeft u de URL op die Door ClickOnce wordt gecontroleerd op toepassingsupdates.
Toepassing automatisch uitvoeren na installatie Vereist. Hiermee geeft u op dat de ClickOnce-toepassing direct na de eerste installatie vanaf een URL moet worden uitgevoerd. De standaardinstelling is dat het selectievakje is ingeschakeld.
Toestaan dat URL-parameters worden doorgegeven aan de toepassing Vereist. Hiermee wordt de overdracht van parametergegevens naar de ClickOnce-toepassing toegestaan via een querytekenreeks die is toegevoegd aan de URL van het implementatiemanifest. De standaardwaarde is dat het selectievakje is uitgeschakeld.
De bestandsextensie .deploy gebruiken Vereist. Als deze optie is geselecteerd, moeten alle bestanden in het toepassingsmanifest de extensie .deploy hebben. De standaardwaarde is dat het selectievakje is uitgeschakeld.

Tabblad Bijwerkopties

Het tabblad Bijwerkopties bevat alleen opties die hier worden vermeld wanneer het keuzevak Toepassingstype op het tabblad Naam is ingesteld op Lokaal installeren.

UI-element Beschrijving
Deze toepassing moet controleren op updates Hiermee geeft u op of ClickOnce moet controleren op toepassingsupdates. Als dit selectievakje niet is ingeschakeld, controleert de toepassing niet op updates, tenzij u deze programmatisch bijwerkt met behulp van de API's in de System.Deployment.Application naamruimte.
Kiezen wanneer de toepassing moet controleren op updates Biedt twee opties voor updatecontroles:

- Voordat de toepassing wordt gestart. De updatecontrole wordt uitgevoerd voordat de toepassing wordt uitgevoerd.
- Nadat de toepassing is gestart. De updatecontrole begint zodra het hoofdformulier van de toepassing is geïnitialiseerd en wordt uitgevoerd wanneer de toepassing de volgende keer wordt gestart.
Frequentie van updatecontrole Bepaalt hoe vaak ClickOnce moet controleren op updates:

- Controleer elke keer dat de toepassing wordt uitgevoerd. ClickOnce voert een updatecontrole uit telkens wanneer de gebruiker de toepassing opent.
- Controleer elke: selecteer een tijdsinterval en een eenheid (uren, dagen of weken) die moeten verlopen voordat u op updates controleert.
Geef een minimaal vereiste versie op voor deze toepassing Optioneel. Hiermee geeft u op dat een specifieke versie van uw toepassing een vereiste installatie is, waardoor uw gebruikers niet met een eerdere versie kunnen werken.
Versie Vereist als het selectievakje Een minimaal vereiste versie voor deze toepassing opgeven is ingeschakeld. Het opgegeven versienummer moet de notatie N.N.N.N.N hebben. Alleen het eerste primaire buildnummer is vereist. Voor versie 1.0 van een toepassing zijn 1geldige waarden bijvoorbeeld , 1.0, 1.0.0en 1.0.0.0.

Tabblad Toepassingsreferentie

Het tabblad Toepassingsreferentie bevat dezelfde velden als het tabblad Naam dat eerder in dit onderwerp is beschreven. De enige uitzondering is het volgende veld.

UI-element Beschrijving
Manifest selecteren Hiermee kunt u het toepassingsmanifest kiezen. Alle andere velden op deze pagina worden ingevuld wanneer u een toepassingsmanifest kiest.

Zie ook