Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发

文章目录

  • 1.Dart Pub使用
  • 2.Flutter 插件库 Flutter Package 的开发
  • 3.Flutter插件库Flutter Plugin的开发

在使用 Flutter 开发时,可能某些功能的实现比较麻烦或者无法实现,这时我们首先应该想到的就是要搜索 Dart Pub:https://pub.dev/flutter。
这是 Flutter 官方的一个针对 Flutter、Web、Dart 的插件库开源仓库,里面有很多官方和其他开发者开源的插件库。那么这节课我们将介绍 Flutter 中 Dart Pub 的使用,以及我们自己实现开发一款 Flutter 插件库的方法

1.Dart Pub使用

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第1张图片
Dart Pub 里的 Flutter 插件库都是兼容 Android 和 iOS 的,当然 Dart Pub 里的插件库还有很多是 Web 相关的插件,我们只需要搜索 Flutter 的插件库使用即可。

我们看下 Flutter 相关的使用频率比较高的插件库:

我们这里以 path_provider 这个插件库为例,点击 path_provider 这个链接进入插件库详情描述页。path_provider 是用于为 Flutter 提供访问 Android 和 iOS 的文件系统目录的功能的一个插件库。

点击进入的页面如下:

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第2张图片

有说明文档、更新日志、例子、安装步骤、版本列表、关于页面、插件官方首页、Github 地址、相关问题页面、API 文档等等信息。

我们需要点击 Installing,复制安装依赖库的信息到 pubspec.yaml:

dependencies:
  path_provider: ^1.1.2

接下来我们可以在 Readme 或者 Example 里看到使用的方法和说明,如果没有的话,可以点击进入官方的 Github 进行下载和查看使用的实例。

2.Flutter 插件库 Flutter Package 的开发

我们除了可以使用 Dart Pub 上提供的插件库以外,如果遇到 Dart Pub 上的插件库也没有办法实现我们想要的功能的时候,我们可以自己编写插件库,需要兼容 Android 和 iOS 平台,也就是要分别写 Android 和 iOS 原生代码,并提供给 Flutter 进行调用。当然,我们也可以将我们的插件库提交到 Dart Pub 上供其他人使用。

那么接下来我们就来看看如何编写 Flutter 插件库,并提交到 Dart Pub 上。

Flutter 的 Dart Pub 上的插件库主要分为两种:一种是包(Flutter Package):纯 Dart 编写的 API 插件库;另一种就是插件(Flutter Plugin):编写 Android、iOS 的原生代码,然后通过 Flutter 的 MethodChannel 来调用封装好的对应平台的原生代码来实现的插件库

这两种插件库各有各的特点和功能,我们的 Android Studio 在创建项目时,也提供了插件库创建的两种方式:

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第3张图片

我们可以看到有 Flutter Plugin 和 Flutter Package 两种方式来创建插件库。相应地,如果我们的插件库通过纯 Dart 就可以实现这个插件功能的话,就选择 Flutter Package 方式创建插件库;如果我们的插件库必须借助 Android、iOS 平台的原生代码才可以实现插件功能的话,那么就选择 Flutter Plugin 方式创建我们的插件库。

我们先看下 Flutter Package 这种方式创建插件库。

除了可以用 Android Studio 进行界面操作创建外,我们还可以通过命令行方式创建:

$ flutter create --template=package hello

这里的 hello 为插件 Package 名称,英文名称。

我们看下创建后的项目结构:

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第4张图片

插件的逻辑写在 lib 目录下,纯 Dart 实现的功能逻辑。

test 目录下面是单元测试文件。

CHANGELOG.md 这个文件是用于描述插件更新的日志的。提交到 Dart Pub 上就是 CHANGELOG 这里显示的内容。

LICENSE 是添加我们的开源插件库所遵循的开源协议是哪些,及其描述。

pubspec.yaml 这里面是我们插件库的描述信息,如插件库名称信息、作者信息、版本信息等其他信息。

我们大致看下 pubspec.yaml 的内容:

// 插件库名称
name: flutter_package
// 插件库描述
description: A new Flutter package.
// 插件库版本
version: 0.0.1
// 作者信息,名字 <邮箱>形式
author: Tan Dong <tandongjay@qq.com>
// 插件库的主页
homepage: https://github.con/tandong/flutter_package
// 插件库运行的sdk版本环境
environment:
  sdk: ">=2.1.0 <3.0.0"
// 所需要的依赖
dependencies:
  flutter:
    sdk: flutter

dev_dependencies:
  flutter_test:
    sdk: flutter

# For information on the generic Dart part of this file, see the
# following page: https://dart.dev/tools/pub/pubspec

README.md 是插件库的说明文档,包含插件库的功能描述、特点、用法示例等等说明描述性的信息。

当我们的项目具备这些文件和目录结构后,并且在 lib 目录下编写完 dart 功能代码后,我们就可以自己使用了,如果想共享给其他人,就可以发布到 Dart Pub 上。

