Skip to main content

开发包和插件

包介绍

#

包允许创建易于共享的模块化代码。一个最小的包包含以下内容:

pubspec.yaml
一个元数据文件,声明包的名称、版本、作者等等。
lib
lib 目录包含包中的公共代码,至少包含一个 <package-name>.dart 文件。

包类型

#

包可以包含多种类型的内容:

Dart 包

用 Dart 编写的通用包,例如 path 包。其中一些可能包含 Flutter 特定的功能,因此依赖于 Flutter 框架,这限制了它们只能在 Flutter 中使用,例如 fluro 包。

插件包

一种特殊的 Dart 包,包含用 Dart 代码编写的 API 以及一个或多个特定于平台的实现。

插件包可以为 Android(使用 Kotlin 或 Java)、iOS(使用 Swift 或 Objective-C)、Web、macOS、Windows 或 Linux 或任何组合编写。

一个具体的例子是 url_launcher 插件包。要了解如何使用 url_launcher 包以及如何扩展它以实现对 Web 的支持,请参阅 Harry Terkelsen 在 Medium 上发表的文章:如何编写 Flutter Web 插件,第一部分

FFI 插件包

一种特殊的 Dart 包,包含用 Dart 代码编写的 API 以及一个或多个使用 Dart FFI 的特定于平台的实现(Android, iOS, macOS)。

开发 Dart 包

#

以下说明解释了如何编写 Flutter 包。

步骤 1:创建包

#

要创建一个 Flutter 包的启动器,请使用 flutter create 命令中的 --template=package 标志:

flutter create --template=package hello

这会在 hello 文件夹中创建一个包项目,其内容如下:

LICENSE
一个(大部分)空的许可证文本文件。
test/hello_test.dart
包的单元测试
hello.iml
IntelliJ IDE 使用的配置文件。
.gitignore
一个隐藏文件,告诉 Git 在项目中忽略哪些文件或文件夹。
.metadata
IDE 用于跟踪 Flutter 项目属性的隐藏文件。
pubspec.yaml
一个 yaml 文件,包含指定包依赖项的元数据。由 pub 工具使用。
README.md
一个入门 markdown 文件,简要描述包的目的。
lib/hello.dart
一个包含包的 Dart 代码的入门应用程序。
.idea/modules.xml, .idea/workspace.xml
一个包含 IntelliJ IDE 配置文件的隐藏文件夹。
CHANGELOG.md
一个(大部分)空的 markdown 文件,用于跟踪包的版本更改。

步骤 2:实现包

#

对于纯 Dart 包,只需在主 lib/<package name>.dart 文件中或 lib 目录中的多个文件中添加功能即可。

要测试包,请在 test 目录中添加单元测试

有关如何组织包内容的更多详细信息,请参阅Dart 库包 文档。

开发插件包

#

如果您想开发一个调用特定于平台的 API 的包,则需要开发一个插件包。

API 使用平台通道 连接到特定于平台的实现。

联合插件

#

联合插件是一种将对不同平台的支持拆分为单独包的方法。因此,联合插件可以使用一个包用于 iOS,另一个用于 Android,另一个用于 Web,另一个用于汽车(作为物联网设备的示例)。除其他好处外,这种方法允许领域专家扩展现有插件以使其适用于他们最了解的平台。

联合插件需要以下包:

面向应用的包
插件用户依赖于使用插件的包。此包指定 Flutter 应用使用的 API。
平台包
一个或多个包含特定于平台的实现代码的包。面向应用的包会调用这些包——除非它们包含可供最终用户访问的特定于平台的功能,否则不会将它们包含到应用中。
平台接口包
将面向应用的包连接到平台包的包。此包声明任何平台包都必须实现的接口才能支持面向应用的包。拥有一个定义此接口的包可确保所有平台包都以统一的方式实现相同的功能。

受支持的联合插件

#

理想情况下,当向联合插件添加平台实现时,您将与包作者协调以包含您的实现。通过这种方式,原始作者 支持 您的实现。

例如,假设您为(虚构的)foobar 插件编写了 foobar_windows 实现。在受支持的插件中,原始 foobar 作者会在面向应用的包的 pubspec 中添加您的 Windows 实现作为依赖项。然后,当开发人员在其 Flutter 应用中包含 foobar 插件时,Windows 实现以及其他受支持的实现会自动提供给应用。

未受支持的联合插件

#

如果您由于任何原因无法获得原始插件作者添加的实现,则您的插件 受支持。开发人员仍然可以使用您的实现,但必须手动将插件添加到应用的 pubspec.yaml 文件中:

