<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Recent changes to DevelopmentEnvironmentSetup</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>Recent changes to DevelopmentEnvironmentSetup</description><atom:link href="https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/feed" rel="self"/><language>en</language><lastBuildDate>Mon, 21 Sep 2015 19:21:59 -0000</lastBuildDate><atom:link href="https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/feed" rel="self" type="application/rss+xml"/><item><title>DevelopmentEnvironmentSetup modified by Steven Soloff</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v6
+++ v7
@@ -98,7 +98,7 @@

 In a new workspace, you must import each file under `eclipse/&amp;lt;version&amp;gt;/templates` into the corresponding section of your workspace preferences (**Window &amp;gt; Preferences**). Each folder under `templates` is arranged in a hierarchy identical to how the Eclipse Preferences dialog is structured. 

-&amp;gt; The path for the user-defined spelling dictionary under **General &amp;gt; Editors &amp;gt; Text Editors &amp;gt; Spelling** should be set to ` ${project_loc:org.gamegineer.other.settings}/eclipse/&amp;lt;version&amp;gt;/templates/general/editors/text-editors/spelling/user-dictionary.txt`. 
+&amp;gt; The path for the user-defined spelling dictionary under **General &amp;gt; Editors &amp;gt; Text Editors &amp;gt; Spelling** should be set to ` ${project_loc:org.gamegineer.other.settings}/eclipse/templates/general/editors/text-editors/spelling/user-dictionary.txt`. 

 You will then proceed to configure your workspace as you desire (e.g. arrange views, adjust editor colors, etc.). Gamegineer developers are permitted to store their personal workspace preferences under `eclipse/&amp;lt;version&amp;gt;/users`. Export your preferences to a file in this directory with the same name as your SourceForge user ID (e.g. _joe_developer.epf**). Please avoid modifying another user's preferences. **_

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Steven Soloff</dc:creator><pubDate>Mon, 21 Sep 2015 19:21:59 -0000</pubDate><guid>https://sourceforge.net11de9577d85f8b714a1e22a5d0fffd214235227e</guid></item><item><title>DevelopmentEnvironmentSetup modified by Steven Soloff</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v5
+++ v6
@@ -26,11 +26,11 @@

 ### Ant

