Xamarin.Android 10.2.0.99

February 19, 2020 — Xamarin.Android 10.2.0.99 was published as part of Visual Studio 2019 version 16.5 Preview 3.

Corresponding Visual Studio 2019 Preview release notes

• Visual Studio 2019 Preview

What's new

• Issues fixed
• Installing
• Open source

Issues fixed

Application and library build and deployment

• Developer Community 790804, Developer Community 854497: Starting in Xamarin.Android 10.1, Mono.AndroidTools.RequiresUninstallException: The installed package is incompatible. Please manually uninstall and try again. interrupted deployment if the keystore used to sign the app had changed compared to the previous deployment. The fix for this issue is also included in Xamarin.Android 10.1.4.0.
• Developer Community 854863: More than one device connected, please provide --device-id could prevent deploying successfully in projects configured to use the Android App Bundle publishing format when more than one device or emulator was attached.
• Developer Community 869165: error CS0234: The type or namespace name 'CodeDom' does not exist in the namespace prevented building successfully in projects that used the word System as a dotted part of the default namespace for the project.
• GitHub 4068: error MSB4044: The "CopyGeneratedJavaResourceClasses" task was not given a value for the required parameter "SourceTopDirectory". prevented incremental builds from completing successfully for projects using the Xamarin.AndroidX.Migration NuGet package.
• GitHub PR 4106: Any unhandled exceptions in the Xamarin.Android MSBuild tasks would result in two MSBuild errors instead of one.
• GitHub PR 4121: warning XA2000: Warning: Use of AppDomain::CreateDomain detected in assembly ... The AppDomain's will not be part of .NET 5 and therefore will be missing in newer Xamarin.Android releases. did not indicate that .NET 5 will still include the AppDomain type but only support use of a single AppDomain.
• GitHub PR 4131: error ADB1000 was shown in addition to error ADB0030 if the ADB0030 error condition occurred.
• GitHub PR 4205: Some of the Xamarin.Android MSBuild tasks were using foreground logging methods from background threads. That usage pattern could in theory lead to lock ups in the Visual Studio user interface.
• Java.Interop GitHub 556: An app that referenced a library using the new support for Kotlin libraries could build successfully using an older version of Xamarin.Android but then fail when running on device. Xamarin.Android 10.2.0.99 adjusts one of the new APIs in Java.Interop.dll so that older versions of Xamarin.Android produce a linker error at build time.

Application Mono Framework behavior on device and emulator

This version of Xamarin.Android updates the Mono 6.8 runtime and class libraries from Commit df42020f to Commit 1cca0cfe, adding 17 new commits.

Fixes included for issues reported with Xamarin.Android applications:

• Developer Community 716868, Mono GitHub 18106: Starting in Xamarin.Android 9.2, No compatible code running appeared in the Visual Studio debugger after the debugger paused on breakpoints in callback methods from Android Java APIs, such as WebViewClient.ShouldInterceptRequest() or Android.OS.AsyncTask.RunInBackground().

Design-time build process

• GitHub PR 4199: Using ReSharper's class creation dialog in a Xamarin.Android project could lock up the Visual Studio interface.

Installing

To get the new version in Visual Studio, update Visual Studio:

• Visual Studio 2019 version 16.5 Preview 3 — Visual Studio Installer

For other scenarios, the latest commercial .vsix installer package can be found in the project README.

Open source

• The corresponding open-source build for this version without commercial features is xamarin-android-d16-5 build #37.
• The Mono runtime and class library artifacts for this version come from the android-release-Darwin-*.7z archive generated by the Mono open-source build: archive-mono/job/2019-10 build #108.
• Core JNI interaction logic is in the Java.Interop repo.
• Android bindings and MSBuild tooling are in the xamarin-android repo.
• Chat is in the xamarin/xamarin-android Gitter channel.

Xamarin.Android 10.2.0.84

January 22, 2020 — Xamarin.Android 10.2.0.84 was released as part of Visual Studio 2019 version 16.5 Preview 2.

January 14, 2020 — Xamarin.Android 10.2.0.84 was released as part of Visual Studio 2019 for Mac version 8.5 Preview 1 in the Preview updater channel.

Corresponding Visual Studio 2019 Preview release notes

• Visual Studio 2019 Preview
• Visual Studio 2019 for Mac Preview

What's new

