KunMinX/Linkage-RecyclerView

🔗 Linkage-RecyclerView: Một dòng mã, danh sách liên kết hai cấp hoàn chỉnh

Dù không dùng饿了么, cũng nên收藏 thư viện này — một dòng linkage.init(items) để có二级联动列表.

Linkage-RecyclerView là thư viện Android của KunMinX, triển khai danh sách liên kết hai cấp (left category + right items) dựa trên kiến trúc MVP với nguyên lý phụ thuộc đảo (Dependency Inversion). Thư viện được tạo ra vì nhu cầu trong dự án RxJava Magician, khi không tìm được thư viện phù hợp trên GitHub. Kết quả là một thư viện bên thứ ba thực sự, có thể phụ thuộc từ Maven Central, tách rời hoàn toàn và cấu hình tối giản.

Người dùng không cần nghiên cứu logic nội bộ — chỉ cần implement Config class để tuỳ chỉnh, hoặc dùng mặc định với một dòng khởi tạo.

✨ Điểm nổi bật

• Một dòng khởi tạo: linkage.init(items) là đủ để chạy二级联动列表, không boilerplate.
• MVP架构解耦: Người dùng không cần hiểu nội bộ, chỉ cần implement Config để tuỳ chỉnh.
• Maven Central: Phụ thuộc trực tiếp qua implementation 'com.kunminx.linkage:linkage-recyclerview:2.7.0'.
• DefaultGroupedItem: Thực thể mặc định với ba trường title, group, content để dễ dàng ánh xạ dữ liệu.
• Hỗ trợ header section: Dữ liệu nhóm có thể chứa tiêu đề phân vùng (header).
• Jetpack + Material Design 2: Sử dụng AndroidX, ConstraintLayout, Material Components.
• Không Dagger, không trick: Code rõ ràng, dễ đọc, không kỹ thuật phức tạp không cần thiết.
• ProGuard ready: Cần cấu hình -keep class com.kunminx.linkage.bean.** {*;} cho entity class.

💡 Vì sao đáng chú ý

Thư viện giải quyết đúng bài toán phổ biến: hiển thị danh sách phân loại liên kết trên Android mà không cần viết hàng chục dòng RecyclerView adapter, ItemDecoration, hay logic sync giữa hai danh sách. Kiến trúc MVP giúp tách biệt hoàn toàn phần cấu hình khỏi phần hiển thị — người dùng chỉ cần quan tâm đến data và Config, không cần chạm vào internal logic.

Phù hợp cho mọi trường hợp cần danh sách hai cấp: danh mục sản phẩm, menu phân loại, danh sách theo nhóm. Dữ liệu JSON từ backend chỉ cần map sang DefaultGroupedItem là chạy. Dự án cũng là reference tốt cho việc học cách viết thư viện Android với MVP sạch sẽ, không dependency nặng nề.