[Mono.Android] Bind API-S Beta 3 and enumify

[jpobst]

Context: https://developer.android.com/about/versions/12/overview
Context: https://android-developers.googleblog.com/search/label/Android12

Android 12 Beta 3 has been released.

• API diff vs. Beta 2
• API diff vs. API-30

Given that these API's are "final-ish", we have performed enumification on this version.

There are some methods that are documented as taking constants that should be enumified, but the constants do not exist in the API yet:

?,31,android/net/ipsec/ike,TunnelModeChildSessionParams$Builder,addInternalAddressRequest,addressFamily,
?,31,android/net/ipsec/ike,TunnelModeChildSessionParams$Builder,addInternalDhcpServerRequest,addressFamily,
?,31,android/net/ipsec/ike,TunnelModeChildSessionParams$Builder,addInternalDnsServerRequest,addressFamily,
?,31,android/telephony,[Interface]TelephonyCallback$CallDisconnectCauseListener,onCallDisconnectCauseChanged,preciseDisconnectCause,
?,31,android/telephony,[Interface]TelephonyCallback$DataActivationStateListener,onDataActivationStateChanged,state,

Example, see preciseDisconnectCause parameter documentation for onCallDisconnectCauseChanged. Compare to the disconnectCause parameter documentation which has links to documented constants.

For now, these methods are not enumified. We will have to see if the August update adds these constants. (And determine if it too late to enumify them.)

We will mark this API level as stable in a future commit, as that generally requires changing quite a few files.

[jonpryor]

@jpobst wrote:

Google's documented timeline for Android 12 is unchanged

In point of fact, it has changed. From their announcement: https://android-developers.googleblog.com/2021/07/android-12-beta-3.html

First, the title:

Android 12 Beta 3 and final APIs

Note "final APIs". 🤔

Then:

Beta 3 also includes the final Android 12 APIs and the official SDK.

Which matches the sole change in this PR:

-				new AndroidPlatformComponent ("platform-S_r05",    apiLevel: "S",  pkgRevision: "5"),
+				new AndroidPlatformComponent ("platform-31_r01",   apiLevel: "S",  pkgRevision: "1"),

platform-31_r01 is not what Google has historically called a package with an unstable API.

The timeline page has also been updated, though perhaps it hadn't been updated at the time the PR was created?

Timeline: July
Build: Beta 3
Type: Incremental Beta-quality release, final APIs [emphasis @jonpryor]
Developer actions: Continue compatibility testing, watch for feedback from Android Beta users. Start early testing with targeting Android 12, compile apps against official API 31 SDK [emphasis @jonpryor]

API-31 is now stable. On to enumification!

[jonpryor]

wrt CallDisconnectCauseListener.onCallDisconnectCauseChanged():

?,31,android/telephony,[Interface]TelephonyCallback$CallDisconnectCauseListener,onCallDisconnectCauseChanged,preciseDisconnectCause,

The docs mention a @hide type PreciseDisconnectCause:

https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/telephony/java/android/telephony/PreciseDisconnectCause.java

As such, there's nothing to enumify.

---

wrt TunnelModeChildSessionParams.Builder.addInternalAddressRequest():

?,31,android/net/ipsec/ike,TunnelModeChildSessionParams$Builder,addInternalAddressRequest,addressFamily,

The docs refer to AF_INET. Viewing the appropriate source: https://android.googlesource.com/platform/frameworks/opt/net/ike/+/refs/heads/master/src/java/android/net/ipsec/ike/TunnelModeChildSessionParams.java

AF_INET is via static import, which comes from android.os.OsConstants: https://android.googlesource.com/platform/libcore/+/master/luni/src/main/java/android/system/OsConstants.java

wherein OsConstants.AF_INET is not a compile-time constant. Consequently, we cannot enumify this.

This logic also applies to the other TunnelModeChildSessionParams.Builder.add*Request() methods.

---

wrt TelephonyCallback.DataActivationStateListener.onDataActivationStateChanged():

?,31,android/telephony,[Interface]TelephonyCallback$DataActivationStateListener,onDataActivationStateChanged,state,

Docs: https://developer.android.com/reference/android/telephony/TelephonyCallback.DataActivationStateListener?hl=en#onDataActivationStateChanged(int)

