diff --git a/docs/migration/android-projects.md b/docs/migration/android-projects.md index 794370599..a700df65d 100644 --- a/docs/migration/android-projects.md +++ b/docs/migration/android-projects.md @@ -120,21 +120,21 @@ There are behavioral changes to the `String.IndexOf()` method in .NET 5+ on diff ## Linker -.NET 5+ has new settings for the linker: +.NET 8 has new settings for the linker: - `true` -- `link`, which enables member-level trimming. +- `partial`, which trims assemblies that have opted-in to trimming. For more information, see [Trimming options](/dotnet/core/deploying/trimming-options). -In .NET for Android projects by default, `Debug` builds don't use the linker, and `Release` builds set `PublishTrimmed=true` and `TrimMode=link`. `TrimMode=copyused` is the default for the .NET SDK but isn't appropriate for mobile apps. However, you can still opt into `TrimMode=copyused` if required. +In .NET for Android projects by default, `Debug` builds don't use the linker, and `Release` builds set `PublishTrimmed=true` and `TrimMode=partial`. If the legacy `AndroidLinkMode` setting is used, both `SdkOnly` and `Full` default to equivalent linker settings: - `true` -- `link` +- `partial` -With `AndroidLinkMode=SdkOnly`, only BCL and SDK assemblies marked with `%(Trimmable)` are linked at the member level. `AndroidLinkMode=Full` sets `%(TrimMode)=link` on all .NET assemblies. +With `AndroidLinkMode=SdkOnly`, only BCL and SDK assemblies marked with `%(Trimmable)` are linked at the member level. `AndroidLinkMode=Full` sets `%(TrimMode)=partial` on all .NET assemblies. > [!TIP] > You should migrate to the new linker settings, because the `AndroidLinkMode` setting will eventually be deprecated.