Changes between Version 6 and Version 7 of UsingElckerlycInEclipse


Ignore:
Timestamp:
07/14/11 12:58:04 (8 years ago)
Author:
dennisr
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • UsingElckerlycInEclipse

    v6 v7  
    11= Using Elckerlyc in an Eclipse project = 
    22 
    3 == Setting up project structure == 
     3== STEP 1: Setting up project structure == 
    44First, you need to set up projects in Eclipse for the various modules that you want to compile. The process is slightly different when you work from the source SVN or when you work from the released binaries. 
    55 
    6 === Setting up project structure via SVN in Eclipse === 
     6=== Variant A: Setting up project structure via SVN in Eclipse === 
    77If you use the source releases from Elckerlyc, you need to set up SVN in Eclipse, check out the modules from the repository, and make them into an Eclipse project. 
    88 
     
    3535    a. go to the next step to add required libraries to the build path 
    3636 
    37 === Setting up project structure in Eclipse from the binary release of Elckerlyc === 
     37=== Variant B: Setting up project structure in Eclipse from the binary release of Elckerlyc === 
    3838 1. We assume that you have downloaded the Elckerlyc release files, and have a directory structure as follows: 
    3939{{{ 
     
    5353 1. go to the next step to add required libraries to the build path 
    5454 
    55 === Adding Elckerlyc to your existing Eclipse project === 
     55=== Variant C: Adding Elckerlyc to your existing Eclipse project === 
    5656Don't make new project; do the "resolve" step for myfirstproject (see below) --> everything you need is now in myfirstproject/lib 
    5757copy it to your existing project, add it to the classpath; don't forget lib_ld_path and resourcez (see below) 
    5858note that several of these libraries are machine or OS dependent --> e.g., to get the set of libraries for a mac64, resolve myfirstproject on a mac64 
    5959 
    60 == Set build paths to include dependent libraries == 
    61 you need the right versions (for your machine and operating system) of all dependent libraries in the project classpath;  
     60== STEP 2: Set build paths to include dependent libraries == 
     61you need the right versions (for your machine and operating system) of all dependent libraries in the project classpath; Elckerlyc contains ant scritps to take care of this. 
     62 1. First, collect right versions of libraries using our ant scripts 
     63    a. command prompt in `HmiDemo/MyFirstProject` 
     64    a. `ant resolve` 
     65    a. Now, all required libraries, in the version for your OS and machine, are in `HmiDemo/MyFirstProject/lib` 
     66 2. Second, add to project classpath in eclipse 
     67    a. in the 'project properties' dialog, go to Java Build Path 
     68    a. In the tab "libraries", add all jar files in `HmiDemo/MyFirstProject/lib` to the class path of the project 
     69  
     70== STEP 3: Set build paths to include required resources == 
     71Elcekrlyc requires resources such as the data files containing virtual human embodiments or gesture repertoire. In !MyFirstProject, these resources are contained in jar files (see previous step). 
     72For example, the data files for face animation are in `HmiDemo/MyFirstProject/lib/HmiHumanoidFaceControl.jar`. Maybe you want to use the source versions of these resources, instead of the released jar, because you want to be able to modify them. Do this as follows (steps are similar for other resource releases): 
     73 1. in the 'project properties' dialog, go to Java Build Path 
     74 1. In the tab "libraries", remove the released jar version of the required resource from the class path of the project (in this case: remove `HmiHumanoidFaceControl.jar`) 
     75 1. in the tab "libraries", choose "add external class folder"; browse to the right resource directory (in this case: `HmiResource/HmiHumanoidFaceControl/resource`) and add it. 
    6276 
    63 == Set build paths to include required resources == 
    64 add the various resources to the project classpath;  
     77In addition, you need to add `HmiDemo/MyFirstProject/resource` as class folder to the project classpath. 
    6578 
    6679== set a few virtual machine variables == 
    67 (lib path? memory stuff; ... 
     80For running your project, you need to set a few additional settings in "run configuration" dialog for your main class 
     81 1. tab "arguments", VM arguments, add  
     82{{{ 
     83-Djava.library.path="lib" 
     84-Xms128m  
     85-Xmx512m   
     86-Xss5M 
     87}}} 
     88 1. add {{{-Dlogback.configurationFile=LogbackConfigs/warnlogstdout.xml}}} or any other config file to specify your logging (see ProgrammingGuidelines) 
     89 1. Add a relative path from you project directory to the proejct root: {{{-Dshared.project.root="../.."}}} 
    6890 
    6991== Project dependencies ==