[Mono.Android] Obsolete Mono.Android.dll for < API-19 #2329
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
jonpryor
force-pushed
the
jonp-obsolete-mono-android-types
branch
from
c19c1e1 to
6739bc7
Compare
grendello
approved these changes
Oct 22, 2018
pjcollins
approved these changes
Oct 22, 2018
jonathanpeppers
approved these changes
Oct 22, 2018
|
Just as a tiny wording question, maybe "update" would be a more familiar term for a variety of users as compared to "bump?" |
Fixes: http://work.devdiv.io/712427 For the next major release of Visual Studio, Xamarin.Android will stop building and distributing `Mono.Android.dll` for: * v2.3 (API-10) * v4.0.3 (API-15) * v4.1 (API-16) * v4.2 (API-17) * v4.3 (API-18) This will be done for the following reasons: 1. Support for API-10 and API-15 will be dropped from the [Android NDK][0]: > Support for ICS (android-14 and android-15) will be removed from r18 2. The [Android Support Library][1], as of release 26.0.0 (July 2017), requires API-14 or higher: > Starting with Support Library version 26.0.0 (released in July 2017), > the minimum supported API level has changed to Android 4.0 (API level 14) > for all support library packages. 3. The Android Support Library replacement, [AndroidX][2], requires a `compileSdkVersion` minimum value of API-28 (v9.0). 4. As of 2018-Oct-22, the [Android Distribution Dashboard][3] shows that only ~3.8% of devices hitting the Google Play Store are running Android 4.3 (API-18) or earlier. We want to provide a "heads-up" that these assemblies will be removed, to give our customers an opportunity to bump their `$(TargetFrameworkVersion)` to v4.4 or later. To do so, add `/package/class/@deprecated` and `/package/interface/@deprecated` XML attribute to *all bound types*, via `metadata`, for API levels 1 through 18. This will cause all types to contain the following additional `[Obsolete]`: [ObsoleteAttribute (@"The assembly `Mono.Android.dll` for this API level will be removed in a future release. Please bump your `$(TargetFrameworkVersion)` to be v4.4 or greater.")] If one of these types is used from a project referencing a `Mono.Android.dll` of v4.3 or earlier, the compiler will generate the following warning for all such referenced types: MainActivity.cs(30,30): Warning CS0618: 'Activity' is obsolete: 'The assembly `Mono.Android.dll` for this API level will be removed in a future release. Please bump your `$(TargetFrameworkVersion)` to be v4.4 or greater.' [0]: https://developer.android.com/ndk/downloads/revision_history [1]: https://developer.android.com/topic/libraries/support-library/ [2]: https://developer.android.com/jetpack/androidx/ [3]: https://developer.android.com/about/dashboards/
jonpryor
force-pushed
the
jonp-obsolete-mono-android-types
branch
from
6739bc7 to
b1c9d96
Compare
jonpryor
added a commit
that referenced
this pull request
Oct 23, 2018
Fixes: http://work.devdiv.io/712427 For the next major release of Visual Studio, Xamarin.Android will stop building and distributing `Mono.Android.dll` for: * v2.3 (API-10) * v4.0.3 (API-15) * v4.1 (API-16) * v4.2 (API-17) * v4.3 (API-18) This will be done for the following reasons: 1. Support for API-10 and API-15 will be dropped from the [Android NDK][0]: > Support for ICS (android-14 and android-15) will be removed from r18 2. The [Android Support Library][1], as of release 26.0.0 (July 2017), requires API-14 or higher: > Starting with Support Library version 26.0.0 (released in July 2017), > the minimum supported API level has changed to Android 4.0 (API level 14) > for all support library packages. 3. The Android Support Library replacement, [AndroidX][2], requires a `compileSdkVersion` minimum value of API-28 (v9.0). 4. As of 2018-Oct-22, the [Android Distribution Dashboard][3] shows that only ~3.8% of devices hitting the Google Play Store are running Android 4.3 (API-18) or earlier. We want to provide a "heads-up" that these assemblies will be removed, to give our customers an opportunity to bump their `$(TargetFrameworkVersion)` to v4.4 or later. To do so, add `/package/class/@deprecated` and `/package/interface/@deprecated` XML attribute to *all bound types*, via `metadata`, for API levels 1 through 18. This will cause all types to contain the following additional `[Obsolete]`: [ObsoleteAttribute (@"The assembly `Mono.Android.dll` for this API level will be removed in a future release. Please bump your `$(TargetFrameworkVersion)` to be v4.4 or greater.")] If one of these types is used from a project referencing a `Mono.Android.dll` of v4.3 or earlier, the compiler will generate the following warning for all such referenced types: MainActivity.cs(30,30): Warning CS0618: 'Activity' is obsolete: 'The assembly `Mono.Android.dll` for this API level will be removed in a future release. Please bump your `$(TargetFrameworkVersion)` to be v4.4 or greater.' [0]: https://developer.android.com/ndk/downloads/revision_history [1]: https://developer.android.com/topic/libraries/support-library/ [2]: https://developer.android.com/jetpack/androidx/ [3]: https://developer.android.com/about/dashboards/
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fixes: http://work.devdiv.io/712427
For the next major release of Visual Studio, Xamarin.Android will stop
building and distributing
Mono.Android.dllfor:This will be done for the following reasons:
Support for API-10 and API-15 will be dropped from the
Android NDK:
The Android Support Library, as of release 26.0.0
(July 2017), requires API-14 or higher:
The Android Support Library replacement, AndroidX, requires
a
compileSdkVersionminimum value of API-28 (v9.0).As of 2018-Oct-22, the Android Distribution Dashboard shows
that only ~3.8% of devices hitting the Google Play Store are
running Android 4.3 (API-18) or earlier.
We want to provide a "heads-up" that these assemblies will be removed,
to give our customers an opportunity to bump their
$(TargetFrameworkVersion)to v4.4 or later.To do so, add
/package/class/@deprecatedand/package/interface/@deprecatedXML attribute to all bound types,via
metadata, for API levels 1 through 18. This will cause alltypes to contain the following additional
[Obsolete]:If one of these types is used from a project referencing a
Mono.Android.dllof v4.3 or earlier, the compiler will generate thefollowing warning for all such referenced types: