Terméktelepítési irányvonalak
A platform szabványos eszközöket biztosít a termékek frissítéséhez és
kiterjesztéséhez. A termékek frissítési és kiterjesztési
platformmechanizmusaiban részvétele érdekében a csomagolt terméknek
követnie kell az alábbi irányelveket. Ennek segítségével a termék
problémamentesen együtt létezhet a többi Eclipse
alapú termékkel, vagy akár javíthatja is azokat.
Tekintse meg újra a példa könyvtárstruktúrát az acmeweb termékhez:
acmeweb/
acmeweb.exe
eclipse/
.eclipseproduct
eclipse.exe
startup.jar
install.ini
.config/
platform.cfg
jre/
features/
com.example.acme.acmefeature_1.0.0/
feature.xml
...
plugins/
com.example.acme.acmefeature_1.0.0/
plugin.xml
about.ini
about.html
about.mappings
about.properties
acme.png
plugin_customization.ini
splash.jpg
welcome.xml
com.example.acme.acmewebsupport_1.0.0/
...
links/
...
Honnan jönnek ezek a fájlok? Tekintsük meg a terméktartalmat a
fejlesztési csapat perspektívájából. A telepített fájlok öt fő
kategóriába csoportosíthatók:
- felső szintű termékfájlok (mint például az acmeweb.exe)
- termékszolgáltatások és bedolgozók
- maga az Eclipse platform
- a Java futási környezet (JRE)
- a telepítési folyamat által előállított fájlok
Egy megfelelő telepítési parancsfájl létrehozza a megfelelő
könyvtárstruktúrát az alábbiak végrehajtásával:
- lehetővé teszi, hogy a felhasználó megadja a telepítés felső szintű
könyvtárát (mint például a c:\acmeweb.
A további lépésekben acmeweb néven hivatkozunk rá.)
- biztosítja, hogy a termék még nincs telepítve a helyen
- átmásolja a fájlokat az alábbiak szerint:
- A felső szintű termékfájlok az acmeweb könyvtárba másolódnak
- Az Eclipse fájlok az acmeweb/eclipse könyvtárba
másolódnak a várt szolgáltatás és a bedolgozó könyvtárstruktúrák segítségével
- A JRE fájlok az acmeweb/eclipse/jre fájlba
másolódnak. Ha a JRE már valahol máshol megtalálható, akkor az
alkalmazás billentyűparancsot be kell állítani, hogy az eclipse-et a
-vm parancssori argumentummal hívja meg, így a JRE helyét ismerni
fogja a platform
- A termékszolgáltatások és bedolgozók az
acmeweb/eclipse/features
és acmeweb/eclipse/plugins könyvtárba másolódnak
- létrehozza az .eclipseproduct jelzőfájlt az
acmeweb/eclipse könyvtárban. A jelzőfájl egy
java.io.Properties formátumú fájl, amely jelzi a termék nevét,
azonosítóját és verzióját.
- tárolja a szükséges telepítési információkat (felhasználó, licenc,
dátum), amelyeket meg kell jeleníteni a párbeszédablak névjegyben az
acmeweb/eclipse/plugins/com.example.acmefeature_1.0.0/about.mappings
fájlban
- ha az elsődleges szolgáltatásmechanizmus (R3.0 előtt) kerül
felhasználásra a termék megadásához, akkor lecseréli az
acmeweb/eclipse/install.ini fájlt egy olyanra, amely beállítja a
feature.default.id
tulajdonságot a termék elsődleges szolgáltatására
- meghívja a termék végrehajtható fájlját a -initialize kapcsolóval.
Ennek hatására a platform végrehajtja az összes időigényes első
idejű feldolgozást, és ideiglenes tárolhatja az eredményeket, így ha a
felhasználó elindítja a terméket, ez azonnal megjelenik egy használatba
vehető állapotban.
Többfelhasználós problémák
Ha a termék telepítve van a környezet több felhasználó közti megosztásának
engedélyezése érdekében, akkor körültekintően kell szétválasztani az egyéni
felhasználó adatait (mint például a workspace könyvtár) a megosztott
terméktelepítési könyvtártól.
Eltávolítási problémák
A termék eltávolításakor az alábbi szempontok fontosak.
- az eclipse/features és eclipse/plugins
könyvtár összes fájlját el kell távolítani akkor is, ha
eredetileg nem a telepítőprogrammal lettek telepítve. Ez biztosítja,
hogy a platformfrissítés-kezelő által hozzáadott fájlok eltávolításra
kerüljenek a termék eltávolításakor.
- a fenti pont kivételével csak a telepítőprogram által más
könyvtárakba telepített fájlokat kell eltávolítani. A fontos adatok -
mint például a workspace könyvtár megőrzése fontos, így a
termék eltávolítás utáni újratelepítése a várt eredményt szolgáltatja.
A termék újratelepítése
Ha a termék már telepítve van, akkor a telepítőnek engedélyeznie kell a
szolgáltatásfrissítést, amennyiben rendelkezésre áll. A termék
létezése a acmeweb/eclipse/.eclipseproduct
megkeresésével igazolható. A jelzőfájlban lévő információk
segítségével megerősítheti a felhasználó számára, hogy a megfelelő termék
kerül frissítésre. A frissítések rendelkezésre állása a
szolgáltatásnevek mintaegyeztetésével erősíthető meg. Az
acmeweb/eclipse/plugins/com.example.acmefeature_1.0.1 jelenléte
például azt jelzi, hogy a 1.0.1 verziófrissítés már alkalmazva lett a
termékre.
Ha az újratelepítés érvényesítve lett, akkor a telepítőprogramnak
szükség esetén át kell másolnia vagy le kell cserélnie a fájlokat. Ha
az alapul szolgáló Eclipse verziószáma nem változik, akkor jó esély van rá,
hogy a teljes könyvtárak figyelmen kívül hagyhatók. A
platformszolgáltatásokhoz és bedolgozókhoz fűzött verziószám meghatározza,
hogy szükség van-e módosításra egy bedolgozó vagy egy szolgáltatás
könyvtára alatt.
A termékek telepítésével kapcsolatos további információkat az
Eclipse telepítő
írása rész tartalmaz.