Flutter实战 | 从 0 搭建「网易云音乐」APP（一、创建项目、添加插件、通用代码）

本系列可能会伴随大家很长时间，这里我会从0开始搭建一个「网易云音乐」的APP出来。

下面是该APP 功能的思维导图：

因为工作的原因，一星期有可能只更新一篇该系列的文章，不过一星期最少一篇。

本章节为第一节，从创建项目说起。

创建「网易云音乐」项目

首先看一下本地 Flutter 环境：

创建命令就都知道了，不用命令的话，用 AS 或者 VS 更简单。

项目创建好后，删除无用代码，然后开始创建文件夹：

一共分为六个文件夹：

•model：存放所有数据类•pages：存放所有的页面•provider：存放所有的 Provider•route：存放路由相关•utils：存放所有的工具类•widgets：存放所有封装好的组件

下面我们开始添加依赖。

添加插件

首先对我们一些大概的功能有一个了解，

例如 网络请求肯定有，那我会选择 Dio 来当做网络请求的插件，

下面是目前所想到的插件：

通用代码

功能如下：

其中 widget_future_builder.dart 在我上一篇文章：Flutter | 定义一个通用的多功能网络请求 Widget 中已经说过了，这里就不多说了。

挑几个没说过的说一下。

loading.dart

用于显示加载中的组件。

开始的时候考虑用 showDialog 来做，但是它默认会把背景变成半透明的黑色。

然后查看源码，发现他是调用 showGeneralDialog 来创建的对话框，传入了一个 barrierColor: Colors.black54 来控制的半透明背景。

那我可以自己来使用 showGeneralDialog，关于该控件的介绍及使用，我这里就不多赘述了，可以查看caijinglong的博客 - Flutter dialog (2) - showGeneralDialog的使用。^[12]

最后我这里的代码就是这样（截取一部分）：

class Loading {

  static bool isLoading = false;

  static void showLoading(BuildContext context) {

    if (!isLoading) {

      isLoading = true;

      showGeneralDialog(

          context: context,

          pageBuilder: (BuildContext context, Animation animation,

              Animation secondaryAnimation) {

            return xxx;

          }).then((v) {

            // 消失的时候把状态置为 false

        isLoading = false;

      });

    }

  }

  static void hideLoading(BuildContext context) {

    if (isLoading) {

      Navigator.of(context).pop();

    }

  }

}

只提供了两个静态方法：showLoading()、hideLoading()。

showLoading 逻辑如下：

1.首先判断 isLoading 是否为 true，如果正在显示 loading，那么则不作操作2.如果不为 true，则显示 loading，并把状态置为 true3.调用 then 方法，在 dialog 消失的时候把状态置为 false

net_utils.dart

网络请求的管理&工具类。

在这个文件中，我们要进行 Dio 的初始化和网络请求的封装。

在查看 API 文档的时候，发现登录状态是由 Cookie 来管理的。 所以我要使用 cookie 的插件来满足需求。

写一个初始化的方法，在 runApp 时调用：

static Dio _dio;

static void init() async {

   // 获取沙盒路径，用于存储 cookie

  Directory tempDir = await getTemporaryDirectory();

  String tempPath = tempDir.path;

  CookieJar cj = PersistCookieJar(dir: tempPath);

  _dio = Dio(BaseOptions(baseUrl: 'http://127.0.0.1:3000'))

    ..interceptors.add(CookieManager(cj))

    ..interceptors.add(LogInterceptor(responseBody: true, requestBody: true));

}

然后再写一个通用的 _get() 方法，所有的网络请求最终都经过它：

static Future<Response> _get(BuildContext context, String url,

                             {Map<String, dynamic> params}) async {

  Loading.showLoading(context);

  try {

    return await _dio.get(url, queryParameters: params);

  } on DioError catch (e) {

    if (e.response is Map) {

      return Future.value(e.response);

    } else {

      return Future.error(0);

    }

  } finally {

    Loading.hideLoading(context);

  }

}

这个逻辑我在上一篇文章中也提到过，如果返回状态不是 2xx，那就会抛出 DioError，然后我们在这里处理逻辑即可。

common_text_style.dart

一些通用的 text 样式。

我们在这里创建一些 顶级变量 ：

final commonTextStyle = TextStyle(fontSize: 16, color: Colors.black87);

final smallCommonTextStyle = TextStyle(fontSize: 12, color: Colors.black87);

final smallGrayTextStyle = TextStyle(fontSize: 12, color: Colors.grey);

这样其他类使用起来就很方便，万一以后要改文字样式也很方便。

总结

该篇文章是当前系列的第一篇，主要提供了一些搭建项目的思路。

该系列文章代码会传至 GitHub：https://github.com/wanglu1209/NeteaseClouldMusic

并且每次提交都会对应一个分支。

本文中的代码请在 NeteaseClouldMusic-Day1 分支中查看代码。

References

[1] Provider: https://pub.dev/packages/provider
[2] shared_preferences: https://pub.dev/packages/shared_preferences
[3] dio: https://pub.dev/packages/dio
[4] flutter_screenutil: https://pub.dev/packages/flutter_screenutil
[5] fluro: https://pub.dev/packages/fluro
[6] common_utils: https://pub.dev/packages/common_utils
[7] dio_cookie_manager: https://pub.dev/packages/dio_cookie_manager
[8] cookie_jar: https://pub.dev/packages/cookie_jar
[9] permission_handler: https://pub.dev/packages/permission_handler
[10] path_provider: https://pub.dev/packages/path_provider
[11] extended_image: https://pub.dev/packages/extended_image
[12] caijinglong的博客 - Flutter dialog (2) - showGeneralDialog的使用。: https://www.kikt.top/posts/flutter/dialog/dialog-2/