lholmquist / aerogear-aerodoc-ios

aerogear-aerodoc-ios

What's in aerogear-aerodoc-ios?

AeroDoc is an tutorial application to demonstrate how to build an application using Unified Push server. To get the big picture:

You're a developper and you want to use AeroGear Unified Push Server to develop AeroDoc, a backend RESTful application with iOS client to create new leads and send them as push notifications to sale agents.

If you want to know more about AeroDoc description, see aerogear-aerodoc-backend

This repo focus on iOS client app. But before running the app, you'll need some setup.

Prerequisites

• This application is using Push notifications from APNS, it required setup of Provisioning Profile. Please follow the steps explained in aerogear tutorial

• Unified Push server should be deployed. Follow instructions from aerogear unified push server

• AeroDoc backend should be deployed. Follow instructions from AeroDoc backend

Setup

• Login (reset password if needed)

• Register your application to get:

• your pushApplicationID

• and a masterSecret

• Register your iOS variant. Start with development one. You will need your apple provisionning as explained in prerequisites. You should get:

• variantID

• and a secret

• Setup AeroDoc backend configuration AeroDoc backend needs to know:

  • where url is your Unified Push Server, it could be local or running on OpenShift.
  • what is your pushApplicationID
  • and masterSecret

• Setup AeroDoc iOS client

• make sure bundle id of app matches the one in provisioning device

• in config file, replace:

  #define URL_AERODOC @"http://localhost:8080/aerodoc/"
  #define URL_UNIFIED_PUSH @"http://localhost:8080/ag-push/"
  #define VARIANT_ID @"YOUR_VARIANT"
  #define VARIANT_SECRET @"YOUR_SECRET"
  #define ENDPOINT @"rest"

you're all set, enjoy!

Installation

pod install

Working with the app

Using AeroDoc, admin can create new leads, search for a nearby sale agent (SA), push the lead to a particular SA.

The SA logins to iOS AeroDoc aoo. Get a list of all open leads. Get a special message for the leads pushed to him. Puhsed leads appear with star icons. Once a lead is accepted, it is not available on open leads any more, but it is stored locally on SA device in MyLeads list.

Post-install

Because the application is storing local data on device, you may want to clear data from time to time.