基于Android实现的天气预测APP

我就是我 2024-04-07 14:25 51阅读 0赞

## 基于Android开发的天气预测APP ##

## 一、相关技术 ##

### 1.1 网络 ###

网络数据源使用 Retrofit 库访问彩云 API 提供的 Webservice 接口来实现。

Retrofit 通过封装络请求和数据解析，极地提升了开发效率。并且持定义数据解析在封装所有网络请求的 API 时，我使用了协程技术来简化 Retrofit 回调的写法。

#### 1.1.1 数据存储 ####

本地数据源使用 SharedPreferences 持久化技术来实现，使用键值对的方式来存储数据。相较于数据库保存数据，SharedPreferences 操作更加简单，本地需要保存的数据也比较简单。因此 SharedPreferences 更加合适。

### 1.2 UI ###

创建 ViewModel 实现 ui 层与 service 层的解耦合

使用滚动控件 RecyclerView，使天气展示界面可以轻松高效地展示大量数据。我提供数据并定义每个列表项的外观，而 RecyclerView 库会根据需要动态创建元素

使用 Fragment，使我的一个单独的 activity 可以合成一个多区域的 UI，并且可以在多个 activity 中再使用。

### 1.3 全局获取 Context 对象 ###

由于本项目需要在 Activity 以外的很多地方使用 Context 对象。因此我使用Application 类，在应用程序启动的时候，系统就会自动将其进行初始化，以便于我们管理程序内如全局 Context 一样的一些全局的状态信息。

![在这里插入图片描述][585b864307c54ad09dd087359493dc71.png]

这样就可以以静态变量的形式获取 Context 对象了。

同时项目中还需要在在 AndroidManifest.xml 文件的标签下进行指定自定义的 Application 类。

![在这里插入图片描述][ab4f2afb47d7430cb630e74b28925417.png]

## 二、系统功能需求 ##

### 2.1 需求分析 ###

本项目实现了一个简单的天气信息查询的 APP。作为查询信息类的 APP 为了可以是用户能够及时准确的获取一个城市的天气信息。APP 至少应该具备准确查询城市级天气信息、可以查询多城市天气、可以刷新实时天气这三项基本功能。

由于获取城市天气信息的功能过于复杂，且与本课程学习重点无关。因此，我使用了彩云天气的开放 API 获取城市的天气。该 API 可以获取全球 100 多个国家的城市数据，以及每个城市的实时天气预报信息。经过简单的申请注册即可获取令牌使用。

### 2.2 功能描述 ###

因此本项目具有：

*  可以搜索全球大多数国家的各个城市数据；
 *  可以查看全球绝大多数城市的天气信息；
 *  可以自由地切换城市，查看其他城市的天气；
 *  可以手动刷新实时的天气。
 *  这四大主要功能，足以满足用户日常查询天气的需求。

## 三、系统设计与实现 ##

### 3.1 总体设计 ###

在本项目中，我使用了 MVVM 架构模式。MVVM 架构将程序结构主要分为 Model、View、ViewModel 三个模块。其中 Model 是数据模型部分；View 是界面展示部分；而 ViewModel 实现了业务逻辑和界面展示的解耦合。

![在这里插入图片描述][8a163a48a01542899c5738e1f53774dd.png]

*  MVVM项目架构示意图
 *  UI 控制层包含了平时写的 Activity、Fragment、布局文件等与界面相关的展示代码。
 *  ViewModel 层用于对 UI 元素相关的数据进行持久化，同时 ViewModel 层还提供了接口给 UI 控制层调用以及和 model 层进行通信。
 *  Model 层用于判断调用方请求的数据应该是从本地数据源中获取还是从网络数据源中获取，并将获取到的数据返回给调用方。实现了 APP 所必须的逻辑处理功能。

### 3.2 系统组成 ###

按照 MVVM 架构的设计，我在项目中将设计业务逻辑处理（model 层）的代码放在 service 包，并且将界面展示部分（view 层）代码放在 ui 包中。

### 3.3 模块设计 ###

#### 3.3.1 service 模块 ####

在 logic 包下新建一个 Repository 单例类，作为仓库层的统一封装入口。使用liveData()将异步获取的数据以响应式编程的方式通知给上一层。同时我将liveData()函数的线程参数类型指定成了 Dispatchers.IO 使这段网络请求代码运行在子线程。

![在这里插入图片描述][2b2745193857455e8e6b9a0b99ea072f.png]

