Переносимая библиотека с Xamarin - .NET Standard против UWP

Дело не в том, что вам нужно строить вашей пользовательской сборки .NetStd каким-либо образом, зависящим от платформы. Вы компилируете против эталонную сборку Xamarin.Essentials .NetStd, а затем связать / включить специфичную для платформы сборку Xamarin.Essentials, которая включает код, зависящий от платформы.

Таким образом, в время выполнения типы в вашей пользовательской сборке .NetStd будут перенаправлены / вызваны в сборку, специфичную для платформы Xamarin.Essentials, которая была включена в ваше приложение.

Итак, в вашей пользовательской сборке .NetStd, которая включает Xamarin.Essentials, будет определение внешней сборки:

.assembly extern Xamarin.Essentials
{
  .ver 1:0:0:0
}

И затем в той же сборке .NetStd будет ваш код, который вызывает тип, который существует в сборке, то есть: OpenAppPackageFileAsync

IL_0030:  call [System.Threading.Tasks]System.Threading.Tasks.Task`1<[System.IO]System.IO.Stream> [Xamarin.Essentials]Xamarin.Essentials.FileSystem::OpenAppPackageFileAsync(string)

Примечание. В случае Essentials он не использует DI / Interfaces для вызова кода, зависящего от платформы, метод OpenAppPackageFileAsync вызывает метод PlatformOpenAppPackageFileAsync, и именно этот метод будет включать код, зависящий от платформы, в каждую из его зависимых от платформы сборок. В методе эталонной сборки на основе .NetStd он выдает NotImplementedInReferenceAssemblyException, поскольку не существует общего / универсального кода платформы на основе .NetStd, который реализует загрузку файлов Android / iOS / UWP, связанных с приложением только для чтения, то есть:

.method private hidebysig static [System.Threading.Tasks]System.Threading.Tasks.Task`1<[System.IO]System.IO.Stream>
          PlatformOpenAppPackageFileAsync(string filename) cil managed
  {
    // Code size       6 (0x6)
    .maxstack  8
    IL_0000:  newobj     instance void Xamarin.Essentials.NotImplementedInReferenceAssemblyException::.ctor()
    IL_0005:  throw
  } // end of method FileSystem::PlatformOpenAppPackageFileAsync

Теперь, когда вы упаковываете / объединяете свое зависящее от платформы приложение, скажем Android в этом примере, вы будете обрабатывать / включать не эталонную сборку Essentials, а версию для конкретной платформы.

Версия сборки Xamarin.Essentials.dll для Android включает это для метода PlatformOpenAppPackageFileAsync:

.method private hidebysig static [mscorlib]System.Threading.Tasks.Task`1<[mscorlib]System.IO.Stream>
          PlatformOpenAppPackageFileAsync(string filename) cil managed
  {
    // Code size       70 (0x46)
    .maxstack  3
    .locals init ([mscorlib]System.Threading.Tasks.Task`1<[mscorlib]System.IO.Stream> V_0,
             [Mono.Android]Java.IO.FileNotFoundException V_1)
    IL_0000:  ldarg.0
    IL_0001:  brtrue.s   IL_000e
    ~~~~
    .try
    {
      IL_001d:  call       [Mono.Android]Android.Content.Context Xamarin.Essentials.Platform::get_AppContext()
      IL_0022:  callvirt   instance [Mono.Android]Android.Content.Res.AssetManager [Mono.Android]Android.Content.Context::get_Assets()
      IL_0027:  ldarg.0
      IL_0028:  callvirt   instance [mscorlib]System.IO.Stream [Mono.Android]Android.Content.Res.AssetManager::Open(string)
      IL_002d:  call       [mscorlib]System.Threading.Tasks.Task`1<!!0> [mscorlib]System.Threading.Tasks.Task::FromResult<[mscorlib]System.IO.Stream>(!!0)
      IL_0032:  stloc.0
      IL_0033:  leave.s    IL_0044
      ~~~