[Bug]: configure fails on iOS device: PlatformException

[Z6P0]

Required Reading

• Confirmed

Plugin Version

1.5.0

Flutter Doctor

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.38.9, on macOS 14.8.3 23J220 darwin-arm64, locale
    fr-FR)
[✓] Android toolchain - develop for Android devices (Android SDK version
    36.0.0-rc4)
[✓] Xcode - develop for iOS and macOS (Xcode 16.2)
[✓] Chrome - develop for the web
[✓] Connected device (4 available)
[✓] Network resources

• No issues found!

Mobile operating-system(s)

• iOS
• Android

Device Manufacturer(s) and Model(s)

iPhone 12 mini

Device operating-systems(s)

iOS 17.7.1

What happened?

The example app fails at BackgroundFetch.configure with this error:

flutter: [BackgroundFetch] ERROR: PlatformException(1, null, 1, null)

It runs without error on iOS simulator.

Plugin Code and/or Config

// See https://pub.dev/packages/background_fetch#-example

Relevant log output

flutter: [BackgroundFetch] ERROR: PlatformException(1, null, 1, null)
[ERROR:flutter/runtime/dart_vm_initializer.cc(40)] Unhandled Exception: PlatformException(1, null, 1, null)

[christocracy]

Search your ios settings "background refresh". You've got it disabled globally or at app level.

[Z6P0]

This is it!
However I would appreciate if the app didn't crash at startup because of this global setting. Can you please just return an error code?

[christocracy]

This is not a crash:

flutter: [BackgroundFetch] ERROR: PlatformException(1, null, 1, null)
[ERROR:flutter/runtime/dart_vm_initializer.cc(40)] Unhandled Exception: PlatformException(1, null, 1, null)

It's an unhandled exception. Why don't you wrap your code in an exception handler?

[Z6P0]

Of course I could put exception handlers everywhere but since the configure method returns a status code I expected it would manage exceptions internally.