Megosztás a következőn keresztül:

MageUI.exe (Jegyzéklétrehozási és -szerkesztő eszköz, Grafikus ügyfél)

  • Cikk

MageUI.exe ugyanazt a funkciót támogatja, mint a parancssori eszköz Mage.exe, de Windows-alapú felhasználói felülettel (UI). Ezzel az eszközzel üzembe helyezési és alkalmazásjegyzékeket hozhat létre, szerkeszthet és írhat alá. A MageUI.exe létrehozott új jegyzékek a .NET-keretrendszer 4 ügyfélprofilra irányulnak. A MageUI.exe korábbi verzióit kell használni a korábbi .NET-keretrendszer verziók megcélzásához. Ha szerelvényeket ad hozzá vagy távolít el egy jegyzékfájlból, vagy újra aláírja a meglévő jegyzékfájlokat, MageUI.exe nem frissíti a jegyzékfájlt a 4. ügyfélprofil .NET-keretrendszer célként. További információ: Mage.exe (Jegyzéklétrehozás és -szerkesztő eszköz).

Ez az eszköz automatikusan telepítve van a Visual Studióval. Az eszköz futtatásához használja a Visual Studio fejlesztői parancssorát vagy a Visual Studio Developer PowerShellt.

A Mage.exe és a MageUI.exe két verziója a Visual Studio összetevője. A verzióinformációk megtekintéséhez futtassa a MageUI.exe, válassza a Súgó, majd a Névjegy lehetőséget. Ez a dokumentáció a Mage.exe és MageUI.exe 4.0.x.x verzióját ismerteti.

Megjegyzés

MageUI.exe nem támogatja a kompatibilisFrameworks elemet egy olyan alkalmazásjegyzék mentésekor, amely már aláírt egy tanúsítvánnyal a MageUI.exe használatával. Ehelyett aMage.exekell használnia.

Felhasználói felületi elemek listája

Az alábbi táblázat felsorolja az elérhető menü- és eszköztárelemeket.

Parancs Menü Parancsikont Description
Alkalmazásjegyzék Fájl, Új Létrehoz egy új alkalmazásjegyzéket.
Üzembehelyezési jegyzék Fájl, Új Létrehoz egy új üzembehelyezési jegyzékfájlt.
Megnyitás Fájl CTRL+O Megnyit egy meglévő üzembehelyezési jegyzékfájlt, alkalmazásjegyzéket vagy megbízhatósági licencet szerkesztésre.
Bezárás Fájl CTRL+F4 Bezár egy megnyitott fájlt.

Ha a bezárása előtt módosít egy fájlt, MageUI.exe kéri, hogy írja alá újra a fájlt egy nyilvános kulccsal, kulcspárral vagy tárolt tanúsítvánnyal.
Mentés Fájl CTRL+S Menti a lemezre azt a dokumentumot, amely jelenleg felhasználói beviteli fókuszú.
Mentés másként Fájl Lemezre menti a fájlt, így új fájlnevet és/vagy helyet adhat meg.
Az összes mentése Fájl Menti a MageUI.exe jelenleg megnyitott összes fájl módosításait.
Beállítások Fájl Megnyitja a Beállítások párbeszédpanelt. További információért tekintse meg az alábbi szakaszt.
Kilépés Fájl ALT+F4 Kilép MageUI.exe.
Cut Szerkesztés CTRL+X Eltávolítja a jelenleg kijelölt szöveget az alkalmazásból, és áthelyezi a rendszer vágólapjára.
Másolás Szerkesztés CTRL+C Másolja az aktuálisan kijelölt szöveget a vágólapra.
Beillesztés Szerkesztés CTRL+V Szöveg beillesztése a rendszer vágólapjáról az aktuálisan aktív szövegelembe.
Törlés Szerkesztés Törli a listában jelenleg kijelölt elemet, például egy megbízhatósági licencet az Üzembehelyezési jegyzék lapon.
Az összes bezárása Ablak Bezárja az MageUI.exe jelenleg megnyitott összes fájlt. Ha egy vagy több fájlt menteni szeretne, MageUI.exe kéri, hogy mentse őket. MageUI.exe arra is kéri, hogy válasszon ki egy aláíró kulcsot az egyes aláíratlan vagy módosított fájlokhoz.
Információ Súgó A MageUI.exe verzió- és szerzői jogi információinak megjelenítése.

Beállítások párbeszédpanel

A Beállítások párbeszédpanel a következő elemeket tartalmazza.

