深海游弋的鱼 – 默默的点滴

OpenBB的介绍以及如何使用OpenBB助力A股港股的金融数据分析

OpenBB 是一个开源的金融数据平台，旨在为投资者、分析师、研究人员和开发者提供免费、透明且易于使用的金融与宏观经济数据访问接口。它曾被认为是类似于彭博终端（Bloomberg Terminal）的功能性替代品，但完全开放源码，用户可以自由定制和扩展。

在一些文章中将 OpenBB 解释为 Open Bloomberg，这是个误解。尽管它常被视为“开源版彭博终端”，但其名称中的“BB”实际上源自黑莓公司的股票代码，而 OpenBB 的创始人此前曾在黑莓股票上亏损。

📜 OpenBB 的历史背景

OpenBB 的前身是由 Didier Lopes 在 2021 年创建的开源项目 Gamestonk Terminal。2021 年 3 月，Gamestonk Terminal 1.0 版本正式发布，凭借其独特的功能和开源特性，迅速在市场上崭露头角，并于同年成功获得第一笔风险投资。基于该项目的良好发展态势，新公司于 2022 年正式成立，并将公司和项目更名为 OpenBB。

请参考创始人Didier Lopes的这篇文章 GME didn’t take me to the moon, but Gamestonk terminal did。

OpenBB的发展时间线如下:

2020 年第四季度：Didier 开启 Gamestonk Terminal 的开发之旅
2021 年第一季度：Gamestonk Terminal 正式上线
2021 年第二季度：Joeseph Jacks 与开发团队展开合作洽谈
2021 年第三季度：OpenBB 项目宣告成立
2021 年第四季度：获得 850 万美元的初始投资
2022 年第一季度：OpenBB 正式发布

从 Gamestonk Terminal 到 OpenBB Terminal，其产品开发思路与传统金融终端类似，是一款集成众多数据源的开源金融终端产品。和著名的 Bloomberg Terminal 一样，OpenBB Terminal 对不同数据源的数据进行了抽象化和标准化处理，这种特性显著提升了金融分析从业人员的工作效率，也使得 OpenBB Terminal 在短时间内吸引了大量用户。

OpenBB Platform

随着 OpenBB Terminal 的用户规模不断扩大，项目团队面临着巨大的维护压力。正如创始人 Didier Lopes 在文章中提到，维护这个免费开源终端，包括添加数据集、处理 500 多个 Python 包依赖项以及应对数据源端点更新等工作，所投入的资源对于初创公司来说难以持续。

关于停止 OpenBB Terminal 的开发决定，请参考文章 Sunsetting OpenBB Terminal: Why, How, and What now?。

在实际金融数据分析中，投资者往往面临复杂的数据获取问题。例如，多元化投资者的资产可能涉及多个币种和股票市场，需要从不同数据源收集数据并进行计算，这一过程不仅耗时，而且重复性高。虽然可以通过编写 Python 脚本来自动拉取数据，但随着时间推移，会遇到数据源接口变更和数据需求多样化的难题。

基于这些问题，OpenBB 开发团队重新审视产品价值，决定在 2024 年一季度发布 OpenBB Platform 取代 OpenBB Terminal。OpenBB Platform 专注于金融数据的抽象化和标准化，开发者能够自由添加所需数据源。以查询历史股价为例，无论选择哪种数据源，都可使用统一接口：

from openbb import obb
prices = obb.equity.price.historical(symbol='000002', start_date="2025-05-01", end_date="2025-05-30", provider="yfinance")

1 2	from openbb import obb prices = obb.equity.price.historical(symbol='000002', start_date="2025-05-01", end_date="2025-05-30", provider="yfinance")

用户可以根据自身需求，灵活选择默认或指定的数据源，无论是免费还是付费的数据源都能适配。

随着产品升级，OpenBB 的用户界面也进化为 OpenBB Platform CLI，它结合了命令行工具和 WebView，为调用 OpenBB API 提供了便捷环境。在命令行中查询股价历史的示例命令如下：

2025 Jun 25, 21:35 (🦋) /equity/price/ $ historical --symbol 000002 --provider akshare --start_date 2025-05-01 --end_date 2025-05-30