在 logic/model 包下新建一个 Sky.kt 文件，定义了一个 Sky 类作为数据模型表示该天气情况所对应的文字、图标和背景。然后使用 mapOf()函数来定义每种天气代码所应该对应的文字、图标和背景。

![在这里插入图片描述][4ef4f3cc20a942a2a15cd9c327acdeae.png]

在 logic/model 通过 PlaceResponse.kt 文件定义数据模型实现对城市位置信息的映射。

在 logic/model 包下新建一个 RealtimeResponse.kt 文件定义数据模型实现对当前天气信息的映射。

在 logic/model 包下新建一个 DailyResponse.kt 文件定义数据模型实现对预测天气信息的映射。

在 logic/model 包下定义一个 Weather 类，将 Realtime 和 Daily 对象封装起来。

![在这里插入图片描述][86b467f5f3b6413f8eee66debd77443a.png]

在 logic/network 包下新建一个 ServiceCreator 单例类，创建了一个 Retrofit 构建器。

在 logic/network 包下新建 PlaceService 接口，定义一个用于访问彩云天气城市搜索 API 的 Retrofit 接口。

![在这里插入图片描述][6f5d92e776b047a8ba4d34829e698d13.png]

该函数的返回值为 Call，这样 Retrofit 就会将服务器返回的 JSON 数据自动解析成 PlaceResponse 对象了。

在 logic/network 包下新建 WeatherService 接口定义一个用于访问天气信息 API 的 Retrofit 接口。

在 logic/network 包下新建一个 SunnyWeatherNetwork 单例类，定义一个统一的网络数据源访问入口，对所有网络请求的 API 进行封装。

![在这里插入图片描述][0b24b76d6d08406ab39df2f029a29c51.png]

并自定义的 await()函数调用 suspendCoroutine 函数简化回调过程。

![在这里插入图片描述][69d18bcc93d74b2cbf7710f0bebb61f7.png]

在此当外部调用 SunnyWeatherNetwork 所提供的函数时，Retrofit 就会立即发起网络请求，同时当前的协程也会被阻塞住。直到服务器响应我们的请求之后，await()函数会将解析出来的数据模型对象取出并返回，同时恢复当前协程的执行，searchPlaces()函数在得到 await() 函数的返回值后会将该数据再返回到上一层。

在 logic/dao 包下新建一个 PlaceDao 单例类封装了几个必要的存储和读取数据的接口，将Place 对象存储到 SharedPreferences 文件中，并编写一些涉及 SharedPreferences 的操作。

\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-rBl0cYvN-1662615514250)(https://www.writebug.com/myres/static/uploads/2022/9/8/339af5cac748f041bf0888002e73bfd3.writebug)\]

#### 3.3.2 ui 模块 ####

实现搜索城市界面：

*  在 ui/place 包下新建一个 PlaceViewModel，定义搜索城市界面的 ViewModel 层。
 *  在 ui/place 包下新建一个 PlaceAdapter 类为 RecyclerView 准备适配器。
 *  在 ui/place 包下新建一个 PlaceFragment 对 Fragment 进行实现。

实现天气展示界面：

*  在 ui/weather 包下新建一个 WeatherViewModel，定义天气展示的 ViewModel 层。
 *  在 ui/weather 包下新建一个 WeatherActivity，显示天气信息的 Activity

[585b864307c54ad09dd087359493dc71.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/3bc7527307924b5e917e8081c380b040.png
[ab4f2afb47d7430cb630e74b28925417.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/a37835cd7fa74341b9b1c465af7ecec0.png
[8a163a48a01542899c5738e1f53774dd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/ae1febf07e69424faee2753ddbbddeaf.png
[2b2745193857455e8e6b9a0b99ea072f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/37b2449c92a242d7bdbd6eb7f0018fbc.png
[4ef4f3cc20a942a2a15cd9c327acdeae.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/1fa92685aa7745f38066bdae9f1c9468.png
[86b467f5f3b6413f8eee66debd77443a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/17696b5dd57e4b63b791da1a2a34e0af.png
[6f5d92e776b047a8ba4d34829e698d13.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/d3ee8d68add4413fb39adbf3afd8da02.png
[0b24b76d6d08406ab39df2f029a29c51.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/7dd88ebf37674e7e8877ca8622bb937e.png
[69d18bcc93d74b2cbf7710f0bebb61f7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/fa9288a725164cb68a737323e49395de.png