• Mono Framework version update to 6.8
• Build and deployment performance
• App startup performance
• Improved Android manifest merging
• Bindings projects support for Kotlin libraries
• New build errors and warnings XA0121, XA2000
• AndroidEnableDesugar now requires D8
• Option for .NET exceptions from certain Android APIs
• Custom profiles for Enable Startup Tracing
• Mono debugger loglevel passthrough
• Mono compiler option passthrough
• Issues fixed
• Thank you
• Installing
• Open source

Mono Framework version update to 6.8

Xamarin.Android now uses the Mono 6.8 runtime and class libraries at Commit df42020f, bringing in about 800 new commits.

Build and deployment performance

• GitHub PR 3907: Adjust GenerateResourceDesigner to use System.Reflection.Metadata rather than Cecil, use loops instead of LINQ expressions, and skip over .NET Standard libraries. This reduced the time for the GenerateResourceDesigner task during an incremental build from about 470 milliseconds to about 370 milliseconds for a small app on a test system. The GenerateResourceDesigner task also runs in the foreground each time an Android resource is saved, so this makes Visual Studio more responsive when working on Android resources.
• GitHub PR 3913: Skip the _GenerateJavaStubs target for builds where only Android resources have changed. This makes Visual Studio more responsive when working with Android resources. For example, it reduced the design-time build by about 400 milliseconds for a scenario where an Android resource was edited and saved in a moderately large app on a test system.
• GitHub PR 4020: Skip a managed linker step for assemblies that have no references to Java.Lang.Object, such as .NET Standard libraries. This reduced the time for the _LinkAssembliesNoShrink target on a test system from about 160 milliseconds to about 50 milliseconds for an incremental build after a one-line change to the MainActivity class.

App startup performance

• GitHub PR 3951: Avoid searching for unmanaged compiled assemblies generated by Enable Startup Tracing or AOT Compilation unless the app was built with one of those options enabled. This reduced the Runtime.init() phase of application startup for a small test app from about 172 milliseconds to about 168 milliseconds.

Improved Android manifest merging

Xamarin.Android now includes an option to use the same Android manifest merger tool that Android Studio uses to merge AndroidManifest.xml files. This provides new capabilities and improves compatibility with Android Studio. See the documentation for details about the available merge rules.

To enable the new behavior for your project, set the $(AndroidManifestMerger) MSBuild property to manifestmerger.jar in your .csproj file:

<PropertyGroup>
  <AndroidManifestMerger>manifestmerger.jar</AndroidManifestMerger>
</PropertyGroup>

Any project authors who were previously using the Xamarin.Android.ManifestMerger NuGet package can remove that package after adding this setting.

Bindings projects support for Kotlin libraries

This release adds better support for creating bindings for Kotlin libraries, including:

• Hiding Kotlin internal types and members
• Using Kotlin provided metadata to properly name method parameters
• Hiding Kotlin generated methods like foo-impl that aren't intended for public use
• Restoring Kotlin-mangled method names to their original names, such as changing foo-V5j3Lk8 back to foo
• Adding support for Kotlin's native unsigned types (UInt, ULong, UShort, UByte)

Although it was technically possible to bind a Kotlin library previously, these changes greatly reduce the number of custom rules needed in the Transforms\Metadata.xml file to produce expected bindings.

No additional steps are needed to enable this. The binding process will detect if a .jar file was produced from Kotlin and will apply the needed fixes.

Important: Some of these changes required adding new APIs to Java.Interop.dll. This means that like the binding projects themselves, Xamarin.Android application projects that consume one of these new Kotlin library bindings must also be built using Xamarin.Android 10.2 or higher.

New build errors and warnings XA0121, XA2000

XA0121 error for old Xamarin.Android.Support library versions

The XA0121 warning from Xamarin.Android 10.1 is now an error because compatibility with the old GetAdditionalResourcesFromAssemblies MSBuild task has been removed.

Any project that uses one of the affected Xamarin.Android.Support libraries from version 26 or earlier will now see errors like:

error XA0121: Assembly 'Xamarin.Android.Support.Animated.Vector.Drawable' is using '[assembly: Java.Interop.JavaLibraryReferenceAttribute]', which is no longer supported. Use a newer version of this NuGet package or notify the library author.

To resolve these errors, update the project to use version 27 or higher of the Xamarin.Android.Support libraries.

