在 Flutter 中，foundation 是一个核心库，提供了许多基础功能和工具类，用于构建应用程序的底层逻辑。它包含了许多常用的工具和功能，如异步编程、键、对象序列化、调试工具等。foundation 是 Flutter 框架的一部分，通常不需要单独安装，因为它已经包含在 Flutter SDK 中。

以下是 foundation 中一些常用功能的介绍和使用示例：

1. 异步编程 (Future 和 Stream)

foundation 提供了对 Future 和 Stream 的支持，用于处理异步操作。

import 'dart:async';

Future<void> fetchData() async {
  await Future.delayed(Duration(seconds: 2));
  print('Data fetched!');
}

void main() {
  fetchData().then((_) {
    print('Data processing complete.');
  });
}

2. ChangeNotifier

ChangeNotifier 是一个简单的类，用于通知监听器对象的状态已更改。它通常与 Provider 一起使用，用于状态管理。

import 'package:flutter/foundation.dart';

class Counter with ChangeNotifier {
  int _count = 0;

  int get count => _count;

  void increment() {
    _count++;
    notifyListeners();
  }
}

void main() {
  final counter = Counter();
  counter.addListener(() {
    print('Count changed to ${counter.count}');
  });

  counter.increment();
  counter.increment();
}

3. Key

Key 是 Flutter 中用于标识 Widget 的唯一标识符。foundation 提供了不同类型的 Key，如 GlobalKey、UniqueKey 等。

import 'package:flutter/material.dart';

class MyWidget extends StatelessWidget {
  final GlobalKey<_MyStatefulWidgetState> _key = GlobalKey();

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        MyStatefulWidget(key: _key),
        ElevatedButton(
          onPressed: () {
            _key.currentState?.updateText('New Text');
          },
          child: Text('Update Text'),
        ),
      ],
    );
  }
}

class MyStatefulWidget extends StatefulWidget {
  MyStatefulWidget({Key? key}) : super(key: key);

  @override
  _MyStatefulWidgetState createState() => _MyStatefulWidgetState();
}

class _MyStatefulWidgetState extends State<MyStatefulWidget> {
  String _text = 'Initial Text';

  void updateText(String text) {
    setState(() {
      _text = text;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Text(_text);
  }
}

4. 调试工具

foundation 提供了一些调试工具，如 debugPrint，用于在开发过程中打印调试信息。

import 'package:flutter/foundation.dart';

void main() {
  debugPrint('This is a debug message');
}

5. 对象序列化

foundation 提供了 DiagnosticsNode 和 Diagnosticable 类，用于对象的序列化和调试信息输出。

import 'package:flutter/foundation.dart';

class MyObject with Diagnosticable {
  final String name;
  final int age;

  MyObject({required this.name, required this.age});

  @override
  void debugFillProperties(DiagnosticPropertiesBuilder properties) {
    super.debugFillProperties(properties);
    properties.add(StringProperty('name', name));
    properties.add(IntProperty('age', age));
  }
}

void main() {
  final obj = MyObject(name: 'John', age: 30);
  debugPrint(obj.toString());
}

6. Listenable

Listenable 是一个接口，用于表示可以监听的对象。ChangeNotifier 就是 Listenable 的一个实现。

import 'package:flutter/foundation.dart';

class MyListenable with ChangeNotifier {
  String _value = '';

  String get value => _value;

  void setValue(String newValue) {
    _value = newValue;
    notifyListeners();
  }
}

void main() {
  final listenable = MyListenable();
  listenable.addListener(() {
    print('Value changed to ${listenable.value}');
  });

  listenable.setValue('Hello');
  listenable.setValue('World');
}