Manual

You can use this when you want to manually wire in Shiny due to application complexities.

First, install - this contains all of the internal services needed by Shiny modules as well as all the lifecycle hooks in order for Shiny to successfully register against the native platform

iOS/Mac Catalyst AppDelegate

using System;
using Foundation;
using Shiny.Hosting;
using UIKit;

namespace Shiny;


public abstract class ShinyAppDelegate : UIApplicationDelegate
{
    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
    {
        var host = HostBuilder.Create();

        // add shiny services & your own services here
        host.Build().Run();

        return base.FinishedLaunching(application, launchOptions);
    }

    public override bool ContinueUserActivity(UIApplication application, NSUserActivity userActivity, UIApplicationRestorationHandler completionHandler)
    {
        Host.Lifecycle.OnContinueUserActivity(userActivity,  completionHandler);
    }

    // only used by Shiny.Net.Http
    public override void HandleEventsForBackgroundUrl(UIApplication application, string sessionIdentifier, Action completionHandler)
    {
        Host.Lifecycle.OnHandleEventsForBackgroundUrl(sessionIdentifier, completionHandler);
    }

    // if using any of the Shiny.Push packages
    public override void RegisteredForRemoteNotifications(UIApplication application, NSData deviceToken)
    {
        Host.Lifecycle.OnRegisteredForRemoteNotifications(deviceToken);
    }

    public override void FailedToRegisterForRemoteNotifications(UIApplication application, NSError error)
    {
        Host.Lifecycle.OnFailedToRegisterForRemoteNotifications(error);
    }

    public override void DidReceiveRemoteNotification(UIApplication application, NSDictionary userInfo, Action<UIBackgroundFetchResult> completionHandler)
    {
        Host.Lifecycle.OnDidReceiveRemoteNotification(userInfo, completionHandler);
    }
}

Android

Tip

For Classic Xamarin, you will need to add framework reference to Mono.Android.Export. You can do this by editing your head android project and adding the following

<ItemGroup>
    <Reference Include="Mono.Android.Export" />
</ItemGroup>

Application

The application is required for Shiny on Android. The application will spin up allowing shiny to register all of its delegates and your services when the app is launching. When Android launches in the background, it won’t run your main activity.

using System;
using Android.App;
using Android.Runtime;
using Shiny.Hosting;

namespace Shiny;


[Application]
public class YourShinyAndroidApplication : Application
{
    // you need this constructor for .NET Android
    public YourShinyAndroidApplication(IntPtr javaReference, JniHandleOwnership transfer) : base(javaReference, transfer) {}


    public override void OnCreate()
    {
        base.OnCreate();
        var host = HostBuilder.Create();

        // add your shiny & custom services here

        host.Build().Run();
    }
}

Activity

This is all of the required Shiny stuff in your activity. The main requirement here is OnRequestPermissionsResult since it is used by every single module within Shiny.

using Android.App;
using Android.Content;
using Android.Content.PM;
using Android.Runtime;
using AndroidX.AppCompat.App;
using Shiny.Hosting;

namespace Shiny;

[IntentFilter(new[] {
    // if using local notifications
    Shiny.ShinyNotificationIntents.NotificationClickAction,

    // if using push notifications
    Shiny.ShinyPushIntents.NotificationClickAction
})]
public class ShinyAndroidActivity : AppCompatActivity
{
    protected override void OnCreate(Bundle? savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        Host.Lifecycle.OnActivityOnCreate(this, savedInstanceState);
    }


    protected override void OnNewIntent(Intent? intent)
    {
        base.OnNewIntent(intent);
        Host.Lifecycle.OnNewIntent(this, intent);
    }


    protected override void OnActivityResult(int requestCode, [GeneratedEnum] Result resultCode, Intent? data)
    {
        base.OnActivityResult(requestCode, resultCode, data);
        Host.Lifecycle.OnActivityResult(this, requestCode, resultCode, data);
    }


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