Felhasználói felületi elem Description
Bejelentkezés mentésre A módosítások mentésekor a rendszer arra kéri, hogy írja alá a fájlt.
Alapértelmezett aláíró tanúsítvány használata A Tanúsítványfájl szövegmezőben megadott kulccsal írja alá az összes fájlt. Ez kiküszöböli azt az aláírási kérést, amely általában egy fájl mentésekor jelenik meg, és a Bejelentkezés a mentésre lehetőség van kiválasztva. A tanúsítványfájl szövegmezője melletti három pont (...) segítségével jelöljön ki egy kulcsfájlt.
Kivonatoló algoritmus Megadja azt az algoritmust, amellyel függőségi kivonatokat hozhat létre. Az értéknek "sha256RSA" vagy "sha1RSA" értékűnek kell lennie. Az SHA1-et használja alapértelmezettként. Az alkalmazás- és üzembehelyezési jegyzékekben egyaránt használható. Ha a felhasználó tanúsítványt biztosít a jegyzék mentésekor, a tanúsítvány algoritmusaival függőségi kivonatokat hozhat létre.

Aláírási beállítások párbeszédpanel

Az Aláírási beállítások párbeszédpanel akkor jelenik meg, ha első alkalommal ment egy jegyzék- vagy megbízhatósági licencet, vagy amikor módosít egy jegyzék- vagy megbízhatósági licencet. Csak akkor jelenik meg, ha a BeállításokpárbeszédpanelEn a Bejelentkezés mentésre lehetőség van kiválasztva. A TimeStamping URI szövegmezőben egy értéket meghatározó jegyzék aláírásakor csatlakoznia kell az internethez.

Ez a párbeszédpanel a következő elemeket tartalmazza.

Felhasználói felületi elem Description
Bejelentkezés tanúsítványfájllal Aláírja a jegyzékfájlt egy, a fájlrendszerben tárolt digitális tanúsítvánnyal.
Fájl Itt adhatja meg a tanúsítványt képviselő .pfx fájl elérési útját.
... Megnyitja a Fájl kiválasztása párbeszédpanelt egy meglévő .pfx-fájl kiválasztásához.
Új Létrehoz egy új .pfx-et, amely nem ellenőrizhető hitelesítésszolgáltatón keresztül. A ClickOnce-üzemelő példányok aláírásához használt tanúsítványtípusokról további információt a Megbízható alkalmazástelepítés áttekintése című témakörben talál.
Jelszó Itt adhatja meg a tanúsítvánnyal való aláíráshoz használt jelszót. Ha nem alkalmazható, üresen hagyható.
Bejelentkezés tárolt tanúsítvánnyal Megjeleníti a számítógép tanúsítványtárolójában tárolt digitális tanúsítványok választható listáját.
TimeStamping URI Megjeleníti egy digitális időbélyegző szolgáltatás egységes erőforrás-lokátorát (URI). A jegyzékek időbélyegzővel történő beállítása megakadályozza, hogy újra alá kell írnia a jegyzékfájlokat, ha a digitális tanúsítvány lejár az alkalmazás következő verziójának üzembe helyezése előtt. További információ: A Windows főtanúsítvány-program tagjai és a ClickOnce és az Authenticode.
Ne írja alá Lehetővé teszi a jegyzékfájl mentését anélkül, hogy digitális tanúsítványból származó aláírást ad hozzá.

Lap és panel leírása

Amikor megnyit egy dokumentumot MageUI.exe, az a saját lapfülén belül jelenik meg. Minden lap tulajdonságpaneleket tartalmaz. A panelek a dokumentum adatainak csoportosított részhalmazait tartalmazzák.

Alkalmazásjegyzék lap

Az Alkalmazásjegyzék lapon megjelenik egy alkalmazásjegyzék tartalma. Az alkalmazásjegyzék ismerteti az üzembe helyezéshez tartozó összes fájlt, valamint az alkalmazás ügyfélen való futtatásához szükséges engedélyeket.

Az Alkalmazásjegyzék lap az alábbi lapokat tartalmazza.

Felhasználói felületi elem Leírás
Név Meghatározza az üzembe helyezéssel kapcsolatos információk azonosítását.
Leírás Megadja a közzétevői, termék- és támogatási információkat.
Alkalmazásbeállítások Meghatározza, hogy böngészőalkalmazásról van-e szó, és hogy ez a jegyzékfájl-e a megbízhatósági információk forrása.
Fájlok Megadja az üzembe helyezést alkotó összes fájlt.
Engedélyek szükségesek Megadja az alkalmazás által az ügyfélen való futtatáshoz szükséges minimális engedélykészletet.

