מוֹך

  
בדיקות Lint כדי לאמת את השימוש ב-Gradle APIs
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫17 ביוני 2026 1.0.0 - - -

הצהרה על יחסי תלות

כדי להוסיף תלות ב-Lint, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

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")
}

אחר כך תוכלו להריץ את הבדיקות האלה באמצעות ./gradlew :my-plugin:lint.

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

אין הערות לגבי הגרסה של הארטיפקט הזה.

גרסה 1.0 של Lint

גרסה 1.0.0

‫17 ביוני 2026

androidx.lint:lint-gradle:1.0.0 מופץ. גרסה 1.0.0 מכילה את השמירות האלה.

התכונות העיקריות של גרסה 1.0.0:

lint-gradle שולח את הבדיקות הבאות כדי לעזור למפתחי פלאגינים של Gradle:

  • בדיקת הגדרות מוקדמת כדי לדחות את היצירה וההגדרה של אובייקטים עד שהם נדרשים
  • בדיקה של הפרות בידוד פרויקטים
  • בדיקה של באגים אפשריים בשיחות Provider.toString
  • בדיקת ביצועים שמסמנת קריאות ל-API שהן יקרות באופן לא צפוי
  • בדיקה של קלט במטמון של הגדרות רחבות מדי
  • מסמנים את התיבה כדי להגביל את השימוש ב-Property<File>
  • בדיקה פנימית של השימוש ב-API של Gradle, של Android Gradle Plugin ושל Kotlin Gradle plugin
  • שיחה אל withType בלי בדיקת .configureEach
  • בדיקת השימוש ב-GradleRunner.withPluginClasspath

גרסה ‎1.0.0-rc01

‫19 במאי 2026

androidx.lint:lint-gradle:1.0.0-rc01 מופץ. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.0.0-beta01

‫22 באפריל 2026

androidx.lint:lint-gradle:1.0.0-beta01 מופץ. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.0.0-alpha06

‫8 באפריל 2026

androidx.lint:lint-gradle:1.0.0-alpha06 מופץ. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • נוסף אימות של קריאות ל-mustRunAfter ול-shouldRunAfter כי הן יקרות בגלל ש-Gradle צריך לסדר מחדש את הגרפים של המשימות.
  • נוספה בדיקה של קריאות ל-API אל System.getenv() ו-System.getenv("key") שאמורות לעבור דרך Provider API
  • תרומה חיצונית מ-josh@fueledbycaffeine.com להוספת בדיקה לזיהוי שרשור מחרוזות של ספק

גרסה ‎1.0.0-alpha05

‫20 במאי 2025

androidx.lint:lint-gradle:1.0.0-alpha05 מופץ. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו בדיקה שמציגה אזהרה לגבי שימוש ב-configurations.create וב-configurations.maybeCreate, כי הם גורמים למימוש מהיר של ההגדרה הזו החל מ-Gradle 8.14, ולכן צריך להחליף אותם ב-configurations.register.
  • הוספת בדיקה כדי לזהות שימושים בממשקי API פנימיים של Kotlin Gradle Plugin
  • מומלץ להוסיף בדיקה כדי לזהות שימושים ב-evaluationDependsOn וב-evaluationDependsOnChildren, כי השימוש בהם לא בטוח עם התכונה 'פרויקטים מבודדים'.

גרסה ‎1.0.0-alpha04

‫23 באפריל 2025

androidx.lint:lint-gradle:1.0.0-alpha04 מופץ. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • מומלץ להוסיף בדיקה לשיחות Provider<String>.toString שבוצעו בטעות, כי סביר להניח שמדובר בבאגים.
  • הוספת בדיקה כדי לזהות שימושים בשיטות, במאפיינים ובשדות שמגיעים מסוגים פנימיים.

תיקוני באגים

  • כדי לאפשר שימוש ב-Project.isolated, צריך לתקן את הבדיקה GradleProjectIsolation.
  • תיקון הבדיקה WithTypeWithoutConfigureEach כדי לזהות שימושים ב-Project.tasks.withType<Task>() ללא configureEach.
  • תיקון הבדיקה InternalGradleApiUsage כדי לזהות שימושים מלאים בממשקי API פנימיים.

גרסה ‎1.0.0-alpha03

‫11 בדצמבר 2024

androidx.lint:lint-gradle:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • כדאי לנסות לפתור בעיות שקשורות לשיחות לProvider<>.toString, כי ברוב המקרים מדובר בבאג.
  • כדאי לתפוס קריאות של פונקציות הרחבה של אוספים ב-Kotlin ב-TaskContainer, כי הן גורמות ליצירה מהירה של Task.
  • שיחות ל-ConfigurableFileCollection.from שמעבירות Configuration גורמות לפתרון מהיר של ההגדרה, ומציעות להשתמש ב-project.files(configuration) או ב-configuration.incoming.artifactView {}.files.
  • הכלי יאתר מקרים שבהם נעשה שימוש ב-Property<File> ויציע להשתמש ב-RegularFileProperty או ב-DirectoryProperty, כי הוא אוכף את השימוש בספרייה לעומת קובץ.

גרסה ‎1.0.0-alpha02

‫4 בספטמבר 2024

androidx.lint:lint-gradle:1.0.0-alpha02 מופץ. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו בדיקה ל-API ‏GradleRunner.withPluginClasspath שלא מומלץ לשימוש.
  • הוספנו בדיקות לממשקי API שגורמים לבעיות בהגדרות עצלות, על ידי סימון קריאות ל-TaskContainer.withType בלי קריאה ל-configureEach.
    • נוספו בדיקות לממשקי API שגורמים לבעיות בבידוד פרויקטים ב-Gradle, על ידי סימון קריאות ל-Project.getRootProject, Project.findProject, Project.getParent, Project.findProperty, Project.getProperties, Project.hasProperty, Project.property.

גרסה ‎1.0.0-alpha01

‫21 בפברואר 2024

androidx.lint:lint-gradle:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • קבוצה ראשונית של בדיקות Lint למחברים של Gradle Plugin, כדי לעזור להם לזהות טעויות בקוד שלהם. הם אמורים לשמש בפרויקטים של Gradle שמוגדרים בהם java-gradle-plugin. הוא יזהה שימושים בממשקי API פנימיים של Gradle ושל Android Gradle Plugin, וכן הגדרות של משימות שמתבצעות באופן אוטומטי.