yaml
dependencies:
  foobar: ^1.0.0
  foobar_windows: ^1.0.0 # 未受支持的插件实现

此方法也适用于覆盖已受支持的 foobar 插件实现。

有关联合插件的更多信息,它们为什么有用以及如何实现,请参阅 Harry Terkelsen 在 Medium 上发表的文章:如何编写 Flutter Web 插件,第二部分

指定插件支持的平台

#

插件可以通过向 pubspec.yaml 文件中的 platforms 映射添加键来指定它们支持的平台。例如,以下 pubspec 文件显示了 hello 插件的 flutter: 映射,该映射仅支持 iOS 和 Android:

yaml
flutter:
  plugin:
    platforms:
      android:
        package: com.example.hello
        pluginClass: HelloPlugin
      ios:
        pluginClass: HelloPlugin

当为更多平台添加插件实现时,应相应地更新 platforms 映射。例如,以下是 hello 插件的 pubspec 文件中的映射,在更新以添加对 macOS 和 Web 的支持后:

yaml
flutter:
  plugin:
    platforms:
      android:
        package: com.example.hello
        pluginClass: HelloPlugin
      ios:
        pluginClass: HelloPlugin
      macos:
        pluginClass: HelloPlugin
      web:
        pluginClass: HelloPlugin
        fileName: hello_web.dart

联合平台包

#

平台包使用相同的格式,但包含一个 implements 条目,指示它实现了哪个面向应用的包。例如,包含 hello 的 Windows 实现的 hello_windows 插件将具有以下 flutter: 映射:

yaml
flutter:
  plugin:
    implements: hello
    platforms:
      windows:
        pluginClass: HelloPlugin

受支持的实现

#

面向应用程序的包可以通过添加对它的依赖项并将其作为 platforms: 映射中的 default_package 包含进来,从而支持平台包。如果上面的 hello 插件支持 hello_windows,它将如下所示:

yaml
flutter:
  plugin:
    platforms:
      android:
        package: com.example.hello
        pluginClass: HelloPlugin
      ios:
        pluginClass: HelloPlugin
      windows:
        default_package: hello_windows

dependencies:
  hello_windows: ^1.0.0

请注意,如这里所示,面向应用程序的包可以在包中实现某些平台,而在支持的联合实现中实现其他平台。

共享 iOS 和 macOS 实现

#

许多框架都支持 iOS 和 macOS,并且 API 相同或几乎相同,因此可以使用相同的代码库为 iOS 和 macOS 实现某些插件。通常,每个平台的实现都在其自己的文件夹中,但是 sharedDarwinSource 选项允许 iOS 和 macOS 使用相同的文件夹:

yaml
flutter:
  plugin:
    platforms:
      ios:
        pluginClass: HelloPlugin
        sharedDarwinSource: true
      macos:
        pluginClass: HelloPlugin
        sharedDarwinSource: true

environment:
  sdk: ^3.0.0
  # Flutter 3.7 之前的版本不支持 sharedDarwinSource 选项。
  flutter: ">=3.7.0"

启用 sharedDarwinSource 时,iOS 的 ios 目录和 macOS 的 macos 目录不会分别存在,两个平台都会使用共享的 darwin 目录来存放所有代码和资源。启用此选项时,您需要将 iosmacos 中的任何现有文件移动到共享目录。您还需要更新 podspec 文件以设置两个平台的依赖项和部署目标,例如:

ruby
  s.ios.dependency 'Flutter'
  s.osx.dependency 'FlutterMacOS'
  s.ios.deployment_target = '11.0'
  s.osx.deployment_target = '10.14'

步骤 1:创建包

#

要创建一个插件包,请使用 flutter create 命令中的 --template=plugin 标志。

使用 --platforms= 选项后跟逗号分隔的列表来指定插件支持的平台。可用平台为:androidiosweblinuxmacoswindows。如果没有指定平台,则生成的项目不支持任何平台。

使用 --org 选项指定您的组织,使用反向域名表示法。此值用于生成的插件代码中的各种包和捆绑包标识符。

默认情况下,插件项目使用 Swift 编写 iOS 代码,使用 Kotlin 编写 Android 代码。如果您更喜欢 Objective-C 或 Java,可以使用 -i 指定 iOS 语言,使用 -a 指定 Android 语言。请选择以下 一项

