Flutter Dio源码分析(四)--封装

Flutter Dio源码分析(一)--Dio介绍

创新互联专业提供成都主机托管四川主机托管成都服务器托管四川服务器托管，支持按月付款！我们的承诺：贵族品质、平民价格，机房位于中国电信/网通/移动机房，成都服务器托管服务有保障！

Flutter Dio源码分析(二)--HttpClient、Http、Dio对比

Flutter Dio源码分析(三)--深度剖析

Flutter Dio源码分析(四)--封装

Flutter Dio源码分析(一)--Dio介绍视频教程

Flutter Dio源码分析(二)--HttpClient、Http、Dio对比视频教程

Flutter Dio源码分析(三)--深度剖析视频教程

Flutter Dio源码分析(四)--封装视频教程

github仓库地址

本文会手把手教你该怎么去封装一个类库，平时在我们的工作中都是拿着别人的造好的轮子在使用，这篇文章将带你怎么去自己造轮子，以后再碰到别的类库需要对其进行封装的时候提供一个的思路和方法。

在前面的文章中，我们对 Dio 的基本使用、请求库对比、源码分析，我们知道 Dio 的使用非常的简单，那为什么还需要进行封装呢？有两点如下：

当组件库方法发生重要改变需要迁移的时候如果有多处地方用到，那么需要对使用到的每个文件都进行修改，非常的繁琐而且很容易出问题。

当不需要 Dio 库的时候，我们可以随时方便切换到别的网络请求库，当然 Dio 目前内置支持使用第三方库的适配器。

因为一个应用程序基本都是统一的配置方式，所以我们可以针对 拦截器 、 转换器 、 缓存 、 统一处理错误 、 代理配置 、 证书校验 等多个配置进行统一管理。

因为我们的应用程序在每个页面中都会用到网络请求，那么如果我们每次请求的时候都去实例化一个 Dio ，无非是增加了系统不必要的开销，而使用单例模式对象一旦创建每次访问都是同一个对象，不需要再次实例化该类的对象。

这是通过静态变量的私有构造器来创建的单例模式

我们对 超时时间 、 响应时间 、 BaseUrl 进行统一设置

因为不管是 get() 还是 post() 请求， Dio 内部最终都会调用 request 方法，只是传入的 method 不一样，所以我们这里定义一个枚举类型在一个方法中进行处理

我们已经把 Restful API 风格简化成了一个方法，通过 DioMethod 来标明不同的请求方式。在我们平时开发的过程中，需要在请求前、响应前、错误时对某一些接口做特殊的处理，那我们就需要用到拦截器。 Dio 为我们提供了自定义拦截器功能，很容易轻松的实现对请求、响应、错误时进行拦截

我们发现虽然 Dio 框架已经封装了一个 DioError 类库，但如果需要对返回的错误进行统一弹窗处理或者路由跳转等就只能自定义了

在我们发送请求的时候会碰到几种情况，比如需要对非open开头的接口自动加上一些特定的参数，获取需要在请求头增加统一的 token

在我们请求接口前可以对响应数据进行一些基础的处理，比如对响应的结果进行自定义封装，还可以针对单独的 url 做特殊处理等。

我们看了转换器的介绍，发现和拦截器的功能差不多，那为什么还要存在转换器，有两点：

执行流程： 请求拦截器 请求转换器 发起请求 响应转换器 响应拦截器 最终结果 。

只会被用于 'PUT'、 'POST'、 'PATCH'方法，因为只有这些方法才可以携带请求体(request body)

会被用于所有请求方法的返回数据。

在开发过程中，客户端和服务器打交道的时候，往往会用一个 token 来做校验，因为每个公司处理刷新token的逻辑都不一样，我这里举一个简单的例子

为什么我们需要有取消请求的功能，如果当我们的页面在发送请求时，用户主动退出当前界面或者app应用程序退出的时候数据还没有响应，那我们就需要取消该网络请求，防止不必要的错误。

由 服务器生成 的 一小段文本信息 ，发送给浏览器，浏览器把 cookie 以kv形式保存到本地 某个目录下的文本文件内，下一次请求同一网站时会把该 cookie 发送给服务器。

cookie 的使用需要用到两个第三方组件 dio_cookie_manager 和 cookie_jar

因为在我们平时的开发过程中，会碰到一种情况，在进行网络请求时，我们希望能正常访问到上次的数据，对于用户的体验比较好，而不是展示一个空白的页面，该缓存主要是 《Flutter实战》网络接口缓存 提供参考。

我们在程序退出后内存缓存将会消失，所以我们用 shared_preferences 进行磁盘缓存数据。

在我们用flutter进行抓包的时候需要配置 Dio 代理。由 DefaultHttpClientAdapter 提供了一个 onHttpClientCreate 回调来设置底层 HttpClient 的代理。

用于验证正在访问的网站是否真实。提供安全性，因为证书和域名绑定，并且由根证书机构签名确认。

日志打印主要是帮助我们开发时进行辅助排错

新建一个flutter项目，可以在ios上运行，四步搞定！

1. 建立一个flutter项目的命令

2. 在ios文件夹下，生成pods文件夹

3. Xcode环境签名设置；

把错误的版本删除再添加，可解决签名错误问题；必须先删除再添加，直接修改可能不起作用。团队开发，必须使用团队的签名。

4.运行创建的flutter项目；

选择真机、模拟机，点击运行按钮，或使用命令运行：

下面两步是赠送的：

5.新加一款插件，所涉及的命令；

