Es muy fácil utilizar el entorno de desarrollo Eclipse para desarrollar tu aplicación App Engine Java, así como cualquier otra aplicación web basada en servlet. Con el complemento de Google para Eclipse, es aún más fácil. El complemento te permite crear, probar y subir aplicaciones App Engine desde Eclipse.
El complemento de Google para Eclipse también facilita el desarrollo de aplicaciones a través de Google Web Toolkit (GWT) para ejecutarlas en App Engine o en cualquier otro entorno.
Este artículo describe cómo instalar el complemento de Google para Eclipse y cómo crear un nuevo proyecto de App Engine y depurarlo mediante el servidor de desarrollo que se ejecuta en Eclipse. Además, también se describe cómo utilizar el complemento para subir tu proyecto a App Engine.
Para obtener más información sobre el complemento, incluido cómo utilizarlo en proyectos de Google Web Toolkit, consulta la documentación del complemento de Google para Eclipse.
Puedes obtener Eclipse en el sitio web de Eclipse. "Eclipse IDE for Java EE Developers" (el entorno integrado de desarrollo (IDE) para desarrolladores Java EE) incluye todos los componentes necesarios para el desarrollo de la aplicación web.
El complemento de Google para Eclipse está disponible para Eclipse 3.3 (Europa) o Eclipse 3.4 (Ganymede).
Además del complemento de Google para Eclipse, recomendamos los complementos de Web Tools Platform (WTP) para el desarrollo web. Consulta el sitio web Web Tools Platform. Entre otras cosas, WTP ofrece modos de edición para archivos JSP y HTML.
Puedes instalar el complemento de Google para Eclipse a través de la función "Software Update" de Eclipse.
Para instalar el complemento a través de Eclipse 3.4 (Ganymede):
http://dl.google.com/eclipse/plugin/3.4Haz clic en OK. Se cerrará el cuadro de diálogo y la nueva ubicación se añadirá a la lista de software disponible.
Haz clic en el triángulo situado junto a la nueva ubicación y, a continuación, selecciona el triángulo situado junto a "Google" para ver las opciones de instalación. Activa las casillas de verificación situadas junto a "Google Plugin for Eclipse 3.4" y "Google App Engine Java SDK". También puedes seleccionar "Google Web Toolkit SDK" si quieres utilizar Google Web Toolkit con tus aplicaciones. Haz clic en el botón "Install...". Sigue las indicaciones para aceptar las condiciones del servicio e instalar el complemento.
Nota: el proceso de instalación del complemento puede tardar varios minutos mientras Eclipse actualiza las dependencias. Para obtener más información, consulta las preguntas frecuentes (en inglés).
El proceso de instalación del complemento de Eclipse 3.3 (Europa) es similar, aunque los mensajes del sistema y la ubicación de instalación son diferentes. La ubicación del complemento de Google para Eclipse 3.3 es la siguiente:
http://dl.google.com/eclipse/plugin/3.3
Para obtener más información sobre "Software Update", consulta la documentación de Eclipse.
Para crear un nuevo proyecto de App Engine:
.
| 
Guestbook para el proyecto descrito en la Guía de introducción. En "Package", introduce un nombre de paquete adecuado como, por ejemplo, guestbook.appengine-java-sdk/ de tu SDK.El asistente crea una estructura de directorio para el proyecto, que incluye un directorio src/ para los archivos de origen Java y un directorio war/ para las clases compiladas y otros archivos de la aplicación, bibliotecas, archivos de configuración, archivos estáticos (como, por ejemplo, imágenes y CSS), así como otros archivos de datos. El asistente también crea un archivo de origen servlet y dos archivos de configuración. La estructura de directorio completa es similar a:
Guestbook/
src/
guestbook/
server/
GuestbookServlet.java
META-INF/
jdoconfig.xml
log4j.properties
logging.properties
war/
WEB-INF/
lib/
...App Engine JARs...
appengine-web.xml
web.xml
index.html
El directorio war/ utiliza el formato estándar WAR para asociar aplicaciones web. (Los archivos del archivo WAR no son compatibles con el SDK). El complemento de Eclipse utiliza este directorio para ejecutar el servidor de desarrollo y para implementar la aplicación en App Engine.
Cuando Eclipse crea tu proyecto, crea un directorio denominado classes/ en war/WEB-INF/ y coloca los archivos de la clase compilada en él. Eclipse también copia archivos sin origen que se encuentran en src/ a war/WEB-INF/classes/, entre los que se incluyen META-INF/ y los archivos log4j.properties y logging.properties. El contenido final del directorio war/ prepara la aplicación para probarse e implementarse.
Para obtener información detallada sobre el nuevo proyecto que crea el complemento, consulta la Guía de introducción.
El SDK de App Engine incluye un servidor web para probar tu aplicación en un entorno simulado. El complemento de Google para Eclipse añade nuevos elementos al menú Run para iniciar este servidor.
Para ejecutar la aplicación en el servidor web del depurador de Eclipse, selecciona el menú Run , Debug As > Web Application. Eclipse crea el proyecto y cambia a la perspectiva "Debug" y, a continuación, el servidor se inicia. Si el servidor se inicia correctamente, aparecerán varios mensajes en la consola, incluido un mensaje similar a este:
The server is running at http://localhost:8080/
Si quieres personalizar la forma en la que se inicia el servidor, puedes crear una nueva configuración "Run/Debug" del tipo "Web Application".
Para probar la nueva aplicación que ha creado el complemento, inicia el servidor como se indicó anteriormente y, a continuación, accede a la siguiente URL a través de tu navegador (mediante una ruta de URL adecuada para tu aplicación):
Con Eclipse, puedes dejar que el servidor se ejecute en el depurador mientras realizas cambios en el código fuente, JSP, archivos estáticos y appengine-web.xml. Al guardar los cambios en el código fuente, Eclipse compila la clase de forma automática y, a continuación, intenta insertarla en el servidor web en ejecución de forma dinámica. En la mayoría de los casos, puedes simplemente volver a cargar la página en tu navegador para probar la nueva versión del código. El servidor de desarrollo reconoce de forma automática los cambios realizados en JSP, archivos estáticos y appengine-web.xml, los cuales surten efecto sin reiniciar el servidor. Si cambias web.xml u otros archivos de configuración, debes detener e iniciar el servidor para que los cambios surtan efecto.
Para detener el servidor, asegúrate de que el panel Debug esté seleccionado y, a continuación, haz clic en el botón "Terminate": 
.
El complemento de Google para Eclipse añade varios botones a la barra de herramientas de Eclipse. El botón de implementación de App Engine sube tu aplicación a App Engine: 
.
Antes de subir tu aplicación por primera vez, debes registrar una ID de aplicación con App Engine a través de la consola de administración. Registra una ID de aplicación y, a continuación, edita el archivo appengine-web.xml y cambia el elemento <application>...</application> que contiene la nueva ID.
Al hacer clic en el botón de implementación de App Engine, se muestra un mensaje de Eclipse que te pide tu nombre de usuario de la cuenta de administrador (tu dirección de correo electrónico) y contraseña. Introduce la información de tu cuenta y haz clic en el botón Upload para terminar la subida. Eclipse obtiene la ID de la aplicación e información sobre la versión desde el archivo appengine-web.xml y sube el contenido del directorio war/.
Prueba tu aplicación en App Engine a través del acceso a su URL:
http://<your application ID>.appspot.com/guestbookAlgunas funciones de las herramientas del SDK de Java de App Engine sólo están disponibles mediante la ejecución directa de las herramientas desde la línea de comandos. Si has instalado el SDK a través de Eclipse, puedes ejecutar estas herramientas desde el directorio de instalación del complemento de Eclipse.
El SDK se ubica en el directorio de instalación de Eclipse, en plugins/com.google.appengine.eclipse.sdkbundle_VERSION/, donde VERSION es un identificador de versión del SDK. En este directorio se encuentra el subdirectorio appengine-java-sdk/bin/ que contiene las herramientas.
Nota: si utilizas Mac OS X o Linux, debes asignar permiso de ejecución a los archivos ejecutables antes de ejecutarlos. Por ejemplo, para asignar permiso de ejecución appcfg.sh, introduce el siguiente comando desde el directorio appengine-java-sdk/bin/: chmod u+x appcfg.sh
Para obtener más información sobre las funciones disponibles de forma exclusiva desde la línea de comandos, consulta Subida y administración.