MageUI.exe (manifestgenererings- och redigeringsverktyg, grafisk klient)
MageUI.exe har stöd för samma funktioner som kommandoradsverktyget Mage.exe, men med ett Windows-baserat användargränssnitt (UI). Med det här verktyget kan du skapa, redigera och signera distributions- och programmanifest. Nya manifest som skapas med MageUI.exe riktas mot .NET Framework 4-klientprofilen. Tidigare versioner av MageUI.exe ska användas som mål för tidigare .NET Framework versioner. När du lägger till eller tar bort sammansättningar från ett manifest eller omsignerar befintliga manifest uppdaterar MageUI.exe inte manifestet till mål .NET Framework 4-klientprofilen. Mer information finns iMage.exe (manifestgenerering och redigeringsverktyg).
Det här verktyget installeras automatiskt med Visual Studio. Om du vill köra verktyget använder du Visual Studio Developer Command Prompt eller Visual Studio Developer PowerShell.
Två versioner av Mage.exe och MageUI.exe ingår som en komponent i Visual Studio. Om du vill se versionsinformation kör du MageUI.exe, väljer Hjälp och väljer Om. Den här dokumentationen beskriver version 4.0.x.x av Mage.exe och MageUI.exe.
Anteckning
MageUI.exe stöder inte compatibleFrameworks-elementet när du sparar ett programmanifest som redan har signerats med ett certifikat med hjälp av MageUI.exe. I stället måste du använda Mage.exe.
UIElement-lista
I följande tabell visas de meny- och verktygsfältsobjekt som är tillgängliga.
| Kommando | Meny | Genväg | Description |
|---|---|---|---|
| Programmanifest | Fil, ny | Skapar ett nytt programmanifest. | |
| Distributionsmanifest | Fil, ny | Skapar ett nytt distributionsmanifest. | |
| Öppna | Fil | CTRL+O | Öppnar ett befintligt distributionsmanifest, programmanifest eller förtroendelicens för redigering. |
| Stäng | Fil | CTRL+F4 | Stänger en öppen fil. Om du ändrar en fil innan du stänger den uppmanar MageUI.exe dig att signera om filen med en offentlig nyckel, ett nyckelpar eller ett lagrat certifikat. |
| Spara | Fil | CTRL+S | Sparar för att diska dokumentet som för närvarande har fokus på användarindata. |
| Spara som | Fil | Sparar en fil på disk, så att du kan ange ett nytt filnamn och/eller plats. | |
| Spara alla | Fil | Sparar ändringarna som gjorts i alla filer som är öppna inom MageUI.exe. | |
| Inställningar | Fil | Öppnar dialogrutan Inställningar . Mer information finns i följande avsnitt. | |
| Avsluta | Fil | ALT+F4 | Avslutar MageUI.exe. |
| Klipp ut | Redigera | CTRL+X | Tar bort den markerade texten från programmet och flyttar den till systemets Urklipp. |
| Kopiera | Redigera | CTRL+C | Kopierar den markerade texten till systemets Urklipp. |
| Klistra in | Redigera | CTRL+V | Klistrar in text från systemets Urklipp i det aktuella aktiva textelementet. |
| Ta bort | Redigera | Tar bort ett element som är markerat i en lista, till exempel en förtroendelicens på fliken Distributionsmanifest . | |
| Stäng alla | Fönster | Stänger alla filer som för närvarande är öppna i MageUI.exe. Om en eller flera filer behöver sparas uppmanar MageUI.exe dig att spara dem. MageUI.exe uppmanar dig också att välja en signeringsnyckel för varje osignerad eller ändrad fil. | |
| Om | Hjälp | Visar version och copyrightinformation om MageUI.exe. |
Dialogrutan
Dialogrutan Inställningar innehåller följande element.
| Gränssnittselement | Description |
|---|---|
| Spara inloggning | Uppmanar dig att signera en fil när du sparar ändringarna. |
| Använd standardsigneringscertifikat | Använder nyckeln som anges i textrutan Certifikatfil för att signera alla filer. Detta eliminerar signeringsprompten som vanligtvis visas när du sparar en fil och Logga in Spara har valts. Använd knappen med tre punkter (...) bredvid textrutan Certifikatfil för att välja en nyckelfil. |
| Sammanfattad algoritm | Anger algoritmen som beroendesammandrag ska genereras med. Värdet måste vara "sha256RSA" eller "sha1RSA". Använder SHA1 som standard. Används både i program- och distributionsmanifest. Om användaren tillhandahåller ett certifikat när manifestet sparas använder algoritmerna i certifikatet för att generera beroendesammandrag med. |
Dialogrutan Signeringsalternativ
Dialogrutan Signeringsalternativ visas när du sparar ett manifest eller en förtroendelicens för första gången, eller när du ändrar ett manifest eller en förtroendelicens. Det visas bara om alternativet Spara inloggning i dialogrutan Inställningar är markerat. Du måste vara ansluten till Internet när du signerar ett manifest som anger ett värde i textrutan Tidsstämplings-URI .
Den här dialogrutan innehåller följande element.
| Gränssnittselement | Description |
|---|---|
| Signera med certifikatfil | Signerar manifestet med ett digitalt certifikat som lagras i filsystemet. |
| Fil | Innehåller ett område där du kan skriva sökvägen till pfx-filen som representerar certifikatet. |
| ... | Öppnar dialogrutan Välj fil för att välja en befintlig .pfx-fil. |
| Nytt | Genererar en ny .pfx som inte kan verifieras via en certifikatutfärdare (CA). Mer information om de typer av certifikat som används för signering av ClickOnce-distributioner finns i Översikt över distribution av betrodda program. |
| Lösenord | Innehåller ett område där du kan ange lösenordet som används för signering med det här certifikatet. Om det inte är tillämpligt kan lämnas tomt. |
| Signera med lagrat certifikat | Visar en urvalsbar lista över digitala certifikat som lagras i datorns certifikatarkiv. |
| Tidsstämplings-URI | Visar URI (Uniform Resource Locator) för en digital tidsstämplingstjänst. Tidsstämpling av manifesten hindrar dig från att behöva signera om manifesten om ditt digitala certifikat upphör att gälla innan du distribuerar nästa version av programmet. Mer information finns i Windows-rotcertifikatprogrammedlemmar och ClickOnce och Authenticode. |
| Signera inte | Gör att du kan spara manifestet utan att lägga till en signatur från ett digitalt certifikat. |
Beskrivningar av flikar och paneler
När du öppnar ett dokument med MageUI.exe visas det på en egen fliksida. Varje flik innehåller en uppsättning egenskapspaneler. Panelerna innehåller grupperade delmängder av dokumentets data.
Fliken Programmanifest
På fliken Programmanifest visas innehållet i ett programmanifest. Programmanifestet beskriver alla filer som ingår i distributionen och de behörigheter som krävs för att programmet ska kunna köras på klienten.
Fliken Programmanifest innehåller följande flikar.
| Gränssnittselement | Beskrivning |
|---|---|
| Namn | Anger identifierande information om den här distributionen. |
| Beskrivning | Anger information om utgivare, produkt och support. |
| Programalternativ | Anger om det här är ett webbläsarprogram och om manifestet är källan till förtroendeinformation. |
| Filer | Anger alla filer som utgör den här distributionen. |
| Behörigheter som krävs | Anger den minsta behörighetsuppsättning som krävs av programmet för att köras på en klient. |
Namnflik
Fliken Namn visas när du först skapar eller öppnar ett programmanifest. Den identifierar distributionen unikt och anger eventuellt en giltig målplattform.
| Gränssnittselement | Beskrivning |
|---|---|
| Namn | Krävs. Namnet på programmanifestet. Vanligtvis samma som filnamnet. |
| Version | Krävs. Versionsnumret för distributionen i formatet N.N.N.N. Endast det första större versionsnumret krävs. För till exempel version 1.0 av ett program skulle giltiga värden innehålla 1, 1.0, 1.0.0och 1.0.0.0. |
| Processor | Valfritt. Den datorarkitektur som den här distributionen kan köras på. Standardvärdet är msil, eller Microsoft Intermediate Language, som är standardformatet för alla hanterade sammansättningar. Ändra det här fältet om du har förkompilerat sammansättningarna i ditt program för en specifik arkitektur. Mer information om förkompilering finns iNgen.exe (Native Image Generator). |
| Kultur | Valfritt. Den ISO-lands- och regionkod i två delar där det här programmet körs. Standardvärdet är neutral. |
| Token för offentlig nyckel | Valfritt. Den offentliga nyckeln som programmanifestet har signerats med. Om det här är ett nytt eller osignerat manifest visas det här fältet som Unsigned. |
Fliken Beskrivning
Den här informationen tillhandahålls vanligtvis i distributionsmanifestet. Dessa fält kan bara ändras om kryssrutan Använd förtroendeinformation för programmanifestet är markerad på fliken Programalternativ .
| Gränssnittselement | Description |
|---|---|
| Utgivare | Namnet på den person eller organisation som ansvarar för programmet. Det här värdet används som mappnamn på Start-menyn. |
| Produkt | Det fullständiga produktnamnet. Om du har valt Installera lokalt för elementet Programtyp på fliken Distributionsalternativ i distributionsmanifestet visas det här namnet på Start-menylänken och i Lägg till eller ta bort program för det här programmet. |
| Supportplats | Den URL som kunder kan få hjälp och support från för programmet. |
Fliken Programalternativ
| Gränssnittselement | Description |
|---|---|
| Windows Presentation Foundation webbläsarprogram | Anger om det här är ett WPF-program som körs i webbläsaren som ett XAML-webbläsarprogram (XBAP). |
| Använda förtroendeinformation för programmanifest | Anger om manifestet innehåller förtroendeinformation. |
Fliken Filer
| Gränssnittselement | Description |
|---|---|
| Programkatalog | Katalogen där programmets filer finns. Använd ellipsknappen (...) för att välja katalogen. |
| Fylla | Lägger till alla filer i programkatalogen och underkatalogerna till programmanifestet. Om MageUI.exe hittar en enda körbar fil i katalogen markeras den automatiskt som startpunkt, vilket är den fil som först körs när ClickOnce-programmet startas på klienten. |
| Programfiler | Visar en lista över alla filer i programmet. Varje fil har tre redigerbara attribut som beskrivs nedan. |
| Filtyp | Filtyp kan vara ett av fyra värden: -Ingen. - Startpunkt. Programmets primära körbara fil. Endast en körbar fil kan markeras som startpunkt. – Datafil. En fil, till exempel en XML-fil, som tillhandahåller data till programmet. – Ikonfil. En programikon, till exempel visas på skrivbordet eller i hörnet av ett programs fönster. |
| Valfritt | Filer som markerats som valfria laddas inte ned vid den första installationen eller uppdateringen, men kan laddas ned vid körning med hjälp av API:et System.Deployment on-Demand. Mer information finns i Genomgång: Ladda ned sammansättningar på begäran med ClickOnce Deployment-API:et Med designern. |
| Grupper | En etikett för en uppsättning valfria filer. Du kan använda en gruppetikett på en uppsättning filer och använda API:et på begäran för att ladda ned en batch med filer med ett enda API-anrop. |
Fliken Behörigheter som krävs
Använd fliken Behörigheter som krävs om du behöver ge programmet mer åtkomst till den lokala datorn än vad som är beviljat som standard. Mer information finns i Skydda ClickOnce-program.
| Gränssnittselement | Description |
|---|---|
| Typ av behörighetsuppsättning | Den minsta behörighetsuppsättning som krävs av det här programmet för att köras på klienten. En beskrivning av dessa behörighetsuppsättningar och vilka behörigheter de behöver eller inte kräver finns i Namngivna behörighetsuppsättningar. |
| Information | DEN XML som skapats för programmanifestet för att representera behörighetsuppsättningen. Såvida du inte har god förståelse för XML-formatet för programmanifestet bör du inte redigera denna XML manuellt. Mer information finns i ClickOnce-programmanifest. |
Fliken Distributionsmanifest
Fliken Distributionsmanifest innehåller följande flikar.
| Gränssnittselement | Beskrivning |
|---|---|
| Namn | Anger identifierande information om den här distributionen. |
| Beskrivning | Anger information om utgivare, produkt och support. |
| Distributionsalternativ | Anger ytterligare information om distributionen, till exempel programtyp och startplats. |
| Uppdateringsalternativ | Anger hur ofta ClickOnce ska söka efter programuppdateringar. |
| Programreferens | Anger programmanifestet för den här distributionen. |
Namnflik
Fliken Namn visas när du först skapar eller öppnar ett distributionsmanifest. Den identifierar distributionen unikt och anger eventuellt en giltig målplattform.
| Gränssnittselement | Beskrivning |
|---|---|
| Namn | Krävs. Namnet på distributionsmanifestet. Vanligtvis samma som filnamnet. |
| Version | Krävs. Versionsnumret för distributionen i formatet N.N.N.N. Endast det första större versionsnumret krävs. För till exempel version 1.0 av ett program skulle giltiga värden innehålla 1, 1.0, 1.0.0och 1.0.0.0. |
| Processor | Valfritt. Den datorarkitektur som den här distributionen kan köras på. Standardvärdet är msil, eller Microsoft Intermediate Language, standardformatet för alla hanterade sammansättningar. Ändra det här fältet om du har kompilerat sammansättningarna i ditt program för en specifik arkitektur. |
| Kultur | Valfritt. Den ISO-lands-/regionkod i två delar där det här programmet körs. Standardvärdet är neutral. |
| Token för offentlig nyckel | Valfritt. Den offentliga nyckeln som distributionsmanifestet har signerats med. Om det här är ett nytt eller osignerat manifest visas det här fältet som Unsigned. |
Fliken Beskrivning
| Gränssnittselement | Description |
|---|---|
| Utgivare | Krävs. Namnet på den person eller organisation som ansvarar för programmet. Det här värdet används som mappnamn på Start-menyn. |
| Produkt | Krävs. Det fullständiga produktnamnet. Om du har valt Installera lokalt för elementet Programtyp på fliken Distributionsalternativ visas det här namnet i startmenylänken och i Lägg till eller ta bort program för det här programmet. |
| Supportplats | Valfritt. Den URL som kunder kan få hjälp och support från för programmet. |
Fliken Distributionsalternativ
| Gränssnittselement | Description |
|---|---|
| Programtyp | Valfritt. Anger om det här programmet installeras på klientdatorn (Installera lokalt), körs online (endast online) eller om det är ett WPF-program som körs i webbläsaren (WPF-webbläsarprogram). Standardinställningen är Installera lokalt. |
| Startplats | Valfritt. Url:en som programmet faktiskt ska startas från. Användbart när du distribuerar ett program från en CD som ska uppdateras från webben. |
| Inkludera startplats (ProviderURL) i manifestet | Valfritt. Anger den URL som ClickOnce ska undersöka för programuppdateringar. |
| Kör programmet automatiskt efter installationen | Krävs. Anger att ClickOnce-programmet ska köras omedelbart efter den första installationen från en URL. Standardvärdet är att kryssrutan är markerad. |
| Tillåt att URL-parametrar skickas till programmet | Krävs. Tillåter överföring av parameterdata till ClickOnce-programmet via en frågesträng som läggs till i distributionsmanifestets URL. Standardvärdet är att kryssrutan är avmarkerad. |
| Använda filnamnstillägget .deploy | Krävs. När du väljer det här alternativet måste alla filer i programmanifestet ha tillägget .deploy. Standardvärdet är att kryssrutan är avmarkerad. |
Fliken Uppdateringsalternativ
Fliken Uppdateringsalternativ innehåller bara de alternativ som anges här när markeringsrutan Programtyp på fliken Namn är inställd på Installera lokalt.
| Gränssnittselement | Description |
|---|---|
| Det här programmet bör söka efter uppdateringar | Anger om ClickOnce ska söka efter programuppdateringar. Om den här kryssrutan inte är markerad söker programmet inte efter uppdateringar om du inte uppdaterar den programmatiskt med hjälp av API:erna i System.Deployment.Application namnområdet. |
| Välj när programmet ska söka efter uppdateringar | Innehåller två alternativ för uppdateringskontroller: - Innan programmet startar. Uppdateringskontrollen utförs före programkörningen. - När programmet har startats. Uppdateringskontrollen börjar när programmets huvudform har initierats och körs nästa gång programmet startas. |
| Frekvens för uppdateringskontroll | Avgör hur ofta ClickOnce ska söka efter uppdateringar: - Kontrollera varje gång programmet körs. ClickOnce utför en uppdateringskontroll varje gång användaren öppnar programmet. - Kontrollera var: Välj ett tidsintervall och en enhet (timmar, dagar eller veckor) som måste förflutit innan du söker efter uppdateringar. |
| Ange en lägsta version som krävs för det här programmet | Valfritt. Anger att en specifik version av programmet är en obligatorisk installation, vilket hindrar användarna från att arbeta med en tidigare version. |
| Version | Krävs om kryssrutan Ange en lägsta version som krävs för det här programmet är markerad. Det angivna versionsnumret måste ha formatet N.N.N.N. Endast det första större versionsnumret krävs. För till exempel version 1.0 av ett program skulle giltiga värden innehålla 1, 1.0, 1.0.0och 1.0.0.0. |
Fliken Programreferens
Fliken Programreferens innehåller samma fält som fliken Namn som beskrivs tidigare i det här avsnittet. Det enda undantaget är följande fält.
| Gränssnittselement | Description |
|---|---|
| Välj manifest | Gör att du kan välja programmanifestet. Alla andra fält på den här sidan fylls i när du väljer ett programmanifest. |
