iOS7 最佳实践:一个天气应用案例(上)

在这个两部分的系列教程中,您将探索如何使用以下工具和技术来创建自己的App:

本教程专为熟悉基本知识的、但还没有接触到太多高级主题的中级开发者而设计。本教程也是想要去探索Objective-C函数编程一个很好的开始。

开始

打开Xcode并执行File\New\Project。选择Application\Empty Application。将项目命名为SimpleWeather,单击下一步,选择一个目录去保存你的项目,然后点击Create。 现在,你的基础项目已经完成。下一步是集成你的第三方工具。但首先你要关闭Xcode,确保他不会影响下一步。

Cocoapods

你将要下载Cocoapods的代码,在Xcode项目中添加文件来使用,并配置项目需要的设置。

Mantle

Mantle是由于Github团队开发的,目的是去除Objective-C把JSON数据转为NSObject子类的所有样板代码。Mantle也能做数据转换,通过一种神奇的方式把JSON原始数据(strings, ints, floats)转换为复杂数据,比如NSDate, NSURL, 甚至是自定义类。

LBBlurredImage

LBBlurredImage是一个继承自UIImageView,轻而易举使图像模糊的项目。你将仅仅用一行代码来创建一个神奇的模糊效果。

TSMessages

TSMessages 是另一个非常简单的库,用来显示浮层警告和通知。当出现错误信息而不直接影响用户的时候,最好使用浮层来代替模态窗口(例如UIAlertView),这样你将尽可能减少对用户的影响。

你将只用TSMessages,在网络失去连接或API错误的时候。如果发生错误,你将看到类似这样的一个浮层:

TSefegfergrefgerMessage

ReactiveCocoa

最后,你将使用到ReactiveCocoa,他也来自于GitHub团队。ReactiveCocoa给Objective-C带来了函数编程,类似与.NET的Reactive Extensions。你将在第二部分花费大部分时间去实现ReactiveCocoa。

设置你的Cocoapods

设置你的Cocoapods,先要确保你已经安装了Cocoapods。为此,打开命令行程序,并输入。

你将会看到类似这样的输出:

这决定于你如何管理Ruby gems,例如你使用rbenvRVM,路径可能有所不同。

如果命令行简单的返回提示,或显示pod not found,表示Cocoapods未安装在你的机器上。可以查看我们的Cocoapods教程作为安装说明。这也是一个很好的资源,如果你想更多得了解Cocoapods的话。

Podfiles是用来告诉Cocoapods哪些开源项目需要导入。

要创建你的第一个Cocoapod,首先在命令行中用cd命令导航到你的XCode项目所在的文件夹,在命令行中启动编辑器,输入

这文件做了两件事情:

  • 告诉Cocoapods你的目标平台与版本,这里的你目标是iOS 7.0。
  • 列给Cocoapods一个项目所有需要引入和安装的三方库清单。

在命令行中输入pod install进行安装。

这可能需要花一到两分钟的时间去安装各种包。你的命令行应该输出如下所示:


Cocoapods会在你的项目目录中创建一堆新文件,但是,只有一个需要你关心,SimpleWeather.xcworkspace

用Xcode打开SimpleWeather.xcworkspace。看看你的项目设置,现在有一个Pods项目在你的项目工作区,以及在Pods文件夹放着每一个你引入的库,如下所示:

SimpleWeather-Cocoapods

SimprefregfleWeather-Project

确保你已经选择SimpleWeather项目,如图所示:

构建并运行您的App,以确保一切工作正常:

blfvvgregergank-app


创建你的主视图控制器

虽然这个App看起来复杂,但它还会通过一个单一的View Controller完成。现在,你将添加他。

选中SimpleWeather项目,单击File\New\File,并且选择Cocoa Touch\Objective-C class. 命名为WXController,并设置为UIViewController的子类。

确保Targeted for iPadWith XIB for user interface都没有选中,如下图所示:

create-rtgregecontroller

打开WXController.m然后用如下所示替换-viewDidLoad方法:

现在打开AppDelegate.m,并且引入如下两个class:

眼尖的读者会注意到WXController使用引号引入,TSMessage使用单括号引入。

回头看下当你创建Podfile的时候,你使用Cocoapods引入TSMessage。Cocoapods创建TSMessage项目,并把它加入到工作空间。既然你从工作区的其他项目导入,可以使用尖括号代替引号。

代替-application:didFinishLaunchingWithOptions的内容:

标号注释的解释:

  1. 初始化并设置WXController实例作为App的根视图控制器。通常这个控制器是一个的UINavigationControllerUITabBarController,但在当前情况下,你使用WXController的单个实例。
  2. 设置默认的视图控制器来显示你的TSMessages。这样做,你将不再需要手动指定要使用的控制器来显示警告。

构建并运行,看看你的新视图控制器起作用了。

wxcontfvdvroller-red

在红色背景下,状态栏有点不够清晰。幸运的是,有一个简单的方法,使状态栏更清晰易读。

