[Flutter]创建一个私有包并使用

2024-05-06 20:12
文章标签 使用 创建 私有 flutter 包并

本文主要是介绍[Flutter]创建一个私有包并使用，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

在Flutter中创建一个自己的私有组件（通常称为包或库），并通过Dart的包管理工具pub进行使用。

一、创建一个新的Flutter包

1.使用命令行创建

使用Flutter命令行工具来创建一个新的包：

$ flutter create --template=package my_private_package

这将创建一个名为my_private_package的新目录，其中包含Dart的包标准结构。

2.使用Android Studio创建

New Flutter Project -> 选择项目类型为“Package”

3.默认项目结构

默认文件和单元测试

 

LICENSE & CHANGELOG.md

pubspec.yaml

name: my_private_package
description: "A new Flutter project."
version: 0.0.1
homepage:environment:sdk: '>=3.3.3 <4.0.0'flutter: ">=1.17.0"dependencies:flutter:sdk: flutterdev_dependencies:flutter_test:sdk: flutterflutter_lints: ^3.0.0# For information on the generic Dart part of this file, see the
# following page: https://dart.dev/tools/pub/pubspec# The following section is specific to Flutter packages.
flutter:# To add assets to your package, add an assets section, like this:# assets:#   - images/a_dot_burr.jpeg#   - images/a_dot_ham.jpeg## For details regarding assets in packages, see# https://flutter.dev/assets-and-images/#from-packages## An image asset can refer to one or more resolution-specific "variants", see# https://flutter.dev/assets-and-images/#resolution-aware# To add custom fonts to your package, add a fonts section here,# in this "flutter" section. Each entry in this list should have a# "family" key with the font family name, and a "fonts" key with a# list giving the asset and other descriptors for the font. For# example:# fonts:#   - family: Schyler#     fonts:#       - asset: fonts/Schyler-Regular.ttf#       - asset: fonts/Schyler-Italic.ttf#         style: italic#   - family: Trajan Pro#     fonts:#       - asset: fonts/TrajanPro.ttf#       - asset: fonts/TrajanPro_Bold.ttf#         weight: 700## For details regarding fonts in packages, see# https://flutter.dev/custom-fonts/#from-packages

 README.md

