tìm lỗi mã nguồn

  
Kiểm tra tìm lỗi mã nguồn để xác minh việc sử dụng API Gradle
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 17 tháng 6 năm 2026 1.0.0 - - -

Khai báo phần phụ thuộc

Để thêm phần phụ thuộc trên Lint, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun của mình:

Groovy

plugins {
    id("com.android.lint")
}
dependencies {
    lintChecks "androidx.lint:lint-gradle:1.0.0"
}

Kotlin

plugins {
    id("com.android.lint")
}
dependencies {
    lintChecks("androidx.lint:lint-gradle:1.0.0")
}

Sau đó, bạn có thể chạy các lượt kiểm tra này bằng ./gradlew :my-plugin:lint.

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Trình theo dõi sự cố để biết thêm thông tin.

Không có ghi chú phát hành cho cấu phần phần mềm này.

Lint Phiên bản 1.0

Phiên bản 1.0.0

Ngày 17 tháng 6 năm 2026

Phát hành androidx.lint:lint-gradle:1.0.0. Phiên bản 1.0.0 bao gồm các thay đổi sau.

Các tính năng chính của phiên bản 1.0.0:

lint-gradle cung cấp các lượt kiểm tra sau đây để hỗ trợ tác giả trình bổ trợ Gradle:

  • Kiểm tra cấu hình sớm để hoãn việc tạo và định cấu hình đối tượng cho đến khi cần
  • Kiểm tra lỗi vi phạm tính năng cách ly dự án
  • Kiểm tra các lỗi có thể xảy ra khi gọi Provider.toString
  • Kiểm tra hiệu suất gắn cờ các lệnh gọi đến API có chi phí ngoài dự kiến
  • Kiểm tra các đầu vào bộ nhớ đệm cấu hình quá rộng
  • Kiểm tra để không khuyến khích việc sử dụng Property<File>
  • Kiểm tra việc sử dụng API nội bộ của Gradle, Trình bổ trợ Android cho Gradle và Trình bổ trợ Kotlin cho Gradle
  • Kiểm tra lệnh gọi đến withType mà không có .configureEach
  • Kiểm tra việc sử dụng GradleRunner.withPluginClasspath

Phiên bản 1.0.0-rc01

Ngày 19 tháng 5 năm 2026

Phát hành androidx.lint:lint-gradle:1.0.0-rc01. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.0.0-beta01

Ngày 22 tháng 4 năm 2026

Phát hành androidx.lint:lint-gradle:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.0.0-alpha06

Ngày 8 tháng 4 năm 2026

Phát hành androidx.lint:lint-gradle:1.0.0-alpha06. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm lượt kiểm tra cho các lệnh gọi đến mustRunAfter và shouldRunAfter vì các lệnh gọi này tốn kém do Gradle phải sắp xếp lại biểu đồ tác vụ.
  • Thêm lượt kiểm tra cho các lệnh gọi đến System.getenv() và System.getenv("key") đáng lẽ phải đi qua API Nhà cung cấp
  • Đóng góp bên ngoài từ josh@fueledbycaffeine.com để thêm lượt kiểm tra nhằm phát hiện việc nối chuỗi của Nhà cung cấp

Phiên bản 1.0.0-alpha05

Ngày 20 tháng 5 năm 2025

Phát hành androidx.lint:lint-gradle:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm lượt kiểm tra để cảnh báo về việc sử dụng configurations.create và configurations.maybeCreate vì các lượt sử dụng này gây ra việc hiện thực hoá sớm cấu hình đó bắt đầu từ Gradle 8.14 và do đó, cần thay thế bằng configurations.register.
  • Thêm lượt kiểm tra để nắm bắt việc sử dụng các API nội bộ của Trình bổ trợ Kotlin cho Gradle
  • Thêm lượt kiểm tra để nắm bắt việc sử dụng evaluationDependsOn và evaluationDependsOnChildren vì các lượt sử dụng này không an toàn với tính năng Dự án bị cô lập.

Phiên bản 1.0.0-alpha04

Ngày 23 tháng 4 năm 2025

Phát hành androidx.lint:lint-gradle:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm lượt kiểm tra cho các lệnh gọi Provider<String>.toString vô tình vì các lệnh gọi này có thể là lỗi.
  • Thêm lượt kiểm tra để nắm bắt việc sử dụng các phương thức, thuộc tính, trường đến từ các loại nội bộ.

Sửa lỗi

  • Khắc phục lượt kiểm tra GradleProjectIsolation để cho phép sử dụng Project.isolated.
  • Khắc phục lượt kiểm tra WithTypeWithoutConfigureEach để nắm bắt việc sử dụng Project.tasks.withType<Task>() mà không có configureEach.
  • Khắc phục lượt kiểm tra InternalGradleApiUsage để nắm bắt việc sử dụng đầy đủ các API nội bộ.

Phiên bản 1.0.0-alpha03

Ngày 11 tháng 12 năm 2024

Phát hành androidx.lint:lint-gradle:1.0.0-alpha03. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • Nắm bắt các lệnh gọi đến Provider<>.toString vì việc này gần như luôn là lỗi.
  • Nắm bắt các lệnh gọi của hàm mở rộng bộ sưu tập Kotlin trên TaskContainer vì các lệnh gọi này gây ra việc tạo Task sớm.
  • Nắm bắt các lệnh gọi đến ConfigurableFileCollection.from truyền vào Configuration vì điều đó gây ra việc phân giải sớm cấu hình, đề xuất sử dụng project.files(configuration) hoặc configuration.incoming.artifactView {}.files.
  • Nắm bắt việc sử dụng Property<File> đề xuất sử dụng RegularFileProperty hoặc DirectoryProperty vì việc này đang thực thi việc sử dụng thư mục so với tệp.

Phiên bản 1.0.0-alpha02

Ngày 4 tháng 9 năm 2024

Phát hành androidx.lint:lint-gradle:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm lượt kiểm tra cho API GradleRunner.withPluginClasspath không được khuyến khích.
  • Thêm lượt kiểm tra cho các API gây ra vấn đề cho cấu hình trì hoãn bằng cách gắn cờ các lệnh gọi đến TaskContainer.withType mà không gọi configureEach.
    • Thêm lượt kiểm tra cho các API gây ra vấn đề cho tính năng cách ly dự án Gradle bằng cách gắn cờ các lệnh gọi đến Project.getRootProject, Project.findProject, Project.getParent, Project.findProperty, Project.getProperties, Project.hasProperty, Project.property.

Phiên bản 1.0.0-alpha01

Ngày 21 tháng 2 năm 2024

Phát hành androidx.lint:lint-gradle:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Một tập hợp ban đầu các lượt kiểm tra tìm lỗi mã nguồn cho tác giả Trình bổ trợ Gradle để giúp họ nắm bắt các lỗi trong mã của mình. Các lượt kiểm tra này dự kiến sẽ được sử dụng trên các dự án Gradle áp dụng java-gradle-plugin. Các lượt kiểm tra này sẽ nắm bắt việc sử dụng các API nội bộ của Gradle và Trình bổ trợ Android cho Gradle cũng như cấu hình tác vụ sớm.