feat(connectivity_plus): Return multiple active types on MacOS/iOS when available

[vbuberen]

Description

Switching from check for active used connection on iOS/MacOS to available connections to return multiple connection types when such are available. Tested with a dongle for MacBook which has Ethernet port and looks like getting results as expected:

Here is a screenshot from a few more test cases where I tried to connect/disconnect both Wi-Fi and Ethernet

Additionally did a few changes to the API documentation comments.

Related Issues

Closes #3073

Breaking Change

Does your PR require plugin users to manually update their apps to accommodate your change?

• Yes, this is a breaking change (please indicate that with a ! in the title as explained in Conventional Commits).
• No, this is not a breaking change.

[vbuberen]

Would appreciate an additional check on how it works on iOS with mobile and wi-fi active as don't have iPhone with a SIM card

[miquelbeltran]

Would appreciate an additional check on how it works on iOS with mobile and wi-fi active as don't have iPhone with a SIM card

I should be able to do that.

Btw, I think we can change the Android implementation to also report the available connections instead of just the used ones, but I don't remember exactly now what was the api.

[miquelbeltran]

Maybe we should implement this change in a different stream listener?

In other words:

• checkConnectivity and onConnectivityChanged continue to report the "active" used connection
• A new property availableConnectivity and onAvailableConnectivityChanged report on all available interfaces, even when not actively used.

I know it is more work, but I think there is still a valid use case for the previous implementation.

While we implement the rest of the platforms, we can mirror availableConnectivity to checkConnectivity if no specific implementation for availableConnectivity exists.

[vbuberen]

Btw, I think we can change the Android implementation to also report the available connections instead of just the used ones, but I don't remember exactly now what was the api.

For some reason I thought that on Android we already do it this way and return multiple types after introducing this feature with multiple types returned. But seems like I confused something as tested and see that no, we return only the one currently active/used ones.

In other words:
checkConnectivity and onConnectivityChanged continue to report the "active" used connection
A new property availableConnectivity and onAvailableConnectivityChanged report on all available interfaces, even when not actively used.

I like this idea. It would make sense for users, who rely on onConnectivityChanged as a way to determine if user has internet (even though the plugin doesn't guarantee that, but still most people use the plugin for this exact purpose).
Will need to do some additional research on APIs to achieve this.

[miquelbeltran]

If I remember correctly, the hasTransport() method says if the interface exists, and hasCapability() if it is being used. Both are on the NetworkCapabilities class, so the implementation shouldn't be too different.

[vbuberen]

If I remember correctly, the hasTransport() method says if the interface exists, and hasCapability() if it is being used. Both are on the NetworkCapabilities class, so the implementation shouldn't be too different.

Yeah, that is for Android. I meant more Windows/Linux platforms as a subject for research as not really familiar with them.

[vbuberen]

I don't see any activity in the related issue, so will just close the PR, considering having no real value in expanding API that way.