Migrar o código do Xamarin.Essentials em aplicativos .NET para Android e .NET para iOS

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0-android</TargetFramework>
    ...
    <UseMauiEssentials>true</UseMauiEssentials>
  </PropertyGroup>
</Project>

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0-ios</TargetFramework>
    ...
    <UseMauiEssentials>true</UseMauiEssentials>
  </PropertyGroup>
</Project>

Em qualquer Activity que seja iniciada, você precisa chamar o método Platform.Init, que está no namespace Microsoft.Maui.ApplicationModel do método OnCreate:

using Android.Content.PM;
using Android.Runtime;
using Microsoft.Maui.ApplicationModel;

namespace MyAndroidApp;

[Activity(Label = "@string/app_name", MainLauncher = true)]
public class MainActivity : Activity
{
    protected override async void OnCreate(Bundle? savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        Platform.Init(this, savedInstanceState);
        // ...
    }
}

O método Platform.Init exige um argumento Application ou um argumento Activity e um argumento Bundle.

Na classe AppDelegate, você precisa chamar o método Platform.Init, que está no namespace Microsoft.Maui.ApplicationModel do método FinishedLaunching:

using Microsoft.Maui.ApplicationModel;

namespace MyiOSApp;

[Register("AppDelegate")]
public class AppDelegate : UIApplicationDelegate
{
    public override UIWindow? Window
    {
        get;
        set;
    }

    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
    {
        // create a new window instance based on the screen size
        Window = new UIWindow(UIScreen.MainScreen.Bounds);

        // create a UIViewController with a single UILabel
        var vc = new UIViewController();
        // ...
        Window.RootViewController = vc;

        Platform.Init(() => vc);

        // make the window visible
        Window.MakeKeyAndVisible();

        return true;
    }
}

O método Platform.Init exige um argumento Func<UIKit.UIViewController.

Para acessar o Context ou a Activity atual do aplicativo em execução:

var context = Platform.AppContext;

// Current Activity or null if not initialized or not started.
var activity = Platform.CurrentActivity;

Se houver uma situação em que o aplicativo Activity seja necessário, mas o aplicativo ainda não tenha sido totalmente iniciado, chame o método WaitForActivityAsync:

var activity = await Platform.WaitForActivityAsync();

Para lidar com solicitações de permissão de runtime, substitua o método OnRequestPermissionsResult em todas as Activity e chame o método Platform.OnRequestPermissionsResult nele:

public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Permission[] grantResults)
{
    Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
}

Além de obter a Activity atual, você também pode se registrar para ver os eventos de ciclo de vida:

protected override void OnCreate(Bundle bundle)
{
    base.OnCreate(bundle);
    Platform.Init(this, bundle);
    Platform.ActivityStateChanged += Platform_ActivityStateChanged;
}

protected override void OnDestroy()
{
    base.OnDestroy();
    Platform.ActivityStateChanged -= Platform_ActivityStateChanged;
}

void Platform_ActivityStateChanged(object sender, ActivityStateChangedEventArgs e) =>
    Toast.MakeText(this, e.State.ToString(), ToastLength.Short).Show();

Os estados de atividade são:

• Criado em
• Retomada
• Pausada
• Destruído
• SaveInstanceState
• Iniciado
• Interrompido

Por exemplo, para lidar com ações de aplicativo, substitua o método PerformActionForShortcutItem na classe AppDelegate e chame o método Platform.PerformActionForShortcutItem nele:

public override void PerformActionForShortcutItem(UIApplication application, UIApplicationShortcutItem shortcutItem, UIOperationHandler completionHandler)
{
    Platform.PerformActionForShortcutItem(application, shortcutItem, completionHandler);
}