AndroidX (Jetpack) bindings for Xamarin.Android
Перейти к файлу
Jonathan Pobst a6b6dc15d7
[NuGet.config] Remove wildcard from nuget.org. (#891)
In order to ensure we are testing the packages built during CI/local build we need to remove the wildcard from `nuget.org`.

With the `nuget.org` wildcard it means that anything that cannot be found locally will be pulled from published packages.  We will never know if we are accidentally pulling a published package instead of the intended local one.
2024-05-17 07:29:04 -10:00
.github version bumps 2024-02-16 09:21:09 +01:00
build Remove Classic support. (#875) 2024-05-03 07:51:29 -10:00
docs Merge branch 'main' into mu-20240502-alignment-bumps 2024-05-09 09:35:49 +02:00
icons Add a smaller image for the nugets 2019-07-19 16:39:18 +02:00
samples [NuGet.config] Remove wildcard from nuget.org. (#891) 2024-05-17 07:29:04 -10:00
source Clean up unused legacy parts of the AndroidX project template. (#889) 2024-05-16 09:04:36 -10:00
templates Use an updated `generator` for `@RestrictTo` support. (#820) 2023-12-04 07:43:06 -10:00
util [binderator] Allow `extraDependencies` to specify an `excludedDependency`. (#780) 2023-08-29 08:55:46 -05:00
.gitignore [ci] Move CI YAML from XC. (#658) 2022-12-05 14:27:54 -06:00
BUILDING.md 2 docs merged into 1 2022-09-11 12:20:42 +02:00
Directory.Build.props Remove Classic support. (#875) 2024-05-03 07:51:29 -10:00
Directory.Build.targets Add support for exact version NuGet dependencies based on Maven dependency info from POM. (#770) 2023-10-18 14:21:56 -10:00
External-Dependency-Info.txt Update the README.md 2019-11-20 00:40:53 +02:00
LICENSE.md Audit license specifications. (#562) 2022-05-26 08:27:08 -05:00
Licenses.json Create Licenses.json 2022-06-26 17:29:45 +02:00
README.md Remove Classic support. (#875) 2024-05-03 07:51:29 -10:00
SECURITY.md Create SECURITY.md 2021-05-24 14:59:55 -05:00
SignList.xml Binderator signlist 2022-12-08 19:01:21 +01:00
THIRD-PARTY-NOTICES Update THIRD-PARTY-NOTICES 2019-07-19 10:45:39 -04:00
azure-pipelines.yml Remove Classic support. (#875) 2024-05-03 07:51:29 -10:00
build.cake Remove Classic support. (#875) 2024-05-03 07:51:29 -10:00
cgmanifest.json automatic files 2024-05-03 10:20:49 +02:00
config.json Merge branch 'main' into mu-20240502-alignment-bumps 2024-05-09 09:35:49 +02:00
global.json Update global.json 2024-04-11 22:22:00 +02:00
nuget-diff.cake Fix persistent `api-diff` issues. (#852) 2024-02-23 07:13:03 -10:00
published-namespaces.txt Remove Classic support. (#875) 2024-05-03 07:51:29 -10:00
utilities.cake spelling after namespace changes 2024-05-01 12:11:04 +02:00
validation.cake [ci] Move CI YAML from XC. (#658) 2022-12-05 14:27:54 -06:00
workloads.json Update workloads.json 2024-04-11 11:21:15 +02:00

README.md

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.