Skip to content

Add support for new bandwidthConstrainedOk flag used to deliver notifications to satellite networks#1145

Merged
jonathanedey merged 2 commits intofirebase:mainfrom
andrew-signal:andrew/bandwidth-constrained-ok
Mar 3, 2026
Merged

Add support for new bandwidthConstrainedOk flag used to deliver notifications to satellite networks#1145
jonathanedey merged 2 commits intofirebase:mainfrom
andrew-signal:andrew/bandwidth-constrained-ok

Conversation

@andrew-signal
Copy link
Contributor

@andrew-signal andrew-signal commented Oct 17, 2025

Discussion

Hi! The Android Developers page for Developing for constrained satellite networks indicates that we need to pass a new flag, bandwidth_constrained_ok in our AndroidConfig options, like so, to ensure delivery of our pushes on constrained satellite networks.

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    }
    "android": {
       "bandwidth_constrained_ok": true
    }
  }
}

In order to do this in a server app based on the firebase-admin-java SDK, we need to expose a config option in AndroidConfigBuilder.

(In practice, things seem to be okay without this flag, but the documentation says we should add it, so I'm inclined to add it.)

Testing

  • I added a new unit test to match the already extant one for direct_boot_ok.
  • mvn test passes locally on my machine.
  • I expect CI will also run on this PR.

API Changes

  • This does add the minimal new config parameter to set this parameter in AndroidConfigBuilder, which is the least intrusive change I can make to the public API to expose this now-needed functionality.

@google-cla
Copy link

google-cla bot commented Oct 17, 2025

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@lahirumaramba lahirumaramba self-assigned this Nov 5, 2025
@jonathanedey jonathanedey self-requested a review February 25, 2026 17:59
Copy link
Collaborator

@jonathanedey jonathanedey left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, Thank you @andrew-signal for the contribution!

@jonathanedey
Copy link
Collaborator

cc: @lahirumaramba, I'll merge this PR as is and have the docs updated and reviewed in a follow up pr along with the RestrictedSatelliteOk api.

@jonathanedey jonathanedey merged commit d69dcbd into firebase:main Mar 3, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants