开发了个 Flipper 调试工具的 Flutter 版本 SDK，让 Flutter 应用调试起来更容易

[lijy91]

最近一直在持续的学习 Flutter，但一直没有发现有好用的网络调试工具，也不想太想使用 Charles 这个工具，后来发现了 Facebook Flipper 这个工具，所以花了几天时间做了个 Flutter 版的 Flipper SDK。期间碰到了一些问题但 Flipper 项目的人迅速的帮忙。

这个库可以让你能够在 Flipper 上查看你的 Flutter 应用的网络请求及 Preferences 数据，相比之前我之前使用 print 来输出请求数据来说，实在是方便了好多，如果你也在用 Flutter 开发你的应用，不妨来试一下吧。

特性

• Network inspector

• Shared preferences (and UserDefaults) inspector

集成到你的项目

必备条件

开始之前确保你已安装：

• 已安装 Flipper Desktop

安装

添加以下内容到包的 pubspec.yaml 文件中：

dependencies:
  flutter_flipperkit: ^0.0.2

根据示例更改项目的 ios/Podfile 文件：

Flipper 目前需要的 platform 为 8.0

+source 'https://github.com/facebook/flipper.git'
+source 'https://github.com/CocoaPods/Specs'
# Uncomment this line to define a global platform for your project
-# platform :ios, '9.0'
+platform :ios, '9.0'

根据示例更改项目的 android/app/build.gradle 文件：

Flipper 目前需要的 sdkVersion 为 28

android {
-    compileSdkVersion 27
+    compileSdkVersion 28

    defaultConfig {
-        targetSdkVersion 27
+        targetSdkVersion 28
    }
}

您可以通过命令行安装软件包：

$ flutter packages get

快速集成

添加下列代码到 lib/main.dart 文件：

import 'package:flutter_flipperkit/flutter_flipperkit.dart';

void main() {
  FlipperClient flipperClient = FlipperClient.getDefault();

  // 添加网络插件
  flipperClient.addPlugin(new FlipperNetworkPlugin());
  // 添加 Preferences 插件
  flipperClient.addPlugin(new FlipperSharedPreferencesPlugin());
  flipperClient.start();

  runApp(MyApp());
}

Dio 集成示例：

import 'dart:io';
import 'package:dio/dio.dart';
import 'package:flutter_flipperkit/flutter_flipperkit.dart';
import 'package:uuid/uuid.dart';

class DioClient {
  Dio _http;
  FlipperNetworkPlugin _flipperNetworkPlugin;

  DioClient() {
    _flipperNetworkPlugin = FlipperClient
      .getDefault().getPlugin(FlipperNetworkPlugin.ID);
    
    Options options = new Options(
      connectTimeout: 5000,
      receiveTimeout: 3000,
      headers: {
        "Accept": "application/json",
        "Content-Type": "application/json"
      },
      responseType: ResponseType.JSON,
    );
    this._http = new Dio(options);
    // 在拦截器中添加和 Flipper 通讯的代码
    this._http.interceptor.request.onSend = (Options options) async {
      // 发送请求数据到 Flipper
      this._reportRequest(options);
      return options;
    };
    this._http.interceptor.response.onSuccess = (Response response) {
      // 发送响应数据到 Flipper
      this._reportResponse(response);
      return response;
    };
  }

  Dio get http {
    return _http;
  }

  void _reportRequest(Options options) {
    String requestId = new Uuid().v4();
    options.extra.putIfAbsent("requestId", () => requestId);
    RequestInfo requestInfo = new RequestInfo(
      requestId: requestId,
      timeStamp: new DateTime.now().millisecondsSinceEpoch,
      uri: '${options.baseUrl}${options.path}',
      headers: options.headers,
      method: options.method,
      body: options.data,
    );

    _flipperNetworkPlugin.reportRequest(requestInfo);
  }

  void _reportResponse(Response response) {
    Map<String, dynamic> headers = new Map();
      for (var key in []
        ..addAll(HttpHeaders.entityHeaders)
        ..addAll(HttpHeaders.requestHeaders)
        ..addAll(HttpHeaders.responseHeaders)
      ) {
        var value = response.headers.value(key);

        if (value != null && value.isNotEmpty) {
          headers.putIfAbsent(key, () => value);
        }
      }
      String requestId = response.request.extra['requestId'];
      ResponseInfo responseInfo = new ResponseInfo(
        requestId: requestId,
        timeStamp: new DateTime.now().millisecondsSinceEpoch,
        statusCode: response.statusCode,
        headers: headers,
        body: response.data,
      );

      _flipperNetworkPlugin.reportResponse(responseInfo);
  }
}

Dio 使用示例

new DioClient().http.get('https://www.v2ex.com/api/topics/hot.json');

运行程序

这时，集成已经完成，启用应用后可在 Flipper Desktop 上实时看到你的网络请求了

$ flutter run

已知问题

• Flipper Desktop 中文乱码，但已解决并提交 PR 给官方，暂时可以使用我修改的版本 https://github.com/lijy91/flipper
• 暂不支持 iOS 真机

探讨

如果您对此项目有任何建议或疑问，可以通过 Telegram 或我的微信进行讨论。

相关链接

• https://github.com/blankapp/flutter_flipperkit
• https://github.com/facebook/flipper

如果大家觉得这个项目对你有帮忙，顺手来个 Star 吧~

https://github.com/blankapp/flutter_flipperkit

[Hilong]

赞一个，flutter 生态就是这样靠你们一步步变好的。

[iamsee]

赞，希望 flutter 生态越来越好

[wen704]

老哥流啤

[zjupigeon]

看好 flutter，或者这类，让跨平台的开发更简单

[itbeihe]

老哥厉害

[OrangeM21]

老哥稳

[PDX]

6

[Ann5527]

🐂！ Mark 一下备用

[20015jjw]

fb flipper 用户表示感谢

[lijy91]

@Hilong
@iamsee
@zjupigeon Flutter 未来大有可为，我一路从 Android -> RN -> Flutter，Flutter 给我的感觉很好，不管是开发体验还是在性能体验上都非常不错。

[lijy91]

@20015jjw 我也是最近才发现的 Flipper 确实不错，还发现了一个中文乱码的 Bug 给官方提了 PR。

[Mrxxy]

收藏支持

[kooze]

最近在做 flutter 应用，支持了！

[allenjuly7]

star +1

[wen704]

@lijy91 现在就差 Flutter 的热更新了,我和你的路线一样,不过 RN 上有热更新, Flutter 上没有,不然现在立马把项目转 Flutter 上去.

[lijy91]

@wen704 他们官方今年的计划就有热更新，应该不远了。

[wen704]

@lijy91 可以,先自己玩玩 demo 熟练起来,到时候热更新来了就换上去吧,不过看 iOS ,github 上都说很悬,可能只有安卓有,其实谷歌自己标准里也是不给热更新的...

[magic3584]

楼主两个 GitHub 号。。。

[lijy91]

@magic3584 一个账号，多个组织

[chenglu]

大赞楼主～