在iOS7,UIViewController有一个新的API,用来控制状态栏的外观。打开WXController,直接添加下面的代码到-viewDidLoad:方法下:

 

再次构建并运行,你将看到状态栏如下的变化:

wxcontroller-red-status1

设置你的App视图

现在是时候让你的App接近生活。下载这个项目的图片,并解压缩到一个合适的位置。这个压缩包的背景图片出自Flickr用户idleformat之手,天气图片出自Dribbble用户heeyeun之手。

切换回Xcode,单击File\Add Files to “SimpleWeather”….定位到你刚刚解压缩的图片文件夹并选择它。选择Copy items into destination group’s folder (if needed),然后单击Add

打开WXController.h, 添加如下委托协议:

现在打开WXController.m。 小提示:你可以使用Control-Command-Up的快捷键来实现.h.m文件之间的快速切换。

添加如下代码到WXController.m顶部:

LBBlurredImage.h包含在Cocoapods引入的LBBlurredImage项目,你会使用这个库来模糊背景图片。

应该有一个空的私有接口样板在WXController imports的下方。它具有以下属性:

现在,是时候在项目中创建并设置视图。

下面是你App的分解图,记住,table view将是透明的:

scrervververveens

为了实现动态模糊效果,在你的App中,你会根据App的滚动来改变模糊图像的alpha值。

打开WXController.m,使用如下代码来,替换掉-viewDidLoad中设置背景色的代码:

这是非常简单的代码:

  1. 获取并存储屏幕高度。之后,你将在用分页的方式来显示所有天气​​数据时,使用它。
  2. 创建一个静态的背景图,并添加到视图上。
  3. 使用LBBlurredImage来创建一个模糊的背景图像,并设置alpha为0,使得开始backgroundImageView是可见的。
  4. 创建tableview来处理所有的数据呈现。 设置WXController为delegate和dataSource,以及滚动视图的delegate。请注意,设置pagingEnabledYES

添加如下UITableView的delegate和dataSource的代码到WXController.m@implementation块中:

  1. Pragma mark组织代码的很好的一种方式。
  2. 你的table view有两个部分,一个是每小时的天气预报,另一个用于每日播报。table view的section数目,设置为2。
  3. 天气预报的cell是不可选择的。给他们一个半透明的黑色背景和白色文字。

最后,添加如下代码到WXController.m:

WXController.m中,你的视图控制器调用该方法来编排其子视图。

构建并运行你的App,看看你的视图如何堆叠。

backgrferfreferound

仔细看,你会看到所有空的table cell的cell分隔线。

仍然在-viewDidLoad中,添加下面的代码来设置你的布局框架和边距:

这是相当常规设置代码,但这里是怎么回事:

  1. 设置table的header大小与屏幕相同。你将利用的UITableView的分页来分隔页面页头和每日每时的天气预报部分。
  2. 创建inset(或padding)变量,以便您的所有标签均匀分布并居中。
  3. 创建并初始化为各种视图创建的高度变量。设置这些值作为常量,使得可以很容易地在需要的时候,配置和更改您的视图设置。
  4. 使用常量和inset变量,为label和view创建框架。
  5. 复制图标框,调整它,使文本具有一定的扩展空间,并将其移动到该图标的右侧。当我们把标签添加到视图,你会看到布局的效果。

添加如下代码到-viewDidLoad

这是相当长的一块代码,但它真的只是在做设置各种控件的繁重工作。简单的说:

  1. 设置当前view为你的table header。
  2. 构建每一个显示气象数据的标签。
  3. 添加一个天气图标的图像视图。

构建并运行你的App,你应该可以看到你之前布局的所有所有view。下面的屏幕截图显示了使用手工布局的、所有标签框在视觉上的显示。

built-layfbberreou1t

用手指轻轻推动table,当你滚动它的时候,应该会反弹。

获取气象数据

你会注意到,App显示“Loading…”,但它不是真正地在工作。是时候获取一些真正的天气数据。

你会从OpenWeatherMap的API拉取数据。 OpenWeatherMap是一个非常棒的服务,旨在提供实时,准确,免费的天气数据给任何人。虽然有很多天气API,但他们大多要么使用较旧的数据格式,如XML,或是有偿服务 – 并且有时还相当昂贵。

你会遵循以下基本步骤,来获你设备的位置的气象数据:

  1. 找到设备的位置
  2. API端下载JSON数据
  3. 映射JSON到WXConditionsWXDailyForecasts
  4. 告诉UI有新数据了

开始创建你的天气模型和数据管理类。单击File\New\File…并选择Cocoa Touch\Objective-C class。命名为WXClient并使其为NSObject的子类。

这样再做三次创建以下类:

  • WXManager作为NSObject的子类
  • WXCondition作为MTLModel的子类
  • WXDailyForecast作为WXCondition的子类

全部完成?现在,你可以开始下一节,其中涉及映射和转换您的天气数据。

