A JBoss Project
Red Hat

How To:

Create Your First Mobile Web App

Mobile Web Tools provides an HTML5 Project wizard that enables you to create web applications optimized for mobile devices. The HTML5 Project wizard is a useful starting point for creating all new HTML5 web applications in the IDE. The wizard generates a sample ready-to-deploy HTML5 mobile application with REST resources from a Maven archetype.

As demonstrated in this article, you can customize the application using the JBoss Tools HTML Editor, deploy and view the application with the mobile browser simulator BrowserSim, and use LiveReload to refresh BrowserSim as the application source code is modified and saved in the IDE.

The instructions here demonstrate how to complete the following tasks:

This article guides you through each of these configuration requirements and must be completed in the order given.

Prerequisite: Configure the IDE for an Available Server

The instructions in this article show you how to deploy your HTML5 web application to a server. The IDE must be configured for any servers to which you want to deploy applications, including the location and type of application server and any custom configuration or management settings. You can complete this configuration at the time of deploying the application but in this article it is assumed that you have completed the configuration beforehand.

For information on configuring a local runtime server and deploying applications to it, see Deploy Apps to a Local Server.

1. Create an HTML5 Project

The HTML5 Project wizard generates a sample project based on a Maven archetype and the project and application identifiers provided by you. The Maven archetype version is indicated in the Description field of the wizard first page and you can change the version, and therefore the project look and dependencies, by selected either an enterprise or non-enterprise target runtime within the wizard.

To create a HTML5 project, complete the following steps:

  1. In JBoss Central, under Start from scratch, click HTML5 Project.

  2. From the Target Runtime list, select an IDE-ready server and click Next.

  3. Complete the fields about the HTML5 project as follows:

    • In the Project name field, type a name for the project.

    • In the Package field, type an alpha-numeric package for the project.

  4. Click Finish.

  5. When prompted with 'HTML5 Project' Project is now ready, click Finish.

The project is generated and listed in the Project Explorer view.

2. Build and Deploy the Application

After the HTML5 project is generated, it can immediately be built and deployed to an application server.

To build and deploy the application, complete the following steps:

  1. In the Project Explorer view, right-click {project name} and click Run As ▸ Run on Server.

  2. Ensure Choose an existing server is selected.

  3. From the table of servers, expand localhost, select the server on which to deploy the application and click Finish.

    Select the runtime server to run the application.
    Figure 1. Selecting the server to run the application

The Console view shows output from the server starting and deploying the application. When deployment is complete, an IDE default web browser opens and shows the deployed web application.

Select the runtime server to run the application.
Figure 2. Enterprise HTML5 web application Viewed in Browser
Select the runtime server to run the application.
Figure 3. Non-enterprise HTML5 web application Viewed in Browser

3. View the Application with BrowserSim

The HTML5 web application has an interface optimized for mobile devices. You can view and test such web pages as they would be on mobile devices using BrowserSim. This mobile device web browser simulator provides skins for different mobile devices, making it easy to test and debug web applications for mobile devices.

To view the application with BrowserSim, complete the following steps:

  1. Ensure JBoss is the perspective in use. To open the JBoss perspective, click Window ▸ Open Perspective ▸ Other and double-click JBoss.

  2. In the Servers view, expand the server adapter to list the application.

  3. Right-click {application name} and click Show In ▸ BrowserSim.

HTML5 Web Application Viewed with BrowserSim.
Figure 4. HTML5 Web Application Viewed with BrowserSim

4. Enable LiveReload for BrowserSim

Mobile Web Tools supports the LiveReload protocol for automatic reloading of web pages in enabled browsers as the application source is modified and saved. LiveReload can be enabled for your system browsers and, as demonstrated here, BrowserSim. This provides an interactive web development experience.

To enable LiveReload for BrowserSim, complete the following steps:

  1. Close any open BrowserSim simulated devices.

  2. In the Servers view, right-click an existing server to display the context menu and click New ▸ Server.

  3. From the list, expand Basic, select LiveReload Server and click Finish.

  4. In the Servers view, right-click LiveReload Server and click Start.

  5. In the Servers view, right-click {application name} and click Show In ▸ BrowserSim.

LiveReload is automatically enabled for this BrowserSim simulated device and all subsequent devices opened while the LiveReload server is running.

5. Change the Application

With LiveReload enabled for BrowserSim, you can make changes to your application source code and BrowserSim automatically reloads the application when changes are saved. This is demonstrated here by making a simple change to the project index.html file, specifically changing the text in the application title banner.

To change your application, complete the following steps:

  1. In the Project Explorer view, expand {project name} > src > main > webapp.

  2. Double-click index.html to open it for editing with the JBoss Tools HTML Editor.

  3. Locate the following line of code inside the <body> tags

    <h3>HTML5 Quickstart</h3>

    and replace it with

    <h3>My Quickstart</h3>
  4. Save the file by pressing Ctrl+S (or Cmd+S).

This code change modifies the heading displayed on the main application page. Notice that BrowserSim automatically reloads the web page when you save the changed file and the application modifications are immediately visible.

Did You Know?

  • You can also launch the HTML5 Project wizard from the JBoss perspective by clicking File ▸ New ▸ HTML5 Project.

  • You can test an undeployed .html file with BrowserSim by right-clicking the .html file in the Project Explorer view and clicking Open With ▸ BrowserSim.

  • To set BrowserSim as the IDE default web browser, in the JBoss perspective click Window ▸ Web Browser ▸ BrowserSim or click Window ▸ Preferences ▸ General ▸ Web Browser and from the External web browsers list select BrowserSim.

  • You can also enable LiveReload for already opened BrowserSim simulated devices. After starting the LiveReload server, right-click the BrowserSim simulated device frame and click Enable LiveReload.

back to top