AndroidX/README.md

3.3 KiB

AndroidX for Xamarin.Android

GitHub License contributions welcome GitHub contributors Build Status

Xamarin creates and maintains Xamarin.Android bindings for AndroidX.

What is AndroidX

AndroidX (also called Jetpack) is a major improvement to the original Android Support Library. AndroidX packages fully replace the Android Support Library by providing feature parity and new libraries.

With the release of AndroidX, Android Support is now considered deprecated and will no longer receive new feature updates. Version 28.0.0 is the last release of the Android Support Library.

Binding Policies

  • This repository binds over 200 AndroidX libraries that are published to NuGet.org. The full package list can be found in config.json.
  • AndroidX Java artifacts and some dependencies come from Google's Maven Respository.
  • Additional dependencies come from Maven/Sonatype Central.
  • Google's release notes for AndroidX libraries are available here.
  • The major/minor/patch version numbers mirror the AndroidX library version. For example, the NuGet Xamarin.AndroidX.Core 1.3.2.1 binds version 1.3.2 of the AndroidX library androidx.core:core.
    • The revision version number is used when a new NuGet needs to be built but the AndroidX library has not been updated.
  • We endeavor to release updated NuGets within a few weeks after new AndroidX releases, however large changes occasionally require more time.
  • In general, we do not bind pre-release libraries. As their API is not stable yet, it results in too much rework.

Details

Full list of maven artifact to NuGet mappings:

./docs/artifact-list.md

Full list of maven artifact with versions to NuGet mappings with versions:

./docs/artifact-list-with-versions.md

License

The license for this repository is specified in LICENSE.md

Each package published from this repository generally contains third-party code (ie: .jar/.aar) that is governed by its own license. Per-package license information is available in cgmanifest.json.

Building

Instructions for building this repository are specified in BUILDING.md

In depth building instructions: ./docs/build.md.

Contribution Guidelines

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

.NET Foundation

This project is part of the .NET Foundation