Visual Studio

Расширение Avalonia Visual Studio

Расширение Avalonia для Visual Studio включает конструктор XAML, который можно использовать для предварительного просмотра XAML в реальном времени по мере его написания. Установив расширение Avalonia for Visual Studio, дважды щелкните XAML-файл Avalonia, чтобы открыть его.

Если вы используете VS2019 или VS2017, вам необходимо установить расширение для более старых версий.

ReSharper для Visual Studio

Для пользователей Visual Studio и ReSharper в ReSharper 2020.3 представлены встроенные функции анализа кода, завершения кода, навигации и поиска.

Если ваш XAML находится в библиотеке, Avalonia требуется исполняемое приложение, чтобы иметь возможность его предварительного просмотра. Выберите исполняемый проект из раскрывающегося списка в правом верхнем углу дизайнера. После создания проекта редактирование XAML в редакторе приведет к автоматическому обновлению предварительного просмотра.

В некоторых случаях из-за ошибок/ограничений в Visual Studio конструктор Avalonia XAML не отображается, вместо этого отображается конструктор WPF. Если в файле XAML отображается много ошибок, попробуйте щелкнуть файл правой кнопкой мыши и выбрать «Открыть с помощью…» → «Редактор XAML Avalonia».

Свойства времени разработки

К вашим элементам управления можно применить ряд свойств, которые вступят в силу только во время разработки. Чтобы использовать их, вы должны добавить пространство имен в свой файл XAML:

xmlns:d="http://schemas.microsoft.com/expression/blend/2008"

После добавления пространства имен становятся доступными следующие свойства времени разработки:

d:DesignWidth и :DesignHeight

Свойства d:DesignWidth и d:DesignHeight применяют ширину и высоту к просматриваемому элементу управления.

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        d:DesignWidth="800" d:DesignHeight="450"
        x:Class="AvaloniaApplication1.MainWindow">
    Welcome to Avalonia!
</Window>

d:DataContext

Свойство d:DataContext применяет DataContext только во время разработки. Рекомендуется использовать это свойство в сочетании с директивой {x:Static} для ссылки на статическое свойство в одной из ваших сборок:

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        d:DesignWidth="800" d:DesignHeight="450"
        x:Class="AvaloniaApplication1.MainWindow">
    Welcome to Avalonia!
</Window>

namespace My.Namespace
{
    public static class DesignData
    {
        public static MyViewModel ExampleViewModel { get; } = new MyViewModel
        {
            // View Model initialization here.
        };
    }
}

Design.DataContext

В качестве альтернативы вы можете использовать прикрепленное свойство Design.DataContext. А также Design.Width и Design.Height.

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:dd="clr-namespace:My.Namespace;assembly=MyAssembly"
        x:Class="AvaloniaApplication1.MainWindow"
        Design.Width="100">
    <Design.DataContext>
        <dd:MyViewModel />
    </Design.DataContext>
    Welcome to Avalonia!
</Window>

Диагностика ошибок

Если у вас возникли проблемы, попробуйте включить подробное ведение журнала. Сделать это можно так:

• Выберите меню «Инструменты» → «Параметры» в Visual Studio.
• Выберите «Редактор Avalonia XAML» из списка.
• Выберите «Подробный» в разделе «Минимальная подробность журнала».

Журналы будут отображаться в окне вывода Visual Studio. Выберите «Показать вывод из: Avalonia Diagnostics».

Устранение неполадок и часто задаваемые вопросы

Visual Studio не показывает средство предварительного просмотра Avalonia

Иногда Visual Studio открывает XAML-файл редактором для WPF вместо Avalonia. Обычно эта проблема решается, если вы закрываете неправильный отображаемый документ и открываете его снова.

Если это не помогло, вы также можете щелкнуть файл правой кнопкой мыши и выбрать [Открыть с помощью…]. В открывшемся диалоговом окне выберите [Редактор Avalonia XAML].

Мой предварительный просмотр пуст

Если предварительный просмотр отображается неправильно, попробуйте (пере)создать проект или решение. Для корректной работы программе предварительного просмотра требуется корректная сборка.

Кроме того, если в вашем решении более одного проекта, вам может потребоваться выбрать проект, который следует использовать для предварительного просмотра. Это можно сделать с помощью раскрывающегося списка, показанного ниже.