foundation library

核心Flutter框架原语.

该库中定义的功能是Flutter框架的所有其他层使用的最低级别的实用程序类和功能.

Classes

AbstractNode
树中的抽象节点. [...]
BindingBase
提供单例服务(也称为"绑定")的mixin的基类. [...]
BitField<T extends dynamic>
枚举(或其他类的值实现"索引"的类)上的BitField. 枚举的前62个值只能用作索引. [...]
CachingIterable<E>
Iterable的惰性缓存版本. [...]
Category
出于文档目的,用于注释类的类别. [...]
ChangeNotifier
可以扩展或混合使用的类,该类使用VoidCallback进行通知以提供更改通知API. [...]
DiagnosticableNode<T extends Diagnosticable>
DiagnosticsNode那懒洋洋地调用相关Diagnosticable 价值实现的getChildrenGetProperties中 .
DiagnosticableTree
用于提供字符串和DiagnosticsNode调试表示形式的基类,这些表示形式描述了对象的属性和子代. [...]
DiagnosticableTreeNode
DiagnosticableTree实例的DiagnosticsNode .
DiagnosticPropertiesBuilder
生成器,用于累积用于从DiagnosticableMixin对象组装DiagnosticsNode的属性和配置.
DiagnosticsBlock
存在的DiagnosticsNode主要是为其他通常缺乏其有意义的值的诊断提供容器. [...]
DiagnosticsNode
Defines diagnostics data for a value. [...]
DiagnosticsProperty<T>
值为 T类型的属性. [...]
DiagnosticsSerializationDelegate
一个委托,该委托配置如何序列化DiagnosticsNode的层次结构. [...]
DiagnosticsStackTrace
使用适用于将堆栈跟踪显示为FlutterError对象的一部分的StackTrace 进行诊断.
DocumentationIcon
一个类注释,用于提供表示该类的图像的URL. [...]
DoubleProperty
描述带有可选度量单位双精度 值的属性. [...]
EnumProperty<T>
然后,一个属性将简要显示枚举值. [...]
ErrorDescription
问题及其原因的说明,可能有助于跟踪问题的任何信息,背景信息等. [...]
ErrorHint
ErrorHint提供可能适用的特定的,非显而易见的建议. [...]
ErrorSpacer
ErrorSpacer创建一个空的DiagnosticsNode ,可用于调整其他DiagnosticsNode对象之间的间距.
ErrorSummary
对检测到的问题的简短描述(一行). [...]
Factory<T>
工厂界面还报告创建对象的类型.
FlagProperty
描述为ifTrueifFalse的属性,取决于value是true还是false. [...]
FlagsSummary<T>
多个属性的摘要,指示每个属性是否存在(非空)或不存在(空). [...]
FlutterErrorDetails
提供给FlutterExceptionHandler回调的信息的类. [...]
HashedObserverList<T>
为观察者模式优化的列表,但针对大量观察者. [...]
IntProperty
一个带有可选单位的int值属性,该值的测量单位. [...]
IterableProperty<T>
具有Iterable<T> 值的属性,可以与其他DiagnosticsTreeStyle一起显示以进行自定义呈现. [...]
Key
WidgetElementSemanticsNode的标识符. [...]
LicenseEntry
涵盖应用程序软件或资产的一部分的许可证,以在诸如LicensePage的界面中显示. [...]
LicenseEntryWithLineBreaks
LicenseEntry的变体,用于使用空白行分隔段落并在段落中用硬包装文本的许可证. 也假定以一个或多个空格字符开头的行引入了新的段落,除非它们以与前一行相同的空格开头,在这种情况下,假定它们是缩进段落的延续. [...]
LicenseParagraph
一个字符串,表示LicenseEntry中的一个段落. [...]
LicenseRegistry
用于将许可证添加到的程序包的注册表,以便可以在诸如LicensePage的界面中一起显示它们. [...]
Listenable
维护侦听器列表的对象. [...]
LocalKey
不是GlobalKey的密钥 . [...]
MessageProperty
调试消息显示为属性. [...]
ObjectFlagProperty<T>
一个属性,其中重要的诊断信息主要是该是存在(非空)还是不存在(空),而不是属性本身的实际值. [...]
ObserverList<T>
当观察者数量少时,针对观察者模式优化的列表. [...]
PartialStackFrame
来自堆栈帧的部分信息,用于堆栈过滤. [...]
PercentProperty
该属性将double限制在0到1之间,并将其格式化为百分比.
ReadBuffer
只读缓冲区,用于从ByteData实例顺序读取. [...]
RepetitiveStackFrameFilter
一个StackFilter用于过滤基于重复的名单PartialStackFrame秒. [...]
StackFilter
过滤堆栈框架以对FlutterError.defaultStackFilter进行其他过滤的 .
StackFrame
来自堆栈跟踪的帧的对象表示. [...]
StringProperty
该属性将其字符串括在引号中. [...]
Summary
一种注释,提供对在索引中使用的类的简短描述. [...]
SynchronousFuture<T>
Future然后其实现立即调用回调. [...]
TextTreeConfiguration
用于指定应如何将特定DiagnosticsTreeStyle呈现为文字的配置. [...]
TextTreeRenderer
创建DiagnosticsNode对象树的ASCII艺术作品表示形式的渲染器. [...]
Unicode
有用的Unicode字符的常量. [...]
ValueKey<T>
使用特定类型的值来标识自身的键. [...]
ValueListenable<T>
一个Listenable子类的接口,它公开一个 . [...]
ValueNotifier<T>
一个拥有单个值的ChangeNotifier . [...]
WriteBuffer
只写缓冲区,用于以增量方式构建ByteData实例. [...]

