Flutter 包介绍
Dart 组织和共享一组功能的方式是通过 Package。 Dart 包只是可共享的库或模块。 一般来说,Dart Package 与 Dart Application 的相同,只是 Dart Package 没有应用程序入口点 main。
包的一般结构(考虑一个演示包,my_demo_package)如下 -
- lib/src/* - 私有 Dart 代码文件。
- lib/my_demo_package.dart - 主要 Dart 代码文件。 它可以作为
import 'package:my_demo_package/my_demo_package.dart'
如有必要,可以将其他私有代码文件导出到主代码文件(my_demo_package.dart)中,如下所示 -
export src/my_private_code.dart
lib/* - 以任何自定义文件夹结构排列的任意数量的 Dart 代码文件。代码可以访问为,
import 'package:my_demo_package/custom_folder/custom_file.dart'
pubspec.yaml - 项目规范,与应用程序相同,
包中的所有 Dart 代码文件都是简单的 Dart 类,它对 Dart 代码没有任何特殊要求将其包含在包中。
包类型
由于 Dart 包基本上是一小部分类似功能的集合,因此可以根据其功能进行分类。
Dart 包
通用 Dart 代码,可用于 Web 和移动环境。例如,english_words 就是这样一个包,它包含大约 5000 个单词并具有基本的实用功能,如名词(英语中的名词列表)、音节(指定单词中的音节数)。
Flutter 包
通用 Dart 代码,依赖于 Flutter 框架,只能在移动环境中使用。例如,fluro 是 Flutter 的自定义路由器。这取决于 Flutter 框架。
Flutter 插件
通用 Dart 代码,依赖于 Flutter 框架以及底层平台代码(Android SDK 或 iOS SDK)。例如,相机是一个与设备相机交互的插件。它依赖于 Flutter 框架以及底层框架来访问相机。
使用 Dart 包
Dart 包被托管并发布到实时服务器 https://pub.dartlang.org
。此外,Flutter 提供了简单的工具 pub 来管理应用程序中的 Dart 包。用作包所需的步骤如下
在 pubspec.yaml 中包含包名称和所需的版本,如下所示 -
dependencies: english_words: ^3.1.5
最新版本号可通过在线服务器查询。
使用以下命令将包安装到应用程序中 -
$ flutter packages get
在 Android Studio 中开发时,Android Studio 会检测到 pubspec.yaml 中的任何更改,并向开发人员显示 Android Studio 包警报,如下所示
可以使用菜单选项在 Android Studio 中安装或更新 Dart 包。
使用如下所示的命令导入必要的文件并开始工作 -
import 'package:english_words/english_words.dart';
使用包中可用的任何方法,
nouns.take(50).forEach(print);
在这里,我们使用了名词函数来获取和打印前 50 个单词。
开发 Flutter 插件包
开发 Flutter 插件类似于开发 Dart 应用程序或 Dart 包。唯一的例外是插件将使用系统 API(Android 或 iOS)来获得所需的平台特定功能。
由于我们在前面的章节中已经学习了如何访问平台代码,让我们开发一个简单的插件 my_browser 来了解插件开发过程。my_browser 插件的功能是允许应用程序在特定平台的浏览器中打开给定的网站。
启动 Android Studio。
点击File → New Flutter Project并选择 Flutter Plugin 选项。
您可以看到如下所示的 Flutter 插件选择窗口 -
输入 my_browser 作为项目名称,然后单击下一步。
在窗口中输入插件名称和其他详细信息,如下所示 -
在下一步的窗口中输入 company 域 flutterplugins.jiyik.com,然后单击Finish。它将生成一个启动代码来开发我们的新插件。
打开 my_browser.dart 文件并编写一个方法 openBrowser 来调用平台特定的 openBrowser 方法。
Future<void> openBrowser(String urlString) async {
try {
final int result = await _channel.invokeMethod(
'openBrowser', <String, String>{ 'url': urlString }
);
}
on PlatformException catch (e) {
// Unable to open the browser print(e);
}
}
打开 MyBrowserPlugin.java 文件并导入以下类 -
import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
在这里,我们必须导入从 Android 打开浏览器所需的库。
在 MyBrowserPlugin 类中添加 Registrar 类型的新私有变量 mRegistrar。
private final Registrar mRegistrar;
在这里,Registrar 用于获取调用代码的上下文信息。
在 MyBrowserPlugin 类中添加一个构造函数来设置 Registrar。
private MyBrowserPlugin(Registrar registrar) {
this.mRegistrar = registrar;
}
更改 registerWith 以在 MyBrowserPlugin 类中包含我们的新构造函数。
public static void registerWith(Registrar registrar) {
final MethodChannel channel = new MethodChannel(registrar.messenger(), "my_browser");
MyBrowserPlugin instance = new MyBrowserPlugin(registrar);
channel.setMethodCallHandler(instance);
}
更改 onMethodCall
以在 MyBrowserPlugin 类中包含 openBrowser 方法。
@Override
public void onMethodCall(MethodCall call, Result result) {
String url = call.argument("url");
if (call.method.equals("getPlatformVersion")) {
result.success("Android " + android.os.Build.VERSION.RELEASE);
}
else if (call.method.equals("openBrowser")) {
openBrowser(call, result, url);
} else {
result.notImplemented();
}
}
在 MyBrowserPlugin
类中编写平台特定的 openBrowser 方法来访问浏览器。
private void openBrowser(MethodCall call, Result result, String url) {
Activity activity = mRegistrar.activity();
if (activity == null) {
result.error("ACTIVITY_NOT_AVAILABLE",
"Browser cannot be opened without foreground activity", null);
return;
}
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setData(Uri.parse(url));
activity.startActivity(intent);
result.success((Object) true);
}
my_browser 插件的完整源代码如下 -
my_browser.dart
import 'dart:async'; import 'package:flutter/services.dart'; class MyBrowser { static const MethodChannel _channel = const MethodChannel('my_browser'); static Future<String> get platformVersion async { final String version = await _channel.invokeMethod('getPlatformVersion'); return version; } Future<void> openBrowser(String urlString) async { try { final int result = await _channel.invokeMethod( 'openBrowser', <String, String>{'url': urlString}); } on PlatformException catch (e) { // Unable to open the browser print(e); } } }
MyBrowserPlugin.java
package com.tutorialspoint.flutterplugins.my_browser; import io.flutter.plugin.common.MethodCall; import io.flutter.plugin.common.MethodChannel; import io.flutter.plugin.common.MethodChannel.MethodCallHandler; import io.flutter.plugin.common.MethodChannel.Result; import io.flutter.plugin.common.PluginRegistry.Registrar; import android.app.Activity; import android.content.Intent; import android.net.Uri; import android.os.Bundle; /** MyBrowserPlugin */ public class MyBrowserPlugin implements MethodCallHandler { private final Registrar mRegistrar; private MyBrowserPlugin(Registrar registrar) { this.mRegistrar = registrar; } /** Plugin registration. */ public static void registerWith(Registrar registrar) { final MethodChannel channel = new MethodChannel( registrar.messenger(), "my_browser"); MyBrowserPlugin instance = new MyBrowserPlugin(registrar); channel.setMethodCallHandler(instance); } @Override public void onMethodCall(MethodCall call, Result result) { String url = call.argument("url"); if (call.method.equals("getPlatformVersion")) { result.success("Android " + android.os.Build.VERSION.RELEASE); } else if (call.method.equals("openBrowser")) { openBrowser(call, result, url); } else { result.notImplemented(); } } private void openBrowser(MethodCall call, Result result, String url) { Activity activity = mRegistrar.activity(); if (activity == null) { result.error("ACTIVITY_NOT_AVAILABLE", "Browser cannot be opened without foreground activity", null); return; } Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(Uri.parse(url)); activity.startActivity(intent); result.success((Object) true); } }
创建一个新项目my_browser_plugin_test来测试我们新创建的插件。
打开 pubspec.yaml 并将 my_browser 设置为插件依赖项。
dependencies:
flutter:
sdk: flutter
my_browser:
path: ../my_browser
Android Studio 将提醒 pubspec.yaml 已更新,如下面的 Android Studio 包警报所示 -
单击获取依赖项选项。Android Studio 将从 Internet 获取包并为应用程序正确配置它。
打开 main.dart 并包含 my_browser 插件,如下所示 -
import 'package:my_browser/my_browser.dart';
从 my_browser 插件调用 openBrowser 函数,如下所示 -
onPressed: () => MyBrowser().openBrowser("https://flutter.dev"),
main.dart 的完整代码如下 -
import 'package:flutter/material.dart';
import 'package:my_browser/my_browser.dart';
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(
title: 'Flutter Demo Home Page'
),
);,
}
}
class MyHomePage extends StatelessWidget {
MyHomePage({Key key, this.title}) : super(key: key);
final String title;
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text(this.title),
),
body: Center(
child: RaisedButton(
child: Text('Open Browser'),
onPressed: () => MyBrowser().openBrowser("https://flutter.dev"),
),
),
);
}
}
运行应用程序并单击 Open Browser 按钮,可以看到浏览器已启动。您可以看到一个浏览器应用程序 - 主页,如下图所示 -
我们可以看到一个浏览器应用程序 - 浏览器屏幕,如下图所示