Pausing IAMs dismisses any currently showing IAM

[jennantilla]

Description

One Line Summary

Pausing IAMs dismisses any currently showing IAM

Details

Detects if there is currently an IAM being displayed when paused is set to true. If so we dismiss the IAM.

Motivation

Add the ability to programmatically close an IAM. This could be used in response to the IAM click listener, or some other event happening in the application.

Scope

In-App Messages

Testing

Manual testing

Tested pausing IAM from the IAM Lifecycle Listener onDidDisplay event. IAM is dismissed, remaining lifecycle callback listeners fire, and queued IAMs don't show.

Tested on Android Studio 2023.3 with a fresh install of the OneSignal example app on a Pixel 8 with Android 14.

Affected code checklist

• Notifications
  • Display
  • Open
  • Push Processing
  • Confirm Deliveries
• Outcomes
• Sessions
• In-App Messaging
• REST API requests
• Public API changes

Checklist

Overview

• I have filled out all REQUIRED sections above
• PR does one thing
  • If it is hard to explain how any codes changes are related to each other then it most likely needs to be more than one PR
• Any Public API changes are explained in the PR details and conform to existing APIs

Testing

• I have included test coverage for these changes, or explained why they are not needed
• All automated tests pass, or I explained why that is not possible
• I have personally tested this on my device, or explained why that is not possible

Final pass

• Code is as readable as possible.
  • Simplify with less code, followed by splitting up code into well named functions and variables, followed by adding comments to the code.
• I have reviewed this PR myself, ensuring it meets each checklist item
  • WIP (Work In Progress) is ok, but explain what is still in progress and what you would like feedback on. Start the PR title with "WIP" to indicate this.

---

This change is 

[emawby]

Did you test by pausing IAMs in the click handler as well?