XA2000 warning for use of AppDomain.CreateDomain()

The new XA2000 build warning identifies cases where projects are using the AppDomain.CreateDomain() API:

warning XA2000: Warning: Use of AppDomain::CreateDomain detected in assembly: AndroidApp1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null. The AppDomain's will not be part of .NET 5 and therefore will be missing in newer Xamarin.Android releases.

Because AppDomain in .NET 5 will follow the .NET Core semantics, where there is only exactly one AppDomain and AppDomain.CreateDomain() throws PlatformNotSupportedException, any projects currently using AppDomain.CreateDomain() will need to switch to a different API like AssemblyLoadContext. Project authors are encouraged to begin this transition as soon as they can to prepare for the behavior change.

AndroidEnableDesugar now requires D8

Xamarin.Android now always use the D8 DEX compiler for projects that have the $(AndroidEnableDesugar) MSBuild property set to true:

<PropertyGroup>
  <AndroidEnableDesugar>true</AndroidEnableDesugar>
</PropertyGroup>

Similarly, Xamarin.Android now always uses the R8 code shrinker for projects that have $(AndroidEnableDesugar) set to true and that have the Code shrinker ($(AndroidLinkTool)) set to ProGuard or r8.

Note: $(AndroidEnableDesugar) does not correspond to any setting in the project properties pages in Visual Studio, so this change only affects project authors who have added the property to their .csproj files by hand.

Background information

This change allows Xamarin.Android to remove support for the old desugar_deploy.jar mechanism from the Android Jack toolchain that was deprecated in 2017.

Option for .NET exceptions from certain Android APIs

