https://sourceforge.net/p/scbg/wiki/DevelopmentEnvironment/Recent changes to DevelopmentEnvironmentenMon, 09 Jun 2014 09:07:58 -0000https://sourceforge.net/p/scbg/wiki/DevelopmentEnvironment/<div class="markdown_content"><h1 id="development-environment-setup">Development Environment Setup</h1> <ul> <li>use Eclipse 3.6 (classic edition) </li> <li>install the following plugins <ul> <li>Google plugin for App Engine and Web Toolkit <a href="http://code.google.com/intl/de-DE/eclipse/docs/download.html" rel="nofollow">http://code.google.com/intl/de-DE/eclipse/docs/download.html</a></li> <li>Web-Developer tools </li> <li>GEF (optional for swt-client which is anyways not compiling currently) </li> <li>SVN (optional, but useful) </li> </ul> </li> </ul> <h1 id="workspace-setup">Workspace Setup</h1> <ul> <li>check out the source code <a href="https://scbg.svn.sourceforge.net/svnroot/scbg">https://scbg.svn.sourceforge.net/svnroot/scbg</a></li> <li>I usually recommend to separate the local source code repository from the Eclipse workspace </li> <li>start Eclipse, create a new workspace and import the projects </li> <li>close the <strong>starcraft.gameclient.swt</strong> project as it is not compiling currently </li> </ul> <h1 id="additional-setup">Additional Setup</h1> <p>A file-system link (ln on Linux, mklink on Windows) must be created in the project <strong>starcraft.webapp</strong>. The <strong>starcraft.resources</strong>\images directory has to be mapped to <strong>starcraft.webapp</strong>\war\images\res. This has been done to avoid having to copy the images. The OpenGL client loads the images through the class path, the web client through the Web server from the file system. </p> <p>Create the symbolic link </p> <div class="codehilite"><pre> <span class="n">cd</span> <span class="o">&lt;</span><span class="n">base</span><span class="o">-</span><span class="n">dir</span><span class="o">&gt;</span><span class="err">\</span><span class="n">starcraft</span><span class="err">\</span><span class="n">starcraft</span><span class="p">.</span><span class="n">webapp</span><span class="err">\</span><span class="n">war</span><span class="err">\</span><span class="n">images</span> <span class="n">mklink</span> <span class="o">/</span><span class="n">D</span> <span class="n">res</span> <span class="p">..</span><span class="err">\</span><span class="p">..</span><span class="err">\</span><span class="p">..</span><span class="err">\</span><span class="n">starcraft</span><span class="p">.</span><span class="n">resources</span><span class="err">\</span><span class="n">images</span> </pre></div> <p>The result should look like this (on Windows) <br /> <img alt="" src="/apps/trac/scbg/raw-attachment/wiki/DevelopmentEnvironment/symlink.png" /></p> <h1 id="project-overview">Project Overview</h1> <ul> <li><strong>starcraft.gameclient</strong><ul> <li><code>GameClient</code> provides the RMI API for the client </li> <li>automated scripts to create some game state </li> <li>rules as PDF </li> </ul> </li> <li><strong>starcraft.gameclient.opengl</strong><ul> <li><code>StarcraftBordgameClient</code> entry class for the OpenGL client </li> <li>other entry points are some classes named *State, e.g. <code>PlanetPlacementState</code></li> <li>not sure that all executes well </li> </ul> </li> <li><strong>starcraft.gameclient.swt</strong><ul> <li>very old, does not compile at all </li> </ul> </li> <li><strong>starcraft.gamemodel</strong><ul> <li>this is a GWT module; the classes defined in the packages 'model', 'shared' and 'remoteservices' are compiled into JavaScript </li> <li>most of these classes are serializable and used for client/server communication </li> <li><code>StarCraftRemoteService</code> is the main communication interface between client and server </li> <li>the use of the 'player' parameter is not consistent; sometimes it could be derived from the 'clientID'; work in progress </li> </ul> </li> <li><strong>starcraft.gameserver</strong><ul> <li><code>ServerRuntime</code> is a good starting point </li> <li>the <code>starcraft.gameserver.game</code> package contains the main server implementation </li> <li>the <code>starcraft.gameserver.debug</code> package was thought as REST implementation, but development is ceased </li> </ul> </li> <li><strong>starcraft.gameserver.rcp</strong><ul> <li>unsure of the current state, but probably nothing useful </li> </ul> </li> <li><strong>starcraft.resources</strong><ul> <li>just images </li> </ul> </li> <li><strong>starcraft.tests</strong><ul> <li>not much useful things </li> <li>the project has dependecies to the client and the server; could be used for automated tests </li> </ul> </li> <li><strong>starcraft.webapp</strong><ul> <li>the GWT web client/server implementation </li> </ul> </li> <li><strong>starcraft.webapp.gae</strong><ul> <li>project for deployment of the application to the Google App Engine </li> </ul> </li> </ul></div>Nicolas CabanisMon, 09 Jun 2014 09:07:58 -0000https://sourceforge.netf9c0f21bbe934a9718bebc72892de003e097a910