Név lap

A Név lap az alkalmazásjegyzék első létrehozásakor vagy megnyitásakor jelenik meg. Egyedileg azonosítja az üzembe helyezést, és opcionálisan meghatároz egy érvényes célplatformot.

Felhasználói felületi elem Leírás
Név Kötelező. Az alkalmazásjegyzék neve. Általában ugyanaz, mint a fájlnév.
Verzió Kötelező. Az üzembe helyezés verziószáma N.N.N.N. formátumban. Csak az első fő buildszámra van szükség. Egy alkalmazás 1.0-s verziójához például az érvényes értékek a következők 1lehetnek: , 1.0, 1.0.0, és 1.0.0.0.
Processzor Választható. Az a gépi architektúra, amelyen ez az üzembe helyezés futtatható. Az alapértelmezett érték a msil, vagy a Microsoft köztes nyelve, amely az összes felügyelt szerelvények alapértelmezett formátuma. Módosítsa ezt a mezőt, ha előre lefordította az alkalmazásban lévő szerelvényeket egy adott architektúrához. Az előfordításról további információt a Ngen.exe (natív képgenerátor) című témakörben talál.
Kultúra Választható. A kétrészes ISO-ország- és régiókód, amelyben az alkalmazás fut. A mező alapértelmezett értéke: neutral.
Nyilvános kulcs jogkivonata Választható. Az a nyilvános kulcs, amellyel ezt az alkalmazásjegyzéket aláírták. Ha ez egy új vagy aláíratlan jegyzékfájl, ez a mező a következőként jelenik meg: Unsigned.

Leírás lap

Ezek az információk általában az üzembehelyezési jegyzékben találhatók. Ezek a mezők csak akkor módosíthatók, ha az Alkalmazásjegyzék megbízhatósági adatainak használata jelölőnégyzet be van jelölve az Alkalmazásbeállítások lapon.

Felhasználói felületi elem Description
Publisher Az alkalmazásért felelős személy vagy szervezet neve. Ezt az értéket használja a Start menü mappaneveként.
Product A teljes terméknév. Ha a Telepítés helyileg lehetőséget választotta az alkalmazástípus elemhez az üzembehelyezési jegyzék Üzembe helyezési beállítások lapján, ez a név jelenik meg a Start menü hivatkozásában és az alkalmazás Programok hozzáadása vagy eltávolítása elemében.
Támogatási hely Az AZ URL-cím, amelyről az ügyfelek segítséget és támogatást kérhetnek az alkalmazáshoz.

Alkalmazásbeállítások lap

Felhasználói felületi elem Description
Windows megjelenítési alaprendszer böngészőalkalmazás Meghatározza, hogy ez egy OLYAN WPF-alkalmazás-e, amely XAML böngészőalkalmazásként (XBAP) fut a böngészőben.
Alkalmazásjegyzék megbízhatósági adatainak használata Meghatározza, hogy ez a jegyzék tartalmaz-e megbízhatósági adatokat.

Fájlok lap

Felhasználói felületi elem Description
Alkalmazáskönyvtár Az a könyvtár, amelyben az alkalmazás fájljai találhatók. A könyvtár kiválasztásához használja a három pontot (...).
Feltölteni Hozzáadja az alkalmazáskönyvtárban és az alkönyvtárban lévő összes fájlt az alkalmazásjegyzékhez. Ha MageUI.exe egyetlen végrehajtható fájlt talál a könyvtárban, az automatikusan belépési pontként jelöli meg, amely a ClickOnce alkalmazás ügyfélen való elindításakor először végrehajtott fájl.
Alkalmazásfájlok Az alkalmazás összes fájlját listázza. Mindegyik fájl három szerkeszthető attribútummal rendelkezik, ezekről az alábbiakban olvashat.
Fájltípus A fájltípus a következő négy érték egyike lehet:

