Flutter Windows单一实例启动控制插件windows_single_launch的使用

Flutter Windows单一实例启动控制插件windows_single_launch的使用

描述

windows_single_launch 是一个用于在Windows上实现单实例启动的Flutter插件。它允许你从一个实例中启动多个应用程序，并且每次启动时都会将当前实例带到前台，如果应用程序被隐藏，则会使其可见。

使用方法

  1. 在你的应用 main 函数开始处添加 WidgetsFlutterBinding.ensureInitialized();
  2. 用 WindowsSingleLaunch.singleRunApp() 替换 runApp() 来运行你的应用。
  3. 调用 singleRunApp() 方法时传递以下参数：
    • app: (Your application)：你的应用实例。
    • originalName: (OriginalName of your application written in windows/runner/Runner.rc)：应用程序在 Windows 跑步机文件中的原始名称。
    • windowTitleName: (title of your application written in windows/runner/main.cpp)：应用程序标题在 Windows 跑步机文件中的名称。

示例代码

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  WindowsSingleLaunch().singleRunApp(
    app: const MyApp(),
    originalName: "windows_single_launch_example.exe",
    windowTitleName: "Windows Single Launch",
  );
}

示例代码解释

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  WindowsSingleLaunch().singleRunApp(
    app: const MyApp(),
    originalName: "windows_single_launch_example.exe",
    windowTitleName: "Windows Single Launch",
  );
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
      ),
    );
  }
}

更多关于Flutter Windows单一实例启动控制插件windows_single_launch的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter Windows单一实例启动控制插件windows_single_launch的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，windows_single_launch 是一个用于 Flutter Windows 应用的插件，它允许开发者控制应用只能以单一实例运行。当尝试启动第二个实例时，可以通过发送消息到第一个实例来通知它。以下是如何在 Flutter Windows 应用中使用 windows_single_launch 插件的示例代码。

1. 添加依赖

首先，在你的 Flutter 项目的 pubspec.yaml 文件中添加 windows_single_launch 依赖：

dependencies:
  flutter:
    sdk: flutter
  windows_single_launch: ^0.1.0  # 请检查最新版本号

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

2. 配置插件

在 Flutter Windows 项目中，你需要进行一些额外的配置来使用这个插件。打开你的 Flutter 项目中的 windows 文件夹，然后编辑 CMakeLists.txt 和 PluginRegistrant.cpp 文件。

CMakeLists.txt

确保 CMakeLists.txt 文件中包含插件的源文件。通常，这个步骤在添加依赖后由 Flutter 工具自动处理，但你可以检查并确认以下内容：

# 在 add_subdirectory 调用之后添加以下内容（如果尚未存在）
add_subdirectory(${CMAKE_SOURCE_DIR}/../flutter/.pub-cache/hosted/pub.dartlang.org/windows_single_launch-<version>/windows)

请将 <version> 替换为实际的插件版本号。

PluginRegistrant.cpp

在 PluginRegistrant.cpp 文件中，确保注册了插件：

#include "plugins/windows_single_launch/windows_single_launch_plugin.h"

void RegisterPlugins(flutter::PluginRegistry* registry) {
  WindowsSingleLaunchPlugin::RegisterWithRegistrar(
      registry->GetRegistrarForPlugin("windows_single_launch"));
}

3. 使用插件

在你的 Flutter 应用的 Dart 代码中，你可以使用 windows_single_launch 插件来控制单一实例启动并处理来自第二个实例的消息。

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

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

  // 检查是否为单一实例并设置消息处理器
  WindowsSingleLaunch().initialize().then((isSingleInstance) {
    if (!isSingleInstance) {
      WindowsSingleLaunch().onMessageReceived.listen((String message) {
        // 处理来自第二个实例的消息
        print('Received message from second instance: $message');
        // 你可以在这里显示一个通知、对话框等
      });
    }
  });
}

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

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Windows Single Instance Demo'),
      ),
      body: Center(
        child: Text('This is the main window.'),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          // 模拟启动第二个实例，这里只是发送一个消息到当前实例
          WindowsSingleLaunch().sendMessage('Hello from a simulated second instance!');
        },
        tooltip: 'Send Message',
        child: Icon(Icons.send),
      ),
    );
  }
}

注意

  • 上述代码中的 sendMessage 方法仅用于演示目的，它模拟了从第二个实例发送消息到当前实例。在实际应用中，第二个实例的启动通常是由用户操作触发的。
  • 当你尝试以第二个实例启动应用时，onMessageReceived 监听器将捕获并处理该消息。

通过上述步骤，你可以在 Flutter Windows 应用中实现单一实例启动控制，并处理来自第二个实例的消息。

回到顶部