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

Útmutató: ClickOnce-alkalmazás manuális üzembe helyezése

Ha nem tudja üzembe helyezni a ClickOnce-alkalmazást a Visual Studióval, vagy speciális üzembehelyezési funkciókat kell használnia, például megbízható alkalmazástelepítést, akkor a Mage.exe parancssori eszközzel hozza létre a ClickOnce-jegyzékeket. Ez az útmutató bemutatja, hogyan hozhat létre ClickOnce-telepítést a Jegyzéklétrehozási és -szerkesztő eszköz parancssori verziójának (Mage.exe) vagy grafikus verziójának (MageUI.exe) használatával.

Megjegyzés:

A .NET Core 3.1 és a .NET 5 vagy újabb verziókhoz készült ClickOnce-ban a dotnet-mage.exe használata javasolt a Mage.exehelyett. További információkért lásd a ClickOnce for .NET.

Előfeltételek

Ez az útmutató előfeltételekkel és lehetőségekkel rendelkezik, amelyeket az üzembe helyezés előtt ki kell választania.

  • Telepítse Mage.exe és MageUI.exe.

    Mage.exe és MageUI.exe a Windows Software Development Kit (SDK) része. Telepítve kell lennie a Windows SDK-nak, vagy a Visual Studióhoz mellékelt Windows SDK-verziónak.

  • Adjon meg egy üzembe helyezendő alkalmazást.

    Ez az útmutató feltételezi, hogy rendelkezik egy Olyan Windows-alkalmazással, amelyet üzembe szeretne helyezni. Ezt az alkalmazást AppToDeploy-nak nevezzük.

  • Határozza meg az üzembe helyezés elosztásának módját.

    A terjesztési lehetőségek a következők: web, fájlmegosztás vagy CD. További információért lásd: ClickOnce Security and Deployment.

  • Annak meghatározása, hogy az alkalmazáshoz emelt szintű megbízhatósági szint szükséges-e.

    Ha az alkalmazás teljes körű megbízhatóságot igényel – például teljes hozzáférést a felhasználó rendszeréhez –, beállíthatja ezt a -TrustLevel opciót a Mage.exe használatával. Ha egyéni engedélykészletet szeretne definiálni az alkalmazáshoz, átmásolhatja az internet- vagy intranetes engedélyszakaszt egy másik jegyzékből, módosíthatja az igényeinek megfelelően, és hozzáadhatja az alkalmazásjegyzékhez egy szövegszerkesztő vagy MageUI.exehasználatával. További információ: Megbízható alkalmazások üzembe helyezése – áttekintés.

  • Szerezze be az Authenticode tanúsítványt.

    Az üzembe helyezést authenticode tanúsítvánnyal kell aláírnia. Létrehozhat egy teszttanúsítványt a Visual Studióval vagy MageUI.exeMakeCert.exePvk2Pfx.exe eszközökkel, vagy beszerezhet egy tanúsítványt egy hitelesítésszolgáltatótól. Ha a megbízható alkalmazástelepítést választja, a tanúsítvány egyszeri telepítését is végre kell hajtania az összes ügyfélszámítógépen. További információ: Megbízható alkalmazástelepítés áttekintése.

    Megjegyzés:

    Az üzembe helyezést egy hitelesítésszolgáltatótól beszerezhető CNG-tanúsítvánnyal is aláírhatja.

  • Győződjön meg arról, hogy az alkalmazás nem tartalmaz UAC-adatokat tartalmazó jegyzékfájlt.

    Meg kell határoznia, hogy az alkalmazás tartalmaz-e felhasználói fiókok felügyeletével (UAC) kapcsolatos információkat tartalmazó jegyzékfájlt, például egy <dependentAssembly> elemet. Az alkalmazásjegyzék vizsgálatához használhatja a Windows Sysinternals Sigcheck segédprogramot.

    Ha az alkalmazás tartalmaz egy UAC-adatokat tartalmazó jegyzékfájlt, az UAC-adatok nélkül kell újraépítenie. A Visual Studio C#-projektje esetén nyissa meg a projekt tulajdonságait, és válassza az Alkalmazás lapot. A Jegyzékek legördülő listában válassza az Alkalmazás létrehozása jegyzék nélkül lehetőséget. Visual Basic-projekt esetén nyissa meg a projekt tulajdonságait a Visual Studióban, válassza az Alkalmazás lapot, és kattintson az UAC-beállítások megtekintése gombra. A megnyitott jegyzékfájlban távolítsa el az egyetlen <asmv1:assembly> elemen belüli összes elemet.

  • Határozza meg, hogy az alkalmazásnak előfeltételre van-e szüksége az ügyfélszámítógépen.

    A Visual Studióból üzembe helyezett ClickOnce-alkalmazások tartalmazhatnak egy előfeltételként szolgáló bootstrappert (setup.exe) az üzembe helyezéshez. Ez az útmutató létrehozza a ClickOnce-telepítéshez szükséges két jegyzékfájlt. Az előfeltétel bootstrapper létrehozásához használhatja a GenerateBootstrapper feladatot.

