Releases: dotnet/android
Xamarin.Android 10.2.0.100 Preview
March 10, 2020 — Xamarin.Android 10.2.0.100 was published to the Preview updater channel of Visual Studio 2019 for Mac version 8.5 Preview 6.
March 2, 2020 — Xamarin.Android 10.2.0.100 was published as part of Visual Studio 2019 version 16.5 Preview 5.
Corresponding Visual Studio 2019 Preview release notes
What's new
Issues fixed
Application Mono Framework behavior on device and emulator
This version of Xamarin.Android updates the Mono 6.8 runtime and class libraries from Commit 1cca0cfe to Commit c0c5c78e, adding 14 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.The initial fix for this issue in Xamarin.Android 10.1 was incomplete. Xamarin.Android 10.2 now includes additional changes that allow switching back to the Xamarin.Android 9.4
HttpClient
behavior.To switch back to the Xamarin.Android 9.4 behavior, set the
$(AndroidHttpClientHandlerType)
MSBuild property toSystem.Net.Http.MonoWebRequestHandler, System.Net.Http
in your .csproj file:<PropertyGroup> <AndroidHttpClientHandlerType>System.Net.Http.MonoWebRequestHandler, System.Net.Http</AndroidHttpClientHandlerType> </PropertyGroup>
Installing
To get the new version in Visual Studio, update Visual Studio:
- Visual Studio 2019 version 16.5 Preview 5 — Visual Studio Installer
- Visual Studio 2019 for Mac version 8.5 Preview 6 — Visual Studio for Mac Installer with the Preview updater channel
For other scenarios, the latest commercial .vsix and .pkg installer packages 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 #38.
- 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 #122.
- 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.4.0
February 11, 2020 — Xamarin.Android 10.1.4.0 was released as part of Visual Studio 2019 version 16.4.5
Corresponding Visual Studio 2019 release notes
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. Xamarin.Android 10.1.4.0 now automatically takes care of uninstalling the app in this case, like Xamarin.Android 10.0 did.
Installing
To get the new version in Visual Studio, update Visual Studio:
- Visual Studio 2019 version 16.4 — Visual Studio Installer
For other scenarios, the commercial .vsix installer package can be found in the project README.
Open source
- The corresponding open-source build without commercial features is xamarin-android-d16-4 build #55.
- 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.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
What's new
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 singleAppDomain
. - 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()
orAndroid.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
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 theGenerateResourceDesigner
task during an incremental build from about 470 milliseconds to about 370 milliseconds for a small app on a test system. TheGenerateResourceDesigner
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 theMainActivity
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 tofoo
- 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
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
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 theMainActivity
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 theSetupDependenciesForDesigner
target by about 500 milliseconds for a small app on a test system. TheSetupDependenciesForDesigner
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
andSetupDependenciesForDesigner
targets can skip the_ResolveLibraryProjectImports
target. This reduced the time for theUpdateGeneratedFiles
target by about 300 milliseconds for a small app on a test system. TheUpdateGeneratedFiles
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 runningmsbuild -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
What's new
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 ofSystem.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
What's new
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 ofSystem.Drawing.Color
.
OSS core
The corresponding open-source build without commercial features is xamarin-android-d16-4 build #41.