Lightstreamer - Stock-List Demo with GCM Push Notifications - Android Client
This project contains a full example of an Android application that employs the Lightstreamer Android Client library to subscribe to real-time updates and GCM push notifications.
A simpler version, without GCM support is also available: Stock-List Demo - Android Client
(To install the app from the Google Play Store, you can also use the above QR code)
This is a Java-for-Android version of the Lightstreamer - Basic Stock-List Demo - HTML client.
This app uses the Android Client API for Lightstreamer to handle the communications with Lightstreamer Server. A simple user interface is implemented to display the real-time data received from Lightstreamer Server.
Touch a row opens a new panel with the detailed information, updated in real-time, of the stock.
Touch the chart to setup a new trigger for push notifications.
The demo is ready to receive Mobile Push Notification through Google Cloud Messaging for Android.
Dig the Code
StockListDemo.javais the entry point and only
Activityof the application. It contains two
Fragments, the status of the application, and acts as a proxy to the LightstreamerClient instance. The two
Fragmentare both visible if the application runs on tablet; on the contrary, only one
Fragmentis visible and are exchanged based on the user interaction
LightstreamerClient.javahandles the connection to the Lightstreamer server and the Subscription/Unsubscription requests issued by the various part of the application.
Fragmentcontaining a subscription that is started/stopped based on the lifecycle of the
Fragment. Please note that this class does not actually extend
DetailsFragment.javaare the classes representing the two fragments of the application.
GcmIntentService.javais the class dedicated to receive the Push Notifications, to create the notification for the system, and to attach to it an Intent capable of launching the Demo application focused on the notified item.
Chart.javawraps the AndroidPlot APIs to plot the real-time chart on the details fragment.
Check out the sources for further explanations.
NOTE: Not all the functionalities of the Lightstreamer Android Java client are exposed by the classes listed above. You can easily expand those functionalities using the Android Client API as a reference. If in trouble check out the specific Lightstreamer forum.
If you want to install a version of this demo pointing to your local Lightstreamer Server and running into an Android Virtual Device, follow these steps:
- Note that, as prerequisite, the Lightstreamer - Stock-List Demo - Java Adapter has to be deployed on your local Lightstreamer Server instance. Please check out that project and follow the installation instructions provided with it.
- Launch Lightstreamer Server.
- Download the
deploy.zipfile, which you can find in the deploy release of this project and extract the
- Locate or install the Android SDK
- Install the
Android_StockListDemo.apkin your emulator:
- Execute the emulator (Android SDK/SDK Manager->Tools->Manage AVDs...->New then Start)
- Open the console and move to the platform-tools folder of SDK directory.
- Then type the following command:
adb install [.apk path]
- Look up the demo in your virtual device and launch it.
Note that the demo targets the Lightstreamer server @ http://10.0.2.2:8080 because 10.0.2.2 is the special alias to your host loopback interface.
Setup the IDE
Note that you can skip this section and build the application without using any IDE.
To open the project in Android Studio, import the provided Gradle project and drop in
app/libs the library
ls-android-client.jar from the Lighstreamer SDK for Android Clients.
You may run the demo against your local server or using our online server at http://push.lightstreamer.com:80. The server to which the demo will connect to is configured in the
A full local deploy of this app requires
a Lightstreamer Server 6.0 or greater installation with appropriate Mobile Push Notifications (MPN) module configuration (a detailed step by step guide for setting up the server and configuring the client is available in the README of the project Lightstreamer - MPN Stock-List Demo Metadata - Java Adapter)
To build your own version of the demo you can launch the provided Gradle script from the command line or from the IDE itself. As an example you can build and install a debug version of the application in an emulator (or device) by running
You might also use a different build tool (e.g.: Maven, Ant, etc.) by converting the provided Gradle build files.
Lightstreamer Adapters Needed by This Demo Client
- Lightstreamer - Stock-List Demo - Java Adapter
- Lightstreamer - MPN Stock-List Demo Metadata - Java Adapter
Lightstreamer Compatibility Notes
- Compatible with Lightstreamer Android Client API v. 1.2. Not yet compatible with Lightstreamer Android Client API Unified version.
- For Lightstreamer Allegro (+ Android Client API support), Presto, Vivace.
- This example is based on Android 5 or later; for a version of this example based on Android 2.3 or later, please refer to this release.