Skip to content

Update README #8913

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
May 6, 2024
Merged

Update README #8913

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
0c73424
Update README
rachelkang Apr 29, 2024
a14b0b1
update
rachelkang Apr 29, 2024
8013a96
update
rachelkang Apr 30, 2024
5b8d627
Update repository banner.
jpobst May 2, 2024
8705580
Move Classic XA downloads off the front page README.
jpobst May 2, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified Documentation/images/banner.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 10 additions & 0 deletions Documentation/previous-releases.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,16 @@
Xamarin.Android Previous Releases
===============

Support for Xamarin.Android ended on **May 1, 2024** as per the [Xamarin Support Policy][xamarin-support-policy].

[xamarin-support-policy]: https://dotnet.microsoft.com/en-us/platform/support/policy/xamarin

However, the released installers are still available for download.

| Platform | Link |
|-----------------|--------|
| **Commercial Xamarin.Android 13.2.2 (d17-8)** for Windows+Visual Studio 2022 | [Download][commercial-d17-8-Windows-x86_64] |
| **Commercial Xamarin.Android 13.2.2 (d17-8)** for VSMac 2022 | [Download][commercial-d17-8-macOS-x86_64] |
| **Commercial Xamarin.Android 13.2 (d17-5)** for Windows+Visual Studio 2022 | [Download][commercial-d17-5-Windows-x86_64] |
| **Commercial Xamarin.Android 13.2 (d17-5)** for macOS | [Download][commercial-d17-5-macOS-x86_64] |
| **Commercial Xamarin.Android 13.1 (d17-4)** for Windows+Visual Studio 2022 | [Download][commercial-d17-4-Windows-x86_64] |
Expand Down Expand Up @@ -74,3 +82,5 @@ Xamarin.Android Previous Releases
[commercial-d17-4-macOS-x86_64]: https://aka.ms/xamarin-android-commercial-d17-4-macos
[commercial-d17-5-Windows-x86_64]: https://aka.ms/xamarin-android-commercial-d17-5-windows
[commercial-d17-5-macOS-x86_64]: https://aka.ms/xamarin-android-commercial-d17-5-macos
[commercial-d17-8-Windows-x86_64]: https://aka.ms/xamarin-android-commercial-d17-8-windows
[commercial-d17-8-macOS-x86_64]: https://aka.ms/xamarin-android-commercial-d17-8-macos
44 changes: 19 additions & 25 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,53 +1,47 @@
<img src="Documentation/images/banner.png" alt=".NET Android banner" height="145" >
<img src="Documentation/images/banner.png" alt=".NET for Android banner" height="145" >

.NET Android
.NET for Android
===============

.NET Android provides open-source bindings of the Android SDK and tooling for use with
.NET for Android provides open-source bindings of the Android SDK and tooling for use with
.NET managed languages such as C#. This ships as an optional [.NET workload][net-workload] for .NET 6+ that can
be updated independently from .NET in order to respond to external dependency updates like new Android
platform and tooling.

While .NET Android is an essential part of [MAUI][maui-intro], it is still fully supported to be
used independently for native Android development using .NET.

This repository is also home to the classic Xamarin.Android product.
.NET for Android is part of [.NET MAUI][maui-intro], and may also be used independently for native Android development using .NET.

[net-workload]: https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-install
[maui-intro]: https://learn.microsoft.com/en-us/dotnet/maui/what-is-maui

# Support

.NET Android is now part of .NET 6+ and follows the same support lifecycle as the [MAUI Support Lifecycle][maui-support-lifecycle].
.NET for Android is part of .NET MAUI, since it was introduced in May 2022 as part of .NET 6, and is currently supported as described in the [.NET MAUI Support Policy][maui-support-policy].

Support for Xamarin.Android ended on **May 1, 2024** as per the [Xamarin Support Policy][xamarin-support-policy]:

Support for classic Xamarin.Android will end on **May 1, 2024** as per the [Xamarin Support Policy][xamarin-support-policy]:
> Xamarin support ended on May 1, 2024 for all Xamarin SDKs including Xamarin.Forms. Android API 34 and Xcode 15 SDKs (iOS and iPadOS 17, macOS 14) are the final versions Xamarin targets from existing Xamarin SDKs (i.e. no new APIs are planned).

> Xamarin support will end on May 1, 2024 for all classic Xamarin SDKs. Android 13 will be the final version classic Xamarin.Android will target.
Follow the [official upgrade guidance](https://learn.microsoft.com/dotnet/maui/migration) to bring your Xamarin applications to the latest version of .NET.

[maui-support-lifecycle]: https://dotnet.microsoft.com/en-us/platform/support/policy/maui
[maui-support-policy]: https://dotnet.microsoft.com/en-us/platform/support/policy/maui
[xamarin-support-policy]: https://dotnet.microsoft.com/en-us/platform/support/policy/xamarin

# Downloads

## Current
.NET for Android ships as a workload through the `dotnet` workload system in [.NET 6+][dotnet-download].

.NET Android ships as a workload through the `dotnet` workload system in [.NET 6+][dotnet-download]. See
the [workload documentation][workload-documentation] for installation commands.
In its simplest form, .NET for Android can be installed by running:

[dotnet-download]: https://dotnet.microsoft.com/en-us/download
[workload-documentation]: https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-install
```
dotnet workload install android
```

Classic Xamarin.Android installers are available here:
See the [.NET workload documentation][workload-documentation] for additional installation commands and options.

| Platform | Link |
|-----------------|--------|
| **Commercial Xamarin.Android 13.2.2 (d17-8)** for Windows+Visual Studio 2022 | [Download][commercial-d17-8-Windows-x86_64] |
| **Commercial Xamarin.Android 13.2.2 (d17-8)** for VSMac 2022 | [Download][commercial-d17-8-macOS-x86_64] |

[Previous Releases](Documentation/previous-releases.md) are also available for download.
[dotnet-download]: https://dotnet.microsoft.com/en-us/download
[workload-documentation]: https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-workload-install

[commercial-d17-8-Windows-x86_64]: https://aka.ms/xamarin-android-commercial-d17-8-windows
[commercial-d17-8-macOS-x86_64]: https://aka.ms/xamarin-android-commercial-d17-8-macos
While no longer supported, Classic Xamarin.Android installers are still available [here](Documentation/previous-releases.md).

# Contributing

Expand Down