feat: add offline mode

[Mercy811]

Summary

User interfaces

This feature is enabled by default.

To opt out of using NetworkConnectivityCheckerPlugin and implement custom offline logic, setting config.offline to NetworkConnectivityCheckerPlugin.Disabled will prevent the plugin from installing.

var testInstance = Amplitude(
    configuration: Configuration(
        apiKey: "API_KEY",
        offline: NetworkConnectivityCheckerPlugin.Disabled
    )
)

Tests

Tests to toggling network connection are based on https://amplitude.atlassian.net/wiki/spaces/GOV/pages/2319024851/Mock+network+changes.

Note

Note that simulators don't accurately reflect network changes of Mac (example). So test it on a real device.

Checklist

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

[Mercy811]

Don't merge it until running on a real device

[justin-fiedler]

Looks good. Thanks @Mercy811!

[Mercy811]

NWPathMonitor.pathUploadHandler being called multiple times with the same path is a known issue ( see discussion here). Avoid multiple flush() when back to online at 0f072ad

[justin-fiedler]

Looks good. Thanks @Mercy811 !

[github-actions]

🎉 This PR is included in version 1.3.0 🎉

The release is available on:

• GitHub release
• v1.3.0

Your semantic-release bot 📦🚀