Mixins

Diagnosticable
一个mixin类,用于提供描述对象属性的字符串和DiagnosticsNode调试表示. [...]
DiagnosticableMixin
一个实现Diagnosticable接口的mixin类,该接口提供描述对象属性的字符串和DiagnosticsNode调试表示. [...]
DiagnosticableTreeMixin
一个可帮助转储树的字符串和DiagnosticsNode表示形式的mixin. [...]

Constants

immutable → const Immutable
用于注释类C 表示C和所有亚型C必须是不可变的. [...]
const Immutable ()
kDebugMode → const bool
如果应用程序是在调试模式下编译的,则为true的常量. [...]
!kReleaseMode && !kProfileMode
kIsWeb → const bool
如果将应用程序编译为在Web上运行,则为true的常量. [...]
identical(0, 0.0)
kMaxUnsignedSMI → const int
The largest SMI value. [...]
_bitfield.kMaxUnsignedSMI
kNoDefaultValue → const _NoDefaultValue
指示DiagnosticsNode没有默认值的标记对象.
_NoDefaultValue()
kProfileMode → const bool
如果应用程序是在概要文件模式下编译的,则为true的常量. [...]
bool.fromEnvironment('dart.vm.profile', defaultValue: false)
kReleaseMode → const bool
A constant that is true if the application was compiled in release mode. [...]
bool.fromEnvironment('dart.vm.product', defaultValue: false)
mustCallSuper → const _MustCallSuper
用于注释实例方法m . 指示重写m的方法的每次调用也必须调用m . 另外,重写m每个方法都使用相同的注释进行隐式注释. [...]
const _MustCallSuper()
nonVirtual → const _NonVirtual
用于注释类C或mixin M的实例成员(方法,getter,setter,运算符或字段) m . 表明m不应该在延伸或混入任何类覆盖CM . [...]
const _NonVirtual()
optionalTypeArgs → const _OptionalTypeArgs
用于注释类,mixin或扩展声明C 指示在C上声明的任何类型参数都将被视为可选. 分析器和linter等工具可以使用此信息来抑制警告,否则这些警告将要求提供C上的类型参数.
const _OptionalTypeArgs()
precisionErrorTolerance → const double
可容忍的双精度误差的ε. [...]
1e-10
protected → const _Protected
用于注释一个实例成员(方法,吸气剂,设置器,操作员或场) m类中的C . 如果注释在字段上,则适用于该字段引起的getter和setter(如果适用). 指示m仅应从C实例方法或直接或间接在C中扩展,实现或混合的类调用. 此外,指示仅应this显式或隐式调用m . [...]
const _Protected()
required → const Required
用于注释方法或函数f的命名参数p . 指示对f每次调用都必须包含一个与p对应的参数,尽管p否则将是一个可选参数. [...]
const Required ()
timelineWhitelistArguments → const Map<String, String>
传递给时间轴事件的参数是为了使这些事件显示在以开发者为中心的天文台时间轴版本中. [...]
<String, String>{'mode' : 'basic'}
visibleForTesting → const _VisibleForTesting
用来声明声明的声明已公开,因此使代码可测试的程度比其他必要可见. [...]
const _VisibleForTesting()

Properties

compute Future<R> Function<Q, R>(ComputeCallback<Q, R> callback, Q message, {String debugLabel})
生成隔离对象,在该隔离对象上运行callback ,并向其传递message ,并(最终)返回callback返回的值. [...]
最后
dashedTextConfiguration TextTreeConfiguration
sparseTextConfiguration相同, 不同之处在于,将父级连接到子级的线是虚线. [...]
最后
debugDefaultTargetPlatformOverride TargetPlatform
覆盖defaultTargetPlatform . [...]
读/写
debugDoublePrecision int
Configure debugFormatDouble using num.toStringAsPrecision. [...]
读/写
debugInstrumentationEnabled bool
布尔值,指示debugInstrumentAction是否将检测调试构建中的动作.
读/写
debugPrint DebugPrintCallback
将消息打印到控制台,您可以使用" flutter"工具的" logs"命令(" flutter logs")进行访问. [...]
读/写
debugPrintDone Future<void>
甲未来解析时不再有任何缓冲的内容通过印刷debugPrintThrottled (这是默认实现debugPrint ,其用于报告错误到控制台).
只读
defaultTargetPlatform TargetPlatform
与框架当前在其上执行的平台匹配的TargetPlatform . [...]
只读
denseTextConfiguration TextTreeConfiguration
密集的文本树配置,可最大程度地减少水平空白. [...]
最后
errorPropertyTextConfiguration TextTreeConfiguration
在一行上显示名称,然后在下一行上省略正文和属性,然后省略子级. [...]
最后
errorTextConfiguration TextTreeConfiguration
一种配置,它在节点周围绘制框而不考虑与父级的连接. [...]
最后
flatTextConfiguration TextTreeConfiguration
不缩进子级的仅空白配置. [...]
最后
shallowTextConfiguration TextTreeConfiguration
在多行上渲染节点,省略子级. [...]
最后
singleLineTextConfiguration TextTreeConfiguration
将节点渲染为单行,省略子级. [...]
最后
sparseTextConfiguration TextTreeConfiguration
默认文本树配置. [...]
最后
transitionTextConfiguration TextTreeConfiguration
在叶节点周围绘制框的配置. [...]
最后
whitespaceTextConfiguration TextTreeConfiguration
仅空白配置,子代始终缩进两个空格. [...]
最后

Functions