<!--
This README describes the package. If you publish this package to pub.dev,
this README's contents appear on the landing page for your package.For information about how to write a good package README, see the guide for
[writing package pages](https://dart.dev/guides/libraries/writing-package-pages).For general information about developing packages, see the Dart guide for
[creating packages](https://dart.dev/guides/libraries/create-library-packages)
and the Flutter guide for
[developing packages and plugins](https://flutter.dev/developing-packages).
-->TODO: Put a short description of the package here that helps potential users
know whether this package might be useful for them.## FeaturesTODO: List what your package can do. Maybe include images, gifs, or videos.## Getting startedTODO: List prerequisites and provide or point to information on how to
start using the package.## UsageTODO: Include short and useful examples for package users. Add longer examples
to `/example` folder.```dart
const like = 'sample';
```## Additional informationTODO: Tell users more about the package: where to find more information, how to
contribute to the package, how to file issues, what response they can expect
from the package authors, and more.

二、配置pubspec.yaml

pubspec.yaml 文件是 Dart 和 Flutter 项目的核心配置文件，用于管理项目的依赖、版本、元数据等。

具体解释参见另一文：[Flutter]配置pubspec.yaml-CSDN博客

三、开发

1.是否需要使用library 指令？

我们创建的package项目文件中，默认文件中有使用如下的library指令。下面介绍一下，这个指令到底是否必要？

library my_private_package;

在 Flutter 或 Dart 的包开发中，关于使用 library 指令的需要并不是强制性的，而是可选的。在很多情况下，特别是在现代 Flutter 开发实践中，通常不需要显式地使用 library 指令。下面是一些关于何时以及如何使用 library 指令的指导：

(1).不使用 library 指令

对于大多数 Flutter 应用和包，你实际上不需要使用 library 指令。每个 Dart 文件默认都是一个库，即使没有显式声明。你可以直接在文件中定义类、函数和其他顶级声明，而不需要首先声明一个库。

(2).使用场景

library 指令主要用于以下几个特定场景：

  • 文档生成：如果你希望为整个库提供文档注释，那么可以使用 library 指令来定义一个库，并在它之前添加文档注释。
  • 部分指令：如果你需要将一个库分割成多个部分文件，你可以使用 library 和 part 指令。这种情况下，主文件应该有一个 library 指令，而其他文件则使用 part of 指令。但是，这种做法在 Flutter 中较少使用，因为 import 和 export 通常更加方便和灵活。

示例

假设你正在创建一个包含多个部分的库，你可能会这样做：

// lib/my_private_package.dart
library my_private_package;part 'src/part1.dart';
part 'src/part2.dart';// lib/src/part1.dart
part of my_private_package;// lib/src/part2.dart
part of my_private_package;

(3).现代 Flutter 开发建议

在现代 Flutter 开发中，推荐使用 import 和 export 来组织和重用代码，而不是使用 library 和 part。这样做的好处包括更好的封装性、更清晰的依赖管理和避免命名空间问题。

2.自定义组件

进入这个包的目录，开发你需要的功能。例如，你可以在lib目录中添加Flutter widgets、类等。

示例，创建一个的自定义组件。

import 'package:flutter/material.dart';class GATagetView extends StatelessWidget {const GATagetView({super.key});@overrideWidget build(BuildContext context) {return Scaffold(backgroundColor: Colors.red, // 页面的背景颜色resizeToAvoidBottomInset: false, // 防止键盘弹出时推动背景内容向上移动appBar: AppBar(backgroundColor: Colors.blue, // 导航栏的背景颜色iconTheme: const IconThemeData(color: Colors.white, // 导航栏返回按钮颜色),title: const Text("Taget",style: TextStyle(fontSize: 21,fontWeight: FontWeight.bold,color: Colors.white, // 导航栏标题文字颜色),),),body: Container(decoration: const BoxDecoration(color: Colors.white,// image: DecorationImage(//   image: AssetImage(Assets.images.iconBg.path),//   fit: BoxFit.cover, // 使图片铺满整个屏幕// ),),child: SizedBox(width: double.infinity,height: double.infinity,child: SingleChildScrollView(child: Padding(padding: const EdgeInsets.all(10),child: Text(termsOfUseText(),textAlign: TextAlign.left,style: const TextStyle(color: Colors.black,fontSize: 14.0,fontWeight: FontWeight.normal,decoration: TextDecoration.none,),),),),),));}String termsOfUseText() {String str = """Terms of Use......""";return str;}
}

四、测试

在 Flutter 开发中，创建和测试自定义组件是一个常见的需求。当开发私有包时，尤其是包含自定义组件的包，你会希望能够实时预览和调试这些组件。以下是一些有效的方法来预览和调试 Flutter 中的自定义组件：

1.使用示例应用

最常见的方法是在同一个项目中创建一个示例应用。这种方法很直接，也很易于设置：

  • 创建标准的 Flutter 应用：cd到你的包的根目录，创建一个 example 文件夹，并在这个文件夹中初始化一个新的 Flutter 应用（使用 flutter create example 命令）。

$ flutter create example

  • 依赖本地包：在示例应用的 pubspec.yaml 中添加对本地包的依赖。例如：

dependencies:my_private_package:path: ../

  • 使用自定义组件：在示例应用中，你可以直接使用自定义包中的组件，然后运行示例应用来预览和调试这些组件。

实例:

import 'package:my_private_package/ga_taget_view.dart';TextButton(onPressed: (){Navigator.of(context).push(MaterialPageRoute(builder: (BuildContext context) {return const GATagetView();}));
}, child: const Text("跳转", style: TextStyle(color: Colors.blue),))

​

2.使用 Hot Reload

利用 Flutter 的 Hot Reload 功能，你可以在进行代码更改后迅速看到效果，这对于调试和迭代开发非常有用。只需在示例应用中运行你的组件，每次更改后都可以立即看到更新。

3.使用 DartPad

如果组件不依赖于任何特定的第三方包或项目特定的设置，你可以使用 DartPad 在线预览和测试 Flutter 组件。DartPad 是一个在线的 Dart 和 Flutter 编辑器，支持即时预览。

4.单元测试和组件测试

详细介绍参考：https://blog.csdn.net/wsyx768/article/details/138487007

除了视觉预览，确保组件的功能和性能符合预期是非常重要的。你可以写单元测试和组件测试（widget tests）来验证组件的行为：

  • 单元测试：测试小块的代码逻辑。

  • 组件测试：测试 Flutter 组件的 UI 行为。使用 testWidgets 函数来模拟用户交互和检查 UI 输出。

import 'package:flutter_test/flutter_test.dart';
import 'package:my_custom_package/my_custom_widget.dart';void main() {testWidgets('My Custom Widget Test', (WidgetTester tester) async {await tester.pumpWidget(MyCustomWidget());// 进行各种断言和交互expect(find.text('Some Text'), findsOneWidget);});
}

5.使用可视化调试工具

官方使用文档：https://docs.flutter.dev/tools/devtools

仓库地址：https://github.com/flutter/devtools

版本记录：https://docs.flutter.dev/tools/devtools/release-notes

使用 Flutter 的 DevTools 进行调试。DevTools 提供了性能视图、小部件检查器、内存和网络分析工具等，可以帮助你更深入地了解你的组件和应用的运行情况。

Flutter DevTools 是一个强大的调试工具套件，它帮助开发者理解和优化他们的 Flutter 应用。DevTools 提供了多个工具来调查布局问题、性能瓶颈、内存泄漏等。以下是如何使用 Flutter DevTools 进行调试的详细步骤：

(1).启动 DevTools

首先，确保你已经安装了 Flutter 和 Dart 插件。可以通过以下步骤启动 DevTools：

  • 启动你的应用：使用命令行或者你的 IDE 启动 Flutter 应用。
  • 检查 DevTools 版本: 在命令行中，可以通过运行 $ dart devtools --version 检查您当前的 DevTools 版本。
  • 从 Android Studio 运行 DevTools: https://docs.flutter.dev/tools/devtools/android-studio

  • 从命令行运行 DevTools: https://docs.flutter.dev/tools/devtools/cli

  •  从 VS Code 运行 DevTools: https://docs.flutter.dev/tools/devtools/vscode

 

Open DevTools in Web Browser:

 

(2).DevTools 的主要功能

DevTools 包括多个工具，每个工具都专注于不同的调试方面：

A.Inspector（检查器）
  • 用途：检查和可视化 UI 布局和树状结构。
  • 功能：可以选择任何 widget 并查看其详细属性。这对于理解和调试布局问题非常有用。
B.Timeline（时间线）
  • 用途：分析应用的帧率和性能。
  • 功能：记录并查看应用的 UI 和 GPU 线程的时间线，帮助识别帧延迟的原因。
C.Memory（内存）
  • 用途：监控和分析应用的内存使用情况。
  • 功能：查看内存图表，并进行内存快照，可以帮助找到内存泄漏。
D.Network（网络）
  • 用途：监视应用中的 HTTP 请求。
  • 功能：记录和查看发送的请求，包括请求和响应的详情，非常适合调试网络问题。
E.Performance（性能）
  • 用途：更深入地分析应用性能。
  • 功能：提供 CPU 分析器和性能图表，帮助识别热点函数和性能瓶颈。
F.Debugger（调试器）
  • 用途：逐行执行代码。
  • 功能：设置断点，查看调用堆栈，执行代码。
G.Logging（日志）
  • 用途：查看应用产生的各种日志。
  • 功能：显示 print 输出、框架日志、垃圾回收日志等。

(3).使用 DevTools 进行调试

  • 连接应用：启动 DevTools 后，你需要将其连接到正在运行的 Flutter 应用。如果是通过命令行启动，通常需要在 DevTools 的浏览器界面中输入你的应用的 URI。
  • 选择工具：根据你的调试需求，选择相应的 DevTools 工具。
  • 交互和分析：使用 DevTools 提供的功能进行交互，收集并分析数据，根据分析结果调整和优化你的代码。

五、发布

你可以选择以下几种方式来发布你的包

1.私有Git仓库

  • 将你的包推送到一个私有的Git仓库（例如GitHub, GitLab, Bitbucket等）。
  • 确保你的pubspec.yaml文件里没有敏感信息。

2.本地路径

  • 对于局部或者仅在特定项目中使用，你可以通过本地路径来依赖包。
dependencies:my_private_package:path: ../my_private_package

3.私有Pub服务器

  • 你可以搭建一个私有的Pub服务器，但这需要额外的配置和服务器管理。

4.发布成为公开的包

发布一个公开的 Flutter 或 Dart 包主要涉及将其发布到 Dart 的包管理系统 —— pub.dev。这是 Dart 和 Flutter 社区的中央包仓库，类似于 Node.js 的 npm 或 Python 的 PyPI。下面是发布公开包的基本步骤：

(1).准备你的包

首先，确保你的包满足以下基本要求：

  • pubspec.yaml: 包含所有必要信息，如版本号、描述、依赖等。
  • README.md: 描述包的用途、安装方法、如何使用等。
  • CHANGELOG.md: 记录包的每个版本的变更。
  • LICENSE: 包含开源许可证的文件（例如 MIT、BSD、Apache 等）。

确保代码质量良好，有适当的注释和文档，同时最好有单元测试。

(2).检查包的健康状况

使用 Dart 的 pub 工具来分析你的包，确保没有警告或错误：

$ dart pub publish --dry-run

这个命令会执行一个预发布检查，不会真正发布包，但会告诉你是否有什么问题需要解决。

使用publish命令时，需要先将publish_to配置移除。

name: flutter_test_application
description: "A new Flutter project."# 以下行可防止包被意外发布到
# pub.dev 使用 `flutter pub publish`。 这是私有包的首选。
publish_to: 'none' # 如果您想发布到 pub.dev，请删除此行

(3).发布包

一旦你的包准备好并通过了预检，你可以使用以下命令来发布它：

$ dart pub publish

在执行这个命令时，将会要求你登录到你的 Google 账户（如果还没有登录的话），因为 pub.dev 使用 Google 账户进行身份验证。

(4).管理和维护

一旦你的包发布到 pub.dev，你需要对它进行管理和维护。这包括处理用户的问题、修复 bug、更新文档和发布新版本。

确保遵循语义版本控制规则更新你的包版本。当你做出修改并希望发布新版本时，你需要更新 pubspec.yaml 文件中的版本号，更新 CHANGELOG.md 文件，然后再次运行 dart pub publish。

六、在项目中使用你的包

在其他Flutter项目中，你可以通过以下方式之一添加依赖：

1.Git依赖

pubspec.yaml中添加依赖后，运行$ flutter pub get来安装包。

dependencies:my_private_package:git:url: git@github.com:yourusername/my_private_package.gitref: main

使用实例：

import 'package:my_private_package/ga_taget_view.dart';TextButton(onPressed: (){Navigator.of(context).push(MaterialPageRoute(builder: (BuildContext context) {return const GATagetView();}));
}, child: const Text("跳转", style: TextStyle(color: Colors.blue),))

2.路径依赖（如果包在本地）

在项目的pubspec.yaml中添加了依赖，运行$ flutter pub get来安装包。

(1).使用绝对路径

你需要根据你的系统环境确定完整的路径。例如，如果你的用户目录是 /Users/yourusername，则配置应如下所示：

dependencies:my_private_package:path: /Users/yourusername/documents/my_private_package

(2).使用相对路径

如果你的私有包位于与你的 Flutter 项目相对较近的位置，你也可以使用相对路径。例如，如果你的 Flutter 项目和 my_private_package 都在同一个父目录下，你可以这样配置：

dependencies:my_private_package:path: ../my_private_package

 注意：不能使用~/documents/my_private_package这种格式来指代目录。虽然 ~ 在许多命令行环境中通用（指代用户的主目录），但在 pubspec.yaml 文件中，Flutter 不解析 ~ 为主目录。

之后，你就可以在你的Flutter应用中导入并使用这个包了。

import 'package:my_private_package/ga_taget_view.dart';TextButton(onPressed: (){Navigator.of(context).push(MaterialPageRoute(builder: (BuildContext context) {return const GATagetView();}));
}, child: const Text("跳转", style: TextStyle(color: Colors.blue),))

这篇关于[Flutter]创建一个私有包并使用的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/965267。

相关文章

中文分词jieba库的使用与实景应用（一）

中文分词jieba库的使用与实景应用（一）

知识星球：https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义： 精确模式（默认模式）： 全模式： 搜索引擎模式： paddle 模式（基于深度学习的分词模式）： 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取
阅读更多...
使用SecondaryNameNode恢复NameNode的数据

使用SecondaryNameNode恢复NameNode的数据

1）需求： NameNode进程挂了并且存储的数据也丢失了，如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2）故障模拟 （1）kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 （2）删除NameNode存储的数据（/opt/module/hadoop-3.1.4/data/tmp/dfs/na
阅读更多...
Hadoop数据压缩使用介绍

Hadoop数据压缩使用介绍

一、压缩原则 （1）运算密集型的Job，少用压缩 （2）IO密集型的Job，多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1）为了支持多种压缩/解压缩算法，Hadoop引入了编码/解码器 2）要在Hadoop中启用压缩，可以配置如下参数
阅读更多...
Makefile简明使用教程

Makefile简明使用教程

文章目录 规则makefile文件的基本语法：加在命令前的特殊符号：.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具，常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件
阅读更多...
使用opencv优化图片（画面变清晰）

使用opencv优化图片（画面变清晰）

文章目录 需求影响照片清晰度的因素 实现降噪测试代码 锐化空间锐化Unsharp Masking频率域锐化对比测试 对比度增强常用算法对比测试 需求 对图像进行优化，使其看起来更清晰，同时保持尺寸不变，通常涉及到图像处理技术如锐化、降噪、对比度增强等 影响照片清晰度的因素 影响照片清晰度的因素有很多，主要可以从以下几个方面来分析 1. 拍摄设备 相机传感器：相机传
阅读更多...
【Python编程】Linux创建虚拟环境并配置与notebook相连接

【Python编程】Linux创建虚拟环境并配置与notebook相连接

1.创建 使用 venv 创建虚拟环境。例如，在当前目录下创建一个名为 myenv 的虚拟环境： python3 -m venv myenv 2.激活 激活虚拟环境使其成为当前终端会话的活动环境。运行： source myenv/bin/activate 3.与notebook连接 在虚拟环境中，使用 pip 安装 Jupyter 和 ipykernel： pip instal
阅读更多...
pdfmake生成pdf的使用

pdfmake生成pdf的使用

实际项目中有时会有根据填写的表单数据或者其他格式的数据，将数据自动填充到pdf文件中根据固定模板生成pdf文件的需求 文章目录 利用pdfmake生成pdf文件1.下载安装pdfmake第三方包2.封装生成pdf文件的共用配置3.生成pdf文件的文件模板内容4.调用方法生成pdf 利用pdfmake生成pdf文件 1.下载安装pdfmake第三方包 npm i pdfma
阅读更多...
零基础学习Redis(10) -- zset类型命令使用

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合，内部除了存储元素外，还会存储一个score，存储在zset中的元素会按照score的大小升序排列，不同元素的score可以重复，score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]
阅读更多...
在cscode中通过maven创建java项目

在cscode中通过maven创建java项目

在cscode中创建java项目 可以通过博客完成maven的导入 建立maven项目 使用快捷键 Ctrl + Shift + P 建立一个 Maven 项目 1 Ctrl + Shift + P 打开输入框2 输入 "> java create"3 选择 maven4 选择 No Archetype5 输入 域名6 输入项目名称7 建立一个文件目录存放项目，文件名一般为项目名8 确定
阅读更多...
git使用的说明总结

git使用的说明总结

Git使用说明 下载安装(下载地址) macOS: Git - Downloading macOS Windows: Git - Downloading Windows Linux/Unix: Git (git-scm.com) 创建新仓库 本地创建新仓库：创建新文件夹，进入文件夹目录，执行指令 git init ，用以创建新的git 克隆仓库 执行指令用以创建一个本地仓库的
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2