Alkalmazás üzembe helyezése a Mage.exe parancssori eszközzel

  1. Hozzon létre egy könyvtárat, amelyben a ClickOnce üzembehelyezési fájljait fogja tárolni.

  2. Az imént létrehozott üzembehelyezési címtárban hozzon létre egy verzió alkönyvtárat. Ha először telepíti az alkalmazást, nevezze el az 1.0.0.0 verzió alkönyvtárát.

    Megjegyzés:

    Az üzembe helyezés verziója eltérő lehet az alkalmazás verziójától.

  3. Másolja az összes alkalmazásfájlt a verzió alkönyvtárára, beleértve a végrehajtható fájlokat, szerelvényeket, erőforrásokat és adatfájlokat. Szükség esetén további alkönyvtárakat is létrehozhat, amelyek további fájlokat tartalmaznak.

  4. Nyissa meg a Windows SDK vagy a Visual Studio parancssorát, és váltson a verzió alkönyvtárára.

  5. Hozza létre az alkalmazásjegyzéket Mage.exehívásával . Az alábbi utasítás létrehoz egy alkalmazásjegyzéket az Intel x86 processzoron való futtatáshoz lefordított kódhoz.

    mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .

    Megjegyzés:

    Ügyeljen arra, hogy a -FromDirectory opció után tegye a pontot (.), ami az aktuális könyvtárra utal. Ha nem tartalmazná a pontot, meg kell adnia az alkalmazásfájlok elérési útját.

  6. Írja alá az alkalmazásjegyzéket az Authenticode-tanúsítvánnyal. Cserélje le mycert.pfx a tanúsítványfájl elérési útra. Cserélje le a passwd elemet a tanúsítványfájl jelszavára.

    mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd

    A Visual Studióval és a Windows SDK-val mage.exe elosztott .NET-keretrendszer 4.6.2 SDK-tól kezdve a CNG- és Authenticode-tanúsítványokkal is aláírja a jegyzékeket. Ugyanazokat a parancssori paramétereket használja, mint az Authenticode-tanúsítványok esetén.

  7. Lépjen az üzembe helyezési könyvtár gyökeréhez.

  8. Hozza létre az üzembehelyezési jegyzékfájlt a következő Mage.exehívással: . Alapértelmezés szerint Mage.exe a ClickOnce-üzemelő példányt telepített alkalmazásként jelöli meg, hogy az online és offline is futtatható legyen. Ha azt szeretné, hogy az alkalmazás csak akkor legyen elérhető, ha a felhasználó online állapotban van, használja a -Install lehetőséget a következő falseértékkel: . Ha az alapértelmezett beállítást használja, és a felhasználók webhelyről vagy fájlmegosztásból telepítik az alkalmazást, győződjön meg arról, hogy a -ProviderUrl beállítás értéke az alkalmazásjegyzék helyére mutat a webkiszolgálón vagy a megosztáson.

    mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application

  9. Írja alá az üzembehelyezési jegyzékfájlt Authenticode vagy CNG tanúsítvánnyal.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd

  10. Másolja az üzembehelyezési könyvtárban lévő összes fájlt az üzembehelyezési célhelyre vagy adathordozóra. Ez lehet egy webhely vagy FTP-hely mappája, fájlmegosztás vagy CD-ROM.

  11. Adja meg a felhasználóknak az alkalmazás telepítéséhez szükséges URL-címet, UNC-t vagy fizikai adathordozót. Ha URL-címet vagy UNC-t ad meg, meg kell adnia a felhasználóknak az üzembehelyezési jegyzék teljes elérési útját. Ha például az AppToDeploy az AppToDeploy könyvtárban van üzembe helyezve http://webserver01/ , a teljes URL-cím elérési útja a következő lesz http://webserver01/AppToDeploy/AppToDeploy.application: .

