xamarin-macios/tests/dotnet/README.md

# .net tests

## size-comparison

To install the latest `appcompare` tool do:

```bash
$ dotnet tool install --global appcompare
```

You can update it to the latest version by running:

```bash
$ dotnet tool update --global appcompare
```

The current directory might point to a different and incompatible dotnet
SDK, resulting in an error. However running the command from a different
location (outside the repo) should work.

### Easier Analysis

If you want to read/compare the IL inside the assemblies you need to disable IL stripping.

* Legacy (oldnet)

Add this option inside the `Release|iPhone` configuration of `size-comparison/MySingleView/oldnet/MySingleView.csproj`

```xml
<MtouchExtraArgs>--nostrip</MtouchExtraArgs>
```

* net6

Build with `/p:EnableAssemblyILStripping=false` set. The `MtouchExtraArgs` legacy option is also honored.
[tests][dotnet] Update oldnet sample to use LLVM and add some instructions (#11780) Using the AOT LLVM-backend is recommended for release and should be used when comparing sizes. Also add some basic instruction to ease comparing `oldnet` and `dotnet` app bundles since IL stripping is not yet available to dotnet builds (and without considering this the _real_ numbers are a bit off) 2021-06-02 16:07:55 +03:00			`# .net tests`

			`## size-comparison`

[appcompare] Remove old/local copy of the tool and update comparison documentation (#14190) There's a newer version of the tool availble as a (tool) [nuget](https://www.nuget.org/packages/appcompare/) The nicest part, for this use case, is that it can map renamed files between the two app bundles being compared. [Example](https://gist.github.com/spouliot/68a43a4f514315d52b35446016ba0d2e) 2022-02-18 15:04:28 +03:00			To install the latest `appcompare` tool do:

			```bash
			`$ dotnet tool install --global appcompare`
			```

			`You can update it to the latest version by running:`

			```bash
			`$ dotnet tool update --global appcompare`
			```

			`The current directory might point to a different and incompatible dotnet`
			`SDK, resulting in an error. However running the command from a different`
			`location (outside the repo) should work.`

[tests][dotnet] Update oldnet sample to use LLVM and add some instructions (#11780) Using the AOT LLVM-backend is recommended for release and should be used when comparing sizes. Also add some basic instruction to ease comparing `oldnet` and `dotnet` app bundles since IL stripping is not yet available to dotnet builds (and without considering this the _real_ numbers are a bit off) 2021-06-02 16:07:55 +03:00			`### Easier Analysis`

			`If you want to read/compare the IL inside the assemblies you need to disable IL stripping.`

			`* Legacy (oldnet)`

			Add this option inside the `Release\|iPhone` configuration of `size-comparison/MySingleView/oldnet/MySingleView.csproj`

			```xml
			`<MtouchExtraArgs>--nostrip</MtouchExtraArgs>`
			```

			`* net6`

[msbuild] Add ILStrip'ing for net6 applications. Fixes #11445. (#12563) - Controlled by EnableAssemblyILStripping which defaults to true - Integration test included Before - https://gist.github.com/chamons/c7886f7bacbc2e5ac5966e4251d13e71 After - https://gist.github.com/chamons/148e1bef22fa336f953f3d02dcf20667 859,136 -> 527,872 managed Fixes https://github.com/xamarin/xamarin-macios/issues/11445. 2021-10-05 17:43:22 +03:00			Build with `/p:EnableAssemblyILStripping=false` set. The `MtouchExtraArgs` legacy option is also honored.