-Install version 1.9.2 of [Apache Ant](http://ant.apache.org/). Ant is used to implement portions of the build process. 
+Install version 1.9.6 of [Apache Ant](http://ant.apache.org/). Ant is used to implement portions of the build process. 

 ### Maven

-Install version 3.1.1 of [Apache Maven](http://maven.apache.org/). Maven is used to implement portions of the build process. 
+Install version 3.3.3 of [Apache Maven](http://maven.apache.org/). Maven is used to implement portions of the build process. 

 #### Maven Integration for Eclipse

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Steven Soloff</dc:creator><pubDate>Sat, 12 Sep 2015 21:41:18 -0000</pubDate><guid>https://sourceforge.net18c80b9fbdb4e3687f16df3527b45c4bff693692</guid></item><item><title>DevelopmentEnvironmentSetup modified by Steven Soloff</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v4
+++ v5
@@ -14,11 +14,11 @@

 Install version 1.7.0_51 of the [Java SE 7 JDK](http://www.oracle.com/technetwork/java/javase/overview/index.html). The JDK is required for most everything in the development process, including building and testing the software. 

-### Eclipse SDK
+### Eclipse IDE

-Install version 4.3.2 of the [Eclipse SDK](http://www.eclipse.org/). Gamegineer is a collection of [OSGi](http://www.osgi.org/) bundles built on the Eclipse Equinox OSGi core framework. The Eclipse SDK provides the tools necessary to build such OSGi bundles. 
+Install version 4.5.0 of the [Eclipse IDE for Eclipse Committers](http://www.eclipse.org/). Gamegineer is a collection of [OSGi](http://www.osgi.org/) bundles built on the Eclipse Equinox OSGi core framework. The Eclipse IDE provides the tools necessary to build such OSGi bundles. 

-_It is expected that any version of the Eclipse SDK later than 4.3.2 can be used as a development environment as long as the developer properly sets the target platform for their Eclipse IDE workspace._
+_It is expected that any version of the Eclipse IDE later than 4.5.0 can be used as a development environment as long as the developer properly sets the target platform for their Eclipse IDE workspace._

 #### Execution Environment Descriptions

@@ -34,13 +34,13 @@

 #### Maven Integration for Eclipse

-Install version 1.4.x of Maven Integration for Eclipse (m2e). m2e allows you to run the Maven build process from within Eclipse so you get the same results regardless of whether you build from the command line or from the IDE. 
+Install version 1.6.x of Maven Integration for Eclipse (m2e). m2e allows you to run the Maven build process from within Eclipse so you get the same results regardless of whether you build from the command line or from the IDE. 

-Refer to the [m2e wiki](http://wiki.eclipse.org/M2E_updatesite_and_gittags#m2e_releases) for the correct p2 repository URL used to install the software from within Eclipse. 
+Refer to the [m2e wiki](http://wiki.eclipse.org/M2E_updatesite_and_gittags#m2e_releases) for the correct p2 repository URL used to install the software from within Eclipse if the above version is not available from the corresponding Eclipse releases repository.

 ### Git

-Install version 1.9.x of the [Git client](http://git-scm.com/). A Git client is required for the developer to access the Gamegineer version control repository.
+Install version 2.5.x of the [Git client](http://git-scm.com/). A Git client is required for the developer to access the Gamegineer version control repository.

 ## Configuration

@@ -88,7 +88,7 @@

 ### API Baseline

-Open the workspace preferences dialog (**Windows &amp;gt; Preferences**) and go to the **Plug-in Development &amp;gt; API Baselines**' page. Click **Add Baseline...**. Name the new baseline **Default Gamegineer Target**. Click **Browse...**, and navigate to the `.metadata/.plugins/org.eclipse.pde.core/.bundle_pool` directory under your workspace directory. Click **Reset** to load the target location, and click **Finish** to create the baseline. Finally, click **OK** to close the workspace preferences dialog. 
+Open the workspace preferences dialog (**Windows &amp;gt; Preferences**) and go to the **Plug-in Development &amp;gt; API Baselines**' page. Click **Add Baseline...**. Select **A target platform**, and click **Next**. Name the new baseline **Default Gamegineer Target**. Select the target named **default**. Click **Reset** to load the target, and click **Finish** to create the baseline. Finally, click **OK** to close the workspace preferences dialog.

 &amp;gt; You must repeat this process (using **Edit...** instead of **Add Baseline...**) whenever you or another developer changes the target platform. 

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Steven Soloff</dc:creator><pubDate>Fri, 11 Sep 2015 18:10:02 -0000</pubDate><guid>https://sourceforge.net2fc62e8abeed97e928337e08bfaa0fbb7b2ea382</guid></item><item><title>DevelopmentEnvironmentSetup modified by Steven Soloff</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v3
+++ v4
@@ -74,7 +74,7 @@

 Before continuing you must install the m2e EGit SCM connector from the m2e Marketplace. Click the **m2e Marketplace** link. Check the **m2e-egit** team provider, and click **Finish**. Follow the instructions provided in the wizard to complete the installation. You may be required to restart Eclipse. After this step, return to the **Target Location** page of the import wizard and continue with the next step. 

-Select **git** in the **SCM URL** combo box, and enter **`git@github.com:gamegineer/dev.git`** in the adjacent text field. Uncheck the **Checkout All Projects** option. Click **Finish**. The wizard will close and the projects at the specified URL will be downloaded. This may take several minutes to complete. When the download is complete, the **Import Maven Projects** wizard will appear. Select all items that begin with **/target-platform**, and click the **Deselect Tree** button. Select all items that begin with **/third-party**, and click the **Deselect Tree** button. Click **Finish**. The wizard will close and the selected projects will be installed into the workspace. This may take several minutes to complete. 
+Select **git** in the **SCM URL** combo box, and enter **`ssh://git@github.com/gamegineer/dev.git`** in the adjacent text field. Uncheck the **Checkout All Projects** option. Click **Finish**. The wizard will close and the projects at the specified URL will be downloaded. This may take several minutes to complete. When the download is complete, the **Import Maven Projects** wizard will appear. Select all items that begin with **/target-platform**, and click the **Deselect Tree** button. Select all items that begin with **/third-party**, and click the **Deselect Tree** button. Click **Finish**. The wizard will close and the selected projects will be installed into the workspace. This may take several minutes to complete. 

 Select all projects in the workspace, and select **Replace With &amp;gt; HEAD Revision** from the context menu. Click **Yes to All** when prompted to overwrite unversioned files. 

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Steven Soloff</dc:creator><pubDate>Wed, 09 Sep 2015 19:00:11 -0000</pubDate><guid>https://sourceforge.netcd5db4f340fb50620957c040c469a1ae75ae1ff3</guid></item><item><title>DevelopmentEnvironmentSetup modified by Steven Soloff</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v2
+++ v3
@@ -46,7 +46,7 @@

 ### Development Environment Shell

-A script is used to start a shell that ensures all developers are using the same settings in their development environment. This script depends on your specific workstation configuration and thus cannot be provided in a generalized form. A script template is provided in the version control repository at `git://git.code.sf.net/p/gamegineer/dev/other/org.gamegineer.settings/shell/templates/dev-environment.bat`.
+A script is used to start a shell that ensures all developers are using the same settings in their development environment. This script depends on your specific workstation configuration and thus cannot be provided in a generalized form. A script template is provided in the version control repository at `https://raw.githubusercontent.com/gamegineer/dev/master/other/org.gamegineer.other.settings/shell/templates/dev-environment.bat`.

 Download this template to an appropriate location on your workstation, for example in your local profile. Using a text editor, open the script template and supply appropriate values for the environment variables between the `BEGIN-CUSTOM-VARIABLES` and `END-CUSTOM-VARIABLES` markers. You may wish to create a shortcut to this script using a target of `cmd /k full-path-to-script`. Executing this shortcut will open a shell that represents the root of the development environment.

@@ -54,7 +54,7 @@

 ### Maven Settings

-The Maven build process depends upon some user-defined settings that cannot be provided in the project files stored in version control (e.g. passwords). A Maven settings template is provided in the version control repository at `git://git.code.sf.net/p/gamegineer/dev/other/org.gamegineer.other.settings/maven/templates/settings.xml`.
+The Maven build process depends upon some user-defined settings that cannot be provided in the project files stored in version control (e.g. passwords). A Maven settings template is provided in the version control repository at `https://raw.githubusercontent.com/gamegineer/dev/master/other/org.gamegineer.other.settings/maven/templates/settings.xml`.

 Download this template to `~/.m2/settings.xml`. Using a text editor, open the settings template and supply appropriate values where directed by the presence of `CUSTOM-VARIABLES` comments.

@@ -74,7 +74,7 @@

 Before continuing you must install the m2e EGit SCM connector from the m2e Marketplace. Click the **m2e Marketplace** link. Check the **m2e-egit** team provider, and click **Finish**. Follow the instructions provided in the wizard to complete the installation. You may be required to restart Eclipse. After this step, return to the **Target Location** page of the import wizard and continue with the next step. 

-Select **git** in the **SCM URL** combo box, and enter **`ssh://git.code.sf.net/p/gamegineer/dev`** in the adjacent text field. Uncheck the **Checkout All Projects** option. Click **Finish**. The wizard will close and the projects at the specified URL will be downloaded. This may take several minutes to complete. When the download is complete, the **Import Maven Projects** wizard will appear. Select all items that begin with **/target-platform**, and click the **Deselect Tree** button. Select all items that begin with **/third-party**, and click the **Deselect Tree** button. Click **Finish**. The wizard will close and the selected projects will be installed into the workspace. This may take several minutes to complete. 
+Select **git** in the **SCM URL** combo box, and enter **`git@github.com:gamegineer/dev.git`** in the adjacent text field. Uncheck the **Checkout All Projects** option. Click **Finish**. The wizard will close and the projects at the specified URL will be downloaded. This may take several minutes to complete. When the download is complete, the **Import Maven Projects** wizard will appear. Select all items that begin with **/target-platform**, and click the **Deselect Tree** button. Select all items that begin with **/third-party**, and click the **Deselect Tree** button. Click **Finish**. The wizard will close and the selected projects will be installed into the workspace. This may take several minutes to complete. 

 Select all projects in the workspace, and select **Replace With &amp;gt; HEAD Revision** from the context menu. Click **Yes to All** when prompted to overwrite unversioned files. 

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Steven Soloff</dc:creator><pubDate>Wed, 09 Sep 2015 17:33:58 -0000</pubDate><guid>https://sourceforge.netd30b494551e7f1e23c5951dd9f5f8dbf4bf98872</guid></item><item><title>DevelopmentEnvironmentSetup modified by Steven Soloff</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v1
+++ v2
@@ -38,31 +38,25 @@

 Refer to the [m2e wiki](http://wiki.eclipse.org/M2E_updatesite_and_gittags#m2e_releases) for the correct p2 repository URL used to install the software from within Eclipse. 

-### Subversion
+### Git

-Install version 1.8.x of the [Subversion client](http://subversion.apache.org/). A Subversion client is required for the developer to access the Gamegineer version control repository. 
-
-#### Subclipse
-
-It is recommended to use version 1.10.x of the [Subclipse](http://subclipse.tigris.org/) Eclipse Team Provider plug-in as the preferred Subversion client. Subclipse provides access to a Subversion repository from within the Eclipse IDE. 
-
-Refer to the [Subclipse wiki](http://subclipse.tigris.org/servlets/ProjectProcess?pageID=p4wYuA) for the correct p2 repository URL used to install the software from within Eclipse. 
+Install version 1.9.x of the [Git client](http://git-scm.com/). A Git client is required for the developer to access the Gamegineer version control repository.

 ## Configuration

 ### Development Environment Shell

-A script is used to start a shell that ensures all developers are using the same settings in their development environment. This script depends on your specific workstation configuration and thus cannot be provided in a generalized form. A script template is provided in the version control repository at `https://svn.code.sf.net/p/gamegineer/code/dev/trunk/other/org.gamegineer.settings/shell/templates/dev-environment.bat`. 
+A script is used to start a shell that ensures all developers are using the same settings in their development environment. This script depends on your specific workstation configuration and thus cannot be provided in a generalized form. A script template is provided in the version control repository at `git://git.code.sf.net/p/gamegineer/dev/other/org.gamegineer.settings/shell/templates/dev-environment.bat`.

-Download this template to an appropriate location on your workstation, for example in your local profile. Using a text editor, open the script template and supply appropriate values for the environment variables between the `BEGIN-CUSTOM-VARIABLES` and `END-CUSTOM-VARIABLES` markers. You may wish to create a shortcut to this script using a target of `cmd /k full-path-to-script`. Executing this shortcut will open a shell that represents the root of the development environment. 
+Download this template to an appropriate location on your workstation, for example in your local profile. Using a text editor, open the script template and supply appropriate values for the environment variables between the `BEGIN-CUSTOM-VARIABLES` and `END-CUSTOM-VARIABLES` markers. You may wish to create a shortcut to this script using a target of `cmd /k full-path-to-script`. Executing this shortcut will open a shell that represents the root of the development environment.

-It is **very important** that all development activities originate from this shell. For example, do not start the Eclipse IDE from a separate shortcut, rather you should use the provided `eclipse-dev` macro to ensure the IDE is supplied with the correct environment variables. This shell also serves as the launching point for any Ant or Maven builds you may initiate. 
+It is **very important** that all development activities originate from this shell. For example, do not start the Eclipse IDE from a separate shortcut, rather you should use the provided `eclipse-dev` macro to ensure the IDE is supplied with the correct environment variables. This shell also serves as the launching point for any Ant or Maven builds you may initiate.

 ### Maven Settings

-The Maven build process depends upon some user-defined settings that cannot be provided in the project files stored in version control (e.g. passwords). A Maven settings template is provided in the version control repository at `https://svn.code.sf.net/p/gamegineer/code/dev/trunk/other/org.gamegineer.other.settings/maven/templates/settings.xml`. 
+The Maven build process depends upon some user-defined settings that cannot be provided in the project files stored in version control (e.g. passwords). A Maven settings template is provided in the version control repository at `git://git.code.sf.net/p/gamegineer/dev/other/org.gamegineer.other.settings/maven/templates/settings.xml`.

-Download this template to `~/.m2/settings.xml`. Using a text editor, open the settings template and supply appropriate values where directed by the presence of `CUSTOM-VARIABLES` comments. 
+Download this template to `~/.m2/settings.xml`. Using a text editor, open the settings template and supply appropriate values where directed by the presence of `CUSTOM-VARIABLES` comments.

 ## Workspace

@@ -78,13 +72,11 @@

 Open the import dialog (**File &amp;gt; Import...**). Expand the **Maven** node, select **Check out Maven Projects from SCM**, and click **Next**. 

-Before continuing you must install the m2e Subclipse SCM connector from the m2e Marketplace. Click the **m2e Marketplace** link. Check the **m2e-subsclipse** team provider, and click **Finish**. Follow the instructions provided in the wizard to complete the installation. You may be required to restart Eclipse. After this step, return to the **Target Location** page of the import wizard and continue with the next step. 
+Before continuing you must install the m2e EGit SCM connector from the m2e Marketplace. Click the **m2e Marketplace** link. Check the **m2e-egit** team provider, and click **Finish**. Follow the instructions provided in the wizard to complete the installation. You may be required to restart Eclipse. After this step, return to the **Target Location** page of the import wizard and continue with the next step. 

-&amp;gt; If you are using Subversion 1.8.x and Subclipse 1.10.x, you must use a custom build of the m2e Subclipse SCM connector as the official release only supports Subversion through version 1.7. Open the Install Software dialog (**Help &amp;gt; Install New Software...**). Enter `http://build.g8r.local:8081/nexus/content/unzip/public.unzip/org/sonatype/m2e/subclipse/org.sonatype.m2e/subclipse.repository/0.13.0-SNAPSHOT/org.sonatype.m2e.subclipse.repository-0.13.0-SNAPSHOT.zip-unzip` in the **Work with** field. Select all available software and click **Next**. Follow the instructions provided in the wizard to complete the installation. 
+Select **git** in the **SCM URL** combo box, and enter **`ssh://git.code.sf.net/p/gamegineer/dev`** in the adjacent text field. Uncheck the **Checkout All Projects** option. Click **Finish**. The wizard will close and the projects at the specified URL will be downloaded. This may take several minutes to complete. When the download is complete, the **Import Maven Projects** wizard will appear. Select all items that begin with **/target-platform**, and click the **Deselect Tree** button. Select all items that begin with **/third-party**, and click the **Deselect Tree** button. Click **Finish**. The wizard will close and the selected projects will be installed into the workspace. This may take several minutes to complete. 

-Select **svn** in the **SCM URL** combo box, and enter **`https://svn.code.sf.net/p/gamegineer/code/dev/trunk`** in the adjacent text field. Uncheck the **Checkout All Projects** option. Click **Finish**. The wizard will close and the projects at the specified URL will be downloaded. This may take several minutes to complete. When the download is complete, the **Import Maven Projects** wizard will appear. Select the item that begins with **/target-platform**, and click the **Deselect Tree** button. Select the item that begins with **/third-party**, and click the **Deselect Tree** button. Click **Finish**. The wizard will close and the selected projects will be installed into the workspace. This may take several minutes to complete. 
-
-Select all projects in the workspace, and select **Replace With &amp;gt; Base Revision** from the context menu. Click **Yes to All** when prompted to overwrite unversioned files. 
+Select all projects in the workspace, and select **Replace With &amp;gt; HEAD Revision** from the context menu. Click **Yes to All** when prompted to overwrite unversioned files. 

 Select all projects in the workspace, and select **Maven &amp;gt; Update Project...** from the context menu. Uncheck the **Update project configuration from pom.xml** button, and click **OK**. 

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Steven Soloff</dc:creator><pubDate>Tue, 05 May 2015 21:13:10 -0000</pubDate><guid>https://sourceforge.net2e85f9875b08f1d7747f47f0638d3fac6068859c</guid></item><item><title>DevelopmentEnvironmentSetup modified by Steven Soloff</title><link>https://sourceforge.net/p/gamegineer/wiki/DevelopmentEnvironmentSetup/</link><description>&lt;div class="markdown_content"&gt;&lt;h1 id="development-environment-setup"&gt;Development Environment Setup&lt;/h1&gt;
&lt;div class="toc"&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="#development-environment-setup"&gt;Development Environment Setup&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href="#overview"&gt;Overview&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#software"&gt;Software&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href="#java-se-jdk"&gt;Java SE JDK&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#eclipse-sdk"&gt;Eclipse SDK&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href="#execution-environment-descriptions"&gt;Execution Environment Descriptions&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href="#ant"&gt;Ant&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#maven"&gt;Maven&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href="#maven-integration-for-eclipse"&gt;Maven Integration for Eclipse&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href="#subversion"&gt;Subversion&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href="#subclipse"&gt;Subclipse&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href="#configuration"&gt;Configuration&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href="#development-environment-shell"&gt;Development Environment Shell&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#maven-settings"&gt;Maven Settings&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href="#workspace"&gt;Workspace&lt;/a&gt;&lt;ul&gt;
&lt;li&gt;&lt;a href="#create-workspace"&gt;Create Workspace&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#configure-m2e"&gt;Configure m2e&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#import-projects"&gt;Import Projects&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#target-platform"&gt;Target Platform&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#api-baseline"&gt;API Baseline&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#import-settings"&gt;Import Settings&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;a href="#nexus"&gt;Nexus&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/div&gt;
&lt;h2 id="overview"&gt;Overview&lt;/h2&gt;
&lt;p&gt;This article describes how to set up a Gamegineer development environment. &lt;/p&gt;
&lt;h2 id="software"&gt;Software&lt;/h2&gt;
&lt;p&gt;Many of the development tools used by Gamegineer are not stored in version control simply due to the large size of their distributions. Therefore, it is necessary to install this software outside of the formal development process. As an administrative user, install the software packages that follow. Note that only specific versions have been approved for use in a Gamegineer development environment; wildcards have been used where appropriate. &lt;/p&gt;
&lt;h3 id="java-se-jdk"&gt;Java SE JDK&lt;/h3&gt;
&lt;p&gt;Install version 1.7.0_51 of the &lt;a class="" href="http://www.oracle.com/technetwork/java/javase/overview/index.html" rel="nofollow"&gt;Java SE 7 JDK&lt;/a&gt;. The JDK is required for most everything in the development process, including building and testing the software. &lt;/p&gt;
&lt;h3 id="eclipse-sdk"&gt;Eclipse SDK&lt;/h3&gt;
&lt;p&gt;Install version 4.3.2 of the &lt;a class="" href="http://www.eclipse.org/" rel="nofollow"&gt;Eclipse SDK&lt;/a&gt;. Gamegineer is a collection of &lt;a class="" href="http://www.osgi.org/" rel="nofollow"&gt;OSGi&lt;/a&gt; bundles built on the Eclipse Equinox OSGi core framework. The Eclipse SDK provides the tools necessary to build such OSGi bundles. &lt;/p&gt;
&lt;p&gt;&lt;em&gt;It is expected that any version of the Eclipse SDK later than 4.3.2 can be used as a development environment as long as the developer properly sets the target platform for their Eclipse IDE workspace.&lt;/em&gt;&lt;/p&gt;
&lt;h4 id="execution-environment-descriptions"&gt;Execution Environment Descriptions&lt;/h4&gt;
&lt;p&gt;Install the latest execution environment descriptions for the version of Eclipse you are using. See the &lt;a class="" href="http://wiki.eclipse.org/Execution_Environments" rel="nofollow"&gt;Eclipse wiki&lt;/a&gt; for installation instructions. &lt;/p&gt;
&lt;h3 id="ant"&gt;Ant&lt;/h3&gt;
&lt;p&gt;Install version 1.9.2 of &lt;a class="" href="http://ant.apache.org/" rel="nofollow"&gt;Apache Ant&lt;/a&gt;. Ant is used to implement portions of the build process. &lt;/p&gt;
&lt;h3 id="maven"&gt;Maven&lt;/h3&gt;
&lt;p&gt;Install version 3.1.1 of &lt;a class="" href="http://maven.apache.org/" rel="nofollow"&gt;Apache Maven&lt;/a&gt;. Maven is used to implement portions of the build process. &lt;/p&gt;
&lt;h4 id="maven-integration-for-eclipse"&gt;Maven Integration for Eclipse&lt;/h4&gt;
&lt;p&gt;Install version 1.4.x of Maven Integration for Eclipse (m2e). m2e allows you to run the Maven build process from within Eclipse so you get the same results regardless of whether you build from the command line or from the IDE. &lt;/p&gt;
&lt;p&gt;Refer to the &lt;a class="" href="http://wiki.eclipse.org/M2E_updatesite_and_gittags#m2e_releases" rel="nofollow"&gt;m2e wiki&lt;/a&gt; for the correct p2 repository URL used to install the software from within Eclipse. &lt;/p&gt;
&lt;h3 id="subversion"&gt;Subversion&lt;/h3&gt;
&lt;p&gt;Install version 1.8.x of the &lt;a class="" href="http://subversion.apache.org/" rel="nofollow"&gt;Subversion client&lt;/a&gt;. A Subversion client is required for the developer to access the Gamegineer version control repository. &lt;/p&gt;
&lt;h4 id="subclipse"&gt;Subclipse&lt;/h4&gt;
&lt;p&gt;It is recommended to use version 1.10.x of the &lt;a class="" href="http://subclipse.tigris.org/" rel="nofollow"&gt;Subclipse&lt;/a&gt; Eclipse Team Provider plug-in as the preferred Subversion client. Subclipse provides access to a Subversion repository from within the Eclipse IDE. &lt;/p&gt;
&lt;p&gt;Refer to the &lt;a class="" href="http://subclipse.tigris.org/servlets/ProjectProcess?pageID=p4wYuA" rel="nofollow"&gt;Subclipse wiki&lt;/a&gt; for the correct p2 repository URL used to install the software from within Eclipse. &lt;/p&gt;
&lt;h2 id="configuration"&gt;Configuration&lt;/h2&gt;
&lt;h3 id="development-environment-shell"&gt;Development Environment Shell&lt;/h3&gt;
&lt;p&gt;A script is used to start a shell that ensures all developers are using the same settings in their development environment. This script depends on your specific workstation configuration and thus cannot be provided in a generalized form. A script template is provided in the version control repository at &lt;code&gt;https://svn.code.sf.net/p/gamegineer/code/dev/trunk/other/org.gamegineer.settings/shell/templates/dev-environment.bat&lt;/code&gt;. &lt;/p&gt;
&lt;p&gt;Download this template to an appropriate location on your workstation, for example in your local profile. Using a text editor, open the script template and supply appropriate values for the environment variables between the &lt;code&gt;BEGIN-CUSTOM-VARIABLES&lt;/code&gt; and &lt;code&gt;END-CUSTOM-VARIABLES&lt;/code&gt; markers. You may wish to create a shortcut to this script using a target of &lt;code&gt;cmd /k full-path-to-script&lt;/code&gt;. Executing this shortcut will open a shell that represents the root of the development environment. &lt;/p&gt;
&lt;p&gt;It is &lt;strong&gt;very important&lt;/strong&gt; that all development activities originate from this shell. For example, do not start the Eclipse IDE from a separate shortcut, rather you should use the provided &lt;code&gt;eclipse-dev&lt;/code&gt; macro to ensure the IDE is supplied with the correct environment variables. This shell also serves as the launching point for any Ant or Maven builds you may initiate. &lt;/p&gt;
&lt;h3 id="maven-settings"&gt;Maven Settings&lt;/h3&gt;
&lt;p&gt;The Maven build process depends upon some user-defined settings that cannot be provided in the project files stored in version control (e.g. passwords). A Maven settings template is provided in the version control repository at &lt;code&gt;https://svn.code.sf.net/p/gamegineer/code/dev/trunk/other/org.gamegineer.other.settings/maven/templates/settings.xml&lt;/code&gt;. &lt;/p&gt;
&lt;p&gt;Download this template to &lt;code&gt;~/.m2/settings.xml&lt;/code&gt;. Using a text editor, open the settings template and supply appropriate values where directed by the presence of &lt;code&gt;CUSTOM-VARIABLES&lt;/code&gt; comments. &lt;/p&gt;
&lt;h2 id="workspace"&gt;Workspace&lt;/h2&gt;
&lt;h3 id="create-workspace"&gt;Create Workspace&lt;/h3&gt;
&lt;p&gt;Start Eclipse and create a new workspace in the folder you specified for the &lt;code&gt;WORKSPACE_HOME&lt;/code&gt; environment variable above. To speed up this process, you may want to disable automatic builds using the &lt;strong&gt;Project &amp;gt; Build Automatically&lt;/strong&gt; menu command. At the completion of this process, re-enable automatic builds using the same command. &lt;/p&gt;
&lt;h3 id="configure-m2e"&gt;Configure m2e&lt;/h3&gt;
&lt;p&gt;Open the workspace preferences dialog (&lt;strong&gt;Windows &amp;gt; Preferences&lt;/strong&gt;) and go to the &lt;strong&gt;Maven &amp;gt; Installations&lt;/strong&gt; page. Click &lt;strong&gt;Add...&lt;/strong&gt;, browse to the location of Maven you installed above, and click &lt;strong&gt;OK&lt;/strong&gt;. Ensure the new Maven installation is checked. Finally, click &lt;strong&gt;OK&lt;/strong&gt; to close the workspace preferences dialog. &lt;/p&gt;
&lt;h3 id="import-projects"&gt;Import Projects&lt;/h3&gt;
&lt;p&gt;Open the import dialog (&lt;strong&gt;File &amp;gt; Import...&lt;/strong&gt;). Expand the &lt;strong&gt;Maven&lt;/strong&gt; node, select &lt;strong&gt;Check out Maven Projects from SCM&lt;/strong&gt;, and click &lt;strong&gt;Next&lt;/strong&gt;. &lt;/p&gt;
&lt;p&gt;Before continuing you must install the m2e Subclipse SCM connector from the m2e Marketplace. Click the &lt;strong&gt;m2e Marketplace&lt;/strong&gt; link. Check the &lt;strong&gt;m2e-subsclipse&lt;/strong&gt; team provider, and click &lt;strong&gt;Finish&lt;/strong&gt;. Follow the instructions provided in the wizard to complete the installation. You may be required to restart Eclipse. After this step, return to the &lt;strong&gt;Target Location&lt;/strong&gt; page of the import wizard and continue with the next step. &lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;If you are using Subversion 1.8.x and Subclipse 1.10.x, you must use a custom build of the m2e Subclipse SCM connector as the official release only supports Subversion through version 1.7. Open the Install Software dialog (&lt;strong&gt;Help &amp;gt; Install New Software...&lt;/strong&gt;). Enter &lt;code&gt;http://build.g8r.local:8081/nexus/content/unzip/public.unzip/org/sonatype/m2e/subclipse/org.sonatype.m2e/subclipse.repository/0.13.0-SNAPSHOT/org.sonatype.m2e.subclipse.repository-0.13.0-SNAPSHOT.zip-unzip&lt;/code&gt; in the &lt;strong&gt;Work with&lt;/strong&gt; field. Select all available software and click &lt;strong&gt;Next&lt;/strong&gt;. Follow the instructions provided in the wizard to complete the installation. &lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Select &lt;strong&gt;svn&lt;/strong&gt; in the &lt;strong&gt;SCM URL&lt;/strong&gt; combo box, and enter &lt;strong&gt;&lt;code&gt;https://svn.code.sf.net/p/gamegineer/code/dev/trunk&lt;/code&gt;&lt;/strong&gt; in the adjacent text field. Uncheck the &lt;strong&gt;Checkout All Projects&lt;/strong&gt; option. Click &lt;strong&gt;Finish&lt;/strong&gt;. The wizard will close and the projects at the specified URL will be downloaded. This may take several minutes to complete. When the download is complete, the &lt;strong&gt;Import Maven Projects&lt;/strong&gt; wizard will appear. Select the item that begins with &lt;strong&gt;/target-platform&lt;/strong&gt;, and click the &lt;strong&gt;Deselect Tree&lt;/strong&gt; button. Select the item that begins with &lt;strong&gt;/third-party&lt;/strong&gt;, and click the &lt;strong&gt;Deselect Tree&lt;/strong&gt; button. Click &lt;strong&gt;Finish&lt;/strong&gt;. The wizard will close and the selected projects will be installed into the workspace. This may take several minutes to complete. &lt;/p&gt;
&lt;p&gt;Select all projects in the workspace, and select &lt;strong&gt;Replace With &amp;gt; Base Revision&lt;/strong&gt; from the context menu. Click &lt;strong&gt;Yes to All&lt;/strong&gt; when prompted to overwrite unversioned files. &lt;/p&gt;
&lt;p&gt;Select all projects in the workspace, and select &lt;strong&gt;Maven &amp;gt; Update Project...&lt;/strong&gt; from the context menu. Uncheck the &lt;strong&gt;Update project configuration from pom.xml&lt;/strong&gt; button, and click &lt;strong&gt;OK&lt;/strong&gt;. &lt;/p&gt;
&lt;h3 id="target-platform"&gt;Target Platform&lt;/h3&gt;
&lt;p&gt;The default Gamegineer target platform is stored in the workspace at &lt;code&gt;org.gamegineer.main/default.target&lt;/code&gt;. Open this file and click the &lt;strong&gt;Set as Target Platform&lt;/strong&gt; link in the upper-right corner of the editor window. &lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;You must repeat this process whenever you or another developer changes the target platform. &lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id="api-baseline"&gt;API Baseline&lt;/h3&gt;
&lt;p&gt;Open the workspace preferences dialog (&lt;strong&gt;Windows &amp;gt; Preferences&lt;/strong&gt;) and go to the &lt;strong&gt;Plug-in Development &amp;gt; API Baselines&lt;/strong&gt;' page. Click &lt;strong&gt;Add Baseline...&lt;/strong&gt;. Name the new baseline &lt;strong&gt;Default Gamegineer Target&lt;/strong&gt;. Click &lt;strong&gt;Browse...&lt;/strong&gt;, and navigate to the &lt;code&gt;.metadata/.plugins/org.eclipse.pde.core/.bundle_pool&lt;/code&gt; directory under your workspace directory. Click &lt;strong&gt;Reset&lt;/strong&gt; to load the target location, and click &lt;strong&gt;Finish&lt;/strong&gt; to create the baseline. Finally, click &lt;strong&gt;OK&lt;/strong&gt; to close the workspace preferences dialog. &lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;You must repeat this process (using &lt;strong&gt;Edit...&lt;/strong&gt; instead of &lt;strong&gt;Add Baseline...&lt;/strong&gt;) whenever you or another developer changes the target platform. &lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id="import-settings"&gt;Import Settings&lt;/h3&gt;
&lt;p&gt;The &lt;code&gt;org.gamegineer.other.settings&lt;/code&gt; project contains the standard workspace settings to be used by all Gamegineer developers. &lt;/p&gt;
&lt;p&gt;In a new workspace, you must import each file under &lt;code&gt;eclipse/&amp;lt;version&amp;gt;/templates&lt;/code&gt; into the corresponding section of your workspace preferences (&lt;strong&gt;Window &amp;gt; Preferences&lt;/strong&gt;). Each folder under &lt;code&gt;templates&lt;/code&gt; is arranged in a hierarchy identical to how the Eclipse Preferences dialog is structured. &lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;The path for the user-defined spelling dictionary under &lt;strong&gt;General &amp;gt; Editors &amp;gt; Text Editors &amp;gt; Spelling&lt;/strong&gt; should be set to &lt;code&gt;${project_loc:org.gamegineer.other.settings}/eclipse/&amp;lt;version&amp;gt;/templates/general/editors/text-editors/spelling/user-dictionary.txt&lt;/code&gt;. &lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;You will then proceed to configure your workspace as you desire (e.g. arrange views, adjust editor colors, etc.). Gamegineer developers are permitted to store their personal workspace preferences under &lt;code&gt;eclipse/&amp;lt;version&amp;gt;/users&lt;/code&gt;. Export your preferences to a file in this directory with the same name as your SourceForge user ID (e.g. &lt;em&gt;joe_developer.epf&lt;strong&gt;). Please avoid modifying another user's preferences. &lt;/strong&gt;&lt;/em&gt;&lt;/p&gt;
&lt;h2 id="nexus"&gt;Nexus&lt;/h2&gt;
&lt;p&gt;Each developer should have their own local instance of Nexus. A local Nexus repository is useful when testing changes to certain build goals, such as changing the target platform or generating the project website. Installation of Nexus should be done according to the process described in &lt;a class="" href="/p/gamegineer/wiki/BuildServerSetup/"&gt;Build Server Setup&lt;/a&gt;. &lt;/p&gt;&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Steven Soloff</dc:creator><pubDate>Sat, 24 May 2014 00:45:29 -0000</pubDate><guid>https://sourceforge.net4ee2a377ab913516acda22651bbb1f4566c9ff8f</guid></item></channel></rss>