Plugin slouží k automatizaci vytváření instalačních balíčků. Vše řídí definiční soubor, v kterém je určeno co všechno má který instalační balíček obsahovat. Ukázkový soubor definiční soubor je součástí instalace.

Už se vám někdy stalo, že jste do instlačního balíčku omylem dali soubor, který tam nepatří, nebo tam naopak nedali důležitý soubor? Mě se to stalo několikrát a vždy to přineslo potíže uživatelům. Předsevzetí, že budu pečlive kontrolovat každý instalační soubor, který vytvořím, mi vydrželo vždy tak tři-čtyři instalace. Tak jsem se rozhodl s tím něco udělat. Teď už se mi to nestane. Jednou připravím definici a mám vystaráno.

Pokud se Vám doplněk líbí, kliknutím na tlačítko Donate můžete přispět na jeho vývoj.

Nekamarádíte se s PayPalem? Napište mi email a domluvíme se na jiném způsobu, třeba převodu na účet.

• Diskuze o tomto skriptu je k dispozici na Geocaching.cz.

Podle souboru GipMaker.ini vytvari plugin příslušný gip soubor nasledujícím postupem:

• plugin nabídne uživateli seznam připravených šablon (sekcí) v GipMaker.ini, podle nichž může vytvářet instalační balíčky (*.gip soubory), uživatel si z nabídky vybere a spustí vytvoření instalačního balíčku
• plugin pak vymaže obsah pracovního adresáře
• vytvoří v něm adresářse jménem pluginu podle proměnné DIR_TARGET v příslušné sekci GipMaker.ini; mohou být vytvořeny i vnořené adresáře, např. lib\RelToAbsPath
• ze zadaného meta.ini (proměnná META_INI_FILE) získá verzi a optá se uživatele, zda ji ponechat; pokud ji uživatel změní, zapíše novou verzi do zdrojového meta.ini
• nakopíruje do pracovního adresáře všechny potřebné soubory
• zkontroluje existenci jediného *.meta.ini
• v zadaném souboru (proměnná REMOVE_DEBUGGER_FROM) zapoznámkuje příkazz pro definci konstanty řídící podmíněný překlad ladících informací
• v cílovém adresáři (DIR_GIP) vytvoří *.gip zazipováním obsahu pracovního adresáře, jméno bude doplněno o příslušnou verzi pluginu

Plugin provádí příkazy v následujícím pořadí:

1. kopírování souborů do pracovního adresáře
2. kopírování adresářů do pracovního adresáře
3. mazání souborů z pracovního adresáře
4. zazipování souborů v pracovním adresáři do instalačního balíčku

Ukázkový soubor GipMaker.ini_demo je součástí instalace.

GipMaker.ini je hlavní soubor, který řídí vytváření instalačního balíčku. Každý vytvářený balíček má vlastní sekci, jméno sekce je v hranatých závorkách tak, jak je v INI souborech běžné. Na příklad

[GipMaker]

Všechna jména sekcí jsou ze souboru načtena a nabídnuta uživateli v prvním kroku k zpracování. DAlší pak závisí na obsahu sekce, použitých proměnných. Jejich seznam je zde:

_<n> je vždy pořadové číslo jak budou soubory zpracovány. Každý typ má své vlastní číslování počínaje _1.

Příkazy typu *_RUN jsou prováděny pomocí příkazu RunShell, takže je možné spouštět jakýkoli soubor, který je obsluhován systémem (*.exe, *_*.bat, *.html, ). Cesty jsou absolutní nebo relativní vůči GEOGET_DATADIR, je možné používat i proměnné %GG_DATADIR%, %GG_SCRIPTDIR%, %GG_PROGPATH% a případně v systému definované proměnné.

V řídícím INI souboru je příkaz META_INI_FILE, který definuje meta.ini soubor. Tento soubor obsahuje verzi pluginu a GipMaker načte v něm uvedenou verzi předloží ji uživateli k úpravě. Upravená verze je zapsána do zdrojového souboru, do souboru, který bude součástí instalačního balíčku, i do jména vytvářeného balíčku (gip souboru). Tento postup má výhodu v tom, že údržba verze je jednotná a jednoduchá. Při správném použití není třeba nikde v ostatních souborech pluginu číslo verze používat a tedy ani měnit. Já používám v každém pluginu relativně univerzální funkci, která mi vrátí číclo verze pluginu zjištěné právě z meta.ini souboru:

function GetPluginVersion:string;
begin
  Result:=GeoGetPackageVersion(ReplaceString(GEOGET_SCRIPTFULLNAME,'.ggp.pas','.meta.ini'));
end;

Místo použití konstanty pak všude používám volání této funkce a nemusím v různých částech zdrojového kódu upravovat další texty či definice konstant.

Příkaz REMOVE_DEBUGGER_FROM kromě funkce popsané v tabulce příkazů plní ještě jakousi vedlejší funkci, resp. ona vedlejší funkce je vedlejším efektem funkce popsané. Jde o to, že GeoGet udržuje datum a čas změny hlavního souboru pluginu (*.ggp.pas), který by měl obsahovat funkce vracející text pro menu a pro hint (tooltip). Může se stát, že úpravy pluginu vedoucí k vydání nové verze jsou takového charakteru, že nevyžadují změnu tohoto hlavního souboru (změna formuláře, změna překladových textů či změna v jiných zdrojových souborech). Pokud je součástí textů pro menu nebo pro hint i verze pluginu, GeoGet by změnu nezobrazil. Jelikož použitím příkazu REMOVE_DEBUGGER_FROM dojdě k aktualizaci data a času hlavního souboru, bude GeoGet nucen si aktualizovat text vracený těmito funkcemi.

• změna: vypuštěno zpětné lomítko za GEOGET_PROGPATH
• oprava: chybné nastavení nové verze vytvářeného pluginu