Knihovna zajišťuje podporu pro instalaci aplikací, které používá více pluginů (např. AutoHotKey, wget, …). Cílem je, aby každá taková aplikace byla v DATADIR jen jednou a přitom mohla sloužit několika pluginům a při odinstalování jednoho z nich nebude aplikace odinstalovaná do té doby, dokud ji používá nějaký plugin.

gord, Gord

Jednotlivé funkce knihovny je potřeba použít v instalační/odinstalační funkci ggi scriptu. Příslušné volání zajistí registraci pluginu a aplikace.

Všechny takovéto aplikace jsou uloženy v DATADIR\Tools a tento adresář obsahuje i soubor Content.ini. V něm je poznačeno, který plugin používá kterou aplikaci.

Knihovna obsahuje funkce:

InstallTool_MoveDir(srcDir,PluginName:string)

• zkopíruje celý zdrojový adresář a poznačí jeho příslušnost k pluginu

InstallTool_MoveFile(srcFile,PluginName:string)

• zkopíruje zdrojový soubor a poznačí jeho příslušnost k pluginu

InstallTool_RemoveDir(srcDir,PluginName:string)

• vymaže příslušnost adresáře k pluginu a pokud je to poslední plugin, celý adresář odstraní

InstallTool_RemoveFile(srcFile,PluginName:string)

• vymaže příslušnost souboru k pluginu a pokud je to poslední plugin, soubor odstraní

Ukázkové volání v ggi.pas souboru v případě, kdy plugin Checker bude používat aplikaci AutoHotKey:

{$include InstallTool.lib.pas}
// nebo 
//uses InstallToolUnit
 
function InstallWork: string;
begin
  //pridani AutoHotKey do Tools
  InstallTool_MoveFile(GEOGET_SCRIPTDIR+'\Checker\AutoHotKey.exe','Checker');
  //pokud by byl cely adresar (vice nez jeden soubor)
  //InstallTool_MoveDir(GEOGET_SCRIPTDIR+'\Checker\AutoHotKey','Checker');
  Result:=''; //bezchybna instalace
end;
 
function UninstallWork: string;
begin
  //odebrani AutoHotKey z Tools
  InstallTool_RemoveFile('AutoHotKey.exe','Checker');
  //InstallTool_RemoveDir('AutoHotKey','Checker');
  Result:='';
end;

Jak je z výčtu funkcí patrné, v adresáři Tools mohou být jak jednotlivé soubory, tak i celé adresáře. Doporučuji zachovat následující pravidla:

• pokud aplikaci tvoří jediný *.exe soubor, bude přímo v adresáři Tools
• pokud aplikace pro svou činnost vyžaduje souborů více, budou všechny v adresáři Tools v samostatném podadresáři takového jména, jaké aplikace vytváří při své standardní instalaci

Pokud jste narazili na skript, který knihovnu používá, ale není zde uveden, kontaktujte, prosím, autory.

1.0.0 (10.9.2015)

• úvodní verze