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


Bootstrapper-csomagok létrehozása

A telepítőprogram egy általános telepítő, amely konfigurálható az olyan terjeszthető összetevők észlelésére és telepítésére, mint a Windows Installer (.msi) fájlok és végrehajtható programok. A telepítőt bootstrappernek is nevezik. Az összetevő telepítésének kezeléséhez szükséges metaadatokat meghatározó XML-jegyzékek halmazán keresztül van programozva. A ClickOnce Előfeltételek párbeszédpanelén megjelenő minden újraterjeszthető összetevő vagy előfeltétel egy bootstrapper-csomag. A bootstrapper-csomag olyan könyvtárak és fájlok csoportja, amelyek jegyzékfájlokat tartalmaznak, amelyek ismertetik az előfeltétel telepítésének módját.

A rendszerindító először észleli, hogy az előfeltételek valamelyike már telepítve van-e. Ha nincsenek telepítve az előfeltételek, először a rendszerindító megjeleníti a licencszerződéseket. Másodszor, miután a végfelhasználó elfogadta a licencszerződéseket, a telepítés megkezdődik az előfeltételekhez. Ellenkező esetben, ha az összes előfeltételt észleli, a rendszerindító egyszerűen elindítja az alkalmazástelepítőt.

Egyéni bootstrapper csomagok létrehozása

A bootstrapper-jegyzékeket a Visual Studio XML-szerkesztőjével hozhatja létre. A bootstrapper-csomag létrehozásának példáját lásd: Útmutató: Egyéni bootstrapper létrehozása adatvédelmi kéréssel.

A bootstrapper-csomag létrehozásához létre kell hoznia egy termékjegyzéket, és egy összetevő minden honosított verziójához egy csomagjegyzéket is.

  • A termékjegyzék ( product.xml) tartalmazza a csomag nyelvsemleges metaadatait. Ez az újraterjeszthető összetevő összes honosított verziójára jellemző metaadatokat tartalmazza. A fájl létrehozásához lásd : Termékjegyzék létrehozása.

  • A csomagjegyzék (package.xml) nyelvspecifikus metaadatokat tartalmaz; általában honosított hibaüzeneteket tartalmaz. Egy összetevőnek legalább egy csomagjegyzékkel kell rendelkeznie az összetevő minden honosított verziójához. A fájl létrehozásához lásd : Csomagjegyzék létrehozása.

A fájlok létrehozása után helyezze a termékjegyzékfájlt az egyéni rendszerindítóhoz elnevezett mappába. A csomagjegyzékfájl a területi beállításhoz tartozó mappába kerül. Ha például a csomagjegyzékfájl angol nyelvű terjesztéshez készült, helyezze a fájlt egy en nevű mappába. Ismételje meg ezt a folyamatot minden nyelvi beállításnál, például a 'ja' japán és a 'de' német nyelv esetében. Az utolsó egyéni bootstrapper-csomag a következő mappastruktúrával rendelkezhet.

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

Ezután másolja az terjeszthető fájlokat a bootstrapper mappa helyére. További információkért lásd: Hogyan hozzunk létre honosított bootstrapper-csomagot.

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*

vagy

*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*

Megjegyzés:

A Visual Studio telepítési útvonalában fent felsorolt elérési út a Visual Studio 2019 Update 7 kiadásától kezdve működik.

A bootstrapper mappa helyét az Elérési út értékből is megtalálhatja a következő beállításkulcsban:

*HKLM\Software\Microsoft\GenericBootstrapper*

64 bites rendszereken használja a következő beállításkulcsot:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Minden újraterjeszthető összetevő megjelenik a csomagok mappája alatti saját almappájában. A termékjegyzéket és az terjeszthető fájlokat ebbe az almappába kell helyezni. Az összetevő és a csomagjegyzék honosított verzióit a kultúra neve szerint elnevezett almappákba kell helyezni.

Miután a rendszer átmásolta ezeket a fájlokat a bootstrapper mappába, a rendszerindító csomag automatikusan megjelenik a Visual Studio Előfeltételek párbeszédpanelen. Ha az egyéni bootstrapper-csomag nem jelenik meg, zárja be, majd nyissa meg újra az Előfeltételek párbeszédpanelt. További információ: Előfeltételek párbeszédpanel.

Az alábbi táblázat azokat a tulajdonságokat mutatja be, amelyeket a rendszerindító automatikusan kitölt.

Ingatlan Leírás
AlkalmazásNév Az alkalmazás neve.
Processzorarchitektúra A futtatható program által megcélzott platform processzora és szavankénti bitek száma. Az értékek a következők:

-Intel
- IA64
- AMD64
VersionNT A Windows operációs rendszerek verziószáma. A verzió szintaxisa Major.Minor.ServicePack.
VersionMSI A Telepítés során futtatandó Windows Installer-szerelvény (msi.dll) verziója.
AdminUser Ez a tulajdonság akkor van beállítva, ha a felhasználó rendszergazdai jogosultságokkal rendelkezik. Az értékek igazak vagy hamisak.
Telepítési mód A telepítési mód azt jelzi, hogy honnan kell telepíteni az összetevőt. Az értékek a következők:

- HomeSite – az előfeltételek a szállító webhelyén vannak telepítve.
- SpecificSite – az előfeltételek a kiválasztott helyről vannak telepítve.
- SameSite – Az előfeltételek ugyanarról a helyről kerülnek telepítésre, mint az alkalmazás.

Újraterjeszthető eszközök elkülönítése az alkalmazástelepítésektől

Megakadályozhatja, hogy az újraterjeszthető fájlok üzembe legyenek helyezve a telepítőprojektekben. Ehhez hozzon létre egy terjeszthető listát a .NET-keretrendszer könyvtárának RedistList mappájában:

%ProgramFiles%\Microsoft.NET\RedistList

Az terjeszthető lista egy XML-fájl, amelyet a következő formátumban kell elneveznie: <Cégnév>.<Összetevő neve>.RedistList.xml. Így például ha az összetevő neve DataWidgets, amelyet az Acme készített, használja aAcme.DataWidgets.RedistList.xml. Az terjeszthető lista tartalmának egy példája a következőhöz hasonló lehet:

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>