네이티브 포함

샘플 찾아보기

일반적으로 .NET 다중 플랫폼 앱 UI(.NET MAUI) 앱에는 레이아웃(예: Grid및 보기 Button가 포함된 레이아웃)이 포함된 페이지가 포함됩니다. 페이지, 레이아웃 및 뷰는 모두 .에서 Element파생됩니다. 네이티브 포함을 사용하면 Android용 .NET, iOS용 .NET, Mac Catalyst용 .NET 및 WinUI 네이티브 앱에서 Element 파생되는 모든 .NET MAUI 컨트롤을 사용할 수 있습니다.

네이티브 앱에서 .NET MAUI 컨트롤을 사용하는 프로세스는 다음과 같습니다.

1. .NET MAUI UI 및 모든 종속성이 포함된 .NET MAUI 단일 프로젝트를 만듭니다. 자세한 내용은 .NET MAUI 단일 프로젝트 만들기를 참조 하세요.
2. 네이티브 앱을 만들고 .NET MAUI 지원을 사용하도록 설정합니다. 자세한 내용은 .NET MAUI 지원 사용을 참조 하세요.
3. 네이티브 앱 프로젝트에서 .NET MAUI를 초기화합니다. 자세한 내용은 .NET MAUI 초기화를 참조 하세요.
4. .NET MAUI UI를 만들고 확장 메서드를 사용하여 적절한 네이티브 형식으로 ToPlatformEmbedding 변환합니다. 자세한 내용은 .NET MAUI 컨트롤을 사용합니다.

참고 항목

네이티브 포함을 사용하는 경우 .NET MAUI의 데이터 바인딩 엔진은 여전히 작동합니다. 그러나 네이티브 탐색 API를 사용하여 페이지 탐색을 수행해야 합니다.

.NET MAUI 단일 프로젝트 만들기

.NET MAUI 컨트롤을 사용하는 네이티브 앱을 만들기 전에 이전에 만든 .NET MAUI 클래스 라이브러리 프로젝트와 동일한 솔루션에 .NET MAUI 앱 프로젝트를 추가해야 합니다. .NET MAUI 앱 프로젝트는 네이티브 임베디드 앱에서 다시 사용하려는 UI를 저장합니다. 솔루션에 새 .NET MAUI 앱 프로젝트를 추가한 후 다음 단계를 수행합니다.

1. 프로젝트에서 속성 폴더를 삭제합니다.

2. 프로젝트에서 Platforms 폴더를 삭제합니다.

3. 프로젝트에서 Resources/AppIcon 폴더를 삭제합니다.

4. 프로젝트에서 Resources/raw 폴더를 삭제합니다.

5. 프로젝트에서 Resources/Splash 폴더를 삭제합니다.

6. AppShell 프로젝트에서 클래스를 삭제합니다.

7. 클래스가 App 속성을 설정하거나 메서드를 MainPage 재정 CreateWindow 의하지 않는지 확인합니다.

   public partial class App : Application
   {
       public App()
       {
           InitializeComponent();
       }
   }
   

8. MainPage 프로젝트에서 클래스를 삭제합니다.

9. 빌드 속성이 $(TargetFramework) 설정 net9.0되고 $(OutputType) 빌드 속성이 제거되도록 프로젝트 파일을 수정합니다.

   <PropertyGroup>
     <TargetFramework>net9.0</TargetFramework>
   
     <RootNamespace>MyMauiApp</RootNamespace>
     <UseMaui>true</UseMaui>
     <SingleProject>true</SingleProject>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   
     ...
   </PropertyGroup>
   

   Important

   빌드 속성이 $(TargetFramework) 아닌$(TargetFrameworks) 빌드 속성을 설정해야 합니다.