1	2025 Jun 25, 21:35 (🦋) /equity/price/ $ historical --symbol 000002 --provider akshare --start_date 2025-05-01 --end_date 2025-05-30

执行该命令后，WebView 会展示查询结果。

OpenBB Workspace

OpenBB Platform CLI 更适合开发者和具备编程能力的金融分析人员，而对于企业用户，OpenBB 团队推出了 OpenBB Workspace 解决方案，也被称为 OpenBB Terminal Pro。它虽然并非全开源产品，但有望为团队带来收益，目前是 OpenBB 团队的主要开发方向。

通过参考 OpenBB 官方文章中的架构图（整合了 2024 年 3 月及后续关于私有化部署和 AI 集成的示意图），可以清晰了解其产品定义。

关于这个架构图，参考下面这篇文章 Exploring the architecture behind the OpenBB Platform

开源的 OpenBB Platform 是金融分析应用的基础，在此之上，前端部分不断发展。从 2025 年 6 月起，OpenBB Bot 转由 Unusual Whales 运营，OpenBB Workspace 也转变为基于 AI 的可定制方案。企业用户能够基于 OpenBB Platform 和自身数据，将 OpenBB Workspace 定制为兼具金融终端功能和 AI 能力的专属金融分析平台，相比传统昂贵的金融终端，具有显著优势。为增强灵活性和可定制性，OpenBB 开源了 OpenBB Workspace 的后端和 AI Agent 的集成部分，除用户界面组件外，数据集成方案和 OpenBB Copilot 都支持定制。

OpenBB Workspace Backend
https://github.com/OpenBB-finance/backends-for-openbb

OpenBB Agents
https://github.com/OpenBB-finance/agents-for-openbb

OpenBB与AI的集成

OpenBB 针对企业用户和开发者，分别提供了不同的 AI 使用方式，其与 AI 的集成主要体现在以下两个层面：

OpenBB Platform - LLM Friendly Mode：专为开发者设计的集成方法
OpenBB Workspace - OpenBB Copilot：主要面向企业用户的使用方式

LLM Friendly Mode

在 API 层面，OpenBB Platform 的 LLM 友好模式，极大地降低了开发者将 OpenBB 数据模型集成到 AI 应用中的难度。OpenBB 开放的函数接口能够轻松转换为 LLM 的函数调用，官方提供的示例代码如下：

from magentic import prompt_chain, FunctionCall, OpenaiChatModel

@prompt_chain(
"You are a helpful financial agent that can use function calling to retrieve data.\nUser Query: {query}",
functions=[obb.equity.price.quote],
model=OpenaiChatModel(model="gpt-4-turbo-preview")
)
def llm(query: str) -> FunctionCall | str: ...

r = llm(query="What is the current stock price of AAPL?")
r

from magentic import prompt_chain, FunctionCall, OpenaiChatModel

@prompt_chain(

"You are a helpful financial agent that can use function calling to retrieve data.\nUser Query: {query}",

functions=[obb.equity.price.quote],

model=OpenaiChatModel(model="gpt-4-turbo-preview")

)

def llm(query: str) -> FunctionCall | str: ...

r = llm(query="What is the current stock price of AAPL?")

上述代码创建了一段 LLM 对话，并将 OpenBB 的股价查询函数obb.equity.price.quote作为 LLM 的函数调用，方便快捷地实现数据获取。

OpenBB Copilot

对于企业用户而言，OpenBB Workspace 提供的 OpenBB Copilot 功能十分实用。用户可以依据当前仪表板内容，借助 AI 进行深度分析。例如，在查看辽港股份资料后，通过 OpenBB Copilot 获取 2025 年投资建议，其分析结果和行业对比总结具有较高的参考价值。

上图中，使用的 Equity Template 模板在查询中国股市数据时存在部分空白项，如当前股票新闻、收入分析等。从辽港股份股票代码601880.SS的查询情况来看，中国股市数据主要依赖 Yahoo Finance，但该数据源对于中国股市数据分析存在局限性，OpenBB 若能支持更多本地化主流数据源，将更贴合中国市场需求。

中国市场的金融数据源

