Средство предварительного просмотра XAML для Xamarin.Forms
Средство предварительного просмотра XAML было нерекомендуемым в Visual Studio 2019 версии 16.8 и Visual Studio для Mac версии 8.8 и заменено функцией XAML Горячая перезагрузка в Visual Studio 2019 версии 16.9 и Visual Studio для Mac версии 8.9. Дополнительные сведения о Горячая перезагрузка XAML см. в документации.
Обзор
В средстве предварительного просмотра XAML показано, как будет выглядеть страница Xamarin.Forms XAML в iOS и Android. При внесении изменений в XAML вы увидите, что они будут доступны для предварительного просмотра сразу же вместе с кодом. Средство предварительного просмотра XAML доступно в Visual Studio и Visual Studio для Mac.
Начало работы
Visual Studio 2019
Вы можете открыть средство предварительного просмотра XAML, щелкнув стрелки в области разделенного представления. Если вы хотите изменить поведение разделенного представления по умолчанию, используйте диалоговое окно Сервис > Параметры > Xamarin >Xamarin.Forms XAML Previewer . В этом диалоговом окне можно выбрать представление документа по умолчанию и ориентацию разделения.
При открытии XAML-файла редактор откроется либо в полноразмерном режиме, либо рядом с ним в зависимости от параметров, выбранных в диалоговом окне Сервис > Параметры > Xamarin >Xamarin.Forms XAML Previewer . Однако разделение можно изменить для каждого файла в окне редактора.
Элементы управления предварительного просмотра XAML
Выберите, хотите ли вы просмотреть код, средство предварительного просмотра XAML или и то, и другое, нажав эти кнопки в области разделенного представления. Средняя кнопка переключает сторону средства предварительного просмотра и вашего кода:
Вы можете изменить, будет ли экран разделен по вертикали или по горизонтали, или свернуть одну панель полностью:
Включение или отключение средства предварительного просмотра XAML
Вы можете отключить средство предварительного просмотра XAML в диалоговом окне Сервис > Параметры > Xamarin >Xamarin.Forms XAML Previewer , выбрав Редактор XML по умолчанию в качестве редактора XAML по умолчанию. Это также отключает структуру документа, панель свойств и панель элементов XAML. Чтобы снова включить средство предварительного просмотра XAML и эти средства, измените редактор XAML по умолчанию на Xamarin.Forms Средство предварительного просмотра.
Visual Studio для Mac
Кнопка Предварительного просмотра отображается в редакторе при открытии страницы XAML. Чтобы отобразить или скрыть средство предварительного просмотра, нажмите кнопки Предварительный просмотр или Разделить в левом нижнем углу окна любого документа XAML:
В более ранних версиях Visual Studio для Mac кнопка Предварительного просмотра располагалась в правом верхнем углу окна.
Включение или отключение средства предварительного просмотра XAML
Вы можете отключить средство предварительного просмотра XAML в диалоговом окне Visual Studio > Параметры > Текстовый редактор > XAML , выбрав Редактор XML по умолчанию в качестве редактора XAML по умолчанию. Это также отключает структуру документа, панель свойств и панель элементов XAML. Чтобы снова включить средство предварительного просмотра XAML и эти средства, измените редактор XAML по умолчанию на Xamarin.Forms Средство предварительного просмотра.
Параметры средства предварительного просмотра XAML
Параметры в верхней части области предварительного просмотра:
- Android — отображение версии экрана Android
- iOS — отображение версии экрана iOS (примечание. Если вы используете Visual Studio в Windows, для использования этого режима необходимо связать с Компьютером Mac).
- Устройство — раскрывающийся список устройств Android или iOS, включая разрешение и размер экрана.
- Книжная (значок) — использует книжную ориентацию для предварительного просмотра.
- Альбомная ориентация (значок) — использует альбомную ориентацию для предварительного просмотра.
Обнаружение режима конструктора
Свойство static DesignMode.IsDesignModeEnabled сообщает, выполняется ли приложение в предварительном просмотре. С его помощью можно указать код, который будет выполняться только в том случае, если приложение запущено или не запущено в средстве предварительного просмотра:
if (DesignMode.IsDesignModeEnabled) < // Previewer only code >if (!DesignMode.IsDesignModeEnabled) < // Don't run in the Previewer >Это свойство полезно при инициализации библиотеки в конструкторе страницы, которая не выполняется во время разработки.
Диагностика
Проверьте приведенные ниже проблемы и форумы Xamarin, если средство предварительного просмотра не работает.
Средство предварительного просмотра XAML не отображает или отображает ошибку
- Запуск средства предварительного просмотра может занять некоторое время— вы увидите сообщение «Инициализация отрисовки», пока он не будет готов.
- Попробуйте закрыть и повторно открыть XAML-файл.
- Убедитесь, что класс App имеет конструктор без параметров.
- Проверьте версию Xamarin.Forms — она должна быть не менее Xamarin.Forms 3.6. Вы можете выполнить обновление до последней Xamarin.Forms версии с помощью NuGet.
- Проверьте установку JDK. Для предварительного просмотра Android требуется по крайней мере JDK 8.
- Попробуйте упаковать все инициализированные классы в код C# страницы в if (!DesignMode.IsDesignModeEnabled) .
Пользовательские элементы управления не отображаются
Попробуйте создать проект. Средство предварительного просмотра отображает базовый класс элемента управления, если ему не удается отобразить элемент управления или создатель элемента управления отказался от отрисовки времени разработки. Дополнительные сведения см. в разделе Отображение пользовательских элементов управления в средстве предварительного просмотра XAML.
Отрисовка пользовательских элементов управления в средстве предварительного просмотра XAML
Иногда пользовательские элементы управления не работают должным образом в средстве предварительного просмотра XAML. Используйте рекомендации в этой статье, чтобы понять ограничения предварительного просмотра пользовательских элементов управления.
Средство предварительного просмотра XAML было нерекомендуемым в Visual Studio 2019 версии 16.8 и Visual Studio для Mac версии 8.8 и заменено функцией XAML Горячая перезагрузка в Visual Studio 2019 версии 16.9 и Visual Studio для Mac версии 8.9. Дополнительные сведения о Горячая перезагрузка XAML см. в документации.
Базовый режим предварительного просмотра
Даже если вы еще не создали проект, средство предварительного просмотра XAML будет отображать страницы. До сборки любой элемент управления, который использует код программной части, будет отображать свой базовый Xamarin.Forms тип. При сборке проекта средство предварительного просмотра XAML попытается отобразить пользовательские элементы управления с включенной отрисовкой во время разработки. Если отрисовка завершится сбоем, отобразится базовый Xamarin.Forms тип.
Включение отрисовки времени разработки для пользовательских элементов управления
Если вы создаете собственные пользовательские элементы управления или используете элементы управления из сторонней библиотеки, средство предварительного просмотра может отобразить их неправильно. Пользовательские элементы управления должны согласиться на отрисовку во время разработки, чтобы они отображались в средстве предварительного просмотра, независимо от того, написали ли вы элемент управления или импортировали его из библиотеки. С помощью созданных элементов управления добавьте в [DesignTimeVisible(true)] класс элемента управления , чтобы отобразить его в средстве предварительного просмотра:
namespace MyProject < [DesignTimeVisible(true)] public class MyControl : BaseControl < // Your control's code here >> Элементы управления SkiaSharp
В настоящее время элементы управления SkiaSharp поддерживаются только при предварительном просмотре в iOS. Они не будут отображаться в предварительной версии Android.
Устранение неполадок
Проверка версии Xamarin.Forms
Убедитесь, что установлено не менее Xamarin.Forms 3.6. Вы можете обновить версию Xamarin.Forms в NuGet.
Даже при использовании [DesignTimeVisible(true)] пользовательский элемент управления не отображается должным образом.
Пользовательские элементы управления, которые в значительной степени зависят от кода программной части или данных серверной части, не всегда работают в средстве предварительного просмотра XAML. Вы можете сделать следующее:
- Перемещение элемента управления, чтобы он не инициализировался, если включен режим конструктора
- Настройка данных времени разработки для отображения поддельных данных из серверной части
Средство предварительного просмотра XAML отображает ошибку «Пользовательские элементы управления не отображаются должным образом»
Попробуйте очистить и перестроить проект или закрыть и повторно открыть XAML-файл.
Начало работы с Xamarin.Forms 2.0 и Windows 10 Preview
С выходом Xamarin 4, вышли и Xamarin.Forms 2.0, включающий новые функиции и оптимизации, чтобы помочь вам создавать больше нативных, кросс-платформенных, мобильных приложений. В дополнение к ListView — стратегия кэширования, сужающие жесты и новые свойства, появившиеся в первой публичной превью версии Xamarin.Forms для Windows 10 (UWP) приложений. Хотя Xamarin.Forms уже поддерживает Windows Phone и Windows Store, Windows 10 представляет собой универсальный Windows-проект, который может предназначаться как для настольных, так и мобильных платформ, что позволит вам распрастранить ваше приложение на большее кол-во устройств.
Начало
Прежде, чем вы начнете создавать универсальные приложения Windows 10 с Xamarin.Forms, есть несколько необходимых требований, которые должны быть установлены:
- Windows 10
- Visual Studio 2015
- Universal Windows Developer Tools
Как только вы все установили, пора перейти к готовому Xamarin.Forms проекту. Xamarin.Forms 2.0 не только добавляют предварительную поддержку для приложений Windows 10, но и множество дополнительных функций и оптимизаций для ваших мобильных приложений.
Для начала зайдем в менеджер Nuget пакетов вашей Visual Studio.
Выберите фильтр “Upgrade available” и обновите все ваши Nuget пакеты, для Xamarin.Forms.
Visual Studio может предложить перезапуститься после этого шага.
Добавляем универсальное приложение Windows
После того как все ваши Nuget пакеты обновлены, настало время, чтобы добавить пустой универсальный проект Windows. Его можно найти в разделе Add New Project -> Windows -> Universal -> Blank App .
Добавление Nuget пакетов & PCL/Shared Project ссылок
Когда вы создаете новый проект Xamarin.Forms, все необходимые ссылки и NuGet-пакеты добавляются автоматически. Однако для существующих проектов Xamarin.Forms, которые хотят поддерживать UWP, формы должны быть добавлены вручную. Как? Во-первых, добавьте Xamarin.Forms. Щелкните правой кнопкой по вашему решению (Solution) и найдите пункт “Manage NuGet Packages…” и в фильтре выберите “Installed”. Найдите Xamarin.Forms и выберите UWP проект для установки последней версии пакета.
Теперь, добавьте ваш общий код, который содержит Модели, Представления и ViewModels. В приложении UWP щелкнуть правой кнопкой по “References” и выбрать “Add Reference”. В пункте “Projects” вы найдете все проекты в решении. Найдите свой PCL или Shared проект, проверьте его и нажмите “OK”.
Обновление App.xaml.cs
У всех приложений Windows есть App.xaml для “низкоуровневой” конфигурации приложения. Точно так же, как XAML страница в Xamarin.Forms, у этой страницы есть C# code-behind для обработки событий жизненного цикла. Откройте его, и вы найдете метод OnLaunched .
Найдите следующую строку кода:
rootFrame.NavigationFailed += OnNavigationFailed; и добавьте вызов Xamarin.Forms метода Init :
Xamarin.Forms.Forms.Init (e); Обновление MainPage.xaml
Откройте MainPage.xaml приложения Windows 10 и удалите Grid по умолчанию, чтобы теперь страница была абсолютно пуста. Затем, добавьте новое пространство имен в XAML и измените Page , чтобы была Xamarin.Forms Page :
Обновление MainPage.xaml.cs
Обновите code-behind файл, чтобы инициализировать ваш Xamarin.Forms приложение:
public sealed partial class MainPage < public MainPage() < InitializeComponent(); LoadApplication (new YOUR_NAMESPACE.App()); >> Замените YOUR_NAMESPACE пространством имен, которое используете вы, в котором находится класс App.cs .
Конфигурация приложения и деплой
Иногда Visual Studio может не собирать ново-добавленный проект. Чтобы гарантировать, что проект будет собираться и деплоиться на устройство, щелкните правой кнопкой по решению и откройте менеджер конфигурации. Проверьте приложение UWP, флаги build и deploy , они должны быть активны!
Добавьте изображения и другие Nuget пакеты
Последний шаг, просто добавить любое изображение или любой из Nuget пакетов или плагинов для Xamarin, которые вы можете иметь в качестве зависимостей. Убедитесь, что каждая из этих зависимостей имеей поддержку Windows 10 (UWP), перед использованием.
Узнать больше, обратная связь
Чтобы узнать больше обо всех новых функциях в Xamarin.Forms 2.0 обязательно прочтите примечания к выпуску. Полный исходный код примера (приложения MyWeather), вы можете посмотреть на GitHub. Поддержка Windows 10 (UWP) находится еще не в финальной стадии, поэтому есть возможность, что вы можете столкнуться с некоторыми шероховатостями. Помогите сделать Xamarin.Forms для UWP лучше, пожалуйста, не забудьте оставить отзыв, сообщив о проблеме, если таковые возникли.
Установка предварительной версии Xamarin в ОС Windows
Visual Studio 2019 и Visual Studio 2017 не поддерживают альфа- и бета-каналы и стабильные каналы так, как предыдущие версии. Вместо этого есть два варианта:
- выпуск — эквивалент стабильного канала в Visual Studio для Mac;
- предварительная версия — эквивалент альфа- и бета- каналов в Visual Studio для Mac.
Для пробного использования функций предварительной версии следует скачать установщик предварительной версии Visual Studio, который предложит установить предварительные версии Visual Studio параллельно со стабильной версией (версией выпуска). Дополнительные сведения о новых возможностях Visual Studio 2019 можно найти в заметках о выпуске.
Предварительная версия Visual Studio может включать соответствующие предварительные версии функциональных возможностей Xamarin, в том числе следующие:
- Xamarin.Forms
- Xamarin.iOS
- Xamarin.Android
- Xamarin Profiler
- Xamarin Inspector
- Симулятор iOS удаленной работы для Xamarin
На снимке экрана установщика предварительной версии ниже показаны параметры и предварительной версии, и выпуска (обратите внимание на номера версий, указанные серым цветом: версия 15.0 относится к выпуску, а версия 15.1 — к предварительной версии):
В процессе установки, если выполняется параллельная установка, может применяться псевдоним установки (чтобы версии можно было различить в меню «Пуск»), как показано ниже:
Удаление предварительной версии Visual Studio 2019
Установщик Visual Studio также следует использовать для удаления установленных предварительных версий Visual Studio 2019. Дополнительные сведения см. в руководстве по удалению Xamarin.