AerisWeather SDK for iOS - 2.0

The AerisWeather 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 Weather 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.


Requirements + Compatibility

  • Minimum iOS Deployment Target: iOS 7
  • Supports both Swift (any version) and Objective-C languages
  • Fully Compatible with Xcode 7.0 and iOS 9.0
  • ARC enabled
  • Dependencies: AFNetworking 3.0

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.

3.0.0 Beta Now Available! We've released the first public beta of 3.0.0 of our AerisWeather SDK for iOS for you to try out. Refer to the pre-release branch and release on Github for more details on getting started with the beta.


Before you can begin using the AerisWeather iOS SDK in your project, you will need to determine which components from the AerisWeather iOS SDK you will use and ensure that you have the required AerisWeather API keys for your application.

Step 1: Integrate the AerisWeather SDK libraries with your project using either CocoaPods or manual installation by following our setup guide on Github.

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

Step 3: Import the AerisWeather iOS SDK framework modules into the necessary portions of your project, or within your project’s global precompiled header (*.pch) file. If you're using our SDK in a Swift project, you'll need to setup a bridging header before you can access the SDK's modules from within your Swift code:


#import <Aeris/Aeris.h>


import Aeris

Step 4: 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;


func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
	AerisEngine.engineWithKey("__CLIENT_ID__", secret: "__CLIENT_SECRET__")
	window = UIWindow(frame: UIScreen.mainScreen().bounds)
	window?.backgroundColor = UIColor.whiteColor()
	return true


Occasionally it may be useful to have the AerisWeather 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 AerisWeather 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];


AerisEngine.engineWithKey("__CLIENT_ID__", secret: "__CLIENT_SECRET__")

Last modified: August 18, 2020