This repository contains the Telerik Friends app for Android. It is a sample mobile app demonstrating how to integrate a wide range of Telerik Platform services into a native Android mobile application.
The Telerik Friends sample app showcases these features and SDKs:
To implement all the features listed above, the sample app utilizes the following products, components, and SDKs:
|Login Screen||Activity Stream||Activity Details|
Before you begin, you need to ensure that you have the following:
An active Telerik Platform account Ensure that you can log in to a Telerik Platform account. This can be a free trial account. Depending on your license you may not be able to use all app features. For more information on what is included in the different editions, check out the pricing page. All features included in the sample app work during the free trial period.
Android Studio The sample project is created with Android Studio version 0.4.2 and gradle-1.9. If you want to use another version you may need to modify the
build.gradle file to reflect the gradle version you are using.
Android SDK You need API level 8 or later to build the Facebook library project from the Facebook SDK. The Friends sample app itself requires API level 11 or later. The default project is set up to build for API level 19 (Android 4.4.2) but if you want to change that, edit
app/build.gradle and set
targetVersion to match you setup.
The Friends sample app comes fully functional, but to see it in action you must link it to your own Telerik Platform account.
If you happen to break the structure of the automatically generated Friends data, you can delete the app and start over.
This is a unique string that links the sample mobile app to your Telerik Platform account where all the data is read from/saved. To set it in the app code:
telerik_app_idstring resource and set its value to the App ID of your Telerik Platform app.
This is a unique string that links the sample mobile app to the Analytics part of your Telerik Platform app. If you do not set this the sample will still work, but no analytics data will be collected.
analytics_app_idstring resource and set its value to the Project Key that you acquired earlier.
To demonstrate social login, we have preinitialized the sample to use a purpose-built Facebook app by Telerik. However, you still need to enable Facebook integration in the Telerik Platform portal:
Note that if you intend to use the code for a production app you need to set up your own Facebook application and adjust the Facebook app ID as follows:
facebook_app_idstring resource and set its value to your Facebook app ID.
The sample app allows users to register using their Google ID.
To try this integration, make the following configurations:
To demonstrate social login, we have preinitialized the sample to use a Microsoft Account Client ID owned by Telerik. However, you still need to enable Microsoft Account integration in the Telerik Platform portal:
Note that if you intend to use the code for a production app you need to set up your own Microsoft Account Client ID and adjust the code as follows:
live_id_client_idstring resource and set its value to your Microsoft Account app ID.
The sample app allows users to register using AD FS. To try this integration, configure the following:
Once the app is configured, click Run in Android Studio or Eclipse to run it either on a real device or in an emulator.
Ensure that the emulator or the device that you are using has Internet connectivity when running the sample.