Android Studio项目构建失败：大图片引发AAPT2资源处理错误

Hey there! I see you’ve already sorted out the "file too large" warning, but now you’re hitting those pesky AAPT2 resource processing errors—let’s break down how to fix this step by step.

Common Causes & Solutions #

1. Wipe Build Caches First (Quick Win!)

AAPT2 often gets tripped up by corrupted build caches. Let’s start here:

• In Android Studio, go to Build > Clean Project, then follow up with Build > Rebuild Project.
• If that doesn’t work, manually delete the .gradle folder in your project root and the app/build folder. Restart Android Studio, then try building again. This clears out any stale cached resources that might be causing parsing issues.

2. Double-Check Your Image Resources

Even though you fixed the size warning, your images might still be causing trouble:

• Test with a small, known-good image (100KB or less, standard JPG/PNG) to replace your current large images. If the build succeeds, the issue is with your original image files—they might have corrupted metadata, incompatible formats (like broken WebP files), or hidden encoding issues.
• Make sure images are placed in the correct resource directories (e.g., drawable-xxhdpi for high-res images, not just drawable). AAPT2 can struggle with misplaced assets that trigger unexpected scaling or parsing.

3. Troubleshoot Overlay Parsing Issues

The error specifically mentions failed parsing overlays, so let’s dig into that:

• Check your layout XML files (like activity_main.xml) for any android:overlay attributes or code that uses ViewOverlay. Look for typos, unclosed tags, or overlay settings that don’t match your API level (some overlay features require specific Android versions).
• Temporarily comment out any overlay-related code or layout elements. If the build works, you know exactly where the problem lies—then you can fix the overlay implementation to be compatible with your project setup.

4. Verify Gradle & AAPT2 Versions

Outdated or incompatible Gradle/AAPT2 versions can cause these errors:

• Open your project’s root build.gradle file and check the Android Gradle Plugin version (the line starting with classpath 'com.android.tools.build:gradle:'). Stick to stable, official versions (avoid preview builds) that match your project’s target SDK.
• If you recently updated Gradle, try rolling back to a version that worked before you hit this error.

5. Check Resource Naming & Syntax

AAPT2 is strict about resource rules:

• Ensure all resource files (images, layouts, strings) use lowercase letters and underscores only—no spaces, special characters, or non-ASCII characters.
• Scan your strings.xml and other resource files for unclosed tags or unescaped special characters (like & that should be &). These tiny syntax errors can break AAPT2 parsing.

内容的提问来源于stack exchange，提问作者Dr Mido