Urban Airship's libUAirship is a drop-in static library that provides a simple way to
integrate Urban Airship services into your iOS applications. If you just want to
include the library in your app, you can download libUAirship-latest.zip
from
https://urbanairship.com/resources/developer-resources. This zip contains a pre-compiled
universal library for armv7/armv7s/arm64/i386/x86_64 (libUAirship-x.y.z.a
).
- Urban Airship iOS Library Reference: https://docs.urbanairship.com/reference/libraries/ios/latest/
- Getting started guide: https://docs.urbanairship.com/build/ios.html
- Library Upgrade Guides: https://docs.urbanairship.com/topic_guides/ios_migration.html
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
The core library requires your application to link against the following Frameworks (sample UIs have additional linking requirements):
libUAirship-<current_version>.a CFNetwork.framework CoreGraphics.framework Foundation.framework MobileCoreServices.framework Security.framework SystemConfiguration.framework UIKit.framework libz.dylib libsqlite3.dylib CoreTelephony.framework CoreLocation.framework
Compiler Xcode 6 is required for all projects and the static library. Projects must target >= iOS6.
Header search path Ensure that your build target's header search path includes the Airship directory.
Before getting started you must perform the steps outlined above.
In addition you'll need to include UAirship.h and UAPush.h in your source files.
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 https://go.urbanairship.com. To view all the possible keys and values, visit https://docs.urbanairship.com/ios-lib/Classes/UAConfig.html
You can also edit the file as plain-text:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>inProduction</key>
<false/>
<key>developmentAppKey</key>
<string>Your Development App Key</string>
<key>developmentAppSecret</key>
<string>Your Development App Secret</string>
<key>productionAppKey</key>
<string>Your Production App Key</string>
<key>productionAppSecret</key>
<string>Your Production App Secret</string>
</dict>
</plist>
If you are using development builds and testing using the Apple sandbox set inProduction to false. For App Store and Ad-Hoc builds, set it to true. You may also allow the library to auto-detect the production mode by setting detectProvisioningMode to true.
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.
To enable push notifications, you will need to make several additions to your application delegate.
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Your other application code.....
// Set log level for debugging config loading (optional)
// It will be set to the value in the loaded config upon takeOff
[UAirship setLogLevel:UALogLevelTrace];
// Populate AirshipConfig.plist with your app's info from https://go.urbanairship.com
// or set runtime properties here.
UAConfig *config = [UAConfig defaultConfig];
// You can then programmatically override the plist values:
// config.developmentAppKey = @"YourKey";
// etc.
// Call takeOff (which creates the UAirship singleton)
[UAirship takeOff:config];
// Print out the application configuration for debugging (optional)
UA_LDEBUG(@"Config:\n%@", [config description]);
// Set the icon badge to zero on startup (optional)
[[UAPush shared] resetBadge];
// Set the notification types required for the app (optional). This value defaults
// to badge, alert and sound, so it's only necessary to set it if you want
// to add or remove types.
[UAPush shared].userNotificationTypes = (UIUserNotificationTypeAlert |
UIUserNotificationTypeBadge |
UIUserNotificationTypeSound);
// User notifications will not be enabled until userPushNotificationsEnabled is
// set YES on UAPush. Once enabled, the setting will be persisted and the user
// will be prompted to allow notifications. You should wait for a more appropriate
// time to enable push to increase the likelihood that the user will accept
// notifications.
// [UAPush shared].userPushNotificationsEnabled = YES;
return YES;
}
To enable push later on in your application:
// Somewhere in the app, this will enable push (setting it to NO will disable push,
// which will trigger the proper registration or de-registration code in the library).
[UAPush shared].userPushNotificationsEnabled = YES;
Logging can be configured through either the AirshipConfig.plist file or directly in code. The default log level for production apps is UALogLevelError and the default for development apps is UALogLevelDebug.
In AirshipConfig.plist, set LOG_LEVEL to one of the following integer values:
None = 0
Error = 1
Warn = 2
Info = 3
Debug = 4
Trace = 5
To set the log level in code, call setLogLevel after takeOff:
[UAirship setLogLevel:UALogLevelWarn];
The available log levels are:
UALogLevelNone
UALogLevelError
UALogLevelWarn
UALogLevelInfo
UALogLevelDebug
UALogLevelTrace
Source can be found at https://github.com/urbanairship/ios-library
The unit tests in this project require OCMock. OCMock can be installed automatically with the use of our install script, scripts/mock_setup.sh.
To build full and push-only static libraries from the command line, run the distribution script:
./Deploy/distribute.sh
This will produce static libraries (.a files) in /Airship and create the samples and Airship library distribution zip file in Deploy/output
We accept pull requests! If you would like to submit a pull request, please fill out and submit a Code Contribution Agreement (https://urbanairship.com/legal/contribution-agreement/).
Third party Package | License | Copyright / Creator |
---|---|---|
Base64 | BSD | Copyright 2009-2010 Matt Gallagher. |
Reachability | BSD | Copyright (C) 2010 Apple Inc. |
Third party Package | License | Copyright / Creator |
---|---|---|
JRSwizzle | MIT | Copyright 2012 Jonathan Rentzsch |