feat(ios): adopt UISceneDelegate (Flutter 3.38+)

[DennisAlund]

Summary

Adopts FlutterSceneLifeCycleDelegate on iOS so Facebook URL callbacks (deep links / deferred app links) keep reaching the SDK on apps using the UIScene lifecycle — the default for Flutter 3.38+. Under UIScene, iOS routes URL opens to the scene delegate, so the existing application(_:open:options:) path silently stops firing; this registers as a scene delegate too and forwards those opens. The legacy AppDelegate path is retained for non-UIScene apps.

Mirrors what flutter_facebook_auth 7.1.7 did (same change, same flutter: ">=3.38.0" floor).

Fixes #489.

Changes

• iOS (FacebookAppEventsPlugin.swift): conform to FlutterSceneLifeCycleDelegate, add registrar.addSceneDelegate(instance), and implement scene(_:openURLContexts:) -> Bool. The handler reconstructs the open-URL options (sourceApplication / annotation / openInPlace) from each UIOpenURLContext and forwards via FBSDK 18.x's modern application(_:open:options:) overload — returning whether the SDK handled any URL.
• Breaking: minimum Flutter raised to >=3.38.0 (required for FlutterSceneLifeCycleDelegate / addSceneDelegate). Dart sdk constraint unchanged.
• Version 0.28.0 → 0.29.0 (pubspec.yaml + podspec synced per CONTRIBUTING), example Flutter floor raised, lockfiles updated, CHANGELOG.md + README.md updated.
• No Dart or Android changes — the Dart API and MethodChannel surface are unchanged.

Test plan

• flutter test — 51/51 pass (no Dart changes; suite confirms no regressions)
• flutter analyze — no new issues (2 pre-existing infos in example/lib/main.dart)
• flutter pub get resolves on the new >=3.38.0 floor (root + example)
• CI: example iOS build via CocoaPods (compiles the new Swift against Flutter 3.38 — could not run locally; this machine has no full Xcode)
• Optional manual: trigger an fb<APP_ID>:// URL open on a UIScene host app and confirm the SDK processes it

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adopts Flutter’s iOS UIScene plugin lifecycle APIs so Facebook SDK URL callbacks (deep links / deferred app links) continue to be forwarded correctly on Flutter 3.38+ apps using UISceneDelegate, while retaining the legacy UIApplicationDelegate path for older setups.

Changes:

• iOS: register as a FlutterSceneLifeCycleDelegate and forward scene(_:openURLContexts:) URL opens to FBSDKCoreKit’s ApplicationDelegate.
• Raise minimum Flutter SDK constraint to >=3.38.0 and bump package version to 0.29.0 (including example + lockfiles + podspec sync).
• Update README/CHANGELOG to document UIScene lifecycle support and the new Flutter floor.

Reviewed changes

Copilot reviewed 6 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
README.md	Documents UIScene lifecycle support and updates various documentation links.
pubspec.yaml	Bumps package version and raises Flutter minimum to 3.38.0.
pubspec.lock	Updates Flutter SDK floor in lockfile metadata.
ios/facebook_app_events/Sources/facebook_app_events/FacebookAppEventsPlugin.swift	Registers a scene delegate and forwards scene URL opens to the Facebook SDK.
ios/facebook_app_events.podspec	Syncs podspec version to 0.29.0.
example/pubspec.yaml	Raises example’s Flutter minimum to 3.38.0.
example/pubspec.lock	Syncs example lockfile Flutter floor and local package version.
CHANGELOG.md	Adds 0.29.0 entry describing UISceneDelegate adoption and breaking Flutter floor bump.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.