To create a new project, you'll need to use an App Engine-provided Maven App Engine artifact called appengine-skeleton-archetype, as described in Creating the project. The App Engine Maven artifact is what creates the project layout and files required to deploy and run on App Engine.

After project creation, you'll need to configure the new project, as described in Configuring the project.

Creating the project

To create the project:

1. Change to a directory where you want to build your project.

2. From the command line invoke Maven as follows:

   mvn archetype:generate
   

3. When prompted to Choose a number or apply filter, supply the value com.google.appengine.archetypes:skeleton-archetype to display a short list of archetypes matching the filter.

4. When prompted to Choose a number or apply filter, supply the number displayed for the appengine-skeleton-archetype artifact from the preceding step, for example, 1.

5. When prompted to Define value for property 'groupId', supply the value com.google.appengine.demos.

6. When prompted to Define value for property 'artifactId', supply the value guestbook.

7. When prompted to Define value for property 'version', accept the default value.

8. When prompted to Define value for property 'package', accept the default value.

9. When prompted to confirm your choices, accept the default value (Y).

10. Wait for the project to finish generating. At this point, the basic project layout with required files is complete. Inside the directory where you created the project, you'll have a subdirectory named guestbook, which contains a pom.xml file and two subdirectories: guestbook-ear and guestbook-war. We'll describe what to do inside these two subdirectories later.

Now you are ready to configure the project.

Configuring the project

To configure the project:

1. In guestbook, open pom.xml in an editor, and change the <appengine.target.version> to the most recent App Engine Java SDK version available. Save your changes and close the file.

2. In guestbook-war, open the pom.xml file at that location.

3. Under , locate the line <appengine.app.version>version</appengine.app.version>, and under this, add the line

   <appengine.target.version><!--version--></appengine.target.version>
   

   replacing with the latest App Engine Java SDK version: 1.9.1.

4. Visit the Google Developers Console, and click Create Project.

5. Supply the project name Guestbook and accept the project ID auto-generated for you. Make a note of the project ID, since you'll use it next, then click Create.

6. Back in your terminal window for your Maven project, navigate to the subdirectory guestbook/guestbook-ear/src/main/application/META-INF/ and open the file appengine-application.xml in an editor.

7. Supply the project ID you just obtained above as the value for <application>.

You are now ready to add your own application code and UI.

Next

Proceed to the next step, Adding Application Code and UI.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies.