lint

تحديد الاعتماديات

لإضافة اعتمادية على Lint، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

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

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

يمكنك بعد ذلك إجراء عمليات الفحص هذه باستخدام ./gradlew :my-plugin:lint.

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على الـ مشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

لا تتوفّر ملاحظات إصدار لهذا العنصر.

الإصدار 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
• عملية فحص الأداء التي تضع علامة على استدعاءات واجهات برمجة التطبيقات التي تكون مكلفة بشكل غير متوقّع
• عملية فحص إدخالات ذاكرة التخزين المؤقت للإعداد الواسعة جدًا
• عملية فحص لتثبيط استخدام Property<File>
• عملية فحص استخدام واجهات برمجة التطبيقات الداخلية لنظام Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android والمكوّن الإضافي لنظام Gradle المتوافق مع Kotlin
• عملية فحص استدعاء 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 إلى إعادة ترتيب مخطّطات المهام.
• تمت إضافة عملية فحص لاستدعاءات System.getenv() وSystem.getenv("key") التي يجب أن تتم من خلال واجهة برمجة التطبيقات Provider بدلاً من ذلك.
• مساهمة خارجية من josh@fueledbycaffeine.com لإضافة عملية فحص لرصد تسلسل السلاسل في Provider

الإصدار ‎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.
• إضافة عملية فحص لرصد استخدامات واجهات برمجة التطبيقات الداخلية للمكوّن الإضافي لنظام Gradle المتوافق مع Kotlin
• إضافة عملية فحص لرصد استخدامات evaluationDependsOn وevaluationDependsOnChildren لأنّها غير آمنة مع ميزة "المشاريع المعزولة"

الإصدار ‎1.0.0-alpha04

‫23 أبريل 2025

تم طرح androidx.lint:lint-gradle:1.0.0-alpha04. يتضمّن الإصدار ‎1.0.0-alpha04 هذه التعديلات.

الميزات الجديدة

• إضافة عملية فحص لاستدعاءات Provider<String>.toString العرضية لأنّها من المحتمل أن تكون أخطاء
• إضافة عملية فحص لرصد استخدامات الطرق والخصائص والحقول الواردة من الأنواع الداخلية

إصلاح الأخطاء

• إصلاح عملية فحص GradleProjectIsolation للسماح باستخدام Project.isolated
• إصلاح عملية فحص WithTypeWithoutConfigureEach لرصد استخدامات Project.tasks.withType<Task>() بدون configureEach
• إصلاح عملية فحص InternalGradleApiUsage لرصد استخدامات واجهات برمجة التطبيقات الداخلية المؤهّلة بالكامل

الإصدار ‎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 هذه التعديلات.

الميزات الجديدة

• تمت إضافة عملية فحص لواجهة برمجة التطبيقات GradleRunner.withPluginClasspath غير المستحسَنة.
• تمت إضافة عمليات فحص لواجهات برمجة التطبيقات التي تسبّب مشاكل في الإعداد الكسول من خلال وضع علامة على استدعاءات TaskContainer.withType بدون استدعاء configureEach.
  • تمت إضافة عمليات فحص لواجهات برمجة التطبيقات التي تسبّب مشاكل في ميزة "عزل مشروع 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 في رصد الأخطاء في الرمز البرمجي من المتوقّع استخدامها في مشاريع Gradle التي تطبّق java-gradle-plugin. ستؤدي إلى رصد استخدامات واجهات برمجة التطبيقات الداخلية لنظام Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android وإعداد المهام السريع.