Flutter窗口管理插件bitsdojo_window_linux_v3的使用

Flutter窗口管理插件bitsdojo_window_linux_v3的使用

在Flutter中,bitsdojo_window_linux_v3bitsdojo_window 插件的Linux实现,用于管理和自定义窗口的行为。通过该插件,您可以轻松地控制窗口的大小、位置、最大化、最小化等属性,并添加系统按钮(如最小化、最大化和关闭按钮)。

以下是一个完整的示例,展示如何在Flutter项目中使用 bitsdojo_window_linux_v3 插件来管理窗口。


使用步骤

1. 添加依赖

首先,在项目的 pubspec.yaml 文件中添加 bitsdojo_windowbitsdojo_window_linux_v3 的依赖:

dependencies:
  bitsdojo_window: ^0.22.0 # 请确保使用最新版本
  bitsdojo_window_linux_v3: ^0.22.0 # 对应的Linux实现

然后运行 flutter pub get 来安装依赖。


2. 初始化窗口

在主应用中初始化窗口。您需要创建一个 WindowController 实例,并在 build 方法中调用 bdwTitleBar 来渲染自定义标题栏。

以下是完整的代码示例:

import 'package:flutter/material.dart';
import 'package:bitsdojo_window/bitsdojo_window.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: WindowBorder(
        color: Colors.grey[800]!,
        width: 1,
        child: MyHomePage(),
      ),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final WindowController windowController = WindowController();

  @override
  void initState() {
    super.initState();
    // 启动窗口控制器
    doWhenWindowReady(() {
      const initialSize = Size(800, 600);
      appWindow.minSize = initialSize;
      appWindow.size = initialSize;
      appWindow.alignment = Alignment.center;
      appWindow.show();
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: PreferredSize(
        preferredSize: Size.fromHeight(appBarHeight),
        child: bdwTitleBar(
          controller: windowController,
          title: Text("自定义窗口标题"),
          leading: Row(
            children: [
              WindowButtons(
                controller: windowController,
                minimizeIcon: Icon(Icons.horizontal_rule), // 自定义最小化图标
                maximizeIcon: Icon(Icons.crop_square), // 自定义最大化图标
                closeIcon: Icon(Icons.close), // 自定义关闭图标
              ),
            ],
          ),
        ),
      ),
      body: Center(
        child: Text(
          "窗口管理示例",
          style: TextStyle(fontSize: 24),
        ),
      ),
    );
  }
}

3. 运行效果

运行上述代码后,您将看到一个带有自定义标题栏的窗口。窗口支持以下功能:

  • 最小化
  • 最大化/还原
  • 关闭

此外,您还可以通过 appWindow 对象进一步调整窗口行为,例如设置窗口大小限制、位置等。


更多功能

设置窗口大小限制

您可以通过 minSizemaxSize 属性限制窗口的最小和最大尺寸:

appWindow.minSize = Size(400, 300);
appWindow.maxSize = Size(1200, 800);

监听窗口事件

您可以监听窗口的各种事件,例如移动、调整大小或关闭:

appWindow.onCloseRequest.listen((event) {
  print("窗口即将关闭");
});

更多关于Flutter窗口管理插件bitsdojo_window_linux_v3的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter窗口管理插件bitsdojo_window_linux_v3的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


bitsdojo_window 是一个用于 Flutter 桌面应用程序的插件,它允许开发者自定义窗口的样式和行为,例如无边框窗口、自定义标题栏、窗口大小和位置等。bitsdojo_window_linux_v3 是该插件的 Linux 版本。

以下是如何在 Flutter 项目中使用 bitsdojo_window_linux_v3 的基本步骤:

1. 添加依赖

首先,在 pubspec.yaml 文件中添加 bitsdojo_window 依赖:

dependencies:
  flutter:
    sdk: flutter
  bitsdojo_window: ^0.1.1+3

2. 配置 Linux 平台

linux/ 目录下的 CMakeLists.txt 文件中,确保你已经添加了 bitsdojo_window 的依赖:

# Add bitsdojo_window
target_link_libraries(${BINARY_NAME} PRIVATE bitsdojo_window_linux_v3)

3. 初始化 bitsdojo_window

在你的 Flutter 应用程序的 main.dart 文件中,初始化 bitsdojo_window

import 'package:flutter/material.dart';
import 'package:bitsdojo_window/bitsdojo_window.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

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

4. 自定义窗口样式

你可以使用 bitsdojo_window 提供的 API 来自定义窗口的样式和行为。例如,你可以设置窗口为无边框、自定义标题栏等。

import 'package:flutter/material.dart';
import 'package:bitsdojo_window/bitsdojo_window.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

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

5. 自定义标题栏

你可以使用 bitsdojo_window 提供的 WindowButton 组件来创建自定义的窗口控制按钮(最小化、最大化、关闭)。

import 'package:flutter/material.dart';
import 'package:bitsdojo_window/bitsdojo_window.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Demo Home Page'),
        leading: WindowButtons(),
      ),
      body: Center(
        child: Text('Hello, world!'),
      ),
    );
  }
}

class WindowButtons extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Row(
      children: [
        MinimizeWindowButton(),
        MaximizeWindowButton(),
        CloseWindowButton(),
      ],
    );
  }
}

6. 运行应用程序

确保你已经配置好了 Flutter 桌面开发环境,然后运行你的应用程序:

flutter run -d linux
回到顶部