fluro 这个插件库就是一个 Flutter Package 实现的插件库:https://pub.dev/packages/fluro ,大家可以参考学习下它的结构。

例如,假如我们的插件库名叫做:flutter_package,那么我们默认就会在 lib 目录下新建一个 flutter_package.dart 文件,建议 lib 根目录的文件名为插件库英文名字命名。

入口文件示例:

library flutter_package;

/// A Calculator.
class Calculator {
  /// Returns [value] plus 1.
  int addOne(int value) => value + 1;
}

顶部:library + 插件库名字声明。

下面就可以编写相关的 class 和方法类逻辑了。

发布到 Dart Pub

如果我们的项目结构都完整,包含了 lib、pubspec.yaml、README.md 以及 CHANGELOG.md 等文件,我们就可以发布到 Dart Pub 了。

运行如下命令,检查是否一切就绪并且正确:

$ flutter packages pub publish --dry-run

如果检查通过的话,输入如下命令即可发布:

$ flutter packages pub publish

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第5张图片

这样就完成了我们 Flutter Package 的发布。

依赖冲突的解决

如果遇到插件库的依赖库引用冲突,如版本不一致,插件库使用了一个版本的依赖库、项目中又引入了另一个版本的插件库,这时可能会产生冲突。

Flutter 官方建议我们的插件库所用的依赖库版本声明中,要声明使用范围,而不是指定某个固定版本号。

例如我们的 flutter_package 插件库的 pubspec.yaml 中声明了依赖:

dependencies:
  url_launcher: ^0.4.2

这样使用范围的声明是推荐的,而不是指定固定一个版本的 url_launcher。

还有一种方式解决冲突:

dependencies:
  some_package:
  other_package:
dependency_overrides:
  url_launcher: '0.4.3'

就是强制使用 dependency_overrides 来指定统一 url_launcher 依赖库的版本。

3.Flutter插件库Flutter Plugin的开发

接下来我们看下有了原生代码逻辑的 Flutter Plugin 的插件库的开发。若我们的插件库使用纯Dart 无法实现的话,那么就要通过编写各个平台的原生代码来实现交互调用了。这种方式就是 Flutter Plugin 方式的实现。

这次创建插件库项目我们选择 Flutter Plugin 来创建:

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第6张图片

也可以使用命令创建:

$ flutter create --org com.example --template=plugin hello

这里建议使用 Android Studio 进行创建。

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第7张图片

语言这里我们可以选择使用 Kotin 或者 Swift。默认是 Java 和 Object-C。

当然我们也可以在命令行中指定开发语言:

$ flutter create --template=plugin -i swift -a kotlin hello

创建后的 Flutter Plugin 项目结构如下:

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第8张图片

可以看到:

  • android 目录用于编写 Android 插件功能原生代码;
  • ios 目录用于编写 iOS 插件功能原生代码;
  • example 里是相关使用插件的例子;
  • lib 目录用于编写插件的 flutter 部分,用于调用原生封装好的方法;
  • test 是单元测试目录;
  • CHANGELOG.md 是插件库更新日志的描述文件;
  • LICENSE 是插件库所遵循的开源协议和说明;
  • pubspec.yaml 是插件库的一些配置描述信息,包括名称、描述、作者、主页、版本、运行环境等信息;
  • README.md 是插件库说明文档。

主要的结构和文件就是这些,和 Flutter Package 大同小异。

具体的 Flutter 调用原生的代码逻辑和 Android 及 iOS 平台的代码编写逻辑。

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第9张图片

Flutter 与原生交互:

Flutter学习记录——27.Dart Pub 使用及 Flutter 插件库的开发_第10张图片

例如,Flutter 官方的例子实现获取手机电量信息的。其实就是编写了 Android 的方法、iOS 的方法,然后 Flutter 端编写 dart 代码来反射调用对应平台的获取电池电量的方法。

一个典型的 Flutter Plugin 插件例子就是 path_provider 这个官方插件库:

https://pub.dev/packages/path_provider

它分别编写了 Android 和 iOS 的平台代码来获取文件路径,然后 Flutter 端调用封装好的方法。大家可以参考这个来学习:

https://github.com/flutter/plugins/tree/master/packages/path_provider 。

插件库的发布同上面的 Flutter Package 步骤一致。

关于 API documentation,即 API 文档,在发布软件包时,API 文档会自动生成并发布到 dartdocs.org。

文档的生成就是根据我们项目代码中的相关注释来生成的,所以我们只需要在每个类、方法、属性、块等地方按照 Dart 说明注释的规则来编写注释即可。

关于 Flutter 未上传发布的库的引入依赖,我们简单讲解下。

本地插件库引入形式:

dependencies:
  plugin1:
    path: ../plugin1/

Github 上托管的插件库引入形式:

dependencies:
  package1:
    git:
      url: git://github.com/flutter/packages.git
      path: packages/package2

你可能感兴趣的:(Flutter)