IslandCore 1.0.0

IslandCore

Hosting a UWP app using the Xaml Island framework.
Also supports the WinUI2 NuGet package.

1. Application Manifest

Create an app.manifest file.
Prepare at least the following manifest of apps for your program.

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1"
          manifestVersion="1.0">
    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
        <application>
            
            <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
            <maxversiontested Id="10.0.18362.0"/>
        </application>
    </compatibility>
</assembly>

2. Use IslandCore.Application

Use IslandCore.Application to replace Windows.UI.Xaml.Application in App.xaml.

<island:Application
    x:Class="NewApp1.App"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:island="using:IslandCore">

</island:Application>

A minimal App.xaml.cs example for C#.

using System;
using System.Threading;
using Windows.System;
using Windows.ApplicationModel.Activation;

namespace NewApp1;

public sealed partial class App : IslandCore.Application
{
    private IslandCore.Window _window;

    public App()
    {
        InitializeComponent();

        // This line of code is responsible for initialization.
        InitializeXamlManager();
    }

    protected override void OnLaunched(LaunchActivatedEventArgs args)
    {
        // In C#, you need to handle the SynchronizationContext separately.
        var context = new DispatcherQueueSynchronizationContext(DispatcherQueue.GetForCurrentThread());
        SynchronizationContext.SetSynchronizationContext(context);

        base.OnLaunched(args);
    }

    protected override void OnIslandLaunched(LaunchActivatedEventArgs e)
    {
        _window = new()
        {
            Title = "C# IslandCore Window",
            Content = new MainPage(),
        };

        _window.Activate();
    }
}

A minimal App.cpp example for C++/WinRT.

#include "pch.h"
#include "App.h"

namespace winrt::BlankApp1::implementation
{
    App::App()
    {
        // This line of code is responsible for initialization.
        InitializeXamlManager();
    }
    
    void App::OnIslandLaunched(Windows::ApplicationModel::Activation::LaunchActivatedEventArgs const& e)
    {
        _window = IslandCore::Window();
        _window.Title(L"C++/WinRT IslandCore Window");
        _window.Content(BlankApp1::MainPage{});

        _window.Activate();
    }
};

About App.idl.

namespace BlankApp1
{
    [default_interface]
    runtimeclass App : IslandCore.Application
    {
    }
}

3. Edit project file

For C# projects (.csproj):

<Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
        <OutputType>WinExe</OutputType>
        <TargetFramework>net10.0-windows10.0.26100.0</TargetFramework>
        <TargetPlatformMinVersion>10.0.18362.0</TargetPlatformMinVersion>
        <UseUwp>true</UseUwp>
        <Platforms>x86;x64;arm64</Platforms>
        <ApplicationManifest>app.manifest</ApplicationManifest>

        

        
        <IsPackaged>false</IsPackaged>

        
        <RemoveWebView2Component>false</RemoveWebView2Component>
    </PropertyGroup>

    

    <ItemGroup>
        <PackageReference Include="IslandCore" Version="1.0.0" />
    </ItemGroup>
</Project>

For C++/WinRT Project (.vcxproj):

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    

    <WindowsTargetPlatformVersion Condition=" '$(WindowsTargetPlatformVersion)' == '' ">10.0.26100.0</WindowsTargetPlatformVersion>
    <WindowsTargetPlatformMinVersion>10.0.18362.0</WindowsTargetPlatformMinVersion>

    
    <AppContainerApplication>false</AppContainerApplication>
    <ApplicationType>Windows Store</ApplicationType>
    <ApplicationTypeRevision>10.0</ApplicationTypeRevision>
    <DesktopCompatible>true</DesktopCompatible>

    
    <IsPackaged>false</IsPackaged>

    
    <RemoveWebView2Component>false</RemoveWebView2Component>
</Project>

4. Other Settings

Set the PopupHelper.IsThemeAware attached property for all elements with a Popup, for example:

<ComboBox island:PopupHelper.IsThemeAware="True">
    <ComboBoxItem Content="Item 1" />
    <ComboBoxItem Content="Item 2" />
    <ComboBoxItem Content="Item 3" />
</ComboBox>

Fixing the issue with the ToolTip theme color, for example:

ToolTipHelper.SetNewDefaultToolTipStyle();
ToolTipHelper.SetGlobalToolTipThemeProvider(this);

Set a backdrop for the window, for example:

if (XamlSourceTransparencyHelper.IsSupportMicaBackdrop)
{
    XamlSourceTransparencyHelper.IsBackgroundTransparent = true;
    _window.WindowBackdropType = WindowBackdropType.Mica;
}