zofuthan / aerogear-ios-cookbook

AeroGear iOS Cookbook

Recipe app build with Xcode6.1.1

The AeroGear iOS cookbook is a list of recipes to quick start your iOS AeroGear experience.

Each recipe is a complete iOS app. The goal of the recipes is to show you how easily you can use iOS AeroGear libraries and how it helps to achieve clean code. The app features are very lean and most of UI is kept to basics in order to focus on AeroGear library usage.

	Project Info
License:	Apache License, Version 2.0
Build:	Cocoapods
Documentation:	https://aerogear.org/docs/guides/aerogear-ios-2.X/
Issue tracker:	https://issues.jboss.org/browse/AGIOS
Mailing lists:	aerogear-users (subscribe)
	aerogear-dev (subscribe)

Table of content

Recipe	Core	Push	Security
Authentication: login to backend using basic/digest auth	-	-	basic/digest
Weather: geo-loation based app to fetch information using http lib	http	-	-
Buddies: Simple demo for http usage and serialization	http	-	-
HelloWorld: Simple demo of Push registration and notification handles with framework as dependencies	-	push	-
PushQuickstarts: Complete demo of Push notification with server side using UnifiedPush server	-	Push	-
Shoot: oauth2 sharing photo, web-app to display photos	http, oauth2	-	-
SharedShoot: login using OpenId Connect to download Shoot'nShare photos	http, oauth2	-	-

Most of the recipes illustrate one main topic which is listed in bold in the table. Some examples demonstrate other aspects of the libraries so it is also listed in the different topics.

Some of the demos uses a backend.

Some of the demos listed below are hold in separate repo, but as they follow the same philosophy (illustrate AeroGear libraries usage) we put a placeholder in the recipe cookbook for completeness. HelloWorld, Push-Quickstarts have been added as git submodule, to fetch them:

$ git submodule init && git submodule update

Building and installing each app

The demos utilize cocoapods for handling their dependencies. On the root directory of each demo, simply execute the following:

bundle install
bundle exec pod install

and then double click on the generated .xcworkspace to open in Xcode.

Documentation

For more details about the current release, please consult our documentation.

Development

If you would like to help develop AeroGear you can join our developer's mailing list, join #aerogear on Freenode, or shout at us on Twitter @aerogears.

Also takes some time and skim the contributor guide

Questions?

Join our user mailing list for any questions or help! We really hope you enjoy app development with AeroGear!

Found a bug?

If you found a bug please create a ticket for us on Jira with some steps to reproduce it.