Исправляем ошибку INSTALL_PARSE_FAILED_MANIFEST_MALFORMED в Android

Что означает ошибка INSTALL_PARSE_FAILED_MANIFEST_MALFORMED

Когда вы пытаетесь установить APK на устройстве Android и видите это сообщение, значит менеджер пакетов не смог прочитать файл AndroidManifest.xml из-за некорректного XML или Unsupported-элементов. Ошибка появляется на этапе установки — будь то adb install, Google Play Store или файловый менеджер. Без валидного манифеста система не может определить компоненты приложения, права доступа или минимальную версию SDK, поэтому установка блокируется.

Скопируйте точный текст, который появляется на экране; он обычно выглядит так:

INSTALL_PARSE_FAILED_MANIFEST_MALFORMED

Причины возникновения

• Опечатки в XML — лишние символы, не закрытые теги или неверная вложенность.
• Несоответствие версии — указание minSdkVersion или targetSdkVersion, которых нет в установленной версии Android.
• Ручное редактирование манифеста — изменение атрибутов без понимания структуры, часто приводит к ошибкам синтаксиса.
• Повреждение архива APK — при сборке или передаче файла проверка целостности может упасть, оставляв манифест поврежденным.
• Использование старых инструментов — старые версии apktool или adb могут не поддерживать новые форматы манифеста.

Способы решения

Способ 1: Декомпиляция и ручное исправление манифеста

Если у вас есть исходный код или вы готовы декомпилировать приложение:

1. Установите apktool (если еще не установлен):

   sudo apt-get install apktool   # на Linux
   brew install apktool            # на macOS
   

2. Декомпилируйте APK:

   apktool d my-app.apk
   

3. Откройте полученный каталог my-app/ и найдите файл AndroidManifest.xml. Исправьте найденные синтаксические ошибки (лишние пробелы, некорректные атрибуты, не закрытые теги).
4. Сохраните изменения и пересоберите пакет:

   apktool b my-app -o fixed-app.apk
   

5. Подпишите новый APK своим ключом и установите на устройство.

Способ 2: Использование Android Studio для пересборки

Когда у вас есть проект в Android Studio:

1. Откройте проект и перейдите к app/src/main/AndroidManifest.xml.
2. Проверьте вкладку Manifest на наличие ошибок — Android Studio подсвечивает проблемы (например, неверный формат package или отсутствующий namespace).
3. Исправьте ошибки прямо в редакторе XML или используйте меню Refactor → Add Android XML Lint Inspections, чтобы автоматически найти и исправить типичные проблемы.
4. Выполните Build → Build Bundle(s) / APK(s) → Build APK(s).
5. Установите сгенерированный APK на устройство.

Способ 3: Поиск исправленной версии приложения

Если вы не планируете модифицировать приложение:

1. Посетите официальный сайт разработчика или фориум проекта — часто выпускается патченная версия, устраняющая проблему с манифестом.
2. Скачайте обновленную версию из Google Play Store или надежного репозитория.
3. Удалите текущую установленную копию через настройки устройства, чтобы избежать конфликтов версий.
4. Установите новую версию и проверьте, исчезла ли ошибка.

Профилактика

• Всегда редактируйте манифест через официальные инструменты (Android Studio, apktool с осторожностью).
• Перед сборкой проверяйте валидность XML: многие редакторы предлагают проверку синтаксиса.
• Сохраняйте резервные копии оригинального AndroidManifest.xml перед любыми изменениями.
• Используйте актуальные версии платформы сборки, чтобы избежать несоответствий minSdkVersion/targetSdkVersion.
• Подписывайте приложение корректным keystore, иначе система может отказать в установке из-за несоответствия подписи.