Aeris iOS Weather SDK 2.0
Aeris iOS Weather Framework 允许开发者快速轻松地将天气内容和功能添加到他们的 iOS 应用程序中,而无需编写任何代码。它利用 Aeris API 后端进行数据加载,并构建在有效的对象映射系统之上,将请求的天气内容高效地加载到第三方 iOS 应用程序中,大大减少了开发者端所需的代码和开发量。
组件
AerisWeather SDK 被分割成多个框架,允许您只包含所需的组件。但是,某些组件取决于其他一个或多个组件,因为它们建筑在这之上。
- Aeris.framework - 与解析 Aeris Weather API 数据交互的基库。
- AerisUI.framework - UI 工具和组件(图表、视图)和内置天气视图
- 需要 Aeris.framework
- AerisMap.framework - 使用 Aeris Overlays 服务提供的完整功能交互式天气地图。
- 需要 Aeris.framework、AerisUI.framework
- AerisMapboxMap.framework - AerisMap 库的扩展,支持使用 Mapbox 基图
- 需要 Aeris.framework、AerisUI.framework、AerisMap.framework
- 需要 MBXMapKit
- AerisGoogleMap.framework - AerisMap 库的扩展,支持使用 Google Maps SDK
- 需要 Aeris.framework、AerisUI.framework、AerisMap.framework
- 需要 GoogleMaps
设置
CocoaPods
使用-
将
AerisWeather
pod 添加到您的 Podfile 中。这将把基础 Aeris.framework 作为依赖项添加到您的项目中。pod 'AerisWeather'
-
如果您想安装其他 AerisWeather 组件,也要将它们作为依赖项添加到 Podfile 中。
pod 'AerisWeather/AerisUI' pod 'AerisWeather/AerisMap' pod 'AerisWeather/AerisMapboxMap' pod 'AerisWeather/AerisGoogleMap'
-
在终端运行
pod install
,然后打开您项目的.xcworkspace
文件以启动 Xcode。 -
导入您想使用的 AerisWeather 组件所需的必要伞头文件(例如 Aeris、AerisUI、AerisMap 等)
- 在您的 Podfile 中包含
use_frameworks!
- Swift:
import Aeris
- Objective-C:
#import
,或者启用模块化:@import Aeris;
- Swift:
- 在您的 Podfile 中不包含
use_frameworks!
- Swift: 将
#import "
添加到您的桥接头。" - Objective-C:
#import "
"
- Swift: 将
- 在您的 Podfile 中包含
修复 Xcode 的 “框架模块中包含非模块头文件” 错误
如果您正在使用 Xcode 7.1 或更高版本,并使用 CocoaPods 将 AerisWeather 库作为依赖项包含,则在编译时可能会收到有关“框架模块中包含非模块头文件”的错误。要解决此问题,您必须
- 将项目目标
CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES
标志设置为YES
。此配置设置还可以在 Xcode 中找到,位于目标下的 构建设置 > 在框架模块中允许非模块化包含。 - 如果您的项目是 Swift 类型并且完成 #1 后仍然出现此错误,您需要从目标下的 头文件搜索路径 配置中删除指向 AerisWeather 框架的任何路径。CocoaPods 配置通常会包括对每个 Pod 依赖项的路径,即使该路径已包含在目标下的 框架搜索路径 中。
有关此问题的更多信息,请参阅 Apple 开发者论坛:https://forums.developer.apple.com/message/78028
如果相同的头文件既可以通过头文件搜索路径(
-I
,-isystem
)又可以通过框架搜索路径(-F
,-iframework
)访问,即使涉及到符号链接,编译器也会出现问题。在这些情况下,应优先使用框架搜索路径。(注意,这种无效的配置可能由外部系统生成,例如CocoaPods。)
从Github手动进行
-
检出或下载Aeris-iOS-Libary 仓库。
-
将必要的Aeris框架组件添加到您从下载的文件中创建的Xcode目标中。这些组件位于
AerisWeatherSDK
目录下。 -
根据其特定的设置和安装说明,将
库(版本3.0或更高)添加到您的项目中。 -
在您的项目中需要的位置导入每个Aeris组件所需的框架头文件(例如
Aeris
、AerisUI
、AerisMap
等)。#import <Aeris/Aeris.h> #import <AerisUI/AerisUI.h> #import <AerisMap/AerisMap.h> ...
示例
查看包含内置天气视图和不同映射库的天气地图等不同组件示例视图的包含示例项目,位于AerisSDKDemo
目录下。由于示例项目中的依赖项(特别是AFNetworking)是用CocoaPods安装和管理的,您需要打开AerisSDKDemo/AerisSDKDemo.xcworkspace
。
Aeris iOS天气SDK的各种组件位于AerisSDK
目录下。这些是您将在自己的自定义项目中使用的库。
有关安装和开始使用Aeris iOS天气SDK的完整详细信息和使用说明,请参阅我们的完整使用和API文档。
需要支持?
您可以提交新的工单,提出您的问题、错误报告或功能建议。您也可以在Twitter上联系我们,Twitter账号为@AerisDeveloper。