Строка xmlns:android="http://schemas.android.com/apk/res/android" появляется в начале почти каждого XML-файла Android-проекта, и её отсутствие или опечатка сразу вызывает ошибку вида «attribute ... not allowed here» или подсветку всех атрибутов android: красным в Android Studio. Если вы открыли файл макета и IDE ругается на каждый атрибут — первым делом проверьте, объявлено ли это пространство имён в корневом элементе.
Несмотря на то, что запись выглядит как веб-адрес, никакого запроса в интернет при сборке не происходит. Это URI-идентификатор пространства имён (namespace), который связывает префикс android: с набором системных атрибутов фреймворка. Понимание этого механизма избавляет от большинства ошибок валидации XML-макетов, манифеста и ресурсов.
Что означает эта строка на самом деле
Конструкция xmlns:android расшифровывается как «XML Namespace: android». Она сообщает парсеру: все атрибуты с префиксом android: относятся к пространству имён, идентификатор которого — http://schemas.android.com/apk/res/android. Благодаря этому система отличает системные атрибуты (android:layout_width, android:text) от атрибутов сторонних библиотек и ваших собственных.
Ключевой момент: URI используется только как уникальная строка-идентификатор, а не как реальный сетевой адрес. Открыв этот «адрес» в браузере, вы не получите документацию — страница по такому URL не обслуживается как источник данных для сборки. Удаление интернета на компьютере разработчика никак не влияет на компиляцию макетов.
Объявление пространства имён действует на тот элемент, где оно написано, и на всех его потомков. Именно поэтому xmlns:android принято размещать в корневом элементе файла — будь то <LinearLayout> в макете или <manifest> в AndroidManifest.xml.
Где используется это пространство имён
Объявление встречается практически во всех XML-файлах Android-проекта. Типичные места:
- 📄 Макеты экранов — файлы в
res/layout/, где описываются View-элементы и их параметры. - 📋 AndroidManifest.xml — объявление компонентов приложения, разрешений и метаданных.
- 🎨 Ресурсы —
res/values/, drawable-XML, анимации, меню (res/menu/). - 🧩 XML-разметка виджетов и настроек — например, файлы PreferenceScreen в
res/xml/.
Во всех этих файлах правило одно: если внутри используется хотя бы один атрибут с префиксом android:, пространство имён должно быть объявлено в корневом элементе этого файла. Наследование между отдельными файлами не работает — каждый XML-файл объявляет namespace самостоятельно.
Типичные ошибки и их причины
Чаще всего разработчики сталкиваются с тремя сценариями. Первый — пространство имён вообще не объявлено, и IDE подчёркивает все атрибуты android: с сообщением о неизвестном префиксе. Второй — опечатка в URI: например, пропущен слэш или написано apk/res/androids. Третий — атрибуты сторонней библиотеки используются без объявления её собственного namespace.
⚠️ Внимание: URI пространства имён чувствителен к регистру и должен совпадать посимвольно. Даже лишний пробел внутри кавычек сделает объявление недействительным, и все атрибуты android: перестанут распознаваться.
Отдельный случай — копирование фрагмента разметки из урока или Stack Overflow без корневого элемента. В вырезанном куске кода объявления namespace нет, и после вставки в существующий файл атрибуты внезапно «ломаются». Проверка корневого тега — первый шаг диагностики.
Как исправить ошибки с xmlns:android: пошагово
Диагностика занимает пару минут и не требует никаких рискованных действий — только правка XML-файла:
- 🔍 Откройте проблемный XML-файл и найдите корневой элемент — самый первый тег после заголовка
<?xml ... ?>. - ✏️ Проверьте, что в нём есть точная строка
xmlns:android="http://schemas.android.com/apk/res/android"без опечаток и лишних пробелов. - 🧱 Если используете атрибуты библиотеки (например,
app:), добавьте соответствующее объявление — обычноxmlns:app="http://schemas.android.com/apk/res-auto". - 🔄 После правки выполните Build → Clean Project, затем Rebuild Project, чтобы сбросить закэшированные результаты анализа.
Если IDE продолжает подсвечивать атрибуты после исправления, возможная причина — устаревший кэш среды разработки. В этом случае помогает File → Invalidate Caches / Restart в Android Studio. Сам код при этом менять не нужно.
☑️ Проверка XML-файла с xmlns
Другие пространства имён в Android-проекте
Помимо системного android:, в реальных проектах встречаются и другие префиксы. Каждый из них требует собственного объявления:
| Префикс | URI пространства имён | Назначение |
|---|---|---|
android | http://schemas.android.com/apk/res/android | Системные атрибуты фреймворка |
app | http://schemas.android.com/apk/res-auto | Атрибуты библиотек и кастомных View |
tools | http://schemas.android.com/tools | Атрибуты для превью в IDE, в релиз не попадают |
Пространство res-auto заслуживает отдельного пояснения: оно автоматически подключает атрибуты всех библиотек, входящих в проект. Поэтому для ConstraintLayout, Material Components или собственных кастомных View не нужно указывать отдельный URI каждой библиотеки — достаточно одного объявления xmlns:app.
Почему URI выглядит как веб-адрес
Стандарт XML Namespaces требует, чтобы идентификатор пространства имён был уникальным. Проще всего гарантировать уникальность, используя домен, которым владеет организация. Google выбрала схему на базе своего домена schemas.android.com, но обязанности размещать по этому адресу реальный документ стандарт не предъявляет.
Пример корректного файла макета
Ниже — минимальный эталонный фрагмент, в котором объявлены все три часто используемых пространства имён. Его удобно держать под рукой как шаблон при создании новых макетов:
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
</LinearLayout>
Обратите внимание: объявления идут внутри открывающего тега корневого элемента, а не отдельными строками документа. Порядок объявлений значения не имеет — важна только их полнота и точность написания URI.
Когда атрибуты android: не работают, хотя namespace объявлен
Бывает, что объявление на месте, опечаток нет, а конкретный атрибут всё равно подсвечивается как недопустимый. Здесь возможные причины иные: атрибут не поддерживается данным типом View (например, android:orientation у FrameLayout), либо атрибут требует более нового уровня API, чем указано в minSdkVersion проекта.
⚠️ Внимание: атрибуты, добавленные в поздних версиях Android, на старых устройствах молча игнорируются. Перед использованием сверяйтесь с официальной документацией по конкретному атрибуту и, при необходимости, ищите альтернативу из библиотек совместимости через префикс app:.
Ещё один сценарий — конфликт при слиянии манифестов (manifest merger) из нескольких модулей. В этом случае ошибка указывает на конкретный элемент AndroidManifest.xml, а решается она либо атрибутом tools:replace (с соответствующим объявлением xmlns:tools), либо приведением атрибутов модулей к единому значению. Конкретный подход зависит от структуры проекта, поэтому ориентируйтесь на текст ошибки в логе сборки.
Часто задаваемые вопросы
Что будет, если удалить строку xmlns:android из макета?
Парсер перестанет распознавать все атрибуты с префиксом android:. IDE подсветит их как ошибки, а сборка проекта завершится неудачей с сообщениями о неизвестных атрибутах. Строку нужно вернуть в корневой элемент.
Отправляет ли приложение данные по этому адресу?
Нет. Это не веб-ссылка, а строка-идентификатор пространства имён. Ни при сборке, ни во время работы приложения сетевых запросов к schemas.android.com из-за этого объявления не происходит.
Чем отличается res/android от res-auto?
res/android — пространство системных атрибутов фреймворка (префикс android:). res-auto — автоматическое пространство для атрибутов библиотек и кастомных View текущего проекта (обычно префикс app:).
Можно ли использовать другой префикс вместо android?
Технически XML позволяет выбрать любой префикс, если URI указан верно. Однако общепринятый стандарт — именно android:, и отход от него затруднит чтение кода и совместную работу. Менять префикс без крайней необходимости не стоит.
Почему tools: атрибуты не видны в запущенном приложении?
Пространство tools предназначено только для среды разработки: превью текста, тестовых данных, указаний для линтера. Эти атрибуты вырезаются при сборке и в готовое приложение не попадают — это нормальное поведение, а не ошибка.