binarySearch<T extends Comparable<Object>>(List<T> sortedList, T value) int
返回valuesortedList中的位置(如果存在). [...]
consolidateHttpClientResponseBytes(HttpClientResponse response, {bool autoUncompress: true, BytesReceivedCallback onBytesReceived}) Future<Uint8List>
有效地将HttpClientResponse的响应主体转换为Uint8List . [...]
debugAssertAllFoundationVarsUnset(String reason, {DebugPrintCallback debugPrintOverride: debugPrintThrottled}) bool
如果基础库调试变量均未更改,则返回true. [...]
debugFormatDouble(double value) String
格式化双精度以具有标准格式. [...]
debugInstrumentAction<T>(String description, Future<T> action()) Future<T>
运行指定的action ,定时在debugInstrumentationEnabled为true时计时该动作在调试版本中花费的时间. [...]
debugPrintStack({StackTrace stackTrace, String label, int maxFrames}) → void
使用debugPrintFlutterError.defaultStackFilter将堆栈转储到控制台. [...]
debugPrintSynchronously(String message, {int wrapWidth}) → void
不会限制的debugPrint的替代实现. 由测试使用.
debugPrintThrottled(String message, {int wrapWidth}) → void
限制消息的debugPrint的实现. 这样可以避免在限制日志记录速率的平台(例如Android)上丢弃消息.
debugWordWrap(String message, int width, {String wrapIndent: ''}) Iterable<String>
以给定的宽度包装给定的字符串. [...]
describeEnum(Object enumEntry) String
返回枚举值的简短描述. [...]
describeIdentity(Object object) String
返回object的运行时类型和哈希码的摘要. [...]
listEquals<T>(List<T> a, List<T> b) bool
比较两个列表的深度相等性. [...]
mapEquals<T, U>(Map<T, U> a, Map<T, U> b) bool
比较两个映射以获得深层相等性. [...]
objectRuntimeType(Object object, String optimizedValue) String
框架代码应使用此方法, 以便Object.runtimeType上调用toString . [...]
profile(VoidCallback function) → void
已淘汰. function不能在发行版本中摇摇欲坠. [...]
@ 不推荐使用 ("改用`if(!kReleaseMode){function();}`.''v1.3.9之后不推荐使用此功能.")
setEquals<T>(Set<T> a, Set<T> b) bool
比较两个集合的深度相等性. [...]
shortHash(Object object) String
返回从Object.hashCode的20个最低有效位生成的5个字符长的十六进制字符串.

Enums

DiagnosticLevel
用于过滤显示和省略诊断的各种优先级. [...]
DiagnosticsTreeStyle
DiagnosticsNode树中显示节点的样式. [...]
TargetPlatform
用户交互应适应目标的平台. [...]

Typedefs

AsyncCallback() Future<void>
没有参数且不返回任何数据,但返回Future来指示其工作何时完成的回调的签名. [...]
AsyncValueGetter<T>() Future<T>
用于按需异步报告值的回调的签名. [...]
AsyncValueSetter<T>(T value) Future<void>
报告已设置值并返回保存值后完成的Future的签名. [...]
BytesReceivedCallback(int cumulative, int total) → void
用于在将HttpClientResponse的字节合并到Uint8List时接收到字节块时得到通知的签名. [...]
ComputeCallback<Q, R>(Q message) FutureOr<R>
传递给compute的回调的签名. [...]
ComputePropertyValueCallback<T>() → T
用于计算属性值的签名. [...]
DebugPrintCallback(String message, {int wrapWidth}) → void
debugPrint实现的签名.
DiagnosticPropertiesTransformer(Iterable<DiagnosticsNode> properties) Iterable<DiagnosticsNode>
DiagnosticPropertiesBuilder变压器的签名.
FlutterExceptionHandler(FlutterErrorDetails details) → void
Signature for FlutterError.onError handler.
InformationCollector() Iterable<DiagnosticsNode>
FlutterErrorDetails.informationCollector回调以及收集描述错误的信息的其他回调的签名.
IterableFilter<T>(Iterable<T> input) Iterable<T>
筛选可迭代对象的回调的签名.
LicenseEntryCollector() Stream<LicenseEntry>
传递给LicenseRegistry.addLicense的回调的签名.
ServiceExtensionCallback(Map<String, String> parameters) Future<Map<String, dynamic>>
服务扩展的签名. [...]
ValueChanged<T>(T value) → void
报告基本值已更改的回调的签名. [...]
ValueGetter<T>() → T
用于报告按需值的回调的签名. [...]
ValueSetter<T>(T value) → void
报告已设置值的回调的签名. [...]
VoidCallback() → void
没有参数且不返回数据的回调的签名.

Exceptions / Errors

FlutterError
用于报告Flutter特定的断言失败和违反合同的错误类. [...]