Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jamesstout/ios-library_lite

iOS Urban Airship Library - LITE
https://github.com/jamesstout/ios-library_lite

Last synced: about 1 month ago
JSON representation

iOS Urban Airship Library - LITE

Host: GitHub
URL: https://github.com/jamesstout/ios-library_lite
Owner: jamesstout
License: other
Created: 2013-02-18T09:21:53.000Z (almost 12 years ago)
Default Branch: master
Last Pushed: 2013-03-31T16:52:44.000Z (almost 12 years ago)
Last Synced: 2023-03-27T11:01:04.491Z (almost 2 years ago)
Language: Objective-C
Size: 7.39 MB
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README-LITE.rst
- Changelog: CHANGELOG
- License: LICENSE

Awesome Lists containing this project

README

iOS Urban Airship Library - LITE
================================

This is a stripped down version of the UA library.

All it can do is register, deregister and update APNS registrations - tags/alias/quiet time etc.

All analytics, events, carrier, UI, database, local storage, push handling,
app state monitoring, location services and code required by them have been removed.
Storefront, Inbox, Subscription - all gone.

Build as below, but you DON'T need:

libsqlite3.dylib
CoreLocation.framework
CoreTelephony.framework
StoreKit.framework

USE AT YOUR OWN RISK!

Seems to work fine in my testsI've just submitted this in a live app,
so we'll see how it goes once that's approved.

Next, I wish UA didn't use ASI-HTTP-Request...

Overview
--------

Urban Airship's libUArship is a drop-in static library that provides a simple way to
integrate Urban Airship services into your iOS applications. This entire project will
allow you to build the library files and all sample projects. If you just want to
include the library in your app, you can simply download the latest ``libUAirship.zip``
and a sample project. These zips contain a pre-compiled universal armv6/armv7/armv7s/i386 library.

Working with the Library
------------------------

Copy libUAirship Files
######################

Download and unzip the latest version of libUAirship. If you are using one of our sample
projects, copy the ``Airship`` directory into the same directory as your project::

cp -r Airship /SomeDirectory/ (where /SomeDirectory/YourProject/ is your project)

If you are not using a sample project, you'll need to import the source files for the User
Interface into your project. These are located under /Airship/UI/Default

Required Libraries
##################

The core library requires your application to link against the following Frameworks (sample UIs
have additional linking requirements)::

libUAirship-.a
CFNetwork.framework
CoreGraphics.framework
Foundation.framework
MobileCoreServices.framework
Security.framework
SystemConfiguration.framework
UIKit.framework
libz.dylib
libsqlite3.dylib
CoreTelephony.framework (Exists in iOS 4+ only, so make it a weak link for 3.x compatibility)
StoreKit.framework
CoreLocation.framework

Build Settings
##############

**Compiler**

LLVM 4.0 is the default compiler for all projects and the static library.

**Header search path**

Ensure that your build target's header search path includes the Airship directory.

Quickstart
----------

Prerequisite
############

Before getting started you must perform the steps above outlined above.

In addition you'll need to include *UAirship.h* in your source files.

The AirshipConfig File
######################

The library uses a .plist configuration file named `AirshipConfig.plist` to manage your production and development
application profiles. Example copies of this file are available in all of the sample projects. Place this file
in your project and set the following values to the ones in your application at http://go.urbanairship.com

You can also edit the file as plain-text::

{
/* NOTE: DO NOT USE THE MASTER SECRET */
"APP_STORE_OR_AD_HOC_BUILD" = NO; /* set to YES for production builds */
"DEVELOPMENT_APP_KEY" = "Your development app key";
"DEVELOPMENT_APP_SECRET" = "Your development app secret";
"PRODUCTION_APP_KEY" = "Your production app key";
"PRODUCTION_APP_SECRET" = "Your production app secret";
}

If you are using development builds and testing using the Apple sandbox set `APP_STORE_OR_AD_HOC_BUILD` to false. For
App Store and Ad-Hoc builds, set it to YES.

Advanced users may add scripting or preprocessing logic to this .plist file to automate the switch from
development to production keys based on the build type.

Third party Package - License - Copyright / Creator
###################################################