在中国金融市场，主流数据源大多需要付费使用，其中 Wind、东方财富 Choice 和同花顺 iFind 是行业内常用的数据源。除付费数据源外，也有一些可靠的开源数据源可供选择，如 AKShare 和 TuShare：

AKShare - https://github.com/akfamily/akshare

TuShare - https://github.com/waditu/tushare

通过开发 OpenBB Platform 的数据源扩展，接入中国市场专有的数据源，能够进一步提升 OpenBB 在中国市场金融分析领域的实用性和竞争力。

📝 总结

OpenBB 是一个功能强大、开源免费、面向未来金融数据需求的综合平台。无论你是想了解市场动态、构建投资组合，还是进行深度数据分析，OpenBB 都能为你提供强有力的支持。随着其生态系统的不断发展，OpenBB 正逐渐成为新一代金融科技爱好者的首选工具。

参考链接

【双重验证】主流验证器比较

参考链接

【双重验证·下】主流验证器大评测！

Flutter手势冲突与手势竞争

手势冲突的原因

当多个手势同时出现在同一控件上时，就会发生手势冲突。这可能会导致系统无法准确识别用户的意图，从而导致错误的操作。iOS 上的 UIScrollView 是手势冲突的主要来源，因为它可以响应滚动、缩放和点击等各种手势。当 Flutter 视图与 UIScrollView 同时存在时，很容易发生手势冲突。

常见的冲突场景

最常见的场景是将 Flutter 视图嵌套在 UIScrollView 中。在这种情况下，UIScrollView 的滚动手势和 Flutter 视图的手势很容易发生冲突。例如，当用户在 Flutter 视图上拖动时，UIScrollView 可能将其误认为是滚动操作，从而导致 Flutter 视图无法响应拖动手势。

解决方案：手势竞技场

解决手势冲突的最有效方法之一是使用 Flutter 的手势竞技场。这是一个负责协调手势的系统，可确保同一时间只有一个手势被识别。要使用手势竞技场，需要在 Flutter 视图的最顶层添加一个 GestureRecognizer Widget，并将其作为竞技场的子控件。

手势竞技场的使用

以下是使用手势竞技场的示例代码：

import 'package:flutter/gestures.dart';

class MyGestureRecognizer extends GestureRecognizer {
  // 实现手势识别器的方法
}

class MyFlutterView extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return RawGestureDetector(
      gestures: {
        MyGestureRecognizer(): GestureRecognizerFactoryWithHandlers<MyGestureRecognizer>(
          () => MyGestureRecognizer(),
          (MyGestureRecognizer instance) => instance.addPointer(event),
          (MyGestureRecognizer instance) => instance.handleEvent(event),
        ),
      },
      child: // Flutter 视图的内容
    );
  }
}

import 'package:flutter/gestures.dart';

class MyGestureRecognizer extends GestureRecognizer {

// 实现手势识别器的方法

}

