CGG   JaGrLib Eclipse HOWTO

Je vyzkoušeno, že v Eclipse 3.1 až 3.3 (Europa) se dá s knihovnou JaGrLib dobře pracovat. Co je potřeba nainstalovat:

Spuštění Skel pod Eclipse:

  1. Pomocí libovolného SVN klienta si na disku vytvořit aktuální pracovní kopii repository svn://cgg.mff.cuni.cz/JaGrLib/trunk
     
  2. Spustit Eclipse, přitom zadat libovolný adresář pro "workspace" (používat vždy stejné umístění)
     
  3. Při prvním spuštění je třeba ve workspace založit projekt JaGrLib:
    1. Z hlavního menu zadat "File / New / Project" - objeví se okénko s výběrem typu projektu
    2. Zvolit "Java / Java Project from Existing Ant Buildfile" a zmáčknout "Next" - objeví se další dialog
    3. Zadat "Ant Buildfile" - je to soubor "build.xml" z vaší pracovní kopie repository. Po jeho zadání se již načtou některé informace o projektu, okénko ale na obrazovce zůstane..
    4. Zvolte target "compile" a dále zaškrtněne volbu "Link to the buildfile in the file system". Potom teprve stiskněte tlačítko "Finish"
      Tím je projekt založen a na pozadí se začnou překládat všechny zdrojové soubory.. (pokud vše dopadlo dobře, v záložce "Problems" můžete najít jenom varování)
    5. Nakonec je třeba nastavit spouštění aplikace Skel: v lokálním menu projektu "JaGrLib" (pravé tlačítko myši) se zvolí "Run As / Open Run Dialog", objeví se konfigurační dialog
    6. Po výběru "Java Application" stisknout tlačítko "New" (obrázek s pluskem), přejmenovat "New_configuration"
    7. Zadat "Project" a "Main class" (ze seznamu vybrat "cz.cuni.jagrlib.Main" - hlavní třída aplikace Skel)
    8. V záložce "Arguments" opravit "Working directory:" - zadejte "Other:" / "File System.." a na disku znova najděte adresář s pracovní kopií repository (ten, ve kterém máte soubor "build.xml")

  4. Opakované spuštění Eclipse je již rychlejší, workspace na lokálním disku (viz 2.) si všechna nastavení pamatuje a automaticky otevírá projekt "JaGrLib"..

Starší (komplikovanější) verze návodu:

Instruktážní video: Práce s Eclipse 3.2 (49.8 MB).

Postup spuštění Eclipse s projektem JaGrLib (Skel):

  1. Pomocí libovolného SVN klienta si na disku vytvořit aktuální pracovní kopii repository svn://cgg.mff.cuni.cz/JaGrLib/trunk
     
  2. Spustit Eclipse, přitom zadat libovolný adresář pro "workspace" (používat vždy stejné umístění)
     
  3. Při prvním spuštění je třeba importovat do workspace projekt "eclipse" z JaGrLib:
    1. Nejprve je potřeba nastavit ve workspace dvě systémové proměnné "JAGRLIB" tak, aby ukazovaly na adresář "trunk". Postup: "Window / Preferences", vlevo vybrat "General / Workspace / Linked Resources". Vpravo by mělo být zaškrtnuté políčko "Enable linked resources", je třeba vytvořit proměnnou "JAGRLIB" ukazující na lokální adresář pracovní kopie repository "trunk" (tj. například "JAGRLIB - C:\svn\JaGrLib\trunk")
    2. Druhá proměnná se zadává v "Java / Build Path / Classpath Variables". Opět se založí nová proměnná se jménem "JAGRLIB" a hodnotou stejnou jako v předchozím případě
    3. Z hlavního menu zadat "File / New / Project" - objeví se okénko s výběrem typu projektu
    4. Zvolit "Java project" a zmáčknout "Next" - objeví se další dialog
    5. Zadat jméno projektu: "JaGrLib", nastavit "Create project from existing source" a najít na disku adresář "trunk/eclipse" z vaší pracovní kopie repository (pro starší verzi Eclipse se adresář jmenuje "trunk/eclipse3.1")
    6. V záložce "Source" lze zkontrolovat, které balíky knihovny budou inportovány, záložka "Libraries" obsahuje "JRE System Library" (zkontrolovat cesty k systémovým knihovnám Java Runtime) a několik dalších JAR knihoven: "jai_codec.jar", "obscure.jar", "jep-2.4.0.jar", "jogl.jar", apod.. Žádný z těchto zdrojů nesmí mít uvedeno "(unbound)"!
    7. Po stisku "Finish" by se měl celý projekt zpracovat - na pozadí se začne překládat.. (pokud vše dopadlo dobře, v záložce "Problems" můžeme najít jenom varování)
    8. Pokud se podaří úspěšně vytvořit a přeložit projekt "JaGrLib", je třeba nastavit spouštění aplikace: v lokálním menu projektu "JaGrLib" (pravé tlačítko myši) se zvolí "Run As / Run..", objeví se konfigurační dialog
    9. Po výběru "Java Application" stisknout tlačítko "New" (obrázek s pluskem), přejmenovat "New_configuration"
    10. Zadat "Project" a "Main class" (ze seznamu vybrat "cz.cuni.jagrlib.Main" - hlavní třída aplikace Skel)
    11. V záložce "Arguments" opravit "Working directory:" - zadejte "Other:" a relativní cestu "${project_loc}/../"

  4. Opakované spuštění Eclipse je již rychlejší, workspace na lokálním disku (viz 2.) si všechna nastavení pamatuje a automaticky otevírá projekt "JaGrLib"..

Oprava nefunkční JRE: na daném projektu se v lokálním menu vybere "Build Path / Configure Build Path...". Potom v záložce "Libraries" identifikovat nefunkční "(unbound)" JRE, smazat ji a přidat správnou run-time knihovnu pomocí "Add Library / JRE System Library"

[JaGrLib HOWTO]  [JaGrLib home-page]  [CGG at MFF UK]

Valid XHTML 1.1 Copyright (C) 2006-2009 J.Pelikán, last change: $Date: 2013-11-22 23:47:16 +0100 (Fri, 22 Nov 2013) $
Send comments/requests to pepca.at.cgg.mff.cuni.cz