ios-samples/nnyeah-samples/README.md

48 строки
1.8 KiB
Markdown

# 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