JaCaMo Eclipse Plugin

Maicon Rafael Zatelli

September 2014

Contents

Installation

Agent creation

Internal Action

Artifacts

Organization

Protocols

Importing projects

Exporting projects

Update

Uninstall

Installation

In order to install the JaCaMo  plug-in for Eclipse you should follow the steps below and have

Eclipse version 4.2.0 (Juno) or greater.

Step 1

Download the latest version of JaCaMo at the link: http://sourceforge.net/projects/jacamo/files/

Step 2

After the download, unpack it in any directory of your machine.

Step 3

Even if you had run JaCaMo on your computer before, execute the file "lib/jacamo.jar" by double clicking on it. You also could execute this file by with the following command:

java -jar lib/jacamo.jar

The following window appears. We suggest that you only change the "Java Home" directory (notice that it has to point to a JDK installation).

Screen Shot 2014-09-24 at 18.51.11.png

*** If your internet access pass by a proxy, please click here to see how to configure the proxy in your Eclipse before to continue the installation of the plugin.



Step 4

Finally you could install the JaCaMo plugin for Eclipse opening the Eclipse platform and going to the option "Install New Software..." at the "Help" menu:

Step 5

So, the following window will appear.

Step 6

Click over the "Add" button, and fill out the form as shown in the next figure. The parameters are

Name: jacamoide

Location (for JaCaMo >= 0.4 and Eclipse* Juno/Kepler/Luna/Mars/Neon):

http://jacamo.sourceforge.net/eclipseplugin/juno

Location (for JaCaMo <= 0.3a and Eclipse* Juno/Kepler/Luna/Mars/Neon):

http://jacamo.sourceforge.net/eclipseplugin/juno_old

* Only Java-EE or Committers.



To finish, click on the "OK" button.

install1.png

Step 7

Tick the option "jacamoide" and then press the "next" button. So, you have to wait a moment while Eclipse searches the dependences.

install2.png

Step 8

In the next windows just press the "next" button again.

install3.png

Step 9

The last window that will be shown for you is about the license. Tick the option "I accept the terms of the license agreements" and then press the "finish" button. Then the installation is proceeded, it could take several minutes, so please wait.

install4.png

Step 10

In the end of these process will be shown a window in order to complete the installation. Choose the option "Restart Now".

Step 11

Now, you can open the JaCaMo perspective. You could do it in the menu (Window > Open Perspective > Other)

persp1.png

Step 12

Then, you can select JaCaMo and press “OK”.

persp2.png

Step 13

Finally, you have all set. In order to test the installation of the plug-in, we suggest the creation of a simple hello world project. You could do it in the menu (File > New  > JaCaMo Project) or (File > New > Other > JaCaMo > JaCaMo Project).

newProject.png

Step 14

Fill out the field "Project name" and press the "Finish" button.

newProject2.png

Step 15

If everything is fine, you will have your first project created!

create1.png

Step 16

Now you can run the application by pressing the Run button.

create2.png

Step 17

The result will be a "hello world" message in your screen.

create3.png

How to create an agent type

Step 1

Click on the source folder named "src/agt" using the right button and go to the option New > Agent Type.

agent1.png

Step 2

Fill out the form. The only required field is the name of the agent type.

After it, press the "Finish" button.

agent2.png

Step 3

The agent type will be created and the following window will appear.

agent2.png

Step 4

New agents can be created using the just created agent type. Click on the project file using the right button and go to the option Add Jason File.

agent3.png

Step 5

Fill out the form. The only required fields are the agent name and agent type.

After it, press the "Finish" button, if no more configuration will be performed, otherwise press the “Next” button for an advanced configuration.

agent5.png

agent6.png

Step 6

The new agent will be automatically added in the project file.

agent4.png

How to create an internal action

Step 1

Select the source folder named "src/agt" and go to the option New > Internal Action.

ia1.png

Step 2

Fill out the form. An internal action is a java class, so the only required field is the name of the class.

Note: we suggest you to give a name using the first letter in lower case.

ia2.png

Step 3

The internal action will be created.

ia3.png

How to create an Artifact

Step 1

Click on the source folder named "src/env" using the right button and go to the option New > CArtAgO Artifact.

cart1.png

Step 2

Fill out the form. A CArtAgO artifact is a java class, so the only required field is the name of the class.

Note: in contrast to an internal action, in this case you could use a name with a first letter in upper case, and also we suggest you to name the package.

art2.png

Step 3

The CArtAgO artifact will be created.

art3.png

How to create a Moise Organization

Step 1

Click on the source folder named "src/org" using the right button and go to the option New > Moise Organization.

mois1.png

Step 2

Fill out the form. The only required field is the organization filename.

After it, press the "Finish" button.

org2.png

Step 3

The Moise organization will be created.

org3.png

How to create an Interaction Protocol

Step 1

Click on the source folder named & quot;src/int" using the right button and go to the option New > Interaction Protocol.

prot1.png

Step 2

Fill out the form. The only required field is the protocol filename.

After it, press the "Finish" button.

int2.png

Step 3

The interaction protocol will be created.

int3.png

How to import a JaCaMo project

Step 1

Click on the "File" menu and go to the option "Import...".

Step 2

Select the option JaCaMo > JaCaMo Project.

import1.png

Step 3

Click on the "Browse" button and choose the directory of the project, tick the project that you wish to import and finally press the "Finish" button.

import2.png

How to export a JaCaMo project

Step 1

Click on the project using the right button and go to the option "Export...".

export1.png

Step 2

Select the option JaCaMo > JaCaMo Project.

export2.png

Step 3

Click on the "Browse" button and select the directory that you wish to export the project and press the "Finish" button.

exp2.png

How to update the JaCaMo plugin

You have two ways to update your JaCaMo eclipse plugin.

First way

Simply click on the "Help" menu and go to the option "Check for Updates".

Second way

Step 1

Click on the "Help" menu and go to the option "About Eclipse SDK".

Step 2

Press the "Installation Details" button.

Step 3

Select the "jacamoide_feature" and click on the "Update..." button.

updatex.png

How to uninstall the JaCaMo plugin

Step 1

Click on the "Help" menu and go to the option "About Eclipse SDK".

Step 2

Press the "Installation Details" button.

Step 3

Select the "jacamoide_feature" and click on the "Uninstall..." button.

desinstallx.png

Step 4

Confirm the process of uninstallation pressing the "Finish" button.

desinstallx1.png

Step 5

In order to complete the uninstallation press the "Restart Now" button.

Thanks for your interest on JaCaMo. You will find more information at http://jacamo.sf.net.