The docs mention an android.telephony.TelephonyManager type, likely:
https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/telephony/java/android/telephony/TelephonyManager.java

The SIM_ACTIVATION_STATE_* fields are likewise @hide, and thus cannot be enumified.

[jonpryor]

Commit message?

[Mono.Android] Bind Android 12 Beta 3 and API-31 enumification (#6089)

Context: https://developer.android.com/about/versions/12/overview
Context: https://android-developers.googleblog.com/search/label/Android12

Android 12 [Beta 3 has been released][0].

  * [API diff vs. Beta 2][1]
  * [API diff vs. API-30][2]

Given that these API's are believed to be final (-ish?), we have
performed enumification on this version.

We will mark this API level as stable in a future commit, as that
generally requires changing quite a few files.

There are some methods that are documented as taking constants which
we think would ideally be enumified, but the constants are not public.

	?,31,android/net/ipsec/ike,TunnelModeChildSessionParams$Builder,addInternalAddressRequest,addressFamily,
	?,31,android/net/ipsec/ike,TunnelModeChildSessionParams$Builder,addInternalDhcpServerRequest,addressFamily,
	?,31,android/net/ipsec/ike,TunnelModeChildSessionParams$Builder,addInternalDnsServerRequest,addressFamily,

`TunnelModeChildSessionParams.Builder.addInternal*Request()` methods
like [`TunnelModeChildSessionParams.Builder.addInternalAddressRequest(int)`][3]
are documented as taking `AF_INET` or `AF_INET6` values.

Perusing the [`TunnelModeChildSessionParams.java`][4] source, we see
that `AF_INET` is an
[`import static android.system.OsConstants.AF_INET`][5], which is
*not* a constant value.  As such, it *cannot* be enumified, and thus
none of these methods can be enumified.


	?,31,android/telephony,[Interface]TelephonyCallback$CallDisconnectCauseListener,onCallDisconnectCauseChanged,preciseDisconnectCause,

The `preciseDisconnectCause` parameter of
[`TelephonyCallback.CallDisconnectCauseListener.onCallDisconnectCauseChanged()][6]
is documented as being a value from
`android.telephony.PreciseDisconnectCause`.  However,
[`PreciseDisconnectCause` is `@hide`][7]; it can't be bound.


	?,31,android/telephony,[Interface]TelephonyCallback$DataActivationStateListener,onDataActivationStateChanged,state,

Similar to the `PreciseDisconnectCause` scenario, the `state` parameter in
[`TelephonyCallback.DataActivationStateListener.onDataActivationStateChanged()`][8]
is documented as being a
[`android.telephony.TelephonyManager.SIM_ACTIVATION_STATE_*`][9]
value, which is `@hide`, and thus cannot be bound.

[0]: https://android-developers.googleblog.com/2021/07/android-12-beta-3.html
[1]: https://developer.android.com/sdk/api_diff/31-incr/changes
[2]: https://developer.android.com/sdk/api_diff/31/changes
[3]: https://developer.android.com/reference/android/net/ipsec/ike/TunnelModeChildSessionParams.Builder#addInternalAddressRequest(int)
[4]: https://android.googlesource.com/platform/frameworks/opt/net/ike/+/9dbc4348a97db2076e6841669525d733bbacc287/src/java/android/net/ipsec/ike/TunnelModeChildSessionParams.java#19
[5]: https://developer.android.com/reference/android/system/OsConstants#AF_INET
[6]: https://developer.android.com/reference/android/telephony/TelephonyCallback.CallDisconnectCauseListener#onCallDisconnectCauseChanged(int,%20int)
[7]: https://android.googlesource.com/platform/frameworks/base/+/300c70d67617d01b3b0383742d275ab945a9ed80/telephony/java/android/telephony/PreciseDisconnectCause.java#23
[8]: https://developer.android.com/reference/android/telephony/TelephonyCallback.DataActivationStateListener?hl=en#onDataActivationStateChanged(int)
[9]: https://android.googlesource.com/platform/frameworks/base/+/0c13fd19ecbb60c328a95e3c1620e03c7c8826cd/telephony/java/android/telephony/TelephonyManager.java#4921