Решаем ошибку ClassNotFoundException в NDK и Irrlicht в Java

Быстрый ответ

Ошибку java.lang.ClassNotFoundException обычно вызывает отсутствие класса в classpath при выполнении программы. Чтобы устранить эту проблему, убедитесь, что пути к классам указаны правильно и все необходимые зависимости присутствуют. Посмотрите на файл build.gradle:

dependencies {
    // Зависимости вашего проекта должны быть перечислены здесь
    implementation 'com.your.dependency:dependency-name:version'
}

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

Если указанные шаги вас не вывели на правильный путь:

• Отключите функцию Instant Run в Android Studio через File -> Settings -> Build, Execution, Deployment -> снятое выделение с Instant Run.
• Проверьте, что имя вашего Activity совпадает со значением в AndroidManifest.xml.
• Выполните очистку и пересборку проекта, чтобы обновить пути к классам и устранить возникшие ошибки.
• Убедитесь в корректной подключённости нативных библиотек, если они присутствуют в проекте.
• После чистой сборки удалите приложение с устройства, сделайте небольшую паузу и затем переустановите приложение.

Погружение в глубины

Рассмотрим подробнее распространённые причины возникновения ошибки java.lang.ClassNotFoundException и способы их решения.

Возможно, проблема связана с манифестом

Некорректное имя Activity в AndroidManifest.xml может стать причиной ошибки:

<activity android:name=".YourActivity"/>

Используйте точку для обозначения относительного пути или укажите полное имя пакета. Точка здесь – это не симбол переживаний, а часть синтаксиса 😉.

Проект, возможно, настроен неправильно

Следите за такими распространёнными ошибками настройки:

• Проверьте Java Build Path: все библиотеки и jar-файлы должны быть добавлены.
• Ошибки в main.cpp и Android.mk при использовании NDK.
• Проблемы, возникшие после рефакторинга имён активностей.

Управление зависимостями

Некорректное управление зависимостями также может быть причиной этой ошибки:

• Перепроверьте правильность указания зависимостей в build.gradle.
• Пользуйтесь правильными идентификаторами артефактов и версий.
• Если вы используете библиотеки с нативным кодом, правильно настройте abiFilters.

Визуализация

Можно представить ClassNotFoundException как потугу открыть дверь несоответствующим ключом:

| Попытка            | ✅ Успешно? | Визуализация    |
|--------------------|-------------|-----------------|
| Правильный ключ   | ✅           | 🔑🔓            |
| Неправильный ключ | ❌           | 🔑❌🚪           |

DexPathList можно сравнить со связкой ключей, в которой идёт поиск нужного ключа (класса):

DexPathList: [🔑📚, 🔑📦, 🔑🌐, 🔑❓]

Загрузчик классов при просмотре DexPathList:

Пробуем: 🔑📚
Пробуем: 🔑📦
Пробуем: 🔑🌐
Результат: ❌ (ClassLoader: 🔍❓)

ClassNotFoundException говорит о том, что в DexPathList не было найдено нужного файла класса, который требуется во время выполнения программы.

Дополнительные спасательные круги

Проверка приведения проекта в соответствие стандартам структуры

Следуйте стандартам структуры проектов Android:

• Закладывайте исходный код на Java или Kotlin в src/main/java/.
• Поместите нативный C++ код в src/main/cpp/, если используете NDK.
• Размещайте ресурсы (макеты, изображения) в src/main/res/.

Удаление остатков сборки

• Вручную удалите каталоги /build в директории проекта.
• В Android Studio воспользуйтесь опцией Build -> Clean Project.

Избегание конфликтов библиотек

• Поддерживайте совместимость версий внутри "семьи" библиотек.
• Устранийте конфликты, вызванные расхождением версий одной и той же зависимости между разными библиотеками.

Включение поддержки multidex

Для крупных приложений с большим количеством методов активируйте поддержку multidex:

android {
    defaultConfig {
        ...
        multiDexEnabled true
    }
}

Анализ правил Proguard и конфигураций сборки

Иногда классы могут пропадать из-за действия правил Proguard. Проверьте файл proguard-rules.pro и раздел buildTypes в build.gradle.

Полезные материалы

1. Официальное руководство по включению поддержки multidex в Android Studio.
2. Документация Oracle Java для глубокого понимания работы классов Java.
3. Официальное руководство по реализации multidex в Android-приложениях.
4. Обсуждение на GitHub проблем зависимостей и ошибки ClassNotFoundException.
5. Видеоурок на YouTube по разработке приложений для Android и решению ошибки ClassNotFoundException.
6. Подкаст, в котором обсуждаются Dalvik и ART runtime, ключевые для понимания работы классов во время выполнения программы на Android.