flutter create --org com.example --template=plugin --platforms=android,ios,linux,macos,windows -a kotlin hello
flutter create --org com.example --template=plugin --platforms=android,ios,linux,macos,windows -a java hello
flutter create --org com.example --template=plugin --platforms=android,ios,linux,macos,windows -i objc hello
flutter create --org com.example --template=plugin --platforms=android,ios,linux,macos,windows -i swift hello

这会在 hello 文件夹中创建一个插件项目,其中包含以下专用内容:

lib/hello.dart
插件的 Dart API。
android/src/main/java/com/example/hello/HelloPlugin.kt
使用 Kotlin 编写的插件 API 的 Android 平台特定实现。
ios/Classes/HelloPlugin.m
使用 Objective-C 编写的插件 API 的 iOS 平台特定实现。
example/
一个依赖于插件并演示如何使用它的 Flutter 应用。

步骤 2:实现包

#

由于插件包包含多个平台的代码

由于用多种编程语言编写,因此需要一些特定步骤来确保顺利体验。

步骤 2a:定义包 API (.dart)

#

插件包的 API 在 Dart 代码中定义。在您喜欢的Flutter 编辑器中打开主 hello/ 文件夹。找到文件 lib/hello.dart

步骤 2b:添加 Android 平台代码 (.kt/.java)

#

我们建议您使用 Android Studio 编辑 Android 代码。

在 Android Studio 中编辑 Android 平台代码之前,请确保代码至少构建过一次(换句话说,从您的 IDE/编辑器运行示例应用程序,或在终端中执行 cd hello/example; flutter build apk --config-only)。

然后按照以下步骤操作:

  1. 启动 Android Studio。
  2. 欢迎使用 Android Studio 对话框中选择打开现有 Android Studio 项目,或从菜单中选择文件 > 打开,然后选择 hello/example/android/build.gradle 文件。
  3. Gradle 同步对话框中,选择 确定
  4. Android Gradle 插件更新对话框中,选择 不要再次提醒我此项目

插件的 Android 平台代码位于 hello/java/com.example.hello/HelloPlugin

您可以通过按下运行按钮 (▶) 从 Android Studio 运行示例应用程序。

步骤 2c:添加 iOS 平台代码 (.swift/.h+.m)

#

我们建议您使用 Xcode 编辑 iOS 代码。

在 Xcode 中编辑 iOS 平台代码之前,请确保代码至少构建过一次(换句话说,从您的 IDE/编辑器运行示例应用程序,或在终端中执行 cd hello/example; flutter build ios --no-codesign --config-only)。

然后按照以下步骤操作:

  1. 启动 Xcode。
  2. 选择文件 > 打开,然后选择 hello/example/ios/Runner.xcworkspace 文件。

插件的 iOS 平台代码位于项目导航器中的 Pods/Development Pods/hello/../../example/ios/.symlinks/plugins/hello/ios/Classes。(如果您使用的是 sharedDarwinSource,则路径将以 hello/darwin/Classes 结尾。)

您可以通过按下运行按钮 (▶) 运行示例应用程序。

添加 CocoaPod 依赖项
#

