Flutter 插件使用必知必会

• iOS

• 在ios/Runner目录下自动生成的GeneratedPluginRegistrant.m中，会添加插件的注册代码。

#import “GeneratedPluginRegistrant.h”
#import <url_launcher/UrlLauncherPlugin.h>

@implementation GeneratedPluginRegistrant

• (void)registerWithRegistry:(NSObject*)registry {
  [FLTUrlLauncherPlugin registerWithRegistrar:[registry registrarForPlugin:@“FLTUrlLauncherPlugin”]];
  }

@end

• 在AppDelegate.swift启动后去调用注册

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate, WXApiDelegate {

override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?
) -> Bool {
GeneratedPluginRegistrant.register(with: self)
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
}

3. 在项目文件中 import 所需的包名，并使用

4. 如果依赖中存在 platform-specific code (Java/Kotlin for Android, Swift/Objective-C for iOS)，要确保代码能够编译进 App ，必须 Restart App，防止发生MissingPluginException异常。Hot reload 或者 Hot restart 只对 dart 代码有效。

版本约束

版本格式：主版本号.次版本号.修订号，版本号递增规则如下：

• 主版本号：当你做了不兼容的 API 修改，
• 次版本号：当你做了向下兼容的功能性新增，
• 修订号：当你做了向下兼容的问题修正。

更详细的参考语义化版本

基本用法：

any # 所有版本，等同于不写。对pub运行性能有影响，不推荐
1.2.3 # 明确的版本号
‘>=1.2.3’ # 还有 >1.2.3, <=1.2.3, <1.2.3
^1.2.3 # Caret syntax 等同于 >=1.2.3 <2.0.0

注意:如果在版本约束中使用了’>‘,’<'字符，一定要加引号，否则无法被当作 YAML 的语法解析

版本冲突

如果项目依赖了 A , B 库，他们都依赖了一个 C ,但 C 的版本不同，可能会产生版本冲突。pub 会尝试找到符合所有依赖约束的版本号。如果找不到能匹配的版本，但 A ，B 库依赖 C 库的 API 是一样的，那么可以添加一个依赖覆盖来强制指定某一版本。

注：pub 是 Dart SDK 提供的一个包管理工具

dependencies:
some_package:
other_package:
dependency_overrides:
url_launcher: ‘0.4.3’

如果是 Android 平台的库依赖冲突，可以在 app 的 gradle 文件中强制指定版本

configurations.all {
resolutionStrategy {
force ‘com.google.guava:guava:23.0-android’
}
}

注意： iOS 平台下 CocoaPods 不支持强制版本覆盖

从不同的依赖源添加依赖

SDK

The SDK source is used for any SDKs that are shipped along with packages, which may themselves be dependencies. Currently, Flutter is the only SDK that is supported.

通俗讲，就是 Flutter SDK 自带的库。打开我们 Flutter 的安装地址，进入flutter/packages可以看到各种包，如flutter,flutter_driver,flutter_test等。

➜ packages git:(stable) ✗ ls
analysis_options.yaml flutter_localizations
flutter flutter_test
flutter_driver flutter_tools
flutter_goldens fuchsia_remote_debug_protocol
flutter_goldens_client
➜ packages git:(stable) ✗ pwd
/Users/xxx/flutter/packages

在 Flutter 项目中写过测试的同学对上面几个依赖应该不陌生

dependencies:
flutter:
sdk: flutter # 来源于flutter sdk
dev_dependencies:
flutter_test:
sdk: flutter
flutter_driver:
sdk: flutter

Hosted

A hosted package is one that can be downloaded from pub.dartlang.org (or another HTTP server that speaks the same API).

pub

dependencies:
transmogrify: ^1.4.0

自己的服务器

dependencies:
transmogrify: ^1.4.0
transmogrify:
hosted:
name: transmogrify
url: http://your-package-server.com
version: ^1.4.0

Git

dependencies:
kittens:
git: git://github.com/munificent/kittens.git

