[ English ] [ Česky ]
Movietheque
[ Hlavní strana ] [ Novinky ] [ Screenshoty ] [ Vlastnosti ] [ Tipy a triky ] [ FAQ ] [ Download ] [ Nápověda ] [ O programu ] [ Odkazy ]

[ Základní ] [ Pokročilá ] [ Správa dat ] [ Vývoj pluginù ]

Vítejte do nápovědy pro vývoj pluginů pro Movietheque

Pro psaní pluginů musíte znát jenom jednu věc - Javu. Pokud znáte Javu tak by pro vás měl být vývoj pluginů velmi jednoduchý, jestliže Javu neznáte tak pořád můžete vyvíjet pluginy, rozhraní je velmi intuitivní, možná by mohla stačit znalost C, C#, Basicu, nebo něčeho podobného.

Nějaké základy:
Každý plugin musí dědit od jedné třídy a definovat jednu funkci
Každý plugin pracuje s entitami PMedium a PTrack, PMedium representuje médium a PTrack representuje film každé PMedium obsahuje seznam filmů(PTracků) pojmenovaný "tracks".
PMedium a PTrack jsou kvůli mezinárodnímu použití standardně vyplněny "standardizovanými" jmény(např. kódy států místo jmen států), každá lokalizace má vlastní název pro žánr Komedie, ale všechny lokalizace by měli mít jako standardizované jméno nastaveno "Comedy" takže plugin může být univerzální pro všechny lokalizace.
Pro převádění lokalizovaných a standardizovaných jmen byste měli používat poskytnutou třídu AbstractConvert, takže můžete tisknout plné názvy států atd. v uživatelově rodném jazyce.

Pro příklad pluginů se můžete podívat do stáhnutého zip souboru aplikace, jeden z příkladů představuje prázdný plugin: "ExamplePlugin.jar", můžete ho najít v adresáři s Movietheque. Další příklad je složitější, jsou to standardní pluginy používané v Movietheque, můžete je najít v adresáři pojmenovaném "Plugins" v adresáři s Movietheque, jméno souboru je: "DefaultPlugin.jar".

Plugin se nainstaluje nakopírováním do adresáře "Plugins" v adresáři s Movietheque

Movietheque rozpozná dva typy pluginů: WWW pluginy a pluginy pro tisk.

Pokud chcete vytvořit nový WWW plugin vytvořte třídu WWWPlugin v balíčku cz.muni.fi.xkarmaz.movietheque.plugin.www která dědí od třídy AbstractWWWPlugin umístěné ve stejném balíčku v souboru "PluginInterface.jar" který byste měli přidat na váš classpath. Ve třídě WWWPlugin musíte deklarovat alespoň jednu metodu: public PTrack update(Frame parent, PTrack track), ve které můžete udělat cokoliv s předaným argumentem "track" a aplikace použije položku kterou vrátíte jako upravený film.

Pokud chcete vytvořit nový plugin pro tisk tak musíte vytvořit třídu PrintPlugin v balíčku cz.muni.fi.xkarmaz.movietheque.plugin.print, která dědí od třídy AbstractPrintPlugin, která je definovaná ve stejném balíčku v souboru "PluginInterface.jar", který byste měli přidat na váš classpath. Ve třídě PrintPlugin musíte deklarovat alepsoň jednu funkci: public void print(Frame parent, ArrayList<PMedium> mediums), kde můžete udělat cokoli chcete s médii("mediums") poslanými pro tisk.

Pokud se nechcete obtěžovat s Javou můžete použít prázdný plugin(viz výše), přejmenovat jar soubor, editovat funkce podle vašeho přání a zkompilovat to. Pravděpodobně nejjednodušší cesta k vytváření nových pluginů je stáhnutí celý project Movietheque v Eclipse(v sekci downloadů), editovat to v Eclipse a sestavit to pomocí přiloženého Ant souboru build.xml, potom mi pouze pošlete výsledný jar soubor a jestli bude plugin dobrý tak ho přidám na tyto stránky.

Pro kompletní dokumentaci se podívejte do PluginInterface.jar, obsahuje javadoc, zdrojové soubory atd.


Pokud potřebujete jakoukoliv pomoc, tak mi dejte vědět na email(na stránce "O programu"), pokusím se vám pomoct

Vyrobil Richard Karmazín.
Valid XHTML 1.0! SourceForge.net Logo TOPlist Valid CSS!
Made in Czech Republic