-Nincs.
- Belépési pont. Az alkalmazás elsődleges végrehajtható fájlja. Belépési pontként csak egy végrehajtható fájl jelölhető meg.
- Adatfájl. Egy fájl, például egy XML-fájl, amely adatokat szolgáltat az alkalmazásnak.
- Ikonfájl. Az alkalmazás ikonja, például az asztalon vagy az alkalmazás ablakának sarkában jelenik meg.
Nem kötelező Az opcionálisként megjelölt fájlok nem töltődnek le a kezdeti telepítéskor vagy frissítéskor, de futtatáskor a System.Deployment On-Demand API használatával tölthetők le. További információ : Útmutató: Szerelvények letöltése igény szerint a ClickOnce Deployment API-val a Tervező használatával.
Csoport Nem kötelező fájlok címkéje. Csoportcímkét alkalmazhat egy fájlkészletre, és az Igény szerinti API-val egyetlen API-hívással tölthet le egy kötegnyi fájlt.

Engedélyek kötelező lapja

Ha az alapértelmezettnél több hozzáférést kell biztosítania az alkalmazásnak a helyi számítógéphez, használja a Szükséges engedélyek lapot. További információ: A ClickOnce-alkalmazások biztonságossá tétele.

Felhasználói felületi elem Description
Engedélykészlet típusa Az alkalmazás által az ügyfélen való futtatáshoz szükséges minimális engedélykészlet. Ezeknek az engedélykészleteknek a leírásáért és az általuk megkövetelt engedélyekért lásd: Elnevezett engedélykészletek.
Részletek Az alkalmazásjegyzékhez létrehozott XML az engedélykészletet képviseli. Hacsak nem ismeri az alkalmazásjegyzék XML-formátumát, ne szerkessze manuálisan ezt az XML-t. További információt a ClickOnce alkalmazásjegyzékében talál.

Üzembehelyezési jegyzék lap

Az Üzembe helyezési jegyzék lap az alábbi lapokat tartalmazza.

Felhasználói felületi elem Leírás
Név Meghatározza az üzembe helyezéssel kapcsolatos információk azonosítását.
Leírás Megadja a közzétevői, termék- és támogatási információkat.
Üzembe helyezési beállítások Megadja az üzembe helyezéssel kapcsolatos további információkat, például az alkalmazás típusát és a kezdési helyet.
Frissítési beállítások Meghatározza, hogy a ClickOnce milyen gyakran ellenőrizze az alkalmazásfrissítéseket.
Alkalmazáshivatkozás Az üzembe helyezés alkalmazásjegyzékét adja meg.

Név lap

A Név lap az üzembehelyezési jegyzék első létrehozásakor vagy megnyitásakor jelenik meg. Egyedileg azonosítja az üzembe helyezést, és opcionálisan meghatároz egy érvényes célplatformot.

Felhasználói felületi elem Leírás
Név Kötelező. Az üzembehelyezési jegyzék neve. Általában ugyanaz, mint a fájlnév.
Verzió Kötelező. Az üzembe helyezés verziószáma N.N.N.N. formátumban. Csak az első fő buildszámra van szükség. Egy alkalmazás 1.0-s verziójához például az érvényes értékek a következők 1lehetnek: , 1.0, 1.0.0, és 1.0.0.0.
Processzor Választható. Az a gépi architektúra, amelyen ez az üzembe helyezés futtatható. Az alapértelmezett formátum az msil, vagy a Microsoft köztes nyelve, amely az összes felügyelt szerelvény alapértelmezett formátuma. Módosítsa ezt a mezőt, ha az alkalmazásban lévő szerelvényeket egy adott architektúrához állította össze.
Kultúra Választható. A kétrészes ISO ország-/régiókód, amelyben az alkalmazás fut. A mező alapértelmezett értéke: neutral.
Nyilvános kulcs jogkivonata Választható. Az a nyilvános kulcs, amellyel ez az üzembe helyezési jegyzék alá lett írva. Ha ez egy új vagy aláíratlan jegyzékfájl, ez a mező a következőként jelenik meg: Unsigned.

Leírás lap

Felhasználói felületi elem Description
Publisher Kötelező. Az alkalmazásért felelős személy vagy szervezet neve. Ezt az értéket használja a Start menü mappaneveként.
Product Kötelező. A teljes terméknév. Ha az Üzembe helyezési beállítások lapon a Helyi telepítés lehetőséget választotta az Alkalmazástípus elemhez, ez a név jelenik meg a Start menü hivatkozásában és az alkalmazás Programok hozzáadása vagy eltávolítása elemében.
Támogatási hely Választható. Az AZ URL-cím, amelyről az ügyfelek segítséget és támogatást kérhetnek az alkalmazáshoz.

Üzembe helyezési beállítások lap

