bitsdojo_window_macos_v3 是一个用于 Flutter 的插件，主要用于在 macOS 平台上自定义窗口行为，例如窗口的标题栏、窗口大小、窗口位置、窗口阴影等。它允许开发者更好地控制 macOS 应用程序的窗口外观和行为。

以下是如何在 Flutter 项目中使用 bitsdojo_window_macos_v3 插件的步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 bitsdojo_window_macos_v3 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  bitsdojo_window_macos_v3: ^0.1.1

然后运行 flutter pub get 来获取依赖。

2. 初始化插件

在你的 main.dart 文件中，初始化 bitsdojo_window_macos_v3 插件。

import 'package:flutter/material.dart';
import 'package:bitsdojo_window_macos_v3/bitsdojo_window_macos.dart';

void main() {
  runApp(MyApp());
  doWhenWindowReady(() {
    final initialSize = Size(800, 600);
    appWindow.size = initialSize;
    appWindow.minSize = initialSize;
    appWindow.title = "My Flutter macOS App";
    appWindow.show();
  });
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter macOS App',
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter macOS App'),
      ),
      body: Center(
        child: Text('Hello, macOS!'),
      ),
    );
  }
}

3. 自定义窗口行为

bitsdojo_window_macos_v3 提供了多种方法来控制窗口的行为和外观。以下是一些常见的用法：

设置窗口标题

appWindow.title = "My Custom Title";

设置窗口大小

appWindow.size = Size(800, 600);

设置窗口最小大小

appWindow.minSize = Size(400, 300);

设置窗口最大大小

appWindow.maxSize = Size(1200, 900);

设置窗口位置

appWindow.position = Offset(100, 100);

隐藏/显示窗口

appWindow.hide();
appWindow.show();

最小化/最大化窗口

appWindow.minimize();
appWindow.maximize();

关闭窗口

appWindow.close();

4. 自定义标题栏

bitsdojo_window_macos_v3 还允许你自定义窗口的标题栏。你可以隐藏默认的标题栏，并使用 Flutter 控件来创建自定义的标题栏。

import 'package:flutter/material.dart';
import 'package:bitsdojo_window_macos_v3/bitsdojo_window_macos.dart';

void main() {
  runApp(MyApp());
  doWhenWindowReady(() {
    final initialSize = Size(800, 600);
    appWindow.size = initialSize;
    appWindow.minSize = initialSize;
    appWindow.title = "My Flutter macOS App";
    appWindow.show();
  });
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter macOS App',
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Column(
        children: [
          WindowTitleBarBox(
            child: Row(
              children: [
                Expanded(child: MoveWindow()),
                MinimizeWindowButton(),
                MaximizeWindowButton(),
                CloseWindowButton(),
              ],
            ),
          ),
          Expanded(
            child: Center(
              child: Text('Hello, macOS!'),
            ),
          ),
        ],
      ),
    );
  }
}

在这个例子中，我们使用了 WindowTitleBarBox 来创建一个自定义的标题栏，并添加了最小化、最大化和关闭按钮。

5. 处理窗口事件

你还可以监听窗口事件，例如窗口大小改变、窗口移动等。

appWindow.onWindowResized = () {
  print('Window resized to ${appWindow.size}');
};

appWindow.onWindowMoved = () {
  print('Window moved to ${appWindow.position}');
};

6. 其他功能

bitsdojo_window_macos_v3 还提供了其他一些功能，例如设置窗口的透明度、阴影等。你可以查阅插件的文档以获取更多详细信息和用法。

7. 运行项目

完成上述步骤后，你可以运行你的 Flutter 项目，并查看自定义的窗口行为和外观。

flutter run