按照以下说明添加版本为 0.0.1HelloPod

  1. ios/hello.podspec 的末尾指定依赖项:

    ruby
    s.dependency 'HelloPod', '0.0.1'

    对于私有 pod,请参考私有 CocoaPods 以确保存储库访问权限:

    ruby
    s.source = {
        # 对于托管在 GitHub 上的 pod
        :git => "https://github.com/path/to/HelloPod.git",
        # 或者,对于本地托管的 pod
        # :path => "file:///path/to/private/repo",
        :tag => s.version.to_s
      }`
  1. 安装插件

    • 在项目的 pubspec.yaml 依赖项中添加插件。
    • 运行 flutter pub get
    • 在项目的 ios/ 目录中,运行 pod install

    pod 应该出现在安装摘要中。

如果您的插件需要隐私清单,例如,如果它使用任何必需原因 API,请更新 PrivacyInfo.xcprivacy 文件以描述插件的隐私影响,并在 podspec 文件的底部添加以下内容:

ruby
s.resource_bundles = {'your_plugin_privacy' => ['your_plugin/Sources/your_plugin/Resources/PrivacyInfo.xcprivacy']}

有关更多信息,请查看 Apple 开发者网站上的隐私清单文件

步骤 2d:添加 Linux 平台代码 (.h+.cc)

#

我们建议您使用具有 C++ 集成的 IDE 编辑 Linux 代码。以下说明适用于安装了“C/C++”和“CMake”扩展的 Visual Studio Code,但可以针对其他 IDE 进行调整。

在 IDE 中编辑 Linux 平台代码之前,请确保代码至少构建过一次(换句话说,从您的 Flutter IDE/编辑器运行示例应用程序,或在终端中执行 cd hello/example; flutter build linux)。

然后按照以下步骤操作:

  1. 启动 Visual Studio Code。
  2. 打开 hello/example/linux/ 目录。
  3. 在询问以下内容时选择 您是否要配置项目“linux”?。这将允许 C++ 自动完成工作。

插件的 Linux 平台代码位于 flutter/ephemeral/.plugin_symlinks/hello/linux/

您可以使用 flutter run 运行示例应用程序。**注意:**在 Linux 上创建可运行的 Flutter 应用程序需要作为 flutter 工具一部分的步骤,因此即使您的编辑器提供 CMake 集成,以这种方式构建和运行也不会正常工作。

步骤 2e:添加 macOS 平台代码 (.swift)

#

我们建议您使用 Xcode 编辑 macOS 代码。

在 Xcode 中编辑 macOS 平台代码之前,请确保代码至少构建过一次(换句话说,从您的 IDE/编辑器运行示例应用程序,或在终端中执行 cd hello/example; flutter build macos --config-only)。

然后按照以下步骤操作:

  1. 启动 Xcode。
  2. 选择文件 > 打开,然后选择 hello/example/macos/Runner.xcworkspace 文件。

插件的 macOS 平台代码位于项目导航器中的 Pods/Development Pods/hello/../../example/macos/Flutter/ephemeral/.symlinks/plugins/hello/macos/Classes。(如果您使用的是 sharedDarwinSource,则路径将以 hello/darwin/Classes 结尾。)

您可以通过按下运行按钮 (▶) 运行示例应用程序。

步骤 2f:添加 Windows 平台代码 (.h+.cpp)

#

我们建议您使用 Visual Studio 编辑 Windows 代码。

在 Visual Studio 中编辑 Windows 平台代码之前,请确保代码至少构建过一次(换句话说,从您的 IDE/编辑器运行示例应用程序,或在终端中执行 cd hello/example; flutter build windows)。

然后按照以下步骤操作:

  1. 启动 Visual Studio。
  2. 选择 打开项目或解决方案 ,然后选择 hello/example/build/windows/hello_example.sln 文件。

插件的 Windows 平台代码位于解决方案资源管理器中的 hello_plugin/Source Fileshello_plugin/Header Files

您可以通过右键单击解决方案资源管理器中的 hello_example 并选择 设置为启动项目 ,然后按下运行按钮 (▶) 来运行示例应用程序。重要:在更改插件代码后,必须选择生成 > 生成解决方案才能再次运行,否则将运行过时的已构建插件副本,而不是包含您更改的最新版本。

步骤 2g:连接 API 和平台代码

#

最后,您需要将用 Dart 代码编写的 API 与特定于平台的实现连接起来。这是使用平台通道 或通过平台接口包中定义的接口来完成的。

在现有的插件项目中添加对平台的支持

#

要在现有的插件项目中添加对特定平台的支持,请再次使用 --template=plugin 标志在项目目录中运行 flutter create。例如,要在现有插件中添加 Web 支持,请运行:

flutter create --template=plugin --platforms=web .

如果此命令显示有关更新 pubspec.yaml 文件的消息,请按照提供的说明操作。

Dart 平台实现

#

在许多情况下,非 Web 平台实现仅使用特定于平台的实现语言,如上所示。但是,平台实现也可以使用特定于平台的 Dart。

仅 Dart 平台实现

#

在某些情况下,某些平台可以用 Dart 完全实现(例如,使用 FFI)。对于非 Web 平台上的仅 Dart 平台实现,请将 pubspec.yaml 中的 pluginClass 替换为 dartPluginClass。以下是上面为仅 Dart 实现修改的 hello_windows 示例:

yaml
flutter:
  plugin:
    implements: hello
    platforms:
      windows:
        dartPluginClass: HelloPluginWindows

在此版本中,您将没有 C++ Windows 代码,而是使用包含静态 registerWith() 方法的 HelloPluginWindows 类对 hello 插件的 Dart 平台接口类进行子类化。此方法在启动期间调用,可用于注册 Dart 实现:

dart
class HelloPluginWindows extends HelloPluginPlatform {
  /// 注册此类作为 [HelloPluginPlatform] 的默认实例。
  static void registerWith() {
    HelloPluginPlatform.instance = HelloPluginWindows();
  }

混合平台实现

#

平台实现也可以同时使用 Dart 和特定于平台的语言。例如,插件可以使用不同的平台通道针对每个平台,以便可以根据平台自定义通道。

混合实现使用上面描述的两个注册系统。以下是上面为混合实现修改的 hello_windows 示例:

yaml
flutter:
  plugin:
    implements: hello
    platforms:
      windows:
        dartPluginClass: HelloPluginWindows
        pluginClass: HelloPlugin

Dart HelloPluginWindows 类将使用仅 Dart 实现中显示的 registerWith(),而 C++ HelloPlugin 类将与仅 C++ 实现中的相同。

测试您的插件

#

我们鼓励您使用自动化测试测试您的插件,以确保在您更改代码时功能不会倒退。

要了解有关测试插件的更多信息,请查看测试插件。如果您正在为 Flutter 应用程序编写测试,并且插件导致崩溃,请查看插件测试中的 Flutter

开发 FFI 插件包

#

如果您想开发一个使用 Dart 的 FFI 调用原生 API 的包,则需要开发一个 FFI 插件包。

FFI 插件包和非 FFI 插件包都支持捆绑原生代码。但是,FFI 插件包不支持方法通道,但它们 确实 支持方法通道注册代码。要实现同时使用方法通道_和_ FFI 的插件,请使用非 FFI 插件。每个平台都可以使用 FFI 或非 FFI 平台。

步骤 1:创建包

#

要创建一个 FFI 插件包的启动器,请使用 flutter create 命令中的 --template=plugin_ffi 标志:

flutter create --template=plugin_ffi hello

这会在 hello 文件夹中创建一个 FFI 插件项目,其中包含以下专用内容:

lib: 定义插件 API 的 Dart 代码,以及使用 dart:ffi 调用原生代码的代码。

src: 原生源代码,以及用于将该源代码构建到动态库中的 CMakeLists.txt 文件。

平台文件夹 (androidioswindows 等):用于构建和捆绑原生代码的构建文件

库和平台应用程序。

步骤 2:构建和捆绑原生代码

#

pubspec.yaml 指定 FFI 插件如下:

yaml
  plugin:
    platforms:
      some_platform:
        ffiPlugin: true

此配置会调用各种目标平台的原生构建,并使用这些 FFI 插件在 Flutter 应用程序中捆绑二进制文件。

这可以与 dartPluginClass 组合使用,例如,当 FFI 用于联合插件中一个平台的实现时:

yaml
  plugin:
    implements: some_other_plugin
    platforms:
      some_platform:
        dartPluginClass: SomeClass
        ffiPlugin: true

插件可以同时具有 FFI 和方法通道:

yaml
  plugin:
    platforms:
      some_platform:
        pluginClass: SomeName
        ffiPlugin: true

FFI(和方法通道)插件调用的原生构建系统为:

  • 对于 Android:Gradle,它调用 Android NDK 进行原生构建。
    • 请参阅 android/build.gradle 中的文档。
  • 对于 iOS 和 macOS:Xcode,使用 CocoaPods。
    • 请参阅 ios/hello.podspec 中的文档。
    • 请参阅 macos/hello.podspec 中的文档。
  • 对于 Linux 和 Windows:CMake。
    • 请参阅 linux/CMakeLists.txt 中的文档。
    • 请参阅 windows/CMakeLists.txt 中的文档。

步骤 3:绑定到原生代码

#

要使用原生代码,需要在 Dart 中进行绑定。

为了避免手动编写这些绑定,它们是由 package:ffigen 从头文件 (src/hello.h) 生成的。有关如何安装此包的信息,请参考ffigen 文档

要重新生成绑定,请运行以下命令:

dart run ffigen --config ffigen.yaml

步骤 4:调用原生代码

#

非常短的原生函数可以直接从任何隔离区调用。例如,请参阅 lib/hello.dart 中的 sum

较长时间运行的函数应在辅助隔离区 上调用,以避免在 Flutter 应用程序中丢失帧。例如,请参阅 lib/hello.dart 中的 sumAsync

添加文档

#

建议为所有包添加以下文档:

  1. 一个 README.md 文件,介绍该包
  2. 一个 CHANGELOG.md 文件,记录每个版本的更改
  3. 一个包含包许可条款的LICENSE文件
  4. 所有公共 API 的 API 文档(有关详细信息,请参见下文)

API 文档

#

发布包时,会自动生成 API 文档并发布到 pub.dev/documentation。例如,请参阅device_info_plus 的文档。

如果您希望在本地开发机器上生成 API 文档,请使用以下命令:

  1. 更改到包所在的目录:

    cd ~/dev/mypackage
  2. 告诉文档工具 Flutter SDK 所在的位置(更改以下命令以反映您放置它的位置):

       export FLUTTER_ROOT=~/dev/flutter  # 在 macOS 或 Linux 上
    
       set FLUTTER_ROOT=~/dev/flutter     # 在 Windows 上
  3. 运行 `dart doc` 工具(包含在 Flutter SDK 中),如下所示:
       $FLUTTER_ROOT/bin/cache/dart-sdk/bin/dart doc   # 在 macOS 或 Linux 上
    
       %FLUTTER_ROOT%\bin\cache\dart-sdk\bin\dart doc  # 在 Windows 上

有关如何编写 API 文档的提示,请参阅有效的 Dart 文档

向 LICENSE 文件添加许可证

#

每个 LICENSE 文件中的各个许可证应在其自身行上用 80 个连字符隔开。

如果 LICENSE 文件包含多个组件许可证,则每个组件许可证必须以应用组件许可证的包的名称开头,每个包名称都在其自身行上,并且包名称列表与实际许可证文本之间用空行分隔。(包名称不必与 pub 包的名称匹配。例如,一个包本身可能包含来自多个第三方来源的代码,并且可能需要为每个第三方来源包含一个许可证。)

以下示例显示了一个组织良好的许可证文件:

package_1

<some license text>

--------------------------------------------------------------------------------
package_2

<some license text>

这是另一个组织良好的许可证文件的示例:

package_1

<some license text>

--------------------------------------------------------------------------------
package_1
package_2

<some license text>

这是一个组织不佳的许可证文件的示例:

<some license text>

--------------------------------------------------------------------------------
<some license text>

另一个组织不佳的许可证文件的示例:

package_1

<some license text>
--------------------------------------------------------------------------------
<some license text>

发布您的包

#

实现包后,您可以在pub.dev上发布它,以便其他开发人员可以轻松使用它。

在发布之前,请务必检查 pubspec.yamlREADME.mdCHANGELOG.md 文件,以确保其内容完整且正确。此外,为了提高包的质量和可用性(并使其更有可能获得 Flutter 收藏的状态),请考虑包含以下项目:

  • 多样的代码使用示例
  • 屏幕截图、动画 gif 或视频
  • 到相应代码存储库的链接

接下来,以 dry-run 模式运行发布命令以查看是否所有内容都通过了分析:

flutter pub publish --dry-run

下一步是发布到 pub.dev,但请确保您已准备好,因为发布是永久性的

flutter pub publish

有关发布的更多详细信息,请参阅 dart.dev 上的发布文档

处理包的相互依赖性

#

如果您正在开发一个依赖于另一个包公开的 Dart API 的包 hello,则需要将该包添加到 pubspec.yaml 文件的 dependencies 部分。以下代码使 url_launcher 插件的 Dart API 可用于 hello

yaml
dependencies:
  url_launcher: ^5.0.0

您现在可以在 hello 的 Dart 代码中 import 'package:url_launcher/url_launcher.dart'launch(someUrl)

这与您在 Flutter 应用程序或任何其他 Dart 项目中包含包的方式没有什么不同。

但是,如果 hello 恰好是一个 插件 包,其特定于平台的代码需要访问 url_launcher 公开的特定于平台的 API,则您还需要向特定于平台的构建文件中添加合适的依赖项声明,如下所示。

Android

#

以下示例在 hello/android/build.gradle 中设置 url_launcher 的依赖项:

groovy
android {
    // 跳过的行
    dependencies {
        compileOnly rootProject.findProject(":url_launcher")
    }
}

您现在可以 import io.flutter.plugins.urllauncher.UrlLauncherPlugin 并访问 hello/android/src 源代码中的 UrlLauncherPlugin 类。

有关 build.gradle 文件的更多信息,请参阅关于构建脚本的Gradle 文档

iOS

#

以下示例在 hello/ios/hello.podspec 中设置 url_launcher 的依赖项:

ruby
Pod::Spec.new do |s|
  # 跳过的行
  s.dependency 'url_launcher'

您现在可以 #import "UrlLauncherPlugin.h" 并访问 hello/ios/Classes 源代码中的 UrlLauncherPlugin 类。

有关 .podspec 文件的更多详细信息,请参阅CocoaPods 文档

Web

#

所有 Web 依赖项都由 pubspec.yaml 文件处理,就像任何其他 Dart 包一样。