Aeris iOS Weather SDK

The Aeris iOS Framework allows a developer to quickly and easily add weather content and functionality to their iOS applications quickly and easily without having to code anything themselves. It utilizes the Aeris API backend for data loading and is built on top of an object mapping system that efficiently loads requested weather content into third-party iOS applications, greatly reducing the amount of code and development needed on the developer end.


  • Minimum iOS Target: iOS 7
  • Dependencies: AFNetworking 2.0
  • ARC enabled

Migrating from 1.0 to 2.0

If you’re upgrading from a pre-2.0 version of the SDK, review the 2.0 Migration Guide for an overview of the architectural changes from 1.0.

Getting Started

Before you can begin using the Aeris iOS SDK in your project, you will need to download the latest version of the SDK and ensure that you have the required Aeris API keys for your application.

Step 1: Download the latest version of the Aeris iOS SDK by logging into your account.

Step 2: Obtain Aeris API access keys by registering your application with your account.

Step 3: Determine which components of the Aeris iOS SDK you will need for your project:

  • Aeris.framework
  • AerisUI.framework

    • requires: Aeris.framework
  • AerisMap.framework

    • requires: Aeris.framework, AerisUI.framework
  • AerisGoogleMap.framework

Step 4: Import AFNetworking 2.0 into your project either manually or using CocoaPods by following AFNetworking’s installation instructions. AFNetworking is a required dependency for the Aeris iOS SDK and must be version 2.0 or higher.

Step 5: Install the Aeris iOS SDK files into your project. The following step-by-step instructions are written for Xcode 5 using the iOS 7 SDK:

  1. Launch Xcode and either open an existing project or create a new project.
  2. Drag the Aeris iOS component framework bundles you need from the list in Step 3 to the Frameworks group of your project. When prompted, select Copy items into destination group’s folder.
  3. Select your project from the Project Navigator and choose your application’s target.
  4. Open the Build Phases tab, and within Link Binary with Libraries, add the following frameworks:
    • asdfafsd
  5. Choose your project (not a specific target) and open the Build Settings tab.
  6. In the Other Linker Flags section, add -ObjC. If these settings are not visible, change the filter in the Build Settings bar from Basic to All.
  7. Import your required Aeris iOS SDK framework bundles into the necessary portions of your project, or within your project’s global precompiled header (*.pch) file:

    #import <Aeris/Aeris.h>
    #import <AerisUI/AerisUI.h>
    #import <AerisMap/AerisMap.h>
  8. Initialize AerisEngine with your application’s API access keys in your AppDelegate:

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    	self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
    	[AerisEngine engineWithKey:@"__CLIENT_ID__" secret:@"__CLIENT_SECRET__"];
    	self.window.backgroundColor = [UIColor whiteColor];
    	[self.window makeKeyAndVisible];
    	return YES;
  9. That’s it, your project is ready to start using the Aeris iOS SDK!


To upgrade an existing project to the most recent version of the SDK:

  1. In the Project Navigator, replace the previous Aeris framework bundles with the most recent versions.
  2. Make any necessary changes as a result of the upgrade as described in the release notes.
  3. Clean and rebuild your project by selecting: Product > Clean and then Product > Build or Product > Run.


Occasionally it may be useful to have the Aeris iOS SDK output additional log messages in order to debug issues within your own application, such as API requests and errors as well as internal view and map events. By default, the Aeris iOS SDK only outputs error messages and warnings. So if you require more information during development and testing, just enable debug mode after initializing the AerisEngine with your access keys:

[AerisEngine engineWithKey:@"__CLIENT_ID__" secret:@"__CLIENT_SECRET__"];
[AerisEngine enableDebug];