[iOS] Quick Actions Not Triggered When App is in Background

[BaliakaIriana]

Steps to reproduce

❗ Description
On iOS, when the app is in the background, tapping on a registered Quick Action does not execute the expected logic. However, the same Quick Action works correctly when:

• The app is terminated
• The app is in any state on Android

To reproduce:

1. Install and configure quick_actions package
2. Register Quick Actions in main()
3. Run app on iOS
4. Put app in background (press home button or swipe)
5. Trigger a Quick Action from the home screen icon
6. Observe: app resumes, but no logic is executed

Expected results

Quick Actions should trigger the registered handler and perform the corresponding action even when the app is in the background.

Actual results

On iOS:

App resumes (comes to foreground) but the Quick Action callback is not invoked.

No navigation or logic tied to the action is triggered.

On Android:

Quick Actions work perfectly regardless of app state (background, foreground, or terminated).

Code sample

Code sample

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

import 'src/presentation/features/auth/pages/login_screen.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 QuickActions actions;

  @override
  void initState() {
    actions = QuickActions();
    actions.initialize((type) {
      switch (type) {
        case 'action_one':
          ScaffoldMessenger.of(context).showSnackBar(
            const SnackBar(content: Text('Action One Triggered')),
          );
          break;
        case 'action_two':
          ScaffoldMessenger.of(context).showSnackBar(
            const SnackBar(content: Text('Action Two Triggered')),
          );
          break;
        default:
          break;
      }
    });
    actions.setShortcutItems([
      const ShortcutItem(type: 'action_one', localizedTitle: 'Action One', icon: 'icon_one'),
      const ShortcutItem(type: 'action_two', localizedTitle: 'Action Two', icon: 'icon_two'),
    ]);
    super.initState();
  }
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.red),
        useMaterial3: true,
      ),
      home: const LoginScreen(),
    );
  }
}

Screenshots or Video

Screenshots / Video demonstration

[Upload media here]

Logs

Logs

[Paste your logs here]

Flutter Doctor output

Doctor output

[!] Flutter (Channel [user-branch], 3.24.5, on macOS 15.4.1 24E263 darwin-arm64, locale fr-MG)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 16.2)
[✓] Android Studio (version 2024.3)
[✓] VS Code (version 1.100.2)```

</details>

[tirth-patel-nc]

Triage Report

I was able to reproduce the issue using the provided steps on master (3.33.0-1.0.pre.365) channels with quick_actions 1.1.0 on iOS. However on stable (3.32.1) it is working fine. Android is working fine on both flutter versions.

Code Sample

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

void main() {
  runApp(const MaterialApp(home: Scaffold(body: MyApp())));
}

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

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

class _MyAppState extends State<MyApp> {
  late final QuickActions actions;

  @override
  void initState() {
    super.initState();
    actions = QuickActions();
    actions.initialize((type) {
      switch (type) {
        case 'action_one':
          ScaffoldMessenger.of(
            context,
          ).showSnackBar(const SnackBar(content: Text('Action One Triggered')));
          break;
        case 'action_two':
          ScaffoldMessenger.of(
            context,
          ).showSnackBar(const SnackBar(content: Text('Action Two Triggered')));
          break;
        default:
          break;
      }
    });
    actions.setShortcutItems([
      const ShortcutItem(
        type: 'action_one',
        localizedTitle: 'Action One',
        icon: 'icon_one',
      ),
      const ShortcutItem(
        type: 'action_two',
        localizedTitle: 'Action Two',
        icon: 'icon_two',
      ),
    ]);
  }

  @override
  Widget build(BuildContext context) {
    return Center(child: Text('Test'));
  }
}

Flutter Version	Video
3.32.1 Stable	Screen.Recording.2025-06-04.at.3.51.33.PM.mov
3.33.0-1.0.pre.365 Master	Screen.Recording.2025-06-04.at.3.55.20.PM.mov

#130243 might be related.

[LongCatIsLooong]

/cc @LongCatIsLooong @hellohuanlin

[jmagman]

I suspect related to the recent scene delegate adoption migration #167267.

#130243 is probably describing the right fix, which is to hook up quick_actions with the scene delegate lifecycle.