class MyFlutterView extends StatelessWidget {

@override

Widget build(BuildContext context) {

return RawGestureDetector(

gestures: {

MyGestureRecognizer(): GestureRecognizerFactoryWithHandlers<MyGestureRecognizer>(

() => MyGestureRecognizer(),

(MyGestureRecognizer instance) => instance.addPointer(event),

(MyGestureRecognizer instance) => instance.handleEvent(event),

child: // Flutter 视图的内容

);

}

通过使用这种方法，Flutter 视图的手势和 UIScrollView 的手势可以同时响应，互不干扰，从而完美解决 iOS 上的 Flutter 页面手势冲突问题。

常见问题解答

1. 为什么手势冲突在 iOS 上很常见？

因为 iOS 上的 UIScrollView 可以响应多种手势，并且它经常与 Flutter 视图一起使用，这可能导致手势冲突。

2. 手势竞技场是如何工作的？

手势竞技场是一个负责协调手势的系统，可确保同一时间只有一个手势被识别。它通过让手势识别器注册自己并协调它们的活动来实现此目的。

3. 如何在 Flutter 中使用手势竞技场？

在 Flutter 视图的最顶层添加一个 GestureRecognizer Widget，并将其作为竞技场的子控件。

4. 除了手势竞技场，还有其他解决手势冲突的方法吗？

是的，还有其他方法，例如使用 GestureDetector Widget 或重写控件的手势识别逻辑。

5. 为什么解决手势冲突很重要？

解决手势冲突很重要，因为它可以防止错误的操作，并确保用户获得流畅、无缝的体验。

参考链接

Flutter：使用Overlay展示浮动的Widget

想象一下：你编写出的迷人表单页面

你把它发给产品经理，他看了一眼说：“我一定要完整的输入国家名称吗，当我输入文字时难道你就不能给我展示些建议吗？”，你想了想：“好吧，他是对的”，因此，你决定开发一个‘自动补全‘的’预先输入’功能，随便你怎么称呼它：一个文本展示框 TextField ，当用户输入文字的时候展示一些建议选项。开始工作了..你知道怎么拿到建议数据，你知道怎么写逻辑，你知道所有要做的事情..除了不知道怎么将建议选项浮动展示在 Widgets 之上。

你想了想：打算重新设计代码结构，为了实现悬浮效果，决定将整个页面包装进一个 Stack 组件中，你需要准确的计算每个 Widget 显示的位置，非常侵入性、必须要严谨、容易出错，并且直觉告诉你这么做可能是错误的，有其他的实现方式吗？

方案就是：你可以使用 Flutter 已经提供好的 Stack ：Overlay

在这片文章中，我将会介绍如何使用 Overlay ，来创建悬浮在其他 Widget 之上的 Widgets，并且并不需要重构你的整个页面。

你可以使用 Overlay 来展示自动匹配的建议选项，小提示，或着基本上所有的浮动的东西。

Overlay是什么？

官方文档这样定义

A Stack of entries that can be managed independently. // 一个可以独立管理的Stack子类

Overlays let independent child widgets “float” visual elements on top of other widgets by inserting them into the overlay’s Stack. // 通过将可独立管理的子节点widgets加入到overlay的栈中，Overlays可以将这些widgets浮动展示到显现的elements节点的顶部

这看起来就是我们正在寻找的内容，当我们创建 MaterialApp 的时候，它会自动创建一个Navigator，Navigator 则又会创建一个 Overlay : 一个 Navigator 用来管理所展示的 Views 视图的 Stack 组件。

接下来，让我们一起看看怎么使用 Overlay 来解决我们的问题吧。

注意：这篇文章的核心是介绍如何显示浮动 Widgets，因此不会涉及太多如何实现自动补全文本输入框 TextField 的细节，如果你对一个编写良好、可高度自定义的自动补全 Widget 感兴趣的话，可以参考 flutter_typeahead 。

初始代码

我们以最初的代码开始吧：

Scaffold(
  body: Padding(
    padding: const EdgeInsets.all(50.0),
    child: Form(
      child: ListView(
        children: <Widget>[
          TextFormField(
            decoration: InputDecoration(
                labelText: 'Address'
            ),
          ),
          SizedBox(height: 16.0,),
          TextFormField(
            decoration: InputDecoration(
                labelText: 'City'
            ),
          ),
          SizedBox(height: 16.0,),
          TextFormField(
            decoration: InputDecoration(
                labelText: 'Address'
            ),
          ),
          SizedBox(height: 16.0,),
          RaisedButton(
            child: Text('SUBMIT'),
            onPressed: () {
              // submit the form
            },
          )
        ],
      ),
    ),
  ),
)

Scaffold(

body: Padding(

padding: const EdgeInsets.all(50.0),

child: Form(

child: ListView(

children: <Widget>[

TextFormField(

decoration: InputDecoration(

labelText: 'Address'

SizedBox(height: 16.0,),

TextFormField(

decoration: InputDecoration(

labelText: 'City'

SizedBox(height: 16.0,),

TextFormField(

decoration: InputDecoration(

labelText: 'Address'

SizedBox(height: 16.0,),

RaisedButton(

child: Text('SUBMIT'),

onPressed: () {

// submit the form

)

*一个简单页面，包含了三个文本输入框：country、city、address。

然后我们就以 country 文本输入框为例吧，将它封装成一个我们自己的 StatefulWidget，命名为 CountriesField 。

class CountriesField extends StatefulWidget {
  @override
  _CountriesFieldState createState() => _CountriesFieldState();
}

class _CountriesFieldState extends State<CountriesField> {
  @override
  Widget build(BuildContext context) {
    return TextFormField(
      decoration: InputDecoration(
        labelText: 'Country'
      ),
    );
  }
}

class CountriesField extends StatefulWidget {

@override

_CountriesFieldState createState() => _CountriesFieldState();

}

class _CountriesFieldState extends State<CountriesField> {

@override

Widget build(BuildContext context) {

return TextFormField(

decoration: InputDecoration(

labelText: 'Country'

);

}

接下来我们将要做的是，每次当选中文本输入框获取焦点 Focus 的时候，将一个浮动的 List 列表展示出来。当失去焦点 Focus 的时候，再将它隐藏起来，当然你可以按照自己需求来决定如何实现，你可能需要在用户输入了一些文字后展示它，或者当用户点击 Enter 按钮的时候再隐藏。无论怎样，让我们先看看如何展示这个悬浮的 Widget吧：

class CountriesField extends StatefulWidget {
  @override
  _CountriesFieldState createState() => _CountriesFieldState();
}

class _CountriesFieldState extends State<CountriesField> {

  final FocusNode _focusNode = FocusNode();

  OverlayEntry _overlayEntry;

  @override
  void initState() {
    _focusNode.addListener(() {
      if (_focusNode.hasFocus) {

        this._overlayEntry = this._createOverlayEntry();
        Overlay.of(context).insert(this._overlayEntry);

      } else {
        this._overlayEntry.remove();
      }
    });
  }

  OverlayEntry _createOverlayEntry() {

    RenderBox renderBox = context.findRenderObject();
    var size = renderBox.size;
    var offset = renderBox.localToGlobal(Offset.zero);

    return OverlayEntry(
      builder: (context) => Positioned(
        left: offset.dx,
        top: offset.dy + size.height + 5.0,
        width: size.width,
        child: Material(
          elevation: 4.0,
          child: ListView(
            padding: EdgeInsets.zero,
            shrinkWrap: true,
            children: <Widget>[
              ListTile(
                title: Text('Syria'),
              ),
              ListTile(
                title: Text('Lebanon'),
              )
            ],
          ),
        ),
      )
    );
  }

  @override
  Widget build(BuildContext context) {
    return TextFormField(
        focusNode: this._focusNode,
      decoration: InputDecoration(
        labelText: 'Country'
      ),
    );
  }
}

class CountriesField extends StatefulWidget {

@override

_CountriesFieldState createState() => _CountriesFieldState();

}

class _CountriesFieldState extends State<CountriesField> {

final FocusNode _focusNode = FocusNode();

OverlayEntry _overlayEntry;

@override

void initState() {

_focusNode.addListener(() {

if (_focusNode.hasFocus) {

this._overlayEntry = this._createOverlayEntry();

Overlay.of(context).insert(this._overlayEntry);

} else {

this._overlayEntry.remove();

}

});

}

OverlayEntry _createOverlayEntry() {

RenderBox renderBox = context.findRenderObject();

var size = renderBox.size;

var offset = renderBox.localToGlobal(Offset.zero);

return OverlayEntry(

builder: (context) => Positioned(

left: offset.dx,

top: offset.dy + size.height + 5.0,

width: size.width,

child: Material(

elevation: 4.0,

child: ListView(

padding: EdgeInsets.zero,

shrinkWrap: true,

children: <Widget>[

ListTile(

title: Text('Syria'),

ListTile(

title: Text('Lebanon'),

)

);

}

@override

Widget build(BuildContext context) {

return TextFormField(

focusNode: this._focusNode,

decoration: InputDecoration(

labelText: 'Country'

);

}

我们给 TextFormField 绑定了一个 FocusNode，并且在 initState 里面给 FocusNode 添加了一个监听事件，通过监听事件来获取什么时候获得/失去焦点。
每次当我们获取焦点 (_focusNode.hasFocus == true) 的时候，我们通过 _createOverlayEntry 创建一个OverlayEntry 实例对象，然后通过使用 Overlay.of(context).insert，将它插入到最邻近的 Overlay Widget 中去。
每次当我们失去焦点 (_focusNode.hasFocus == false) 的时候，我们通过使用 _overlayEntry.remove 来移除刚才添加的 Overlay 实例。
_createOverlayEntry 通过使用 context.findRenderObject 来获取我们的 Widget 所在的渲染对象 RenderBox ，渲染对象里包含位置 Position、大小 Size、和一些其他关于渲染的信息，有了这些信息能够帮助我们计算在哪里展示我们的悬浮列表。
_createOverlayEntry 通过渲染信息来获取当前 Widget 的大小，也可以使用 renderBox.localToGlobal 来获取当前 Widget 在屏幕上的坐标。我们将 localToGlobal 设置为 Offset.zero 这意味着我们将在渲染对象中使用（0,0）坐标，并且将他们转换为屏幕上相对应的坐标。
接着我们创建了 OverlayEntry，这时一个用来将 Widgets 展示到 Overlay 中的 Widget。
当前创建的 OverlayEntry 的是一个 Positioned Widget。请牢记 Positioned Widgets 只能被插入到 Stack 中，当然 Overlay 其实也是一个 Stack。
我们设置 Positioned Widget 的坐标，给它和 TextField 相同的 X 轴坐标，相同的宽度，相同的 Y 轴坐标，当然为了不遮挡到 TextField，在底部进行了一些偏移。
在 Positioned 内部，我们设置了一个展示建议选项的 ListView（里面默写了例子中的一些国家）。注意到我把所有的内容都包在了 Material 中，关于这样写有两个原因： Overlay 默认不包含 Material Widget，并且很多 Widgets 如果没有有 Material 祖先节点的话不能展示，除此之外 Material 还提供了 elevation 属性，可以让我们给 Widget 设置阴影效果，看起来就像真正浮在上面一样。

以上，我们的建议选择项可以浮在所有 Widget 之上了！

彩蛋：跟随 Widget 滑动！

在我们离开之前，让我们在多学喜一点吧！假如我们的页面是可以滚动，我们可能注意到如下现象：

建议选择列表固定在了屏幕上！在某些场景下你可能的确需要固定的，但是在当前场景中，我们不想要它固定，我们想要它跟随我们的 TextField 一起滚动！

关键词滚动，Flutter给我们提供了两个widget：CompositedTransformFollower、CompositedTransformTarget，简单介绍就是，如果我们关联起一个 follower 和一个 target ，那么无论 target 滚动到哪里，这个 follower 将跟随它一起滚动！为了关联起一个 follower 和一个target，我们需要给他们设置相同的LayerLink.

因此我们需要将建议选择列表用 CompositedTransformFollower 包起来，将 TextField 用 CompositedTransformTarget 包起来。然后我们将他们使用想用的 LayerLink 关联起来，这样就可以是建议选择列表跟随 TextField 一起滑动了：

class CountriesField extends StatefulWidget {
  @override
  _CountriesFieldState createState() => _CountriesFieldState();
}
class _CountriesFieldState extends State<CountriesField> {

  final FocusNode _focusNode = FocusNode();

  OverlayEntry _overlayEntry;

  final LayerLink _layerLink = LayerLink();

  @override
  void initState() {
    _focusNode.addListener(() {
      if (_focusNode.hasFocus) {

        this._overlayEntry = this._createOverlayEntry();
        Overlay.of(context).insert(this._overlayEntry);

      } else {
        this._overlayEntry.remove();
      }
    });
  }

  OverlayEntry _createOverlayEntry() {

    RenderBox renderBox = context.findRenderObject();
    var size = renderBox.size;

    return OverlayEntry(
      builder: (context) => Positioned(
        width: size.width,
        child: CompositedTransformFollower(
          link: this._layerLink,
          showWhenUnlinked: false,
          offset: Offset(0.0, size.height + 5.0),
          child: Material(
            elevation: 4.0,
            child: ListView(
              padding: EdgeInsets.zero,
              shrinkWrap: true,
              children: <Widget>[
                ListTile(
                  title: Text('Syria'),
                  onTap: () {
                    print('Syria Tapped');
                  },
                ),
                ListTile(
                  title: Text('Lebanon'),
                  onTap: () {
                    print('Lebanon Tapped');
                  },
                )
              ],
            ),
          ),
        ),
      )
    );
  }

  @override
  Widget build(BuildContext context) {
    return CompositedTransformTarget(
      link: this._layerLink,
      child: TextFormField(
          focusNode: this._focusNode,
        decoration: InputDecoration(
          labelText: 'Country'
        ),
      ),
    );
  }
}

class CountriesField extends StatefulWidget {

@override

_CountriesFieldState createState() => _CountriesFieldState();

}

class _CountriesFieldState extends State<CountriesField> {

final FocusNode _focusNode = FocusNode();

OverlayEntry _overlayEntry;

final LayerLink _layerLink = LayerLink();

@override

void initState() {

_focusNode.addListener(() {

if (_focusNode.hasFocus) {

this._overlayEntry = this._createOverlayEntry();

Overlay.of(context).insert(this._overlayEntry);

} else {

this._overlayEntry.remove();

}

});

}

OverlayEntry _createOverlayEntry() {

RenderBox renderBox = context.findRenderObject();

var size = renderBox.size;

return OverlayEntry(

builder: (context) => Positioned(

width: size.width,

child: CompositedTransformFollower(

link: this._layerLink,

showWhenUnlinked: false,

offset: Offset(0.0, size.height + 5.0),

child: Material(

elevation: 4.0,

child: ListView(

padding: EdgeInsets.zero,

shrinkWrap: true,

children: <Widget>[

ListTile(

title: Text('Syria'),

onTap: () {

print('Syria Tapped');

ListTile(

title: Text('Lebanon'),

onTap: () {

print('Lebanon Tapped');

)

);

}

@override

Widget build(BuildContext context) {

return CompositedTransformTarget(

link: this._layerLink,

child: TextFormField(

focusNode: this._focusNode,

decoration: InputDecoration(

labelText: 'Country'

);

}

我们将 Material Widget 用 CompositedTransformFollower 包裹进 OverlayEntry 中，将TextFormField 包裹进 CompositedTransformTarget 中。
我们使用相同的 LayerLink 示例，来关联 follower 和 target，这样 follower 和 target 将会在相同的坐标系中，高效的跟随 target 而动。
从 Positioned Widget 中移除了 top 和 left 属性，因为默认 follower 和target 有相同的坐标，因此不在需要。然而我们保留了 width 属性，因为如果不设置的话，follower 将会无限的延伸。
为了不遮挡 TextFormField ，我们给 CompositedTransformFollower 设置了一个offset（和之前一样的原因）。
最后，我们将 showWhenUnlinked 属性设置为 false，当 TextFormField 在屏幕上不可见时，用来隐藏OverlayEntry（比如我们滑动出屏幕底部很远的时候）。

经过这些操作，我们的 OverlayEntry 现在可以跟随我们的 TextField 一起滚动啦！

重要提示：CompositedTransformFollower 仍然有一点问题，当 target 不可见时，即使 follower 已经从屏幕上隐藏了，这个 follower 仍然会响应点击事件，我已经给 Flutter Team 提了 issue ，此 issue 已经关闭，标记为解决。

Overlay 是一个强大的 Widget ，它给我们提供了一个简单易用的的用来展示浮动 Widget 的的 Stack 组件。

参考链接

Flutter - 左右侧滑菜单：drawer和endDrawer

侧滑菜单可以从左面滑出，也可以从右面滑出。在Scaffold中有drawer和endDrawer两个参数，分别对应左边的菜单和右边的菜单。

      drawer: new Drawer(
        child: new ListView(
          children: <Widget>[
            
          ],
        ),
      ),

drawer: new Drawer(

child: new ListView(

children: <Widget>[

      endDrawer: new Drawer(
        child: new ListView(
          children: <Widget>[
            
          ],
        ),
      ),

endDrawer: new Drawer(

child: new ListView(

children: <Widget>[

参考链接

Android 15新特性，强制edge-to-edge全面屏体验

其实edge-to-edge全面屏体验并不是什么全新的功能，早在Android 15之前就已经支持了。

但是这个功能推出了很多年，仍然有大量的应用程序没有对全面屏体验进行适配。所以，在这次的Android 15更新中，Google终于下决心要强推这个功能，以让所有应用程序都能达到更好的体验。

需要说明的是，只有将App的targetSdkVersion指定到35或更高时，Android 15才会强制启用edge-to-edge功能。所以，如果你就是不想适配，那么只要不升级targetSdkVersion的版本就行了。

下面开始进入正题，首先跟大家介绍一下到底什么是edge-to-edge全面屏体验。

其实简单来讲，就是让App的界面延伸到手机屏幕的全部空间，这样可以带来更加沉浸式的用户体验。

事实上，绝大多数的App都没有将界面延伸到手机屏幕的全部空间，因此它们本可以提供更好的用户体验。

这里说的手机屏幕的全部空间具体指的是什么呢？我们看下面这张图就能快速了解了。

继续阅读Android 15新特性，强制edge-to-edge全面屏体验

Flutter监听软键盘的弹出和关闭获取键盘高度

通过 WidgetsBindingObserver 实现监听软键盘的弹出关闭

实现 WidgetsBindingObserver

 class _State extends State<MyPage> with WidgetsBindingObserver {

  @override
  void initState() {
    super.initState();
    // 初始化
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    // 销毁
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  // 监听
  @override
  void didChangeMetrics() {
    super.didChangeMetrics();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      if(mounted){
        if(0 == MediaQuery.viewInsetsOf(context).bottom) {
           // 关闭键盘
        } else {
           // 显示键盘
        }
      }
    });
  }
}

class _State extends State<MyPage> with WidgetsBindingObserver {

@override

void initState() {

super.initState();

// 初始化

WidgetsBinding.instance.addObserver(this);

}

@override

void dispose() {

// 销毁

WidgetsBinding.instance.removeObserver(this);

super.dispose();

}

// 监听

@override

void didChangeMetrics() {

super.didChangeMetrics();

WidgetsBinding.instance.addPostFrameCallback((_) {

if(mounted){

if(0 == MediaQuery.viewInsetsOf(context).bottom) {

// 关闭键盘

} else {

// 显示键盘

}

});

}

注意:

如果使用 Scaffold 作为父组件，在使用 MediaQuery.viewInsetsOf(context).bottom 获取键盘高度如果无论如何都是 0 。

此时有两种方案：

1. 需设置父级 Scaffold 的 resizeToAvoidBottomInset 为 false 。

Scaffold(
  // 子组件若需要监听键盘高度，需设置为false
  resizeToAvoidBottomInset:false,
  appBar: AppBar(
    title: '页面title',
  ),
  body: ContentPage(),//子页面中监听键盘高度
),

Scaffold(

// 子组件若需要监听键盘高度，需设置为false

resizeToAvoidBottomInset:false,

appBar: AppBar(

title: '页面title',

body: ContentPage(),//子页面中监听键盘高度

但是这样设置之后，会导致键盘弹出的时候，Scaffold 不会自动向上移动，导致输入范围被遮挡。

2. 使用 Scaffold 上层/同层的 BuildContext 作为参数传递给子 View ，然后传递给 MediaQuery 作为参数。

一	二	三	四	五	六	日
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

月度归档： 2025 年 7 月

OpenBB的介绍以及如何使用OpenBB助力A股港股的金融数据分析

📜 OpenBB 的历史背景

OpenBB Platform

OpenBB Workspace

OpenBB与AI的集成

LLM Friendly Mode

OpenBB Copilot

中国市场的金融数据源

📝 总结

参考链接

【双重验证】主流验证器比较

参考链接

Flutter手势冲突与手势竞争

手势冲突的原因

常见的冲突场景

解决方案：手势竞技场

常见问题解答

参考链接

Flutter：使用Overlay展示浮动的Widget

Overlay是什么？

初始代码

彩蛋：跟随 Widget 滑动！

参考链接

Flutter - 左右侧滑菜单：drawer和endDrawer

参考链接

Android 15新特性，强制edge-to-edge全面屏体验

Flutter监听软键盘的弹出和关闭获取键盘高度

注意:

原始链接