Разработка приложений с помощью AndroidX и Xamarin
Начните разрабатывать приложения с помощью AndroidX и Xamarin.Android.
AndroidX — это значительно усовершенствованная библиотека поддержки Android, исходная версия которой больше не поддерживается. Пакеты AndroidX полностью заменяют библиотеку поддержки Android, обеспечивая равенство функций и предоставляя новые библиотеки, которые можно использовать в приложениях Android.
AndroidX содержит следующие возможности:
- Все пакеты в AndroidX теперь имеют согласованное пространство имен, начинающееся с
androidx
. Это означает, что все пакеты библиотеки поддержки Android сопоставляются с соответствующим пакетомandroidx.*
. - Пакеты
androidx
обслуживаются и обновляются отдельно. Это означает, что библиотеки AndroidX можно обновлять независимо друг от друга. - Начиная с версии 28 библиотека поддержки Android больше не будет выпускаться. Все новые разработки будут включены в
androidx
.
Требования
Компоненты из следующего списка необходимы для использования возможностей 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.@ |
Дополнительные сведения об именовании пакетов см. в этой документации.
Средства миграции
Миграция состоит из трех этапов, которые нужно учитывать для вашего приложения.
- Если приложение включает пространства имен библиотеки поддержки Android и вы хотите перейти с них на пространства имен AndroidX, для выполнения большинства сценариев с пространствами имен можно использовать средства IDE миграции в AndroidX.
Включите перенос AndroidX с помощью > параметров > Xamarin > Android Параметры в Visual Studio 2019 (этот шаг можно пропустить на Visual Studio для Mac).
Щелкните проект правой кнопкой мыши и выберите Миграция на AndroidX.
Примечание.
Для сценариев, с которыми это средство не работает, вам нужно будет вручную внести изменения в пространство имен. Правильный пакет сопоставляется автоматически, но мы рекомендуем ознакомиться с официальным сопоставлением артефактов и классов, чтобы упростить миграцию проектов.
- Если приложение включает зависимости, которые не были перенесены в пространство имен AndroidX, необходимо использовать библиотеку поддержки Android для пакета миграции AndroidX.
- Если приложение не содержит зависимостей, требующих миграции в пространство имен AndroidX, вы можете прямо сейчас использовать библиотеки AndroidX в NuGet.
Устранение неполадок
- Некоторые пакеты архитектуры в AndroidX могут конфликтовать с версиями библиотеки поддержки. Чтобы устранить эту проблему, следует использовать версию AndroidX этих пакетов и удалить версию библиотеки поддержки. Например, если вы ссылаетесь в проекте на
Xamarin.Android.Arch.Work.Runtime
, возникнет конфликт с типами нового добавленного пакетаAndroidX.Work
.
Итоги
Из этой статьи вы узнали о том, что такое AndroidX, а также об установке и настройке новейших средств и пакетов для разработки приложений Xamarin.Android с помощью AndroidX. Статья содержит общие сведения об AndroidX. В ней содержатся ссылки на документацию по API и разделы для разработчиков Android, которые помогут вам приступить к созданию приложений с помощью AndroidX. В статье также описаны самые важные изменения в поведении AndroidX, которые могут повлиять на существующие приложения, и приведен раздел об устранении неполадок.