10. MauiProgram 클래스에서 제네릭 인수를 수락하도록 메서드를 TApp 수정 CreateMauiApp 하고 메서드가 반환되기 전에 호출되는 선택적 Action<MauiAppBuilder> 인수를 수락합니다. 또한 호출을 다음으로 UseMauiApp<App> 변경합니다 UseMauiEmbeddedApp<TApp>.

    public static class MauiProgram
    {
        // Create a MauiApp using the specified application.
        public static MauiApp CreateMauiApp<TApp>(Action<MauiAppBuilder>? additional = null) where TApp : App
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiEmbeddedApp<TApp>()
                .ConfigureFonts(fonts =>
                {
                    fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                    fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
                });
    
            #if DEBUG
                builder.Logging.AddDebug();
            #endif
    
            additional?.Invoke(builder);
    
            return builder.Build();
        }
    }
    

11. MauiProgram 클래스에서 선택적 Action<MauiAppBuilder> 인수를 CreateMauiApp 허용하는 오버로드를 추가합니다.

    public static class MauiProgram
    {
        ...
    
        // Create a MauiApp using the default application.
        public static MauiApp CreateMauiApp(Action<MauiAppBuilder>? additional = null) =>
            CreateMauiApp<App>(additional);
    }
    

그런 다음 종속성 및 리소스를 포함하여 필요한 .NET MAUI UI를 프로젝트에 추가하고 프로젝트가 올바르게 빌드되는지 확인해야 합니다.

.NET MAUI 지원 사용

Android용 .NET, iOS용 .NET, Mac Catalyst용 .NET 또는 WinUI 앱에서 Element 파생된 .NET MAUI 컨트롤을 사용하려면 네이티브 앱 프로젝트를 이전에 만든 .NET MAUI 클래스 라이브러리 프로젝트와 동일한 솔루션에 추가해야 합니다. 그런 다음 프로젝트 파일의 첫 번째 <PropertyGroup> 노드에서 속성을 true 설정하고 빌드하여 네이티브 앱의 프로젝트 파일에서 .NET MAUI 지원을 사용하도록 설정 $(UseMaui) $(MauiEnablePlatformUsings) 해야 합니다.

<PropertyGroup>
    ...
    <Nullable>enable</Nullable>
    <ImplicitUsings>true</ImplicitUsings>

    <UseMaui>true</UseMaui>
    <MauiEnablePlatformUsings>true</MauiEnablePlatformUsings>  
</PropertyGroup>

Mac용 .NET Catalyst 앱의 경우 빌드 속성을 최소 15.0으로 설정 $(SupportedOSPlatformVersion) 해야 합니다.

<PropertyGroup>
    ...
    <Nullable>enable</Nullable>
    <ImplicitUsings>true</ImplicitUsings>

    <SupportedOSPlatformVersion>15.0</SupportedOSPlatformVersion>
    <UseMaui>true</UseMaui>
    <MauiEnablePlatformUsings>true</MauiEnablePlatformUsings>  
</PropertyGroup>

WinUI 앱의 경우 빌드 속성을 false다음으로 설정 $(EnableDefaultXamlItems) 해야 합니다.

<PropertyGroup>
    ...
    <Nullable>enable</Nullable>
    <ImplicitUsings>true</ImplicitUsings>

    <UseMaui>true</UseMaui>
    <MauiEnablePlatformUsings>true</MauiEnablePlatformUsings>    
    <EnableDefaultXamlItems>false</EnableDefaultXamlItems>
</PropertyGroup>

이렇게 하면 이미 정의되고 있는 메서드에 대한 InitializeComponent 빌드 오류가 수신되지 않습니다.

그런 다음 NuGet 패키지의 프로젝트 파일에 Microsoft.Maui.Controls 빌드 항목을 추가 $(PackageReference) 합니다.

<ItemGroup>
    <PackageReference Include="Microsoft.Maui.Controls" Version="$(MauiVersion)" />
</ItemGroup>

.NET MAUI 초기화

네이티브 앱 프로젝트가 .NET MAUI 컨트롤을 생성하려면 먼저 .NET MAUI를 초기화해야 합니다. 초기화 시기는 주로 앱 흐름에서 가장 편리한 시기에 따라 달라집니다. 시작 시 또는 .NET MAUI 컨트롤이 생성되기 직전에 수행할 수 있습니다. 여기서 설명하는 방법은 앱의 초기 UI를 만들 때 .NET MAUI를 초기화하는 것입니다.

포함은 앱 컨텍스트 또는 창 컨텍스트에서 수행할 수 있지만 최대 .NET MAUI 호환성을 위해 창 컨텍스트에서 수행해야 합니다.

앱 컨텍스트

네이티브 포함은 네이티브 앱이 창에 대한 지식이 없는 앱 컨텍스트에서 수행할 수 있습니다. 이 방법을 사용하면 네이티브 포함 초기화를 수행하려면 다음을 수행해야 합니다.

• MauiApp 개체를 만듭니다.
• 개체에서 MauiContext 개체를 만듭니다 MauiApp . 개체는 MauiContext .NET MAUI 뷰에서 네이티브 뷰를 가져오는 데 사용됩니다.

다음 예제에서는 이 방법을 보여 줍니다.

var mauiApp = MauiProgram.CreateMauiApp();
var context = new MauiContext(mauiApp.Services); // Activity also needs passing on Android

그런 다음 확장 메서드를 사용하여 .NET MAUI 뷰를 만들고 네이티브 뷰로 ToPlatformEmbedded 변환할 수 있습니다. 이때 개체를 인수로 사용해야 합니다 MauiContext .

이 방법은 네이티브 앱이 간단한 .NET MAUI UI를 포함해야 하지만 모든 .NET MAUI 기능에 액세스할 필요가 없는 시나리오에 적합합니다. 이 방법의 단점은 핫 다시 로드 및 일부 .NET MAUI 기능과 같은 도구가 작동하지 않는다는 것입니다.

팁

MauiApp.NET MAUI 보기가 네이티브 뷰로 포함될 때마다 개체를 만드는 것은 권장되지 않습니다. 포함된 뷰가 속성에 Application.Current 액세스하는 경우 문제가 될 수 있습니다. 대신 개체를 MauiApp 공유 정적 인스턴스로 만들 수 있습니다.

public static class MyEmbeddedMauiApp
{
    static MauiApp? _shared;
    public static MauiApp Shared => _shared ??= MauiProgram.CreateMauiApp();
}

이 방법을 사용하면 앱 수명 주기 초기에 개체를 인스턴스화 MauiApp 하여 앱에 .NET MAUI 보기를 처음 포함할 때 약간의 지연을 방지할 수 있습니다.

Android에서 조각은 활동 내에서 UI의 일부를 나타냅니다. 다음 코드 예제에서는 조각에서 초기화되는 .NET MAUI를 보여줍니다.

using Android.Runtime;
using Android.Views;
using AndroidX.Navigation.Fragment;
using Microsoft.Maui.Controls.Embedding;
using Fragment = AndroidX.Fragment.App.Fragment;
using View = Android.Views.View;

namespace MyNativeEmbeddedApp.Droid;

[Register("com.companyname.nativeembeddingdemo." + nameof(FirstFragment))]
public class FirstFragment : Fragment
{
    public override View? OnCreateView(LayoutInflater inflater, ViewGroup? container, Bundle? savedInstanceState) =>
        inflater.Inflate(Resource.Layout.fragment_first, container, false);

    public override void OnViewCreated(View view, Bundle? savedInstanceState)
    {
        base.OnViewCreated(view, savedInstanceState);

        // Ensure .NET MAUI app is built before creating .NET MAUI views
        var mauiApp = MyEmbeddedMauiApp.Shared;

        // Create .NET MAUI context
        var context = new MauiContext(mauiApp.Services, Activity);

        ...
    }
}

iOS 및 Mac Catalyst에서 재정의를 AppDelegate 위해 반환 true 하도록 클래스를 FinishedLaunching 수정해야 합니다.

namespace MyNativeEmbeddedApp.iOS;

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

    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions) => true;
}

WillConnect 그런 다음 클래스의 메서드를 SceneDelegate 수정하여 주 뷰 컨트롤러를 만들고 다음의 UINavigationController뷰로 설정해야 합니다.

namespace MyNativeEmbeddedApp.iOS;

[Register("SceneDelegate")]
public class SceneDelegate : UIResponder, IUIWindowSceneDelegate
{
    [Export("window")]
    public UIWindow? Window { get; set; }

    [Export("scene:willConnectToSession:options:")]
    public void WillConnect(UIScene scene, UISceneSession session, UISceneConnectionOptions connectionOptions)
    {
        if (scene is not UIWindowScene windowScene)
            return;

        Window = new UIWindow(windowScene);

        var mainVC = new MainViewController();
        var navigationController = new UINavigationController(mainVC);
        navigationController.NavigationBar.PrefersLargeTitles = true;

        Window.RootViewController = navigationController;
        Window.MakeKeyAndVisible();
    }

    ...
}

그런 다음 XML 편집기에서 Info.plist 파일을 열고 파일 끝에 다음 XML을 추가합니다.

<key>UIApplicationSceneManifest</key>
<dict>
  <key>UIApplicationSupportsMultipleScenes</key>
  <true/>
  <key>UISceneConfigurations</key>
  <dict>
    <key>UIWindowSceneSessionRoleApplication</key>
    <array>
      <dict>
        <key>UISceneConfigurationName</key>
        <string>Default Configuration</string>
        <key>UISceneDelegateClassName</key>
        <string>SceneDelegate</string>
      </dict>
    </array>
  </dict>
</dict>

그런 다음 기본 뷰 컨트롤러의 메서드에서 .NET MAUI를 ViewDidLoad 초기화할 수 있습니다.

using Microsoft.Maui.Controls.Embedding;

namespace MyNativeEmbeddedApp.iOS;

public class MainViewController : UIViewController
{
    public override void ViewDidLoad()
    {
        base.ViewDidLoad();

        // Ensure .NET MAUI app is built before creating .NET MAUI views
        var mauiApp = MyEmbeddedMauiApp.Shared;

        // Create .NET MAUI context
        var context = new MauiContext(mauiApp.Services);

        ...
    }
}

Windows에서 MainWindow 클래스는 일반적으로 UI 관련 앱 시작 작업을 수행할 수 있는 위치입니다.

using Microsoft.Maui.Controls.Embedding;
using Microsoft.UI.Xaml;

namespace MyNativeEmbeddedApp.WinUI;

public sealed partial class MainWindow : Microsoft.UI.Xaml.Window
{
    public MainWindow()
    {
        this.InitializeComponent();
    }

    private async void OnRootLayoutLoaded(object? sender, RoutedEventArgs e)
    {
        await Task.Yield();

        // Ensure .NET MAUI app is built before creating .NET MAUI views
        var mauiApp = MyEmbeddedMauiApp.Shared;

        // Create .NET MAUI context
        var context = new MauiContext(mauiApp.Services);

        ...
    }
}

이 예제에서는 개체가 MauiApp 공유 정적 인스턴스로 만들어집니다. 이 개체가 만들어 MauiProgram.CreateMauiApp 지면 개체에서 확장 메서드 MauiAppBuilder 를 UseMauiEmbedding 호출하는 호출됩니다. 따라서 네이티브 앱 프로젝트에는 클래스와 .NET MAUI UI를 포함하는 만든 .NET MAUI 클래스 라이브러리 프로젝트에 대한 참조가 포함되어 MauiProgram 야 합니다. MauiContext 그런 다음 개체에서 개체로 MauiApp 범위가 지정된 개체를 MauiApp 만듭니다. 개체는 MauiContext .NET MAUI 컨트롤을 네이티브 형식으로 변환할 때 사용됩니다.

창 컨텍스트

네이티브 포함은 네이티브 앱에 창에 대한 지식이 있는 창 컨텍스트에서 수행할 수 있습니다. 일부 시나리오에서는 .NET MAUI 보기가 제대로 작동하려면 창에 대한 액세스 권한이 필요합니다. 예를 들어 적응형 트리거는 보기 창에 액세스해야 하며, 창이 없으면 작동하지 않습니다.

이 방법을 사용하면 네이티브 포함 초기화를 수행하려면 다음을 수행해야 합니다.

• MauiApp 개체를 만듭니다.
• 메서드를 사용하여 MauiContext 개체를 만듭니다 CreateEmbeddedWindowContext . 개체는 MauiContext .NET MAUI 뷰에서 네이티브 뷰를 가져오는 데 사용됩니다.

이 메서드는 CreateEmbeddedWindowContext 네이티브 창을 .NET MAUI 창과 관련된 창 컨텍스트를 만듭니다.

var mauiApp = MauiProgram.CreateMauiApp();
var context = mauiApp.CreateEmbeddedWindowContext(this);

그런 다음 확장 메서드를 사용하여 .NET MAUI 뷰를 만들고 네이티브 뷰로 ToPlatformEmbedded 변환할 수 있습니다. 이때 개체를 인수로 사용해야 합니다 MauiContext .

참고 항목

ToPlatformEmbedded 확장 메서드에는 포함된 창에 .NET MAUI 보기를 추가하는 오버로드가 있습니다.

이 방법의 장점은 각 네이티브 창에 대해 단일 .NET MAUI 창이 있고 창 관련 API가 올바르게 작동하며 핫 다시 로드와 같은 도구가 올바르게 작동한다는 것입니다.

팁

MauiApp.NET MAUI 보기가 네이티브 뷰로 포함될 때마다 개체를 만드는 것은 권장되지 않습니다. 포함된 뷰가 속성에 Application.Current 액세스하는 경우 문제가 될 수 있습니다. 대신 개체를 MauiApp 공유 정적 인스턴스로 만들 수 있습니다.

public static class MyEmbeddedMauiApp
{
    static MauiApp? _shared;
    public static MauiApp Shared => _shared ??= MauiProgram.CreateMauiApp();
}

이 방법을 사용하면 앱 수명 주기 초기에 개체를 인스턴스화 MauiApp 하여 앱에 .NET MAUI 보기를 처음 포함할 때 약간의 지연을 방지할 수 있습니다.

Android에서 조각은 활동 내에서 UI의 일부를 나타냅니다. 다음 코드 예제에서는 조각에서 초기화되는 .NET MAUI를 보여줍니다.

using Android.Runtime;
using Android.Views;
using AndroidX.Navigation.Fragment;
using Microsoft.Maui.Controls.Embedding;
using Fragment = AndroidX.Fragment.App.Fragment;
using View = Android.Views.View;

namespace MyNativeEmbeddedApp.Droid;

[Register("com.companyname.nativeembeddingdemo." + nameof(FirstFragment))]
public class FirstFragment : Fragment
{
    Activity? _window;
    IMauiContext? _windowContext;

    public IMauiContext WindowContext =>
        _windowContext ??= MyEmbeddedMauiApp.Shared.CreateEmbeddedWindowContext(_window ?? throw new InvalidOperationException());

    public override View? OnCreateView(LayoutInflater inflater, ViewGroup? container, Bundle? savedInstanceState) =>
        inflater.Inflate(Resource.Layout.fragment_first, container, false);

    public override void OnViewCreated(View view, Bundle? savedInstanceState)
    {
        base.OnViewCreated(view, savedInstanceState);

        _window ??= Activity;

        // Create MAUI embedded window context
        var context = WindowContext;

        ...
    }
}

iOS 및 Mac Catalyst에서 재정의를 AppDelegate 위해 반환 true 하도록 클래스를 FinishedLaunching 수정해야 합니다.

namespace MyNativeEmbeddedApp.iOS;

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

    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions) => true;
}

WillConnect 그런 다음 클래스의 메서드를 SceneDelegate 수정하여 주 뷰 컨트롤러를 만들고 다음의 UINavigationController뷰로 설정해야 합니다.

namespace MyNativeEmbeddedApp.iOS;

[Register("SceneDelegate")]
public class SceneDelegate : UIResponder, IUIWindowSceneDelegate
{
    [Export("window")]
    public UIWindow? Window { get; set; }

    [Export("scene:willConnectToSession:options:")]
    public void WillConnect(UIScene scene, UISceneSession session, UISceneConnectionOptions connectionOptions)
    {
        if (scene is not UIWindowScene windowScene)
            return;

        Window = new UIWindow(windowScene);

        var mainVC = new MainViewController();
        var navigationController = new UINavigationController(mainVC);
        navigationController.NavigationBar.PrefersLargeTitles = true;

        Window.RootViewController = navigationController;
        Window.MakeKeyAndVisible();
    }

    ...
}

그런 다음 XML 편집기에서 Info.plist 파일을 열고 파일 끝에 다음 XML을 추가합니다.

<key>UIApplicationSceneManifest</key>
<dict>
  <key>UIApplicationSupportsMultipleScenes</key>
  <true/>
  <key>UISceneConfigurations</key>
  <dict>
    <key>UIWindowSceneSessionRoleApplication</key>
    <array>
      <dict>
        <key>UISceneConfigurationName</key>
        <string>Default Configuration</string>
        <key>UISceneDelegateClassName</key>
        <string>SceneDelegate</string>
      </dict>
    </array>
  </dict>
</dict>

그런 다음 기본 뷰 컨트롤러의 메서드에서 .NET MAUI를 ViewDidLoad 초기화할 수 있습니다.

using Microsoft.Maui.Controls.Embedding;

namespace MyNativeEmbeddedApp.iOS;

public class MainViewController : UIViewController
{
    UIKit.UIWindow? _window;
    IMauiContext? _windowContext;

    public IMauiContext WindowContext =>
        _windowContext ??= MyEmbeddedMauiApp.Shared.CreateEmbeddedWindowContext(_window ?? throw new InvalidOperationException());

    public override void ViewDidLoad()
    {
        base.ViewDidLoad();

        _window ??= ParentViewController!.View!.Window;

        // Create MAUI embedded window context
        var context = WindowContext;

        ...
    }
}

Windows에서 MainWindow 클래스는 일반적으로 UI 관련 앱 시작 작업을 수행할 수 있는 위치입니다.

using Microsoft.Maui.Controls.Embedding;
using Microsoft.UI.Xaml;

namespace MyNativeEmbeddedApp.WinUI;

public sealed partial class MainWindow : Microsoft.UI.Xaml.Window
{
    Microsoft.UI.Xaml.Window? _window;
    IMauiContext? _windowContext;

    public IMauiContext WindowContext =>
        _windowContext ??= MyEmbeddedMauiApp.Shared.CreateEmbeddedWindowContext(_window ?? throw new InvalidOperationException());

    public MainWindow()
    {
        this.InitializeComponent();
        _window ??= this;
    }

    private async void OnRootLayoutLoaded(object? sender, RoutedEventArgs e)
    {
        await Task.Yield();

        // Create MAUI embedded window context
        var context = WindowContext;

        ...
    }
}

이 예제에서는 개체가 MauiApp 공유 정적 인스턴스로 만들어집니다. 이 개체가 만들어 MauiProgram.CreateMauiApp 지면 개체에서 확장 메서드 MauiAppBuilder 를 UseMauiEmbedding 호출하는 호출됩니다. 따라서 네이티브 앱 프로젝트에는 클래스와 .NET MAUI UI를 포함하는 만든 .NET MAUI 클래스 라이브러리 프로젝트에 대한 참조가 포함되어 MauiProgram 야 합니다. MauiContext 그런 다음 창으로 범위가 CreateEmbeddedWindowContext 지정된 메서드를 사용하여 개체를 만듭니다. 개체는 MauiContext .NET MAUI 컨트롤을 네이티브 형식으로 변환할 때 사용됩니다.

.NET MAUI 컨트롤 사용

네이티브 앱에서 .NET MAUI가 초기화된 후 네이티브 앱의 레이아웃에 .NET MAUI UI를 추가할 수 있습니다. 이 작업은 UI의 인스턴스를 만들고 확장 메서드를 사용하여 적절한 네이티브 형식으로 ToPlatformEmbedded 변환하여 수행할 수 있습니다.

Android에서 확장 메서드는 ToPlatformEmbedded .NET MAUI 컨트롤을 Android View 개체로 변환합니다.

var mauiView = new MyMauiContent();
Android.Views.View nativeView = mauiView.ToPlatformEmbedded(context);

이 예제에서는 ContentView-derived 개체가 Android View 개체로 변환됩니다.

참고 항목

ToPlatformEmbedded 확장 메서드는 네임스페이스에 Microsoft.Maui.Controls.Embedding 있습니다. 따라서 네이티브 앱 프로젝트에는 해당 네임스페이 using 스에 대한 문이 포함되어야 합니다.

그러면 네이 View 티브 앱의 레이아웃에 개체를 추가할 수 있습니다.

rootLayout.AddView(nativeView, new LinearLayout.LayoutParams(MatchParent, WrapContent));

iOS 및 Mac Catalyst에서 ToPlatformEmbedded 확장 메서드는 .NET MAUI 컨트롤을 개체로 UIView 변환합니다.

var mauiView = new MyMauiContent();
UIView nativeView = mauiView.ToPlatformEmbedded(context);

이 예제에서는 ContentView-derived 개체가 개체로 UIView 변환됩니다.

참고 항목

ToPlatformEmbedded 확장 메서드는 네임스페이스에 Microsoft.Maui.Controls.Embedding 있습니다. 따라서 네이티브 앱 프로젝트에는 해당 네임스페이 using 스에 대한 문이 포함되어야 합니다.

UIView 그런 다음 개체를 뷰 컨트롤러의 보기에 추가할 수 있습니다.

stackView.AddArrangedSubView(new ContainerView(nativeView));

ContainerView 는 .NET MAUI 뷰의 크기를 올바르게 조정하는 사용자 지정 형식입니다. .NET MAUI 보기로 리디렉션하여 IntrinsicContentSize 이 작업을 수행합니다 SizeThatFits.

class ContainerView : UIView
{
    public ContainerView(UIView view)
    {
        AddSubview(view);
    }

    public override CGSize IntrinsicContentSize =>
        SizeThatFits(new CGSize(nfloat.MaxValue, nfloat.MaxValue));

    public override CGSize SizeThatFits(CGSize size) =>
        Subviews?.FirstOrDefault()?.SizeThatFits(size) ?? CGSize.Empty;

    public override void LayoutSubviews()
    {
        if (Subviews?.FirstOrDefault() is { } view)
            view.Frame = Bounds;
    }

    public override void SetNeedsLayout()
    {
        base.SetNeedsLayout();
          InvalidateIntrinsicContentSize();
    }
}

또한 .NET MAUI의 ToUIViewController 확장 메서드를 사용하여 .NET MAUI 페이지를 다음으로 변환할 UIViewController수 있습니다.

MyMauiPage myMauiPage = new MyMauiPage();
UIViewController myPageController = myMauiPage.ToUIViewController(context);

이 예제에서는 ContentPage-derived 개체가 .로 변환 UIViewController됩니다.

Windows에서 확장 메서드는 ToPlatformEmbedded .NET MAUI 컨트롤을 개체로 FrameworkElement 변환합니다.

var mauiView = new MyMauiContent();
FrameworkElement nativeView = myMauiPage.ToPlatformEmbedded(context);

이 예제에서는 ContentView-derived 개체가 개체로 FrameworkElement 변환됩니다. 그런 다음 개체를 FrameworkElement WinUI 페이지의 콘텐츠로 설정할 수 있습니다.

참고 항목

ToPlatformEmbedded 확장 메서드는 네임스페이스에 Microsoft.Maui.Controls.Embedding 있습니다. 따라서 네이티브 앱 프로젝트에는 해당 네임스페이 using 스에 대한 문이 포함되어야 합니다.

그러면 네이 FrameworkElement 티브 앱의 레이아웃에 개체를 추가할 수 있습니다.

stackPanel.Children.Add(nativeView);