Khắc phục lỗi Aapt2Exception: RES_TABLE_TYPE_TYPE entry offsets overlap actual entry data trên Android 35

Trong quá trình phát triển ứng dụng Android, bạn có thể gặp phải một số lỗi khó chịu. Một trong số đó là lỗi Aapt2Exception. Trong bài viết này, tôi sẽ hướng dẫn bạn cách khắc phục lỗi này một cách hiệu quả.

Giới thiệu

Tôi đã mất 5 giờ để tìm hiểu về lỗi này:

Copy

Caused by: com.android.builder.internal.aapt.v2.Aapt2Exception: Android resource linking failed  
aapt2 E LoadedArsc.cpp:94] RES_TABLE_TYPE_TYPE entry offsets overlap actual entry data.  
aapt2 E ApkAssets.cpp:149] Failed to load resources table in APK '/Users/xxx/Library/Android/sdk/platforms/android-35/android.jar'.  
error: failed to load include path /Users/xxx/Library/Android/sdk/platforms/android-35/android.jar.

Ngay cả khi tôi cố gắng “vibe coding” cũng không giúp gì 😅, vì vậy tôi đã tìm kiếm trên StackOverflow và cuối cùng tìm ra giải pháp. Tôi chia sẻ ở đây để giúp bạn không phải trải qua nỗi đau như vậy.

Nguyên nhân gây ra lỗi

Android SDK 35 đi kèm với một phiên bản android.jar khác. Các phiên bản Gradle/AGP cũ không thể phân tích đúng cách với aapt2 được tích hợp sẵn, vì vậy việc liên kết tài nguyên sẽ thất bại. Điều này có thể gây ra rất nhiều rắc rối cho các nhà phát triển.

Giải pháp khắc phục

Để khắc phục lỗi này, bạn cần thực hiện theo các bước sau:

Mở tệp gradle.properties trong thư mục gốc của dự án Flutter.

Thêm dòng sau (thay thế /Users/xxx bằng đường dẫn SDK của bạn):

Copy

android.aapt2FromMavenOverride=/Users/xxx/Library/Android/sdk/build-tools/35.0.0/aapt2

Thực hiện Clean và Rebuild

Sau khi thực hiện bước trên, bạn cần thực hiện quá trình Clean và Rebuild để đảm bảo mọi thứ hoạt động bình thường:

bash Copy

./gradlew clean  
./gradlew assembleDebug --stacktrace

🎉 Đó là tất cả! Sau khi thêm dòng này, ứng dụng Flutter của tôi đã xây dựng thành công trên Android 35.

Thực tiễn tốt nhất

Luôn cập nhật SDK và công cụ xây dựng: Đảm bảo rằng bạn đang sử dụng phiên bản mới nhất của Android SDK và Gradle để tránh các lỗi không cần thiết.
Kiểm tra tài liệu: Đọc tài liệu chính thức của Android và Gradle để nắm rõ các thay đổi và tính năng mới.

Cạm bẫy thường gặp

Không xác định đường dẫn SDK đúng: Đảm bảo rằng bạn đã thay thế đúng đường dẫn SDK của mình trong tệp gradle.properties. Đường dẫn sai có thể dẫn đến nhiều lỗi khác nhau.
Quên Clean và Rebuild: Một số nhà phát triển quên thực hiện bước này, dẫn đến việc không thấy thay đổi nào khi sửa lỗi.

Mẹo hiệu suất

Giảm thiểu kích thước APK: Sử dụng ProGuard để giảm kích thước APK của bạn và loại bỏ mã không cần thiết.
Tối ưu hóa hình ảnh và tài nguyên: Giảm kích thước hình ảnh và tối ưu hóa tài nguyên để tăng tốc độ tải của ứng dụng.

Giải quyết sự cố

Nếu bạn vẫn gặp phải lỗi sau khi thực hiện các bước trên, hãy thử:

Kiểm tra logcat: Sử dụng logcat để xem chi tiết lỗi và tìm hiểu nguyên nhân gốc rễ.
Tìm kiếm trên diễn đàn: Đặt câu hỏi trên StackOverflow hoặc các diễn đàn phát triển khác để nhận được sự trợ giúp từ cộng đồng.

Kết luận và kêu gọi hành động

Nếu bạn gặp phải lỗi này, hãy thử thực hiện các bước khắc phục mà tôi đã chia sẻ ở trên. Nếu bạn phát hiện ra cách giải quyết khác, hãy chia sẻ dưới bài viết này để mọi người cùng hưởng lợi! Hãy theo dõi chúng tôi để nhận thêm nhiều mẹo và hướng dẫn hữu ích cho việc phát triển ứng dụng Android của bạn.

Khắc phục lỗi Aapt2Exception trên Android 35 hiệu quả