AndroidX for Xamarin.Android

Xamarin creates and maintains Xamarin.Android bindings for the Google Android Support Libraries and AndroidX.

Building

Building nuget packages from source requires calling the cake script:

.\build.ps1 --target=packages

Android Support -> AndroidX Roadmap

With the release of AndroidX, Android Support is now considered deprecated and will no longer receive new feature updates. We are committed to helping our developers bring their applications into this new world with minimal effort.

Goal

Our goal is to allow developers to take an existing application using Android Support libraries, and reference, build, and run against AndroidX libraries without any code changes.

Phases

1. Xamarin Bindings / NuGet Packages for AndroidX

Provide bindings to all of the new AndroidX packages for Xamarin developers. If you want to migrate your app's code manually to use the new AndroidX API's you can reference these packages. Keep in mind that all of your app's dependencies must also be compiled against AndroidX bindings to use these.

2. Tooling for Building apps and dependencies with AndroidX

Implement build tasks in the AndroidX packages to allow your application to utilize AndroidX without any code changes:

• Dependencies (.NET as well as binding libraries with java and resources in them) will be migrated to the new API's and cached during your first build
• Your app's compiled code will be migrated to the new API's before the application is packaged
• Your app's resource and manifest files will be migrated at build time before the application is packaged

3. Optional One Time Migration Tool

If your app's code (C#, Resources, Manifest, etc) has not been migrated from Android Support, your build times will be slightly longer.

We will provide a migration assistant to help convert your C# code, xml resources, and AndroidManifest to use the new AndroidX API's which you can optionally use to perform a one time migration of your project.

Migration Tools / Tasks Source Code

The source code for the Xamarin.AndroidX.Migration package and other migration tools and utilities are available in: xamarin/XamarinAndroidXMigration

License

The license for this repository is specified in LICENSE.md

The externals build task downloads some external dependencies from Google which are licensed under and subject to the terms of Android Software Development Kit License Agreement

Contribution Guidelines

The Contribution Guidelines for this repository are listed in CONTRIBUTING.md

.NET Foundation

This project is part of the .NET Foundation