You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+36-6Lines changed: 36 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,44 @@
1
-
The following describe how to set up a Processing library project in Eclipse and build it successfully, and to make your library ready for distribution.
1
+
The following describes how to set up a Processing library project in Eclipse and build it successfully, and to make your library ready for distribution.
2
+
3
+
## Import to Eclipse
4
+
5
+
There are two options to import the template project into Eclipse: using a Git [fork](https://help.github.com/articles/fork-a-repo) or using a downloaded package. If you are not familiar with Git or GitHub, you should opt for the downloaded package.
6
+
7
+
### Option A: GitHub
8
+
9
+
1. Fork the template repository to use as a starting point.
10
+
* Navigate to https://github.com/prisonerjohn/processing-library-template in your browser.
11
+
* Click the "Fork" button in the top-right of the page.
12
+
* Once your fork is ready, open the new repository's "Settings" by clicking the link in the menu bar on the right.
13
+
* Change the repository name to the name of your library and save your changes.
14
+
1. Clone your new repository to your Eclipse workspace.
15
+
* Open Eclipse and select the File → Import... menu item.
16
+
* Select Git → Projects from Git, and click "Next >".
17
+
* Select "URI" and click "Next >".
18
+
* Enter your repository's clone URL in the "URI" field. The remaining fields in the "Location" and "Connection" groups will get automatically filled in.
19
+
* Enter your GitHub credentials in the "Authentication" group, and click "Next >".
20
+
* Select the `master` branch on the next screen, and click "Next >".
21
+
* The default settings on the "Local Configuration" screen should work fine, click "Next >".
22
+
* Make sure "Import existing projects" is selected, and click "Next >".
23
+
* Eclipse should find and select the `processing-library-template` automatically, click "Finish".
24
+
1. Rename your Eclipse project.
25
+
* In the Package Explorer, right-click (ctrl-click) on the folder icon of the `processing-library-template` project, and select Refacator → Rename... from the menu that pops up.
26
+
* Give the project the name of your library, and click "OK".
27
+
28
+
### Option B: Downloaded Package
2
29
3
30
1. Download the latest Eclipse template from [here](http://code.google.com/p/processing/downloads/list). **Don't unzip the ZIP file yet.**
4
31
1. Create a new Java project in Eclipse.
5
32
* From the menubar choose File → New → Java Project.
6
33
* Give the project the name of your library.
7
34
* Click "Finish".
8
35
1. Import the template source files.
9
-
* Right-click (ctrl-click) onto the folder icon of your newly created project in the "Package Explorer" and choose "Import" from the menu that pops up.
10
-
* Select General → Archive File, click "Next" and navigate to the ZIP file you downloaded earlier in step 1.
11
-
* Confirm the archive with "Finish".
36
+
* Right-click (ctrl-click) onto the folder icon of your newly created project in the Package Explorer and select "Import..." from the menu that pops up.
37
+
* Select General → Archive File, and click "Next >".
38
+
* Navigate to the ZIP file you downloaded earlier in step 1, and click "Finish".
39
+
40
+
## Set Up and Compile
41
+
12
42
1. Add Processing to the project build path.
13
43
* Open your project's "Properties" window.
14
44
* Under "Java Build Path", select the "Libraries" tab and then "Add External JARs...".
@@ -29,7 +59,7 @@ The following describe how to set up a Processing library project in Eclipse and
29
59
30
60
After having compiled and built your project successfully, you should be able to find your library in Processing's sketchbook folder, examples will be listed in Processing's sketchbook menu. Files that have been created for the distribution of the library are located in your Eclipse's `workspace/yourProject/distribution` folder. In there you will also find the `web` folder which contains the documentation, a ZIP file for downloading your library, a folder with examples as well as the `index.html` and CSS file.
31
61
32
-
To distribute your library please refer to the LibraryGuidelines.
62
+
To distribute your library please refer to the [Library Guidelines](https://github.com/processing/processing/wiki/Library-Guidelines).
33
63
34
64
## Source code
35
65
@@ -66,4 +96,4 @@ To change the JRE used to compile your Java project:
66
96
67
97
Ant is a Java-based build tool. For [more information](http://ant.apache.org/faq.html#what-is-ant) visit the [Ant web site](http://ant.apache.org/). Ant uses a file named `build.xml` to store build settings for a project.
68
98
69
-
Javadoc is an application that creates an HTML-based API documentation of Java code. You can check for its existence by typing `javadoc` on the command line. On Mac OS X, it is installed by default. On Windows and Linux, installing the JDK will also install the Javadoc tool.
99
+
Javadoc is an application that creates an HTML-based API documentation of Java code. You can check for its existence by typing `javadoc` on the command line. On Mac OS X, it is installed by default. On Windows and Linux, installing the JDK will also install the Javadoc tool.
0 commit comments