chore: release 0.25.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: DennisAlund

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.25.0
+- Work around stale default Graph API versions in Facebook SDK v18.x by overriding the native SDK Graph API version to `v24.0` on iOS and Android (PR [#476](https://github.com/oddbit/flutter_facebook_app_events/pull/476), fixes [#474](https://github.com/oddbit/flutter_facebook_app_events/issues/474))
+- Add `setGraphApiVersion(String version)` to forward Graph API version overrides through the plugin API (PR [#476](https://github.com/oddbit/flutter_facebook_app_events/pull/476))
+
 ## 0.24.0
 - Add `activateApp()` to manually log app activation when automatic app event logging is disabled (PR [#466](https://github.com/oddbit/flutter_facebook_app_events/pull/466))
 

README.md

@@ -132,9 +132,9 @@ The Facebook SDK v18.x ships with an outdated default Graph API version that Met
 | iOS SDK v18.x | `v17.0` | September 12, 2025 |
 | Android SDK v18.x | `v16.0` | May 14, 2025 |
 
-This plugin works around the issue by overriding the Graph API version to `v24.0` at initialization. This is transparent and requires no configuration for the vast majority of apps.
+This plugin works around the issue by overriding the Graph API version to `v24.0` during plugin initialization. This requires no extra configuration for the vast majority of apps.
 
-If you need to target a specific Graph API version (e.g. to pin to the same version as your backend), call `setGraphApiVersion` **before** `activateApp`:
+If you need to target a specific Graph API version (e.g. to pin to the same version as your backend), call `setGraphApiVersion` as early as possible in app startup before using features that may trigger Graph API requests:
 
 ```dart
 final facebookAppEvents = FacebookAppEvents();

example/pubspec.lock

@@ -47,7 +47,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "0.24.0"
+    version: "0.25.0"
   fake_async:
     dependency: transitive
     description:

ios/facebook_app_events.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'facebook_app_events'
-  s.version          = '0.24.0'
+  s.version          = '0.25.0'
   s.summary          = 'Flutter plugin for Facebook Analytics and App Events'
   s.description      = <<-DESC
 Flutter plugin for Facebook Analytics and App Events

lib/facebook_app_events.dart

@@ -505,7 +505,8 @@ class FacebookAppEvents {
   ///
   /// The plugin sets a default Graph API version at initialization because the
   /// Facebook SDK v18.x ships with an outdated default that has been removed by
-  /// Meta. Call this method **before** [activateApp] if you need a specific version.
+  /// Meta. Call this as early as possible in app startup if you need a specific
+  /// version before using plugin features that may trigger Graph API requests.
   ///
   /// The [version] string must be in the form `"vX.Y"` (e.g. `"v24.0"`).
   /// Refer to Meta's [Graph API changelog](https://developers.facebook.com/docs/graph-api/changelog/)

pubspec.yaml

@@ -1,7 +1,7 @@
 name: facebook_app_events
 description: Flutter plugin for Facebook App Events, an app measurement
   solution that provides insight on app usage and user engagement in Facebook Analytics.
-version: 0.24.0
+version: 0.25.0
 homepage: https://github.com/oddbit/flutter_facebook_app_events
 
 environment: