Android Client

For general Android development help, see the official Android documentation. The Xamarin docs are also very good, although they don't seem to get updated quite as quickly.

The Android project is designed to be used as a way of presenting the information stored in the SpeechingCommon project to the user. As such, it contains little in the way of data infrastructure, instead being mainly made up of Activities, Fragments and Layouts. The exceptions to this are classes and functions which provide platform-specific implementations, such as audio recording and receiving intents from the Google Cloud Messaging service.

###Data initialisation

When the application is first launched, the current "session" must be initialised. This involves assigning and creating directories for storage, checking for a data connection and loading existing data from a file if possible or pulling new data from the server if not. This session data is relied upon by several parts of the application. The AndroidUtils.InitSession(context) function will take care of this, however it must be called from all activities where the app may enter. For example the SplashActivity calls it when the application is launched normally via the Launcher's app tray, but LocationActivity calls it when the app is launched via a geofence notification intent.