Several methods in Xamarin.Android override or implement .NET base class library methods but do not throw the expected exception types for those methods. For example, `Android.Runtime.InputSt...

Xamarin.Android 10.1.3.7

January 14, 2020 — Xamarin.Android 10.1.3.7 was released as part of Visual Studio 2019 version 16.4.3 and to the Stable updater channel of Visual Studio 2019 for Mac version 8.4.1.

Corresponding Visual Studio 2019 release notes

• Visual Studio 2019
• Visual Studio 2019 for Mac

Issues fixed in Xamarin.Android 10.1.3.7

Application and library build and deployment

• Developer Community 845978, GitHub 3993: Starting in Xamarin.Android 10.1, You uploaded an APK or Android App Bundle with invalid or missing signing information for some of its files prevented uploading successfully to Google Play for apps built using the Android App Bundle publishing format.

Application Mono Framework behavior on device and emulator

This version of Xamarin.Android updates the Mono 6.6 runtime and class libraries from Commit bef1e633 to Commit fd9f379d, adding 3 new commits.

Fixes included for issues reported with Xamarin.Android applications:

• Developer Community 756697: Starting in Xamarin.Android 10.0, NTLM authentication in Xamarin.Android apps no longer worked, resulting in server-side System.ComponentModel.Win32Exception exceptions.

Installing

To get the new version in Visual Studio, update Visual Studio:

• Visual Studio 2019 version 16.4 — Visual Studio Installer
• Visual Studio 2019 for Mac version 8.4 — Visual Studio for Mac Installer with the Stable updater channel

For other scenarios, the commercial .vsix and .pkg installer packages can be found in the project README.

Mono version for continuous build environments

For users installing Xamarin.Android on macOS continuous build environments, the corresponding version of the Mono Framework MDK to use is Mono Framework MDK 6.6.0.155.

Open source

• The corresponding open-source build without commercial features is xamarin-android-d16-4 build #53.
• The Mono runtime and class library artifacts for this version come from the bundle*.7z archive generated by the earlier open-source build xamarin-android-d16-4 build #52.
• Core JNI interaction logic is in the Java.Interop repo.
• Android bindings and MSBuild tooling are in the xamarin-android repo.
• Chat is in the xamarin/xamarin-android Gitter channel.

Xamarin.Android 10.1.1.0

January 8, 2020 — Xamarin.Android 10.1.1.0 was released to the Stable updater channel of Visual Studio 2019 for Mac version 8.4.

December 10, 2019 — Xamarin.Android 10.1.1.0 was released as part of Visual Studio 2019 version 16.4.1.

Mono Framework version update

This version of Xamarin.Android updates the Mono 6.6 runtime and class libraries from Commit e1ef7743 to Commit bef1e633, adding 9 new commits.

This update does not contain any changes that affect Xamarin.Android. The update just keeps the Mono commit aligned with Xamarin.iOS, Xamarin.Mac, and Visual Studio for Mac.

Mono version for continuous build environments

For users installing Xamarin.Android on macOS continuous build environments, the corresponding version of the Mono Framework MDK to use is Mono Framework MDK 6.6.0.155.

Xamarin.Android 10.2.0.16

December 3, 2019 — Xamarin.Android 10.2.0.16 was released as part of Visual Studio 2019 version 16.5 Preview 1.

Important: The names for generated Java types are different in this release. Any project that explicitly uses one of the old names that starts with md5 will need to be updated by hand to account for this change. See Breaking change for generated Java type names below for more details.

Corresponding Visual Studio 2019 Preview release notes

• Visual Studio 2019 Preview

What's new

• Breaking change for generated Java type names
• Build and deployment performance
• App startup performance
• D8 enabled by default for all projects
• Android App Bundle publishing format workflow improvements
• Mono Framework version update
• XA2001 error for nonexistent Android resources
• AAPT2 version update to 3.5.0-5435860
• Issues fixed
• Thank you
• Open source

Breaking change for generated Java type names

The fallback option in Xamarin.Android 10.1 that allowed using the old style of generated Java type names that started with md5 has now been removed.

Authors of projects that include literal uses of generated Java type names that start with md5 will now need to transition to alternatives like the [Register] attribute and the [Activity] attribute.

Projects that have the LowercaseMD5 fallback option set in the $(AndroidPackageNamingPolicy) MSBuild property will now fail to build with the following error:

error XAGJS7015: System.NotSupportedException: PackageNamingPolicy.LowercaseHash is no longer supported.

To resolve the error, remove the section for the $(AndroidPackageNamingPolicy) property from your .csproj file:

<PropertyGroup>
  <AndroidPackageNamingPolicy>LowercaseMD5</AndroidPackageNamingPolicy>
</PropertyGroup>

See the Xamarin.Android 10.1 release notes for additional background information about this change and examples of how to update existing projects.

Build and deployment performance

• GitHub PR 3692: For the specific scenario of Debug builds that have Use Fast Deployment enabled, undo part of the change from GitHub PR 2718 so that type mappings are parsed at run time instead of being compiled into unmanaged native shared libraries. This reduced the time for the GenerateJavaStubs task from about 540 milliseconds to about 320 milliseconds for an incremental build of a test app where the MainActivity type was modified between builds. As expected, this did increase the app startup time from about 1.30 seconds to about 1.35 seconds, but that still left an overall savings of approximately 170 milliseconds.
• GitHub PR 3856: Add a fallback naming scheme for the files that mark whether the outputs of the _CompileAndroidLibraryResources target are up-to-date with the input files. This allows projects that use a google-services.json item and that are configured to use AAPT2 to skip the _CompileAndroidLibraryResources target correctly during incremental builds.
• GitHub PR 3889: Update the _GeneratePackageManagerJavaForDesigner target to check the timestamp of the MonoPackageManager_Resources.java output file instead of the old obsolete MonoPackageManager.java file that was used in Xamarin.Android 9.3 and earlier. This reduced the total time for the SetupDependenciesForDesigner target by about 500 milliseconds for a small app on a test system. The SetupDependenciesForDesigner targets runs in the background for interactive scenarios in Visual Studio after an Android resource has changed.
• GitHub PR 3891: Avoid unnecessary changes to the build.props intermediate file during design-time builds so that the UpdateGeneratedFiles and SetupDependenciesForDesigner targets can skip the _ResolveLibraryProjectImports target. This reduced the time for the UpdateGeneratedFiles target by about 300 milliseconds for a small app on a test system. The UpdateGeneratedFiles target runs in the foreground each time an Android resource is saved, so this makes Visual Studio more responsive when working on Android resources.

App startup performance

• GitHub PR 3729: Initialize application logging and uncaught exception handling lazily. This reduced the time to display the first screen of a small test Xamarin.Forms app from about 783 milliseconds to about 754 milliseconds for a Release configuration build on a Google Pixel 3 XL device.
• GitHub PR 3780: Simplify how Android system properties are looked up for internal uses within the Xamarin.Android runtime. This cut off about 1 millisecond from the total app startup time.

D8 enabled by default for all projects

Xamarin.Android has included an option to use the D8 DEX compiler since Xamarin.Android 9.2, but is has so far been disabled by default to provide a gradual path for finding and addressing compatibility issues. Starting in Xamarin.Android 10.2, the D8 DEX compiler option is now enabled by default for both existing and new projects.

To switch back from D8 to the earlier DX compiler for a particular project, set the Dex compiler option in the Visual Studio project property pages to dx, or set the $(AndroidDexTool) MSBuild property to dx by hand in your .csproj file:

<PropertyGroup>
  <AndroidDexTool>dx</AndroidDexTool>
</PropertyGroup>

Android App Bundle publishing format workflow improvements

Xamarin.Android 10.2 adds two improvements to the support for Android App Bundle publishing format to align it more closely with the support for the APK publishing format.

The first change is that the Xamarin.Android MSBuild targets now copy the unsigned .aab file to the output directory. Previously, only the signed .aab file was copied to the output directory. The unsigned file can be useful in continuous integration environments where you might want to build just the PackageForAndroid MSBuild target to generate an unsigned .aab file that you can sign in a separate step.

This change resolve the following issue:

• GitHub 3804: Building the PackageForAndroid target, for example by running msbuild -restore -p:Configuration=Release -t:PackageForAndroid, does not output an unsigned .aab file to the output path in projects configured to use the Android App Bundle publishing format.

The second change is that the directory name for the mono-symbolicate .pdb symbol file archive now ends with the expected .aab.mSYM extension instead of .apk.mSYM.

Mono Framework version update

This version of Xamarin.Android updates the Mono 6.6 runtime and class libraries from Commit e1ef7743 to Commit 062f0ab8, adding 1 new commit.

This update does not contain any changes that affect Xamarin.Android. The update just keeps the Mono commit aligned with Xamarin.iOS, Xamarin.Mac, and Visual Studio for Mac.

XA2001 error for nonexistent Android resources

Xamarin.Android 10.2 adds a new XA2001 build error to identify cases where projects might unintentionally include references to Android resource file paths that do not exist. Example:

error XA2001: Source file 'Resources\layout\missing.xml' could not be found.

Before this change, projects that included references to nonexistent Android resources would rebuild the _CompileResources and _UpdateAndroidResgen targets on every build. The new error protects against this by ensuring that project authors remove references to nonexistent resources.

AAPT2 version update to 3.5.0-5435860

The version of the...

Xamarin.Android 10.1.0.30

Update January 8, 2020: Xamarin.Android 10.1.1.0 was released to the Stable updater channel of Visual Studio 2019 for Mac version 8.4.

Update December 3, 2019: Xamarin.Android 10.1.0.30 was released as part of Visual Studio 2019 version 16.4.

See the Xamarin.Android 10.1 release notes for the full list of changes compared to Xamarin.Android 10.0.

---

Earlier information from the Xamarin.Android 10.0.3.0 pre-release

November 14, 2019 — Xamarin.Android 10.0.3.0 was released as part of Visual Studio 2019 version 16.4 Preview 5.

November 11, 2019 — Xamarin.Android 10.1.0.30 was released to the Preview updater channel of Visual Studio 2019 for Mac version 8.4 Preview 2.1.

Corresponding Visual Studio 2019 Preview release notes

• Visual Studio 2019 Preview
• Visual Studio 2019 for Mac Preview

What's new

• Issues fixed

Issues fixed in Xamarin.Android 10.1.0.30

Application Mono Framework behavior on device and emulator

This version of Xamarin.Android updates the Mono 6.6 runtime and class libraries from Commit 8946e49a to Commit e1ef7743, adding 8 new commits.

Fixes included for issues reported with Xamarin.Android applications:

• Developer Community 668413, GitHub 3426, Mono GitHub 17133: Starting in Xamarin.Android 9.4, System.UnauthorizedAccessException: Access to the path is denied. ---> System.IO.IOException: Operation not permitted prevented using File.Copy() to copy files to the Android external storage directory.

Open source

The corresponding open-source build without commercial features is xamarin-android-d16-4 build #42.

Mono version for continuous build environments

For users installing Xamarin.Android on macOS continuous build environments, the corresponding version of the Mono Framework MDK to use is Mono Framework MDK 6.6.0.155.

Xamarin.Android 10.0.6.2

November 5, 2019 — Xamarin.Android 10.0.6.2 was released as part of Visual Studio 2019 version 16.3.8 and to the Stable updater channel of Visual Studio for Mac version 8.3.7.

Issues fixed in Xamarin.Android 10.0.6.2

Application Mono Framework behavior on device and emulator

This version of Xamarin.Android updates the Mono 6.4 runtime and class libraries from Commit 5608fe0a to Commit 476d72b9, adding 7 new commits.

The primary reason for this update is to keep the Mono commit aligned with Xamarin.iOS and Visual Studio for Mac, but it also provides a fix for one issue that was reported in Xamarin.Android applications:

• GitHub 3726: System.NotSupportedException: TypeConverter cannot convert from System.String. prevented apps from using TypeConverter.ConvertFromString() to create an instance of System.Drawing.Color.

OSS core

The corresponding open-source build without commercial features is xamarin-android-d16-3 build #61.

Mono version for continuous build environments

For users installing Xamarin.Android on macOS continuous build environments, the corresponding version of the Mono Framework MDK to use is Mono Framework MDK 6.4.0.208.

Xamarin.Android 10.1.0.29

November 4, 2019 — Xamarin.Android 10.1.0.29 was released as part of Visual Studio 2019 version 16.4 Preview 3 and to the Preview updater channel of Visual Studio 2019 for Mac version 8.4 Preview 2.

Corresponding Visual Studio 2019 Preview release notes

• Visual Studio 2019 Preview
• Visual Studio 2019 for Mac Preview

What's new

• Issues fixed

Issues fixed in Xamarin.Android 10.1.0.29

Application and library build process

• GitHub 3571: Errors returned by the ProGuard tool were all surfaced under an unspecific and misleading error MSB6006: "java.exe" exited with code 1. build error. Xamarin.Android 10.1 now includes the more specific error text from ProGuard in the build error.
• GitHub PR 3685: warning ANDJS0000 was always shown for the jarsigner warnings The signer's certificate is self-signed. and No -tsa or -tsacert is provided and this jar is not timestamped. Those messages were not relevant for Xamarin.Android users, so Xamarin.Android 10.1 now reports them as informational messages rather than warnings.
• GitHub PR 3750: Starting in Xamarin.Android 10.1.0.1, ObjectDisposedException ... at HashAlgorithm.ComputeHash could projects from building successfully if they referenced Xamarin.Android.Support libraries version 26 or earlier.
• GitHub PR 3766: The new exception code prefixes added in GitHub PR 3609 did not yet include specific error codes for unexpected element <activity> found in <manifest> and other similar errors caused by elements located in unexpected locations in the AndroidManifest.xml file.
• GitHub 3779: In projects configured to use AAPT2, the second build could incorrectly succeed without errors if the first build failed due to an error in an Android resource file.
• GitHub 3807: Xamarin.Android projects did not yet enable C# 8 features by default for projects that left the $(MaxSupportedLangVersion) MSBuild property at the default empty value.
• Java.Interop GitHub 496: Bindings projects for Kotlin libraries could fail to build due to hyphen characters in method names generated by Kotlin.

Application deployment

• Developer Community 576975, GitHub 3091: The Removing old runtime and Installing shared runtime deployment steps were repeated during every incremental deployment on certain devices.

Application behavior on device and emulator

• Developer Community 749635: Starting in Xamarin.Android 10.0.99.100, apps could exit during launch on certain older Android devices, resulting in the message Couldn't connect to logcat, GetProcessId returned: 0. Couldn't connect debugger. in the Debug output.
• GitHub 3348: FATAL EXCEPTION: main ... java.lang.IllegalStateException: Module with the Main dispatcher is missing. could prevent apps from running if they referenced Kotlin libraries.
• GitHub 3751: Methods marked with Lifecycle.Event attributes were not called as expected in apps built with the D8 Dex compiler in combination with Enable Multi-Dex.
• GitHub 3758: Starting in Xamarin.Android 10.1.0.1, System.IO.FileNotFoundException: Could not load the file 'Mono.Android.Export' prevented apps from running successfully in the Debug configuration if they used types from the Mono.Android.Export assembly.

Application Mono Framework behavior on device and emulator

This version of Xamarin.Android updates the Mono 6.6 runtime and class libraries from Commit 52810372 to Commit 8946e49a, adding 41 new commits.

Fixes included for issues reported with Xamarin.Android applications:

• GitHub 3726: System.NotSupportedException: 'TypeConverter cannot convert from System.String. prevented apps from using TypeConverter.ConvertFromString() to create an instance of System.Drawing.Color.

OSS core

The corresponding open-source build without commercial features is xamarin-android-d16-4 build #41.

Xamarin.Android 10.0.3.0

October 8, 2019 — Xamarin.Android 10.0.3.0 was released as part of Visual Studio 2019 version 16.3.3.

October 7, 2019 — Xamarin.Android 10.0.3.0 was released to the Stable updater channel of Visual Studio 2019 for Mac version 8.3.

Issues fixed in Xamarin.Android 10.0.3.0

Application Mono Framework behavior on device and emulator

This version of Xamarin.Android updates the Mono 6.4 runtime and class libraries from Commit 7af64d1e to Commit 5608fe0a, adding 18 new commits.

Fixes included for issues reported with Xamarin.Android applications:

• Mono GitHub 16395: DateTime.Now transitioned to daylight saving time an hour late in certain time zones.
• Mono GitHub 16950: Starting in Xamarin.Android 9.4, NotImplementedException for DeflateStream.WriteCore() prevented using StreamWriter with GZipStream.

Application and library build process

• Mono GitHub 17064: Errors similar to Failed to resolve System.Void System.Diagnostics.CodeAnalysis.DoesNotReturnIfAttribute::.ctor(System.Boolean) could prevent deploying or archiving successfully in the Release configuration for apps that referenced .NET Standard 2.1 libraries such as Microsoft.EntityFrameworkCore 3.0.

OSS core

The corresponding open-source build without commercial features is xamarin-android-d16-3 build #57.

Both the commercial build and the open-source build use the Mono and libzip artifacts from the bundle*.7z archive generated by the earlier open-source build: xamarin-android-d16-3 build #55.

Xamarin.Android 10.1.0.1

October 17, 2019 — Xamarin.Android 10.1.0.1 was released to the Preview updater channel of Visual Studio 2019 for Mac version 8.4 Preview 1.

October 15, 2019 — Xamarin.Android 10.1.0.1 was released as part of Visual Studio 2019 version 16.4 Preview 2.

Important: The default names for generated Java types are different in this release. Any project that explicitly uses one of the old default names that starts with md5 will need to be updated by hand to account for this change. See Breaking change for generated Java type names below for more details.

Corresponding Visual Studio 2019 Preview release notes

• Visual Studio 2019 Preview
• Visual Studio 2019 for Mac Preview

What's new

• Breaking change for generated Java type names
• SHA-256 by default for APK signing and digest algorithms
• IDE support for Android App Bundle publishing format
• App startup performance
• Build and deployment performance
• XA0119 warning for non-ideal Debug build configurations
• XA0121 deprecation warning for old Xamarin.Android.Support library versions
• R8 version update to 1.5.68
• bundletool version update to 0.10.2
• aprofutil analysis tool
• Issues fixed

Breaking change for generated Java type names

Any project that explicitly uses one of the old default Java type names that starts with md5 will break in Xamarin.Android 10.1.

To restore the previous behavior temporarily, you can set the $(AndroidPackageNamingPolicy) MSBuild property to LowercaseMD5 in your .csproj file:

<PropertyGroup>
    <AndroidPackageNamingPolicy>LowercaseMD5</AndroidPackageNamingPolicy>
</PropertyGroup>

This backward compatibility option will be removed in the upcoming Xamarin.Android 10.2 version, so authors of projects that currently include literal uses of these default names are encouraged to transition to alternatives like the [Register] attribute and the [Activity] attribute as soon as possible.

Example breakage for a custom view

For a custom view like:

namespace AndroidApp1
{
    public class View1 : View
    {
        /* ... */
    }
}

One scenario that will break is if the literal Java type name md559d7fc296fc238aa7bec92ba27f2cb33.View1 is used in a layout file:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <md559d7fc296fc238aa7bec92ba27f2cb33.View1
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</LinearLayout>

This will result in an error when the app tries to inflate the layout:

Android.Views.InflateException: Binary XML file line #1 in com.contoso.androidapp1:layout/layout1: Binary XML file line #1 in com.contoso.androidapp1:layout/layout1: Error inflating class md559d7fc296fc238aa7bec92ba27f2cb33.View1 ---> Android.Views.InflateException: Binary XML file line #1 in com.contoso.androidapp1:layout/layout1: Error inflating class md559d7fc296fc238aa7bec92ba27f2cb33.View1 ---> Java.Lang.ClassNotFoundException: md559d7fc296fc238aa7bec92ba27f2cb33.View1 ---> Java.Lang.ClassNotFoundException: Didn't find class "md559d7fc296fc238aa7bec92ba27f2cb33.View1" on path: DexPathList

The typical fix is to use the type name of C# class in the layout file instead:

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="vertical"
     android:layout_width="match_parent"
     android:layout_height="match_parent">
-    <md559d7fc296fc238aa7bec92ba27f2cb33.View1
+    <AndroidApp1.View1
         android:layout_width="match_parent"
         android:layout_height="match_parent" />
 </LinearLayout>

Another option is to use a [Register] attribute to customize the generated Java type name:

 namespace AndroidApp1
 {
+    [Register("com.contoso.androidapp1.view1")]
     public class View1 : View
     {

And then use that customized name in the layout file:

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="vertical"
     android:layout_width="match_parent"
     android:layout_height="match_parent">
-    <md559d7fc296fc238aa7bec92ba27f2cb33.View1
+    <com.contoso.androidapp1.view1
         android:layout_width="match_parent"
         android:layout_height="match_parent" />
 </LinearLayout>

Example breakage for an activity

For an activity like:

namespace AndroidApp1
{
    public class MainActivity : Activity
    {
        /* ... */
    }
}

One scenario that will break is if the literal Java type name md559d7fc296fc238aa7bec92ba27f2cb33.MainActivity is used in the AndroidManifest.xml file:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          android:versionCode="1"
          android:versionName="1.0"
          package="com.contoso.androidapp1">
  <uses-sdk android:minSdkVersion="21" android:targetSdkVersion="28" />
  <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme">
    <activity android:label="@string/app_name" android:name="md559d7fc296fc238aa7bec92ba27f2cb33.MainActivity">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    </activity>
  </application>
</manifest>

This will result in an error when the app tries to start the activity:

java.lang.RuntimeException: Unable to instantiate activity ComponentInfo{com.contoso.androidapp1/md559d7fc296fc238aa7bec92ba27f2cb33.MainActivity}: java.lang.ClassNotFoundException: Didn't find class "md559d7fc296fc238aa7bec92ba27f2cb33.MainActivity" on path: DexPathList

The typical fix is to add an [Activity] attribute on the C# class to generate the <activity> manifest element automatically:

 namespace AndroidApp1
 {
+    [Activity(Label = "@string/app_name", MainLauncher = true)]
     public class MainActivity : Activity
     {

And then remove the handwritten <activity> element from AndroidManifest.xml:

  <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme">
-   <activity android:label="@string/app_name" android:name="md559d7fc296fc238aa7bec92ba27f2cb33.MainActivity">
-     <intent-filter>
-       <action android:name="android.intent.action.MAIN" />
-       <category android:name="android.intent.category.LAUNCHER" />
-     </intent-filter>
-   </activity>
 </application>

Background information

This change comes from GitHub PR 3649, which switched the checksum algorithm used to create names for generated Java types from MD5 to CRC-64 to improve compatibility with build environments that have FIPS compliance enforced.

The use of MD5 checksums for these names was originally introduced in Xamarin.Android 5 to reduce the chance of conflicts among the names. See the release notes from that version and the related documentation for additional examples of how to resolve issues related to this change.

SHA-256 by default for APK signing and digest algorithms

Xamarin.Android 10.1 switches the default value of the $(AndroidApkSigningAlgorithm) MSBuild property from md5withRSA to SHA256withRSA and the default value of the $(AndroidApkDigestAlgorithm) MSBuild property from SHA1 to SHA-256. The $(AndroidApkSigningAlgorithm) property corresponds to the -sigalg option of the [jarsigner][jarsigner] command, and the $(AndroidApkDigestAlgorithm) corresponds to the -digestalg option.

This change is not expected to cause complications for existing apps, but if needed, existing projects can restore the previous behavior by setting the MSBuild properties back to the previous values in the .csproj file:

<PropertyGroup>
  <AndroidApkSigningAlgorithm>md5withRSA</AndroidApkSigningAl...