Preparing Xamarin Projects for Liferay Screens

To use Liferay Screens with Xamarin, you must install Screens in your Xamarin project. You must then configure your project to communicate with your Liferay Portal instance. Note that Liferay Screens for Xamarin is released as a NuGet package hosted in

Requirements and Example Projects

Liferay Screens for Xamarin includes the bindings necessary to use all Screenlets included with Screens. The following software is required:

Also note that if you get confused or stuck while using Screens for Xamarin, the official Liferay Screens repository contains two sample Xamarin projects that you can reference:

  • Showcase-Android: An example app for Xamarin.Android containing all the currently available Screenlets.

  • Showcase-iOS: An example app for Xamarin.iOS containing all the currently available Screenlets.

Securing JSON Web Services

Each Screenlet in Liferay Screens calls one or more of Liferay Portal’s JSON web services, which are enabled by default. The Screenlet reference documentation for Android and iOS lists the web services that each Screenlet calls. To use a Screenlet, its web services must be enabled in the portal. It’s possible, however, to disable the web services needed by Screenlets you’re not using. For instructions on this, see the tutorial Portal Configuration of JSON Web Services.

Install Liferay Screens in Xamarin Solutions

Follow these steps to install Liferay Screens in your Xamarin project:

  1. Open your project in Visual Studio.

  2. Right click your project’s Packages folder and then select Add packages….

  3. Look for LiferayScreens and install the latest version.

  4. Accept the license agreements for any dependencies. These are necessary to use Liferay Screens in Xamarin.

  5. Check your configuration one of these ways:

    • Rebuild and execute your project, and import a Liferay Screens path (e.g., Com.Liferay.Mobile.Screens.Auth.Login).
    • In your project, select ReferencesFrom Packages and look for the LiferayScreens* file. Open that file in the Assembly Browser. You should then see all the available Liferay Screens files.

Next, you’ll set up communication with Liferay Portal.

Configuring Communication with Liferay Portal

Before using Liferay Screens, you must configure your project to communicate with your Liferay Portal instance. To do this, you must provide your project with the following information:

  • Your portal instance’s ID.
  • The ID of the portal site your app needs to communicate with.
  • Your portal instance’s version.
  • Any other information required by specific Screenlets.

Fortunately, this is straightforward. Do the following in your Xamarin projects:

  • For Xamarin.Android, create a new file called server_context.xml in the Resources/values folder. Add the following code to this file:

    <?xml version="1.0" encoding="utf-8"?>
        <!-- Change these values for your portal installation -->
        <string name="liferay_server"></string>
        <integer name="liferay_company_id">20116</integer>
        <integer name="liferay_group_id">20143</integer>
        <integer name="liferay_portal_version">70</integer>
  • For Xamarin.iOS, create a new file called liferay-server-context.plist in the Resources folder. Add the following code to this file:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
    <plist version="1.0">

Make sure to change these values to match those of your portal instance. The server address is suitable for testing with Android Studio’s emulator, because it corresponds to localhost:8080 through the emulator. If you’re using the Genymotion emulator, you should, however, use instead of localhost.

The liferay_company_id and companyId values are your portal instance’s ID. You can find this in your portal instance at Control PanelConfigurationVirtual Instances. The instance’s ID is in the Instance ID column.

The liferay_group_id and groupId values are the ID of the site your app needs to communicate with. To find this value, first go to the site in your portal instance that you want your app to communicate with. In the Site Administration menu, select ConfigurationSite Settings. The site ID is listed at the top of the General tab.

The liferay_portal_version and version value 70 tells Screens that it’s communicating with a Liferay Portal CE 7.0 or Liferay DXP 7.0 instance. Supported values are 62 for Liferay Portal 6.2, and 70 for Liferay Portal CE 7.0 or Liferay DXP 7.0. Note that if you omit liferay_portal_version or version from these files, they default to 62.

You can also configure Screenlet properties in server_context.xml and liferay-server-context.plist. The example server_context.xml properties listed below, liferay_recordset_id and liferay_recordset_fields, enable DDL Form Screenlet and DDL List Screenlet to interact with a portal instance’s DDLs:

<!-- Change these values for your portal installation -->

<integer name="liferay_recordset_id">20935</integer>
<string name="liferay_recordset_fields">Title</string>

For additional examples of these files, see the Showcase-Android and Showcase-iOS sample projects.

Super! Your Xamarin projects are ready for Liferay Screens.

Using Screenlets in Xamarin Apps

Using Views in Xamarin.Android

Using Themes in Xamarin.iOS

Creating Xamarin Views and Themes

Liferay Screens for Xamarin Troubleshooting and FAQs

« Introduction to Using Xamarin with Liferay ScreensUsing Screenlets in Xamarin Apps »
Was this article helpful?
0 out of 0 found this helpful