أداة 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")
}

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

الملاحظات

تساعدنا ملاحظاتك في تحسين 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") التي يجب أن تتم من خلال واجهة برمجة تطبيقات "مقدّم الخدمة" بدلاً من ذلك.
• مساهمة خارجية من 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.
• إضافة عملية تحقّق من أجل رصد استخدامات واجهات برمجة التطبيقات الداخلية للمكوّن الإضافي لنظام 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 وإعداد المهام المسبق.