ios 端所涉及的命令

6. 刚更新的插件和已有的插件有冲突怎么办？

可以试一试以下步骤：

flutter 签名和获取应用签名

签名：

keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key

【~/key.jks】生成文件的路径和文件名

keytool -importkeystore -srckeystore C:/test/key.jks -destkeystore C:/test/key.jks -deststoretype pkcs12

迁移到行业标准格式 PKCS12

在project/android下创建key.properties文件

文件内容

在Projects\android\app\build.gradle里的 android{ 上边添加

def keystorePropertiesFile = rootProject.file("key.properties")

def keystoreProperties =new Properties()

keystoreProperties.load(new FileInputStream(keystorePropertiesFile))

android{

buildTypes{

release{

    signingConfig signingConfigs.release

}

}

修改成

signingConfigs{

release{

    keyAlias keystoreProperties['keyAlias']

    keyPassword keystoreProperties['keyPassword']

    storeFile file(keystoreProperties['storeFile'])

    storePassword keystoreProperties['storePassword']

}

}

buildTypes{

release{

    signingConfig signingConfigs.release

}

}

之后在执行 flutter build apk打包就签名了。

在有签名文件的情况下获取应用签名：

keytool -list -v -keystore 签名文件路径

MD5就是文件签名：复制出来去掉:就可以使用了。

Flutter 集成ShareSDK分享功能

项目分享中需要用到这两项，需要到官网进行注册。

下面是官网的官方文档：

;id=14

根据官网指示，在pubspec.yaml文件中加入下面依赖

dependencies:

sharesdk_plugin:

安卓的mobsdk.gradle客服说是可以自动生成，也有存在部分未自动生成，所以未自动生成需要手动添加，然后再重新自定义编辑。具体可以直接挪官网demo的文件。

另外手动添mobsdk.gradle文件后，需要在gradle文件中添加mobsdk.gradle的引用

apply from:'../MobSDK.gradle'（在android{}之外添加）

此外，ios的 sharesdk_plugin.podspec会自动生成，就照着官网编辑即可，到了这步就算是sdk的成功引用了， 。

1.需要打包签名，不然微信等部分应用分享失败。

2.flutter签名没有快捷方式了，需要用命令来生成，具体百度吧！

3.打包，在命令行flutter  build apk，会在项目下/build/app/outputs/apk/release/下。

通过cd到项目，运行adb install apk的路径的方式，进行测试。

Flutter 的Android 、iOS 打包

Flutter 项目虽说是跨平台项目，但是项目的名称还是需要在不同的平台设置，不同平台的设置位置是：

1、 Android 项目名字配置是在 android/app/src/main/AndroidManifest.xml 文件中的 application 下的 android:label 。如下图所示:

2、 iOS 项目名字配置是在 ios/Runner/Info.plist 文件中的 dict 下的 keyCFBundleName/key stringtestapp/string 。如下图所示:

Flutter 项目虽说是跨平台项目，但是项目的 Logo 图标还是需要在不同的平台设置，不同平台的设置位置是：

1、 Android 项目 Logo 配置是在图片放置在 android/app/src/main/res 下的对应目录下：

mipmap-mdpi : 48 _ 48

mipmap-hdpi : 72 _ 72

mipmap-xhdpi :96 _ 96

mipmap-xxhdpi :144 _ 144

mipmap-xxxhdpi :192 * 192。如下图所示:

然后，在 android/app/src/main/AndroidManifest.xml 路径下的 AndroidManifest.xml 文件中的 android:icon 。如下图所示：

2、 iOS 项目 Logo 的配置是在 ios/Runner/Assets.xcassets/AppIcon.appiconset 文件下，直接更换图片，名字不要改动 。如下图所示:

1、使用 cd 指令进入项目（testapp）的根目录(方便后面操作),如下图所示：

填写对应的值，如下图所示：

1、 build.gradle 文件的位置,如下图所示:

2、在 build.gradle 中配置 key.propreties 的全局变量,

如下图所示:

3、 build.gradle 文件中进行签名配置。

如下图所示:

注意： buildTypes 中的 signingConfig signingConfigs.debug 可以变更为 signingConfig signingConfigs.release ，这样在打包的时候，直接可以 flutter build apk ，否则就执行 flutter build apk --release 。如图所示：

1、 cd 进入功能（testapp） 的根目录，如下图所示：

2、执行 flutter build apk 指令，如下图所示：

我们打包成功， 生成的 apk 包在 build/app/outputs/apk/release/app-release.apk 目录下，如下图所示：

1、将真机通过 USB 链接到电脑上，如下图所示：

2、然后,在项目的根目录执行 flutter install , 如果出现电脑同时有多个设备时，就执行 flutter install -d deviceid 。如下图所示：

3、设备的安装过程如下：

1、必须一个 Xcode 开发工具

2、如果是 Window 的电脑，请安装 Mac 虚拟系统，进行安装 Xcode .

1、打开目录下的 Runner.xcworkspace 工程。

如下图所示：

2、在 ios 工程中配置 Signing Capabilities , 如下图所示：

1、进入项目的根目录

2、打包指令 flutter build ios --release

如图所示：

3、使用 Xcode 工具进行打包

如图所示：

注意：进行该步骤，必须执行 flutter build ios --release 否则会报错。

打包成功，如下图所示：

Flutter真机调试之后，安装新版本时提示:更新包与已安装应用签名不一致

需要在命令行操作

但是我查出来的并没有我的包名

6.成功了，现在在安装APP，就ok了