ios-samples/nnyeah-samples/README.md

# nnyeah Samples

## What is nnyeah?

nnyeah is a tool that can convert legacy Xamarin platform assemblies to run under .NET 6 or later. The repository for it is here: https://github.com/xamarin/xamarin-macios/tree/main/tools/nnyeah
nnyeah takes 3 inputs:

1. an assembly compiled against a Xamarin platform assembly
2. a Xamarin platform assembly (Xamarin.iOS.dll or Xamarin.macOS.dll)
3. a Microsoft platform assembly (Microsoft.iOS.dll or Microsoft.macOS.dll)

and will generate an output assembly which should act as it were compiled against the Microsoft platform assembly.


## Getting nnyeah

nnyeah is packaged as a nuget package and can be downloaded from here: https://github.com/xamarin/ios-samples/nnyeah-samples/nupkg/nnyeah.0.1.0.nupkg
In addition, nnyeah can be built from the github repository above.

Installing nnyeah as a dotnet tool
nnyeah can be be installed as a dotnet tool with the following command:

    dotnet tool install --add-source /path/to/nupkg-directory -g nnyeah

where `/path/to/nupkg-directory` is a directory which contains the nnyeah nupkg file.

Building nnyeah Samples

First, you will need a path to your target Microsoft iOS dll. You can can get a list of what you have installed with this command:

    find $(dirname $(which dotnet)) -name Microsoft.iOS.dll -print | grep ref

This may return several results. The best choice is probably the one with the highest version.
Set an environment variable named `MS_PLATFORM_DLL` to the path to the dll to target:

    export MS_PLATFORM_DLL=/path/to/Microsoft.iOS.dll

then execute `make` in the directory of the sample you want to try.

Provided samples:

- geo - provides access to geolocation data
- perm - handles permissions (this does not have a sample, but is required by geo
- sidebar - provides a navigation sidebar