Skip to content

Commit ee2a7bd

Browse files
[maui] expand the Android API-37 section (#10374)
1 parent 826a6bd commit ee2a7bd

2 files changed

Lines changed: 28 additions & 5 deletions

File tree

release-notes/11.0/preview/preview3/dotnetmaui.md

Lines changed: 28 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -104,11 +104,17 @@ var status = await Permissions.RequestAsync<Permissions.PostNotifications>();
104104
## .NET for Android adds Android 17 / API 37 preview support
105105

106106
.NET for Android Preview 3 aligns with Android 17 / API 37 previews so apps can
107-
start validating against the upcoming platform now. Set
108-
`net11.0-android37` together with `EnablePreviewFeatures` to opt into the new
109-
target framework and platform APIs. This guidance comes from the official
110-
Preview 3 Android release notes:
111-
<https://github.com/dotnet/android/releases/tag/36.99.0-preview.3.10>.
107+
start validating against the upcoming platform now.
108+
109+
We're grateful to the [Uno Platform](https://platform.uno/) team for their deep
110+
collaboration with the .NET MAUI team in preparation for .NET 11 Preview 3.
111+
Their contributions helped ensure .NET for Android is aligned with Google's
112+
latest platform updates, enabling developers to take advantage of Android 17
113+
previews and API 37 right away. This kind of partnership strengthens the .NET
114+
ecosystem and reflects our shared commitment to delivering high-quality,
115+
cross-platform developer experiences.
116+
117+
To opt into API-37, update your `.csproj`:
112118

113119
```xml
114120
<PropertyGroup>
@@ -117,6 +123,23 @@ Preview 3 Android release notes:
117123
</PropertyGroup>
118124
```
119125

126+
To install API-37 in Visual Studio, use **Tools > Android > Android SDK
127+
Manager > Repository > Full List**:
128+
129+
![Visual Studio SDK Manager showing the API-37 preview option](./media/api-37-sdk-manager.png)
130+
131+
> [!NOTE]
132+
> By default the SDK manager installs to
133+
> `C:\Program Files (x86)\Android\android-sdk\platforms\android-37.0`, which
134+
> .NET for Android does not automatically locate. Rename the folder to
135+
> `C:\Program Files (x86)\Android\android-sdk\platforms\android-37` as a
136+
> workaround until this is addressed in a future release.
137+
138+
See the [API-37 HPKE Encryption Sample](https://github.com/dotnet/android-samples/tree/main/HpkeEncryption)
139+
for a full example calling new APIs available in Android 17. For the complete
140+
list of changes, see the
141+
[.NET for Android Preview 3 release notes](https://github.com/dotnet/android/releases/tag/36.99.0-preview.3.10).
142+
120143
## .NET for Android improves CLI device discovery and deploy flow
121144

122145
`dotnet run` can now list available emulators and auto-boot a selected AVD
96.6 KB
Loading

0 commit comments

Comments
 (0)