Поделиться через


Разработка приложений с помощью AndroidX и Xamarin

Начните разрабатывать приложения с помощью AndroidX и Xamarin.Android.

AndroidX — это значительно усовершенствованная библиотека поддержки Android, исходная версия которой больше не поддерживается. Пакеты AndroidX полностью заменяют библиотеку поддержки Android, обеспечивая равенство функций и предоставляя новые библиотеки, которые можно использовать в приложениях Android.

AndroidX содержит следующие возможности:

  • Все пакеты в AndroidX теперь имеют согласованное пространство имен, начинающееся с androidx. Это означает, что все пакеты библиотеки поддержки Android сопоставляются с соответствующим пакетом androidx.*.
  • Пакеты androidx обслуживаются и обновляются отдельно. Это означает, что библиотеки AndroidX можно обновлять независимо друг от друга.
  • Начиная с версии 28 библиотека поддержки Android больше не будет выпускаться. Все новые разработки будут включены в androidx.

AndroidX Logo

Требования

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

  • Visual Studio. В Windows выполните обновление до Visual Studio 2019 версии 16.4 или более поздней. В macOS выполните обновление до Visual Studio 2019 для Mac версии 8.4 или более поздней.
  • Xamarin.Android. Вместе с Visual Studio нужно установить Xamarin.Android 10.0 или более поздней версии (Xamarin.Android автоматически устанавливается в составе рабочей нагрузки Разработка мобильных приложений на .NET в ОС Windows или в составе установщика Visual Studio для Mac).
  • Пакет Java Developer Kit. Для разработки на Xamarin.Android 10.0 требуется JDK 8. Дистрибутив OpenJDK от корпорации Майкрософт автоматически устанавливается в составе Visual Studio.
  • Пакет SDK для Android. Необходимо установить пакет SDK для Android (API 28) или более поздней версии с помощью Диспетчера SDK Android.

Начать

Вы можете приступить к работе с AndroidX, включив в свой проект Android любой пакет NuGet AndroidX. Подробнее об установке и использовании пакета в Visual Studio и Visual Studio для Mac

Изменения в работе

AndroidX представляет собой переработанную библиотеку поддержки Android. Она включает этапы миграции, которые повлияют на приложения Android, созданные с помощью библиотеки поддержки Android.

Изменение названий пакетов

Имена старых и новых пакетов отличаются. Ниже приведены примеры этих различий.

Прежний вариант Новый
android.support.** androidx.@
android.design.** com.google.android.material.@
android.support.test.** androidx.test.@
android.arch.** androidx.@
android.arch.persistence.room.** androidx.room.@
android.arch.persistence.** androidx.sqlite.@

Дополнительные сведения об именовании пакетов см. в этой документации.

Средства миграции

Миграция состоит из трех этапов, которые нужно учитывать для вашего приложения.

  1. Если приложение включает пространства имен библиотеки поддержки Android и вы хотите перейти с них на пространства имен AndroidX, для выполнения большинства сценариев с пространствами имен можно использовать средства IDE миграции в AndroidX.

Включите перенос AndroidX с помощью > параметров > Xamarin > Android Параметры в Visual Studio 2019 (этот шаг можно пропустить на Visual Studio для Mac).

Enable AndroidX Migrator

Щелкните проект правой кнопкой мыши и выберите Миграция на AndroidX.

Migrate To AndroidX

Примечание.

Для сценариев, с которыми это средство не работает, вам нужно будет вручную внести изменения в пространство имен. Правильный пакет сопоставляется автоматически, но мы рекомендуем ознакомиться с официальным сопоставлением артефактов и классов, чтобы упростить миграцию проектов.

  1. Если приложение включает зависимости, которые не были перенесены в пространство имен AndroidX, необходимо использовать библиотеку поддержки Android для пакета миграции AndroidX.
  2. Если приложение не содержит зависимостей, требующих миграции в пространство имен AndroidX, вы можете прямо сейчас использовать библиотеки AndroidX в NuGet.

Устранение неполадок

  • Некоторые пакеты архитектуры в AndroidX могут конфликтовать с версиями библиотеки поддержки. Чтобы устранить эту проблему, следует использовать версию AndroidX этих пакетов и удалить версию библиотеки поддержки. Например, если вы ссылаетесь в проекте на Xamarin.Android.Arch.Work.Runtime, возникнет конфликт с типами нового добавленного пакета AndroidX.Work.

Итоги

Из этой статьи вы узнали о том, что такое AndroidX, а также об установке и настройке новейших средств и пакетов для разработки приложений Xamarin.Android с помощью AndroidX. Статья содержит общие сведения об AndroidX. В ней содержатся ссылки на документацию по API и разделы для разработчиков Android, которые помогут вам приступить к созданию приложений с помощью AndroidX. В статье также описаны самые важные изменения в поведении AndroidX, которые могут повлиять на существующие приложения, и приведен раздел об устранении неполадок.