Alkalmazás üzembe helyezése a MageUI.exe grafikus eszközzel

  1. Hozzon létre egy könyvtárat, amelyben a ClickOnce üzembehelyezési fájljait fogja tárolni.

  2. Az imént létrehozott üzembehelyezési címtárban hozzon létre egy verzió alkönyvtárat. Ha először telepíti az alkalmazást, nevezze el az 1.0.0.0 verzió alkönyvtárát.

    Megjegyzés:

    Az üzembe helyezés verziója valószínűleg eltér az alkalmazás verziójától.

  3. Másolja az összes alkalmazásfájlt a verzió alkönyvtárára, beleértve a végrehajtható fájlokat, szerelvényeket, erőforrásokat és adatfájlokat. Szükség esetén további alkönyvtárakat is létrehozhat, amelyek további fájlokat tartalmaznak.

  4. Indítsa el a MageUI.exe grafikus eszközt.

    MageUI.exe

  5. Hozzon létre egy új alkalmazásjegyzéket a menü Fájl, Új, Alkalmazásjegyzék elemének kiválasztásával.

  6. Az alapértelmezett Név lapon írja be ennek a telepítésnek a nevét és verziószámát. Adja meg azt a processzort is, amelyhez az alkalmazás készült, például x86.

  7. Válassza a Fájlok lapot, majd az Alkalmazáskönyvtár szövegmezője melletti pontozott (...) gombot. Megjelenik egy Tallózás a mappához párbeszédpanel.

  8. Válassza ki az alkalmazásfájlokat tartalmazó verzió alkönyvtárát, majd kattintson az OK gombra.

  9. Ha az Internet Information Services (IIS) szolgáltatásból telepít, jelölje be a fájlfeltöltéskor adja hozzá a .deploy kiterjesztést minden fájlhoz, amely nem rendelkezik vele jelölőnégyzetet.

  10. Lépjen a Feltöltés gombra az összes alkalmazásfájl fájllistához való hozzáadásához. Ha az alkalmazás egynél több végrehajtható fájlt tartalmaz, jelölje meg az üzembe helyezés fő végrehajtható fájlját indítási alkalmazásként a Fájltípus legördülő listából a Belépési pont kiválasztásával. (Ha az alkalmazás csak egy végrehajtható fájlt tartalmaz, MageUI.exe automatikusan megjelöli azt.)

  11. Válassza a Szükséges engedélyek lapot, és válassza ki azt a megbízhatósági szintet, amelyet az alkalmazásnak érvényesítenie kell. Az alapértelmezett érték a FullTrust, amely a legtöbb alkalmazáshoz megfelelő lesz.

  12. Válassza a Fájl, Mentés másként lehetőséget a menüből. Megjelenik egy Aláírási beállítások párbeszédpanel, amely arra kéri, hogy írja alá az alkalmazásjegyzéket.

  13. Ha egy tanúsítvány fájlként van tárolva a fájlrendszerben, használja az Aláírás tanúsítványfájllal lehetőséget, és a három pont (...) gombbal válassza ki a tanúsítványt a fájlrendszerből. Ezután írja be a tanúsítvány jelszavát.

    -vagy-

    Ha a tanúsítvány a számítógépről elérhető tanúsítványtárolóban van tárolva, válassza az Aláírás tárolt tanúsítvánnyal lehetőséget, és válassza ki a tanúsítványt a megadott listából.

  14. Az alkalmazásjegyzék aláírásához válassza az OK gombot . Megjelenik a Mentés másként párbeszédpanel.

  15. A Mentés másként párbeszédpanelen adja meg a verziókönyvtárat, majd válassza a Mentés lehetőséget.

  16. Válassza a Fájl, Új, Üzembehelyezési jegyzék lehetőséget a menüből az üzembehelyezési jegyzék létrehozásához.

  17. A Név lapon adja meg a telepítés nevét és verziószámát (ebben a példában 1.0.0.0 ). Adja meg azt a processzort is, amelyhez az alkalmazás készült, például x86.

  18. Válassza a Leírás lapot, és adja meg a Publisher és a Termék értékét. (A termék az alkalmazásnak a Windows Start menüben megadott neve, amikor az alkalmazás offline használatra telepíti az ügyfélszámítógépet.)

  19. Válassza az Üzembe helyezési beállítások lapot, és a Hely indítása szövegmezőben adja meg az alkalmazásjegyzék helyét a webkiszolgálón vagy a megosztáson. Például : \\myServer\myShare\AppToDeploy.application.

  20. Ha az előző lépésben adta hozzá a .deploy bővítményt, itt válassza a .deploy fájlnévbővítmény használata lehetőséget.

  21. Válassza a Frissítési beállítások lapot, és adja meg, hogy milyen gyakran szeretné frissíteni az alkalmazást. Ha az alkalmazás önállóan ellenőrzi a frissítéseket UpdateCheckInfo, törölje a jelet az Az alkalmazás frissítéseket ellenőrizzen jelölőnégyzetből.

  22. Válassza az Alkalmazáshivatkozás lapot, majd lépjen a Jegyzék kiválasztása gombra. Megjelenik egy megnyitott párbeszédpanel.

  23. Válassza ki a korábban létrehozott alkalmazásjegyzéket, majd válassza a Megnyitás lehetőséget.

  24. Válassza a Fájl, Mentés másként lehetőséget a menüből. Megjelenik egy Aláírási beállítások párbeszédpanel, amely arra kéri, hogy írja alá az üzembe helyezési jegyzékfájlt.

  25. Ha egy tanúsítvány fájlként van tárolva a fájlrendszerben, használja az Aláírás tanúsítványfájllal lehetőséget, és a három pont (...) gombbal válassza ki a tanúsítványt a fájlrendszerből. Ezután írja be a tanúsítvány jelszavát.

    -vagy-

    Ha a tanúsítvány a számítógépről elérhető tanúsítványtárolóban van tárolva, válassza az Aláírás tárolt tanúsítvánnyal lehetőséget, és válassza ki a tanúsítványt a megadott listából.

  26. Az üzembehelyezési jegyzék aláírásához lépjen az OK gombra . Megjelenik a Mentés másként párbeszédpanel.

  27. A Mentés másként párbeszédpanelen lépjen egy könyvtárral feljebb az üzembe helyezési gyökérkönyvtárba, majd válassza a Mentés lehetőséget.

  28. Másolja az üzembehelyezési könyvtárban lévő összes fájlt az üzembehelyezési célhelyre vagy adathordozóra. Ez lehet egy webhely vagy FTP-hely mappája, fájlmegosztás vagy CD-ROM.

  29. Adja meg a felhasználóknak az alkalmazás telepítéséhez szükséges URL-címet, UNC-t vagy fizikai adathordozót. Ha URL-címet vagy UNC-t ad meg, a teljes elérési utat meg kell adnia a felhasználóknak az üzembe helyezési jegyzékben. Ha például az AppToDeploy az AppToDeploy könyvtárban van üzembe helyezve http://webserver01/ , a teljes URL-cím elérési útja a következő lesz http://webserver01/AppToDeploy/AppToDeploy.application: .

Következő lépések

Ha az alkalmazás új verzióját kell üzembe helyeznie, hozzon létre egy új, az új verzióról elnevezett könyvtárat (például 1.0.0.1), és másolja az új alkalmazásfájlokat az új könyvtárba. Ezután az előző lépéseket kell követnie egy új alkalmazásjegyzék létrehozásához és aláírásához, valamint az üzembehelyezési jegyzék frissítéséhez és aláírásához. Ügyeljen arra, hogy ugyanazt a magasabb verziót adja meg mind a Mage.exe, mind a -New és -Update hívásokban, mivel a ClickOnce csak a magasabb verziókat frissíti, ahol a legjelentősebb a balról első egész szám. Ha MageUI.exehasznált, az üzembehelyezési jegyzék frissítéséhez nyissa meg, válassza az Alkalmazáshivatkozás lapot, nyissa meg a Jegyzék kiválasztása gombot, majd válassza ki a frissített alkalmazásjegyzéket.

Kapcsolódó tartalom

  • Last updated on