Native Hosting

For .NET native apps that don’t use MAUI, Shiny provides base classes that wire up all the platform lifecycle hooks automatically. You inherit from Shiny’s base classes and override a single method to configure your services.

Note

If you already have custom platform boilerplate classes and can’t inherit from Shiny’s base classes, use the Manual hosting model instead.

Setup

1. Install the NuGet package

   

2. Create your platform entry points

   iOS / Mac Catalyst

   Inherit from ShinyAppDelegate:

   using Shiny;
   using Shiny.Hosting;
   using Foundation;
   using UIKit;
   
   namespace YourNamespace;
   
   public class MyDelegate : ShinyAppDelegate
   {
       protected override IHost CreateShinyHost()
       {
           var builder = HostBuilder.Create();
   
           // Register your Shiny modules and services here
   
           return builder.Build();
       }
   
       public override bool FinishedLaunching(
           UIApplication application,
           NSDictionary launchOptions)
       {
           // Your launch code here — don't call Shiny before base
           return base.FinishedLaunching(application, launchOptions);
       }
   }

   Android

   You need both an Application and an Activity class.

   Application — inherit from ShinyAndroidApplication:

   using System;
   using Android.App;
   using Android.Runtime;
   using Shiny.Hosting;
   
   namespace YourNamespace;
   
   public class YourApplication : ShinyAndroidApplication
   {
       public YourApplication(
           IntPtr javaReference,
           JniHandleOwnership transfer)
           : base(javaReference, transfer) {}
   
       protected override IHost CreateShinyHost()
       {
           var builder = HostBuilder.Create();
   
           // Register your Shiny modules and services here
   
           return builder.Build();
       }
   }

   Activity — inherit from ShinyAndroidActivity:

   using Android.App;
   using Android.Content.PM;
   
   namespace YourNamespace;
   
   [Activity(
       Theme = "@style/YourTheme",
       MainLauncher = true,
       ConfigurationChanges =
           ConfigChanges.ScreenSize |
           ConfigChanges.Orientation |
           ConfigChanges.UiMode |
           ConfigChanges.ScreenLayout |
           ConfigChanges.SmallestScreenSize |
           ConfigChanges.Density
   )]
   public class MainActivity : ShinyAndroidActivity
   {
   }

   Caution

   For Classic Xamarin, add a framework reference to Mono.Android.Export:

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