创建你的天气模型

你的模型将使用Mantle,这使得数据映射和转型非常简单。

打开WXCondition.h如下列代码,修改接口:

  1. MTLJSONSerializing协议告诉Mantle序列化该对象如何从JSON映射到Objective-C的属性。
  2. 这些都是你的天气数据的属性。你将会使用这些属性的get set方法,但是当你要扩展App,这是一种很好的方法来访问数据。
  3. 这是一个简单的辅助方法,从天气状况映射到图像文件。

构建并运行App。失败了……

原因是你没有从你的Cocoapods项目中引入Mantle。解决方法是,在WXCondition.h中,你需要把MTLModel.h替换为#import <Mantle.h>

现在构建并运行App。成功了。你会看到一些新的警告,但你可以忽略他们。

首先,你需要处理未实现的-imageName方法。

打开WXCondition.m,添加如下方法:

  1. 创建一个静态的NSDictionary,因为WXCondition的每个实例都将使用相同的数据映射。
  2. 天气状况与图像文件的关系(例如“01d”代表“weather-clear.png”)。
  3. 声明获取图像文件名的公有方法。

看一看从OpenWeatherMap返回的JSON响应数据:

 

你需要把嵌套的JSON值映射到Objective-C的属性。嵌套的JSON值是元素,如温度,即上面看到的main节点。

要做到这一点,你将利用的Objective-C的Key-Value Coding和Mantle的MTLJSONAdapter

还在WXCondition.m,通过添加+JSONKeyPathsByPropertyKey方法,“JSON到模型属性”的映射,且该方法是MTLJSONSerializing协议的require

在这个方法里,dictionary的key是WXCondition的属性名称,而dictionary的value是JSON的路径。

您可能已经注意到,这里有一个从JSON数据映射到Objective-C属性的问题。属性dateNSDate类型的,但JSON有一个Unix时间类型(sjpsega注:即从1970年1月1日0时0分0秒起至现在的总秒数)的NSInteger值。你需要完成两者之间的转换。

Mantle正好有一个功能来为你解决这个问题:MTLValueTransformer。这个类允许你声明一个block,详细说明值的相互转换。

Mantle的转换器语法有点怪。要创建一个为一个特定属性的转换器,,您可以添加一个以属性名开头和JSONTransformer结尾的类方法。 可能看实际代码比试图解释它更容易理解,所以在WXCondition.m中添加以下为NSDate属性设置的转换器。

  1. 使用blocks做属性的转换的工作,并返回一个MTLValueTransformer返回值。
  2. 您只需要详细说明Unix时间和NSDate之间进行转换一次,就可以重用-dateJSONTransformer方法为sunrise和sunset属性做转换。

下一个值转型有点讨厌,但它只是使用OpenWeatherMap的API,并自己的格式化JSON响应方式的结果。weather键对应的值是一个JSON数组,但你只关注单一的天气状况。

WXCondition.m中,使用dateJSONTransformer相同的结构,您可以创建一个NSArray和NSString的之间的转换。该解决方案提供如下:

最后的转换器只是为了格式化。 OpenWeatherAPI使用每秒/米的风速。由于您的App使用英制系统,你需要将其转换为每小时/英里。

WXCondition.m的实现中添加以下转换器的方法和宏定义。

在OpenWeatherMap的API中有一个小的差异,你必须处理。看一看在位于当前状况的响应每日预测反应之间的温度:

current的第一个key是main,最高温度存储在key temp_max中,而daily forecast的第一个key是temp,最高温度存储在key max中。

key Temperature的差异放在一边,其他都一样。所以,你真正需要做的是修改daily forecasts的键映射。

打开WXDailyForecast.m重写+JSONKeyPathsByPropertyKey方法:

  1. 获取WXCondition的映射,并创建它的可变副本。
  2. 你需要为daily forecast做的是改变max和min键映射。
  3. 返回新的映射。

构建并运行您的App,看起来和上次运行没什么改变,但好的一点是,App编译和运行没有任何错误。

built-gergergerglayout

何去何从?

你可以从这里下载完整程序。

在这部分教程中,您使用Cocoapods设置项目,增加视图到控制器,编排视图,并建立模型来反映你抓取的气象数据。该App还没有充分发挥作用,但是你成功用纯代码创建视图,并学习了如何使用Mantle映射和转换JSON数据。

接下来看看教程的第二部分,你将充实你的App,从weather API获取数据,并在UI上显示。您将使用新的iOS7 NSURLSession去下载数据,以及使用ReactiveCocoa把位置查找,天气数据抓取和UI更新事件绑在一起。

收藏 1 评论

相关文章

可能感兴趣的话题



直接登录
最新评论
  • Badteddy iOS 2016/01/07

    你好,此程序在iOS7中是无法运行的, wantsfullscreenlayout已经不支持了。
    在TSMessage.m中,第213行,这个问题该怎么处理?

跳到底部
返回顶部