Felhasználói felületi elem Description
Alkalmazás típusa Választható. Meghatározza, hogy az alkalmazás telepíti-e magát az ügyfélszámítógépre (Helyi telepítés), online (csak online), vagy egy böngészőben futó WPF-alkalmazás (WPF böngészőalkalmazás). Az alapértelmezett beállítás a Helyi telepítés.
Indítási hely Választható. Az AZ URL-cím, amelyről az alkalmazást ténylegesen el kell indítani. Hasznos, ha olyan alkalmazást helyez üzembe EGY CD-ről, amely frissítenie kell magát a weben.
A kezdési hely (ProviderURL) belefoglalása a jegyzékbe Választható. Megadja azt az URL-címet, amelyet a ClickOnce megvizsgál az alkalmazásfrissítések esetében.
Alkalmazás automatikus futtatása a telepítés után Kötelező. Megadja, hogy a ClickOnce alkalmazásnak közvetlenül az URL-címről történő kezdeti telepítés után kell futnia. Alapértelmezés szerint a jelölőnégyzet be van jelölve.
URL-paraméterek átadásának engedélyezése az alkalmazásnak Kötelező. Engedélyezi a paraméteradatok átvitelét a ClickOnce alkalmazásba az üzembehelyezési jegyzék URL-címéhez hozzáfűzött lekérdezési sztringen keresztül. Az alapértelmezett beállítás, hogy a jelölőnégyzet nincs bejelölve.
A .deploy fájlkiterjesztés használata Kötelező. Ha be van jelölve, az alkalmazásjegyzékben lévő összes fájlnak rendelkeznie kell a .deploy kiterjesztéssel. Az alapértelmezett beállítás, hogy a jelölőnégyzet nincs bejelölve.

Frissítési beállítások lap

A Frissítési beállítások lap csak akkor tartalmazza az itt említett beállításokat, ha a Név lap Alkalmazástípus jelölőnégyzete Helyi telepítés értékre van állítva.

Felhasználói felületi elem Description
Ennek az alkalmazásnak frissítéseket kell keresnie Meghatározza, hogy a ClickOnce ellenőrizze-e az alkalmazásfrissítéseket. Ha ez a jelölőnégyzet nincs bejelölve, az alkalmazás csak akkor ellenőrzi a frissítéseket, ha programozott módon frissíti azt a System.Deployment.Application névtérben található API-k használatával.
Annak megadása, hogy az alkalmazás mikor keressen frissítéseket Két lehetőséget biztosít a frissítési ellenőrzésekhez:

- Az alkalmazás indítása előtt. A frissítés ellenőrzése az alkalmazás végrehajtása előtt történik.
- Az alkalmazás elindulása után. A frissítés ellenőrzése az alkalmazás fő űrlapjának inicializálása után kezdődik, és az alkalmazás következő indításakor fog futni.
Frissítési ellenőrzés gyakorisága Meghatározza, hogy a ClickOnce milyen gyakran keressen frissítéseket:

- Ellenőrizze minden alkalommal, amikor az alkalmazás fut. A ClickOnce minden alkalommal végrehajt egy frissítés-ellenőrzést, amikor a felhasználó megnyitja az alkalmazást.
- Minden ellenőrzés: Válasszon ki egy időintervallumot és egy olyan egységet (órákat, napokat vagy heteket), amelyet a frissítések keresése előtt el kell végeznie.
Az alkalmazás minimálisan szükséges verziójának megadása Választható. Meghatározza, hogy az alkalmazás egy adott verziója szükséges telepítés, ami megakadályozza, hogy a felhasználók egy korábbi verzióval dolgoznak.
Verzió Kötelező, ha be van jelölve az alkalmazás minimálisan szükséges verziójának megadása jelölőnégyzet. A megadott verziószámnak N.N.N.N formátumúnak kell lennie. Csak az első fő buildszám szükséges. Egy alkalmazás 1.0-s verziójához például az érvényes értékek a következők lehetnek: 1, 1.0, 1.0.0és 1.0.0.0.

Alkalmazáshivatkozás lap

Az Alkalmazáshivatkozás lap ugyanazokat a mezőket tartalmazza, mint a jelen témakörben korábban ismertetett Név lap. Az egyik kivétel a következő mező.

Felhasználói felületi elem Description
Jegyzékfájl kiválasztása Lehetővé teszi az alkalmazásjegyzék kiválasztását. A lap összes többi mezője fel lesz töltve, amikor kiválaszt egy alkalmazásjegyzéket.

Lásd még