Skip to content

Latest commit

 

History

History
68 lines (42 loc) · 3.83 KB

README.md

File metadata and controls

68 lines (42 loc) · 3.83 KB

AndroidX for .NET for Android

GitHub License contributions welcome GitHub contributors

Microsoft creates and maintains .NET for Android bindings for many of Google's AndroidX libraries.

Support for Xamarin.Android ended on May 1st, 2024. New versions of these packages will not support Xamarin.Android.

What is AndroidX

AndroidX (also called Jetpack) is a suite of libraries that developers can use to access Android functionality using best practices that work consistently across Android versions and devices.

AndroidX is a replacement for Google's original Android Support Library which is no longer maintained.

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 bound 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

Support

Note that these packages are largely just autogenerated bindings around Google's AndroidX libraries. As such, our support is limited to issues caused by our bindings. For tutorials/samples/support using the libraries themselves, please refer to Google's documentation.

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.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.

.NET Foundation

This project is part of the .NET Foundation.