/AndroidX

AndroidX bindings for .NET for Android

Primary LanguageC#MIT LicenseMIT

Third Party Library Bindings for .NET for Android

GitHub License contributions welcome GitHub contributors

Microsoft creates and maintains .NET for Android bindings for many of Google's Java/Kotlin Android libraries and their required third-party dependency libraries, such as:

Note that support for Xamarin.Android ended on May 1st, 2024. New versions of these packages will only support .NET for Android.

Binding Policies

  • This repository binds over 600 Android libraries that are published to NuGet.org. The full package list can be found in config.json.
  • Most Google Java/Kotlin artifacts and some dependencies come from Google's Maven Respository.
  • Additional dependencies come from Maven/Sonatype Central.
  • The major/minor/patch version numbers mirror the bound Android 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 Android library has not been updated.
  • We endeavor to release updated NuGets within a few weeks after new Android 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. Additionally, it can result in stable NuGet packages depending on unstable NuGet packages.

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 Android 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.txt.

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.