Почему приложение крашится, если причина в Manifest?

Почему краш приложения может быть связан с манифестом?

Манифест (AndroidManifest.xml) — это фундаментальный конфигурационный файл любого Android-приложения, который система Android использует для понимания структуры, компонентов, разрешений и требований вашего приложения. Краш (падение) приложения из-за ошибок в манифесте — распространённая проблема, поскольку некорректная конфигурация нарушает "контракт" между приложением и операционной системой на самом раннем этапе, часто до выполнения какого-либо кода вашего приложения.

Вот основные причины, по которым ошибки в AndroidManifest.xml приводят к немедленным или скрытым крашам:

1. Необъявленные компоненты (Activity, Service, Receiver, Provider)

Любой компонент (Activity, Service, BroadcastReceiver, ContentProvider), который вы используете в коде, должен быть явно объявлен в манифесте. Попытка запустить необъявленный компонент вызывает android.content.ActivityNotFoundException или аналогичные исключения.

// Код: Попытка запустить Activity
val intent = Intent(this, UndeclaredActivity::class.java)
startActivity(intent) // Вызовет краш!

<!-- AndroidManifest.xml (НЕПРАВИЛЬНО) -->
<!-- Активность UndeclaredActivity НЕ объявлена здесь -->

2. Отсутствие обязательных атрибутов у компонентов

Для компонентов требуются обязательные атрибуты. Например, каждая Activity (за исключением особых случаев) должна иметь объявленный intent-filter для точки входа LAUNCHER или явно экспортироваться.

<!-- AndroidManifest.xml (НЕПРАВИЛЬНО) -->
<activity android:name=".MainActivity">
    <!-- Отсутствует intent-filter с action MAIN и category LAUNCHER -->
</activity>

Приложение установится, но не будет отображаться в списке приложений, а попытка запуска может завершиться ошибкой.

3. Конфликты и дублирование объявлений

Дублирование объявлений компонентов, разрешений или других элементов может привести к неопределённому поведению и крашам на некоторых версиях Android.

<activity android:name=".MainActivity" android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>
<!-- Дубликат вызовет ошибку! -->
<activity android:name=".MainActivity" android:exported="true"/>

4. Ошибки в объявлении разрешений (Permissions)

• Использование разрешения, не объявленного в манифесте: Если ваш код запрашивает или использует разрешение (например, android.permission.CAMERA), но оно не добавлено в <uses-permission>, система может заблокировать доступ, что приведёт к SecurityException.
• Некорректное объявление собственных разрешений: Ошибки в protectionLevel или имени могут вызвать конфликты.

<uses-permission android:name="android.permission.CAMERA" />
<!-- Если этого нет, запрос или использование камеры может привести к крашу -->

5. Проблемы с атрибутом android:exported (особенно для Android 12+)

Начиная с Android 12 (API 31), все компоненты, имеющие intent-filter, должны явно объявлять атрибут android:exported="true|false". Его отсутствие вызовет ошибку установки (краш на этапе инсталляции) на устройствах с целевым API >= 31.

<!-- AndroidManifest.xml (НЕПРАВИЛЬНО для targetSdkVersion >= 31) -->
<activity android:name=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<!-- ПРАВИЛЬНО -->
<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

6. Несовместимые изменения и проблемы с backwards compatibility

• Использование компонентов, не поддерживаемых версией Android: Например, объявление android:maxSdkVersion может неожиданно ограничить доступ на новых ОС.
• Ошибки в конфигурации uses-feature или uses-library: Могут привести к UnsatisfiedLinkError или ClassNotFoundException, если система ожидает определённую аппаратную или программную возможность.

7. Синтаксические и XML-ошибки

Некорректный синтаксис XML, неверные пространства имён, незакрытые теги — всё это приводит к тому, что система не может распарсить манифест, и приложение не установится или крашнется при запуске.

<!-- Незакрытый тег вызовет ошибку компиляции или установки -->
<application
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    <!-- Здесь забыли закрыть тег > -->

Диагностика и решение проблем

1. Анализ логов (Logcat): Ищите FATAL EXCEPTION, связанные с ActivityNotFoundException, SecurityException, Manifest merger failed. Ключевые теги: AndroidRuntime, PackageManager.
2. Проверка слияния манифестов (Manifest Merger): В сложных проектах финальный манифест формируется из основного файла и манифестов зависимостей (библиотек). Используйте Merge Manifest во вкладке AndroidManifest.xml в Android Studio, чтобы увидеть итоговый файл и обнаружить конфликты.
3. Валидация с помощью aapt или lint: Запустите ./gradlew lint, чтобы статический анализатор указал на распространённые ошибки в манифесте.
4. Мануальная проверка обязательных атрибутов: Убедитесь, что все компоненты объявлены, для компонентов с intent-filter указан android:exported, а для всех используемых разрешений есть <uses-permission>.

Итог: Манифест — это "лицо" вашего приложения для системы Android. Любое несоответствие между ним и фактической структурой кода, либо нарушение требований платформы (особенно касающихся безопасности, как android:exported), приводит к немедленному прекращению работы. Тщательная проверка AndroidManifest.xml должна быть первым шагом при диагностике загадочных крашей на старте приложения.