Differences

This shows you the differences between two versions of the page.

--- classes:csci345_slator:eclipse [2017/01/14 00:21] – [Check Out As] localadmin
+++ classes:csci345_slator:eclipse [2020/04/10 04:54] (current) – [Creating an executable Blackwood jar file] localadmin
@@ Line 26: / Line 26: @@
 <code>
+(for older branches)
 https://lions.cs.ndsu.nodak.edu/svn/blackwood/branches/CS345_Spring201X
+(for the current and most recent branches)
+https://lions.cs.ndsu.nodak.edu/svn/blackwood/branches/CS429_Spring201X/
 </code>
@@ Line 43: / Line 47: @@
 Give the project a name, and select finish.  This will begin the check out process.  The project will be downloaded from lions.cs.ndsu.nodak.edu to your local computer.  Once complete, go to your workbench.
-==== Check Out As ====
+==== The Workbench ====
-Simply checking out the repository is not enough, you will need to create a new project for Eclipse.  I would recommend to "Check out as a project configured using the New Project Wizard".
+You should now see a Package Explorer on the left side of the Eclipse Window.  Yet if you try to run Blackwood now, it will crash.  You will need to link the proper libraries that the project uses.
-Select Java → Java Project.
-Give the project a name, and select finish.  This will begin the check out process.  The project will be downloaded from lions.cs.ndsu.nodak.edu to your local computer.  Once complete, go to your workbench.
+Right click on your project and select 'Properties'.  From here, select the Java Build Path on the left, and click the Libraries tab.
+Here, press the 'Add JARs...' button.  This will open up a new window.  You will find the Jar libraries that need to be added under 'lib'.  Select all of the files that end in ".jar", and click Okay.  Those libraries are now added to the project.
+==== Running Blackwood ====
+Now that the Blackwood source code is downloaded, the project is created and the libraries are properly linked, you can now run Blackwood.  Right click on the project, select Run As... → Java Application.  You will then be prompted to select the correct Main method to run, this can be found in "Main - edu.nodak.ndsu.cs.lions.blackwood".  Should all the steps be followed properly, Blackwood will launch.
+==== Creating an executable Blackwood jar file ====
+Find the Blackwood project in the Package Explorer on the left side of the Eclipse Window.
+Right click on the project and select **Export** from the menu. A select window will open. Find the **Java** option and choose **Runable Jar File** from. Then click **Next**.
+In the next window, Select the Blackwood launch configuration and enter a path and file name in the export destination field. Be sure the **Package required libraries into generated jar** option is selected. Click **Finish**
+If your project runs in Eclipse without errors, you should get an executable jar file when the process finishes.
+==== (If all else fails) Working Blackwood .zip ====
+If you've gone through all the above steps, and you still don't have a working copy of Blackwood in Eclipse: [[https://drive.google.com/open?id=1o1vBkcSF_5M-QudZEPuvOTaZ2ZNogKpC|Attached]] is a working Eclipse Oxygen2 directory with the CS429_Spring2018 branch in its workspace. If the project does not automatically import, right click in the Package Explorer pane and select "Import...", next select "General" -> "Existing Projects into Workspace", and under "Select root directory" click "Browse..." and navigate to the "workspace" folder included in this zip archive. Select the project and hit finish.