Rendering Web Pages in Your Android App

The Rendering Web Content tutorial shows you how to display web content from a Liferay Portal site in your Android app. Displaying content is great, but what if you want to display an entire page? No problem! Web Screenlet lets you display any web page. You can even customize the page by injecting local or remote JavaScript and CSS files. When combined with Liferay Portal’s server-side customization features (e.g., Application Display Templates), Web Screenlet gives you almost limitless possibilities for displaying web pages in your Android apps.

In this tutorial, you’ll learn how to use Web Screenlet to display web pages in your Android app.

Inserting Web Screenlet in Your App

Inserting Web Screenlet in your app is the same as inserting any Screenlet in your app:

  1. Insert the Screenlet’s XML in the layout of the activity or fragment you want to use the Screenlet in. Also be sure to set any attributes that you need. For a list of Web Screenlet’s available attributes, see the Attributes section of the Web Screenlet reference doc.

    For example, here’s Web Screenlet’s XML with the Screenlet’s layoutId and autoLoad attributes set to web_default and false, respectively:


    Note that web_default specifies the Screenlet’s Default View, which is part of the Default View Set.

  2. To use a View that is part of a View Set, like the Default View, the app or activity theme must inherit the theme that sets the View Set’s styles. For the Default View Set, this is default_theme. For example, to set the app’s theme to inherit default_theme, open res/values/styles.xml and set the base app theme’s parent to default_theme. In this example, the base app theme is AppTheme:

    <style name="AppTheme" parent="default_theme">

Next, you’ll implement Web Screenlet’s listener.

Implementing Web Screenlet’s Listener

To use any Screenlet in an activity or fragment, you must also implement the Screenlet’s listener in that activity or fragment’s class. Web Screenlet’s listener is WebListener. Follow these steps to implement WebListener:

  1. Change the class declaration to implement WebListener, and import

    public class YourActivity extends AppCompatActivity implements WebListener {...
  2. Implement WebListener’s onPageLoaded method. This method is called when the Screenlet loads the page successfully. How you implement it depends on what (if anything) you want to happen upon page load. For example, this onPageLoaded implementation displays a toast message indicating success:

    public void onPageLoaded(String url) {
        Toast.makeText(this, "Page load successful!", Toast.LENGTH_SHORT).show();
  3. Implement WebListener’s onScriptMessageHandler method. This method is called when the Screenlet’s WebView sends a message. The namespace argument is the source namespace key, and the body argument is the source namespace body. For example, this onScriptMessageHandler implementation parses data from the source namespace body if it matches a specific namespace, and then starts a new activity with that data via an intent:

    public void onScriptMessageHandler(String namespace, String body) {
        if ("gallery".equals(namespace)) {
            String[] allImgSrc = body.split(",");
            int imgSrcPosition = Integer.parseInt(allImgSrc[allImgSrc.length - 1]);
            Intent intent = new Intent(getApplicationContext(), DetailMediaGalleryActivity.class);
            intent.putExtra("allImgSrc", allImgSrc);
            intent.putExtra("imgSrcPosition", imgSrcPosition);
  4. Implement the error method. This method is called when an error occurs in the process. The e argument contains the exception, and the userAction argument distinguishes the specific action in which the error occurred. In most cases, you’ll use these arguments to log or display the error. For example, this error implementation displays a toast message with the exception’s message:

    public void error(Exception e, String userAction) {
        Toast.makeText(this, "Bad things happened: " + e.getMessage(), Toast.LENGTH_LONG).show();
  5. Get a WebScreenlet reference and set the activity or fragment class as its listener. To do so, import and add the following code to the end of the onCreate method:

    WebScreenlet screenlet = (WebScreenlet) findViewById(;

    Note that the findViewById references the android:id value set in the Screenlet’s XML.

Next, you’ll use the same WebScreenlet reference to set the Screenlet’s parameters.

Setting Web Screenlet’s Parameters

Web Screenlet has WebScreenletConfiguration and WebScreenletConfiguration.Builder objects that supply the parameters the Screenlet needs to work. These parameters include the URL of the page to load and the location of any JavaScript or CSS files that customize the page. You’ll set most of these parameters via WebScreenletConfiguration.Builder’s methods.

To set Web Screenlet’s parameters, follow these steps in the method that initializes the activity or fragment containing the Screenlet (e.g., onCreate in activities, onCreateView in fragments). You can, however, do this in other methods as needed.

  1. Use WebScreenletConfiguration.Builder(<url>), where <url> is the web page’s URL string, to create a WebScreenletConfiguration.Builder object. If the page requires Liferay Portal authentication, then the user must be logged in via Login Screenlet or a SessionContext method, and you must provide a relative URL to the WebScreenletConfiguration.Builder constructor. For example, if such a page’s full URL is http://your.liferay.instance/web/guest/blog, then the constructor’s argument is /web/guest/blog. For any other page that doesn’t require portal authentication, you must supply the full URL to the constructor.

  2. Call the WebScreenletConfiguration.Builder methods to set the parameters that you need.

  3. Call the WebScreenletConfiguration.Builder instance’s load() method, which returns a WebScreenletConfiguration object.

  4. Use Web Screenlet’s setWebScreenletConfiguration method to set the WebScreenletConfiguration object to the Web Screenlet instance.

  5. Call the Web Screenlet instance’s load() method.

Here’s an example snippet of these steps in the onCreate() method of an activity in which the Web Screenlet instance is screenlet, and the WebScreenletConfiguration object is webScreenletConfiguration:

WebScreenletConfiguration webScreenletConfiguration =
            new WebScreenletConfiguration.Builder("/web/westeros-hybrid/companynews")
                .addRawCss(R.raw.portletcss, "portlet.css")


The relative URL /web/westeros-hybrid/companynews supplied to the WebScreenletConfiguration.Builder constructor, and the lack of a setWebType(WebScreenletConfiguration.WebType.OTHER) call, indicates that this Web Screenlet instance loads a Liferay Portal page that requires authentication. The addRawCss method adds the CSS file portlet.css from the res/raw folder. The addLocalCss and addLocalJs methods add the local files gallery.css and gallery.js, respectively.

Great! Now you know how to use Web Screenlet in your Android apps.

Web Screenlet for Android

Using Web Screenlet with Cordova in Your Android App

Using Screenlets in Android Apps

Rendering Web Content in Your Android App

« Rendering Web Content in Your Android AppUsing Web Screenlet with Cordova in Your Android App »