go_home

程序化触发在Android和iOS上的“返回主屏幕”操作。

开始使用

通过在您的Flutter应用程序中调用 GoHome.sendAppToHome()，该插件会将应用程序发送到后台（同时触发适当的生命周期事件）。

这在测试期间可能很有用，如果您应用具有后台功能（如后台音频播放或画中画模式），并且希望编程方式触发这些后台模式。 但是，请注意风险！（见下文）

风险

iOS

• Apple 不赞成程序化退出应用程序（尽管此插件实际上并没有那样做，只是将应用程序发送到后台）
• 尚未确认，苹果是否允许生产应用程序中使用此类代码
• 然而，已经有一些商店中的应用程序在某些场景中使用了类似逻辑（例如，当视频进入画中画模式时，应用程序移至后台）

不要程序化退出

永远不要程序化退出iOS应用程序，因为人们可能会将其视为崩溃。然而，如果外部情况阻止了您的应用程序正常运行，您需要告诉用户有关情况，并解释他们可以采取什么措施。

根据应用程序故障的严重程度，您有两个选择...

Android

• 如果设备上没有默认的主应用程序被选中，可能会出现“主应用选择器”对话框。（这种情况对99.9%的用户来说可能不太常见）

示例代码

example/lib/main.dart

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

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

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  late final AppLifecycleListener _listener;

  @override
  void initState() {
    super.initState();

    // 初始化 AppLifecycleListener 类并传递回调
    _listener = AppLifecycleListener(
      onStateChange: _onStateChanged,
    );
  }

  // 监听应用程序生命周期状态的变化
  void _onStateChanged(AppLifecycleState state) {
    print("生命周期状态改变: $state");
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () => GoHome.sendAppToHome(), // 触发将应用发送到后台的操作
            child: const Text("将应用发送到后台"),
          ),
        ),
      ),
    );
  }

  @override
  void dispose() {
    // 不要忘记释放监听器
    _listener.dispose();

    super.dispose();
  }
}