feat: offline support

[Mercy811]

Summary

Requirements

ACCESS_NETWORK_STATE permission is required. If not, this feature will not supported and will fallback to previous behavior (causing an error)

User interfaces

This feature is enabled by default.

To opt out of using AndroidNetworkConnectivityPlugin and implement custom offline logic, setting config.offline to null will prevent plugin setup.

// Disable this feature
amplitude = Amplitude(
    Configuration(
        apiKey = AMPLITUDE_API_KEY,
        context = applicationContext,
        offline = AndroidNetworkConnectivityCheckerPlugin.Disabled
    )
)

// Implement your own plugin to toggle offline 

Implementation

• AndroidNetworkConnectivityPlugin
  • Network connectivity checker will detect network connectivity when setup and set config.offline accordingly
  • Network listener will flush all stored events when back to online
• EventPipeline
  • If no network, it will only save events to storage and will not schedule a flush
  • Otherwise (network connected, no permission, feature disabled), save events and schedule a flush

Checklist

• [ ] Does your PR title have the correct title format?
• Does your PR have a breaking change?:

[github-actions[bot]]

:tada: This PR is included in version 1.13.0 :tada:

The release is available on:

• GitHub release
• v1.13.0

Your semantic-release bot :package::rocket: