Розв'язання проблеми з розпізнаванням clr-namespace для Components.Routes у .NET MAUI Blazor Hybrid

Розв’язання проблеми з розпізнаванням clr-namespace для Components.Routes у .NET MAUI Blazor Hybrid

3 Березня 2024 в 12:41 29

Під час розробки додатків у середовищі .NET MAUI Blazor Hybrid можуть виникати різноманітні труднощі, зокрема з розпізнаванням clr-namespace для компонентів. У цій статті ми розглянемо одну з таких проблем та запропонуємо рішення.

Почнемо з виокремлення самої проблеми. При створенні нового додатку .NET MAUI Blazor Hybrid із використанням .NET 8.0, деякі розробники зіткнулися з помилкою під час збирання рішення:

XFC0000 Cannot resolve type "clr-namespace:MauiApp1:Components.Routes"

1	XFC0000 Cannot resolve type "clr-namespace:MauiApp1:Components.Routes"

Ця помилка свідчить про те, що компілятор не може знайти тип, який вказано у clr-namespace для компонента Components.Routes.

Перевіримо вихідний код, який викликає помилку:

MainPage.xaml
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:MauiApp1"
             x:Class="MauiApp1.MainPage"
             BackgroundColor="{DynamicResource PageBackgroundColor}">
    <BlazorWebView x:Name="blazorWebView" HostPage="wwwroot/index.html">
        <BlazorWebView.RootComponents>
            <RootComponent Selector="#app" ComponentType="{x:Type local:Components.Routes}" />
        </BlazorWebView.RootComponents>
    </BlazorWebView>
</ContentPage>

MainPage.xaml

<?xml version="1.0" encoding="utf-8" ?>

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"

xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"

xmlns:local="clr-namespace:MauiApp1"

x:Class="MauiApp1.MainPage"

BackgroundColor="{DynamicResource PageBackgroundColor}">

<BlazorWebView.RootComponents>

</BlazorWebView.RootComponents>

</BlazorWebView>

</ContentPage>

Відповідно до коду, помилка виникає на рівні MainPage.xaml, коли використовується компонент Components.Routes у якості кореневого компонента для BlazorWebView.

Далі в коді зазначено Routes.Razor:

Routes.Razor
<Router AppAssembly="@typeof(MauiProgram).Assembly">
    <Found Context="routeData">
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(Layout.MainLayout)" />
        <FocusOnNavigate RouteData="@routeData" Selector="h1" />
    </Found>
</Router>

Routes.Razor

</Found>

</Router>

Цей код використовує Router та RouteView для маршрутизації в додатку. Проте, у зв’язку з помилкою, вони не можуть правильно розпізнати тип Components.Routes.

Тепер перейдемо до можливого рішення проблеми. Один із можливих підходів – перевірити правильність використання clr-namespace та переконатися, що шлях до компонента вказаний вірно.

Приклад правильного використання clr-namespace:

xmlns:local="clr-namespace:MauiApp1.Components"

1	xmlns:local="clr-namespace:MauiApp1.Components"

Також слід перевірити, чи всі необхідні компоненти додатку включені у проект, а також правильність їхніх назв та шляхів.

Після внесення необхідних змін у код та переконавшись у правильності використання clr-namespace, повторно зібравши рішення, можна перевірити, чи виникла помилка.

У випадку, якщо помилка продовжує виникати, слід провести додаткове дослідження, перевірити логи та використати інші інструменти для визначення причини проблеми.

Заключно, помилка з розпізнаванням clr-namespace для Components.Routes у .NET MAUI Blazor Hybrid може виникати з різних причин, проте з правильним аналізом та внесенням необхідних змін у код, її можна вирішити.