In order to develop the LiteracyBridge software projects you need to setup your development environment and download the source code.
Here is a step-by-step guide that helps with the setup:
Download and configure Eclipse
- Download Eclipse for RCP/Plug-in Developers from [http://www.eclipse.org/downloads/]
- Install the following plugins by using the Help -> Install new software function
-
- Subclipse plugin [http://subclipse.tigris.org/update_1.6.x]
- Maven m2ecplise plugin [http://m2eclipse.sonatype.org/sites/m2e]
- Maven SCM plugin [http://m2eclipse.sonatype.org/sites/m2e-extras] (select all SCM packages)
-
Download the source code
- In Eclipse, click File -> New -> Project…
- Select Maven -> Checkout Maven Projects from SCM and click Next
- Select svn in the dropdown list and enter Literacy Bridge's subversion url:
-
- If you are a committer use [https://talkingbook.googlecode.com/svn/] and click on Accept permanently in the next window to accept googlecode's certificate
- For read-only access use [http://talkingbook.googlecode.com/svn/]
-
- Make sure Check out Head Revision and Check out All projects are both checked
- Click Finish
Eclipse now downloads all source code, fetches dependencies using Maven, and creates a separate project for each software module.
Building and starting the ACM project
After making changes in acm-core it is necessary to invoke the Maven build, which compiles and deploys the backend jar file in the UI's lib directory:
- Right-click on literacybridge-parent in the Package Explorer in Eclipse
- Click Run As -> Maven package
- After the build completed expand the acm-ui project in the Package Explorer
- Right-click on plugin.xml within the acm-ui project
- Click Run As -> Eclipse Application
Note: If you see the following error: "java.lang.UnsatisfiedLinkError: Cannot load 32-bit SWT libraries on 64-bit JVM", you have two options to fix it:
* Right-click on plugin.xml and click Run As -> Run Configurations…, go to the Arguments tab, and add -d32 to the VM arguments textbox
* Or: download the 64bit version of Eclipse for RCP/Plug-in Developers and repeat all steps of this guide