指定分支

dependencies:
kittens:
url: git://github.com/munificent/kittens.git
ref: some-branch

pub 默认包目录在 git 仓库的根目录，如果要指定在别的位置，可以用 path 参数

dependencies:
kittens:
git:
url: git://github.com/munificent/cats.git
path: path/to/kittens

本地路径

特别适用在一个人同时开发项目和依赖库的情况。因为修改依赖库的代码，在项目中就可以即时生效，有利于调试和提高效率。

dependencies:
transmogrify:
path: /Users/me/transmogrify # 也可以相对路径，相对路径以 pubspec.yml 文件为基准

依赖的分类

直接依赖和传递依赖

根据依赖与项目的关系，可以分为以下2类：

• immediate dependency ：项目中直接使用的依赖，即我们在 pubspec 中列出的依赖，包括 dependcies 和 dev_dependencies
• transitive dependency ：直接依赖所需的依赖, pub 会根据 pubspec 中列出的依赖自动为我们获取。

举个例子

比如我们项目依赖 A ，而 A 又依赖 B ， B 又依赖 C 。那么 A 是我们项目的immediate dependency, B 和 C 就是transitive dependency

我们可以在命令行中输入命令flutter packages pub deps，查看项目的依赖树。 比如我们在项目中引入了一个支持网络缓存的图片库cached_network_image: ^0.5.0+1

flutter packages pub deps
Dart SDK 2.1.0-dev.9.4.flutter-f9ebf21297
Flutter SDK 1.0.1-pre.2
your_app_name 2.2.0+10 # 项目名称和版本
|-- cached_network_image 0.5.1 # 直接依赖
| |-- flutter… # 直接依赖（因为在项目pubspec中也添加了）
| '-- flutter_cache_manager 0.2.0+1 # 传递依赖
| |-- flutter…
| |-- http…
| |-- path_provider…
| |-- shared_preferences…
| |-- synchronized 1.5.3
| '-- uuid 1.0.3
| |-- convert…
| '-- crypto…
…

常规依赖和dev依赖

根据依赖的作用范围，可以分为：

• dependencies ：常规依赖
• dev dependencies ：开发时所需依赖。它和常规依赖的区别是，项目依赖库中的 dev dependencies ，对于你的项目来说是不可见的。

举个例子

项目的 pubspec.yml 如下。如果 A 有一个 dev_dependencies 依赖 dev_C ,项目最终的依赖是 A , dev_B；不包括 dev_C。

dependencies:
A:
dev_dependencies:
dev_B:

适应场景：如果你需要 import 到 lib 或者 bin 目录，那么选择 dependencies ； 如果你只需要 import 到 test ， example 等，那么就选择 dev dependencies 。使用 dev dependencies 的好处是能让依赖树更小，从而使 pub 运行更快，能跟容易找到满足所有约束的包版本。

包管理

在获取一个新的依赖时，pub 会下载满足版本条件的_最新版本_，然后把版本信息添加到一个 lockfile 中。这个 lockfile 文件叫 pubspec.lock ，位于项目 pubspec.yml 的同级目录。它列出了项目的每个依赖（包括直接依赖和传递依赖）的版本信息。我们应该把这个 lockfile 添加到版本控制中，这样不论开发环境，生产环境都能确保使用了相同的依赖版本。

举个例子

项目的 pubspec.yml 文件包含如下依赖

…
dependencies:
flutter:
sdk: flutter
cached_network_image: ^0.5.0+1

dev_dependencies:
flutter_test:
sdk: flutter
…

结合上面提到知识，我们来看看 pubspec.lock 的内容。 lockfile 把所有依赖树打平，并根据首字母排序

cached_network_image:
dependency: “direct main” # 直接依赖，常规依赖
description:
name: cached_network_image
url: “https://pub.flutter-io.cn”
source: hosted
version: “0.5.1”

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此我收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！
7474)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点！不论你是刚入门Android开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！