Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "VJET/Building from Source"

(New page: *Please Note*: Some software installation requires specific versions. For example, Maven 3 and JDK 1.6 are required. If you want to build from Eclipse, an Eclipse version with PDE suppor...)
 
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
*Please Note*: Some software installation requires specific  versions. For example, Maven 3 and JDK 1.6 are required. If you want to  build from Eclipse, an Eclipse version with PDE support is required.
+
Please Note: Some software installation requires specific  versions. For example, Maven 3 and JDK 1.6 are required. If you want to  build from Eclipse, an Eclipse version with PDE support is required.
  
 
= Git Client Setup =
 
= Git Client Setup =
  
 
[[http://help.github.com/set-up-git-redirect/ http://help.github.com/set-up-git-redirect/]]
 
[[http://help.github.com/set-up-git-redirect/ http://help.github.com/set-up-git-redirect/]]
 
 
 
 
 
  
 
= VJET source code =
 
= VJET source code =
Line 14: Line 9:
 
Clone one of the VJET repos. The main vjet repo is 
 
Clone one of the VJET repos. The main vjet repo is 
  
[[https://github.com/ebayopensource/vjet https://github.com/ebayopensource/vjet]]
+
http://git.eclipse.org/c/vjet/org.eclipse.vjet.all.git/
 
+
 
+
 
+
If you are modifying type libraries use this repo:
+
 
+
[[https://github.com/ebayopensource/vjet-typelib https://github.com/ebayopensource/vjet-typelib]]
+
 
+
 
+
  
 +
<source lang="dos">
 +
git clone --recursive git://git.eclipse.org/gitroot/vjet/org.eclipse.vjet.all.git
 +
</source>
  
 
= Maven Setup =
 
= Maven Setup =
  
1. Install maven 3: [[http://maven.apache.org/download.html http://maven.apache.org/download.html]]
+
1. Install maven 3: [[http://maven.apache.org/download.html http://maven.apache.org/download.html]]<br/>
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
2. Setup Environment Variables:
 
2. Setup Environment Variables:
  
 +
on mac:
 +
<source lang="dos">
 +
export MAVEN_OPTS=-Xmx1024m
 +
</source>
  
 
+
on windows:
 
+
<source lang="dos">
 
+
 
+
<!-- code start-->
+
<pre style="margin-left:20px; font-size:1.4em; background-color:#fdfdfd">
+
 
PATH=[maven 3 location];%PATH%
 
PATH=[maven 3 location];%PATH%
 
MAVEN_OPTS=-Xms512m -Xmx1024m
 
MAVEN_OPTS=-Xms512m -Xmx1024m
 
JAVA_HOME=[JDK 1.6 location]
 
JAVA_HOME=[JDK 1.6 location]
</pre><!-- code end-->
+
</source>
 
+
 
+
 
3. Install the Maven settings.xml file in your local Maven repository:
 
3. Install the Maven settings.xml file in your local Maven repository:
 
<!-- code start-->
 
<pre style="margin-left:20px; font-size:1.4em; background-color:#fdfdfd">
 
Save http://www.ebayopensource.org/svn/vjet/trunk/settings.xml to your local .m2 folder.
 
</pre><!-- code end-->
 
 
 
Note: In Windows, the default location of the .m2 folder is C:<nowiki>D</nowiki>ocuments and Settings<nowiki><</nowiki>username>.&nbsp; Please refer to maven documentation for more information.
 
  
 
= Build VJET from Command Line =
 
= Build VJET from Command Line =
Line 64: Line 37:
 
Navigate to the root directory of your git VJET clone, then execute the maven command:
 
Navigate to the root directory of your git VJET clone, then execute the maven command:
  
<!-- code start-->
+
<source lang="dos">
<pre style="margin-left:20px; font-size:1.4em; background-color:#fdfdfd">
+
 
mvn clean install
 
mvn clean install
</pre><!-- code end-->
+
</source>
 
+
  
 
After a successful build, you can find the generated VJET update site at:
 
After a successful build, you can find the generated VJET update site at:
  
<!-- code start-->
+
<source lang="dos">
<pre style="margin-left:20px; font-size:1.4em; background-color:#fdfdfd">
+
# on build server with profile build-server you will see repo here
{git_clone_root}/eclipse/updatesite/target/site_assembly.zip
+
{git_clone_root}/eclipse/features/org.eclipse.vjet.all.repo/target/signed/site_assembly.zip
</pre><!-- code end-->
+
 
+
 
+
 
+
= Build VJET from Eclipse =
+
 
+
1. Install an Eclipse version (3.6.x and above) with PDE support: [[http://www.eclipse.org/downloads/ http://www.eclipse.org/downloads/]]
+
 
+
 
+
 
+
 
+
 
+
 
+
'''Note''': Windows 64 Bit version may or may not have a startup problem relating to a dll for some Windows platform. If that happens to you, download Windows 32 Bit version instead.
+
 
+
2. Install m2eclipse from update site: [[http://m2eclipse.sonatype.org/sites/m2e http://m2eclipse.sonatype.org/sites/m2e]]
+
 
+
 
+
 
+
 
+
 
+
 
+
3. Install Subclipse, find update site from [[http://subclipse.tigris.org/ http://subclipse.tigris.org/]], for example, [[http://subclipse.tigris.org/update_1.6.x http://subclipse.tigris.org/update_1.6.x]]
+
 
+
 
+
 
+
 
+
 
+
  
4. Start a new Eclipse workspace, setup target environment to include VJET build dependent plugins:
+
# on local build you will see unsigned jars here
 +
{git_clone_root}/eclipse/features/org.eclipse.vjet.all.repo/target/org.eclipse.vjet.all.repo-${project.version}.zip
 +
</source>
  
* Go to Eclipse Preferences <nowiki>-</nowiki>> Plug-in Development <nowiki>-</nowiki>> Target Platform,
+
= Build VJET from Eclipse  =
* In Target Platform, click on Add
+
** In Target Definition dialog, select Initialize the target definition with ''Current Target: Copy settings from the current target platform'', click Next
+
*** In Target Content dialog, on Locations tab, select Add button
+
**** In Add Content dialog, select Software Site, click Next
+
***** In Add Software Site dialog,
+
****** Paste in this update site: [[http://www.ebayopensource.org/svn/vjet/trunk/dependency/ http://www.ebayopensource.org/svn/vjet/trunk/dependency/]],
+
****** Check VJET Build Dependent Plugins
+
****** In the Included Software area, uncheck ''Include required software''
+
****** Click Finish on Add Software Site
+
*** Click Finish on Target Content
+
* Back on Target Platform, select/check the newly added target, verify its Locations area to make sure it lists eclipse home and newly added VJET Build Dependency update site, click Apply, then OK.
+
  
5. Import Projects
+
1. Install an Eclipse version (3.8.x and above) with PDE support: [[http://www.eclipse.org/downloads/ http://www.eclipse.org/downloads/]]
  
a) You can import all VJET projects from VjetTeamSet.psf:
+
2. Install m2eclipse from update site: [[http://m2eclipse.sonatype.org/sites/m2e http://m2eclipse.sonatype.org/sites/m2e]]
Import <nowiki>-</nowiki>> Team <nowiki>-</nowiki>> Team Project Set, browse to your GIT Clone VJET root, select VjetProjectSet.psf and Finish.
+
  
b) Or, you can import a subset of VJET projects from Git Cloned VJET subdirectories:
+
3. Install egit plugins, find update site from [[http://www.eclipse.org/egit/ http://www.eclipse.org/egit/]]
Import <nowiki>-</nowiki>> General <nowiki>-</nowiki>> Existing Projects into Workspace, browse to your Git cloned VJET subdirectory, such as extmod, core, eclipse, or their subdirectories.
+
  
= Trouble Shooting =
+
4. Start a new Eclipse workspace, setup target environment to include VJET build dependent plugins:
  
==== 1. Possible local p2 repository corruption ====
+
  install nightly build as baseline http://eclipse.org/vjet/downloads
  
'''Symptom''': Maven build failed with message similar to following:
+
5. Import Projects
  
<!-- code start-->
+
a) You can import all VJET projects by just selecting the root directory of the git repo Import <nowiki>-</nowiki>&gt; Team <nowiki>-</nowiki>&gt; Team Project Set, browse to your GIT Clone VJET root, select VjetProjectSet.psf and Finish.  
<pre style="margin-left:20px; font-size:1.4em; background-color:#fdfdfd">
+
C:\vjet>mvn clean install
+
[INFO] Scanning for projects...
+
[INFO] Resolving target platform for project MavenProject: org.ebayopensource.vjet.extmod:org.ebayopensource.vjet.extmod.rhino:1.0.0-SNAPSHOT @ C:\vjetsvn\extmod\org.ebayopensource.vjet.extmod.rhino\pom.xml
+
[INFO] Adding repository http://download.eclipse.org/releases/helios/
+
[WARNING] Failed to access p2 repository helios (http://download.eclipse.org/releases/helios/), will try to use local cache. Reason: org.eclipse.equinox.p2.core.ProvisionException: Unable to read repository at http://download.eclipse.org/releases/helios/.
+
[INFO] Adding repository http://download.eclipse.org/tools/orbit/downloads/drops/R20100519200754/repository
+
[WARNING] Failed to access p2 repository orbit (http://download.eclipse.org/tools/orbit/downloads/drops/R20100519200754/repository), will try to use local cache. Reason: org.eclipse.equinox.p2.core.ProvisionException: Unable to read repository at http://download.eclipse.org/tools/orbit/downloads/drops/R20100519200754/repository.
+
[INFO] Adding repository http://m2eclipse.sonatype.org/sites/m2e
+
[INFO] Fetching compositeContent.xml (0B of 631B at 0B/s) from http://m2eclipse.sonatype.org/sites/m2e/compositeContent.xml
+
[INFO] Fetching compositeContent.xml (631B of 631B at 0B/s) from http://m2eclipse.sonatype.org/sites/m2e/compositeContent.xml
+
[INFO] Adding repository http://m2eclipse.sonatype.org/sites/m2e
+
[INFO] Adding repository http://www.ebayopensource.org/svn/vjet/trunk/dependency
+
[INFO] Fetching content.jar (0B of 8.78kB at 0B/s) from http://www.ebayopensource.org/svn/vjet/trunk/dependency/content.jar
+
</pre><!-- code end-->
+
  
 +
b) Or, you can import a subset of VJET projects from Git Cloned VJET subdirectories: Import <nowiki>-</nowiki>&gt; General <nowiki>-</nowiki>&gt; Existing Projects into Workspace, browse to your Git cloned VJET subdirectory, such as extmod, core, eclipse, or their subdirectories.
  
'''Solution''': Delete or rename your existing repository under .m2, then start a new build.
+
[[Category:VJET|Building From Source]]
[[Category:VJET]]
+

Latest revision as of 09:09, 23 February 2013

Please Note: Some software installation requires specific versions. For example, Maven 3 and JDK 1.6 are required. If you want to build from Eclipse, an Eclipse version with PDE support is required.

Git Client Setup

[http://help.github.com/set-up-git-redirect/]

VJET source code

Clone one of the VJET repos. The main vjet repo is 

http://git.eclipse.org/c/vjet/org.eclipse.vjet.all.git/

git clone --recursive git://git.eclipse.org/gitroot/vjet/org.eclipse.vjet.all.git

Maven Setup

1. Install maven 3: [http://maven.apache.org/download.html]
2. Setup Environment Variables:

on mac:

 export MAVEN_OPTS=-Xmx1024m

on windows:

PATH=[maven 3 location];%PATH%
MAVEN_OPTS=-Xms512m -Xmx1024m
JAVA_HOME=[JDK 1.6 location]

3. Install the Maven settings.xml file in your local Maven repository:

Build VJET from Command Line

Navigate to the root directory of your git VJET clone, then execute the maven command:

mvn clean install

After a successful build, you can find the generated VJET update site at:

# on build server with profile build-server you will see repo here
{git_clone_root}/eclipse/features/org.eclipse.vjet.all.repo/target/signed/site_assembly.zip
 
# on local build you will see unsigned jars here
{git_clone_root}/eclipse/features/org.eclipse.vjet.all.repo/target/org.eclipse.vjet.all.repo-${project.version}.zip

Build VJET from Eclipse

1. Install an Eclipse version (3.8.x and above) with PDE support: [http://www.eclipse.org/downloads/]

2. Install m2eclipse from update site: [http://m2eclipse.sonatype.org/sites/m2e]

3. Install egit plugins, find update site from [http://www.eclipse.org/egit/]

4. Start a new Eclipse workspace, setup target environment to include VJET build dependent plugins:

  install nightly build as baseline http://eclipse.org/vjet/downloads

5. Import Projects

a) You can import all VJET projects by just selecting the root directory of the git repo Import -> Team -> Team Project Set, browse to your GIT Clone VJET root, select VjetProjectSet.psf and Finish.

b) Or, you can import a subset of VJET projects from Git Cloned VJET subdirectories: Import -> General -> Existing Projects into Workspace, browse to your Git cloned VJET subdirectory, such as extmod, core, eclipse, or their subdirectories.

Back to the top