Ескертпе
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Жүйеге кіруді немесе каталогтарды өзгертуді байқап көруге болады.
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Каталогтарды өзгертуді байқап көруге болады.
Начните разрабатывать приложения с помощью 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, которые могут повлиять на существующие приложения, и приведен раздел об устранении неполадок.