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 是 Fl​​utter 的自定义路由器。这取决于 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 包警报,如下所示

flutter package alert

可以使用菜单选项在 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 插件选择窗口 -

flutter plugin

输入 my_browser 作为项目名称,然后单击下一步。

在窗口中输入插件名称和其他详细信息,如下所示 -

配置新的 Flutter 插件

在下一步的窗口中输入 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 包警报所示 -

flutter android studio package alert

单击获取依赖项选项。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 按钮,可以看到浏览器已启动。您可以看到一个浏览器应用程序 - 主页,如下图所示 -

flutter open browser

我们可以看到一个浏览器应用程序 - 浏览器屏幕,如下图所示

Flutter 基础设施

查看笔记

扫码一下
查看教程更方便