تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أداة Lint
عمليات التحقّق من Lint للتأكّد من استخدام واجهات برمجة تطبيقات Gradle
| آخر تعديل |
الإصدار الثابت |
إصدار محتمل |
الإصدار التجريبي |
الإصدار الأولي |
| 20 أيار (مايو) 2025 |
- |
- |
- |
1.0.0-alpha05 |
تحديد التبعيات
لإضافة تبعية على Lint، عليك إضافة مستودع Google Maven إلى
مشروعك. اطّلِع على مستودع Maven من Google
لمزيد من المعلومات.
أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle ل
تطبيقك أو وحدتك:
Groovy
plugins {
id("com.android.lint")
}
dependencies {
lintChecks "androidx.lint:lint-gradle:1.0.0-alpha05"
}
Kotlin
plugins {
id("com.android.lint")
}
dependencies {
lintChecks("androidx.lint:lint-gradle:1.0.0-alpha05")
}
لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك
أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على
المشاكل الحالية
في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال
النقر على زر النجمة.
إنشاء مشكلة جديدة
اطّلِع على مستندات أداة تتبُّع المشاكل
لمزيد من المعلومات.
لا تتوفّر ملاحظات حول الإصدار لهذا العنصر.
الإصدار 1.0
الإصدار 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.
- إضافة عملية تحقّق لرصد استخدامات واجهات برمجة التطبيقات الداخلية لـ 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 غير المقصودة لأنّها غالبًا ما تكون أخطاء.
- أضِف عملية تحقّق لرصد استخدامات الطرق والسمات والحقول الواردة من الأنواع الداخلية.
إصلاح الأخطاء
- يجب إصلاح
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 على هذه المراجعات.
الميزات الجديدة
- مجموعة أولية من عمليات التحقّق من الأخطاء لمؤلفي "مكوّن Gradle الإضافي" لمساعدتهم في رصد الأخطاء في رموزهم البرمجية من المتوقّع أن يتم استخدامها في مشاريع Gradle التي تطبّق
java-gradle-plugin. وسيرصد هذا الفحص استخدامات واجهات برمجة التطبيقات الداخلية لنظام Gradle و"المكوّن الإضافي لنظام Gradle المتوافق مع Android" وإعداد المهام المُعجلة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# lint\n====\n\nAPI Reference \n[androidx.lint](/reference/kotlin/androidx/lint/package-summary) \nLint checks to verify usage of Gradle APIs \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|---------------|----------------|-------------------|--------------|----------------------------------------------------------------|\n| May 20, 2025 | - | - | - | [1.0.0-alpha05](/jetpack/androidx/releases/lint#1.0.0-alpha05) |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on Lint, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\nplugins {\n id(\"com.android.lint\")\n}\ndependencies {\n lintChecks \"androidx.lint:lint-gradle:1.0.0-alpha05\"\n}\n```\n\n### Kotlin\n\n```kotlin\nplugins {\n id(\"com.android.lint\")\n}\ndependencies {\n lintChecks(\"androidx.lint:lint-gradle:1.0.0-alpha05\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:1518777%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=1518777&template=1946997)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nThere are no release notes for this artifact.\n\nVersion 1.0\n-----------\n\n### Version 1.0.0-alpha05\n\nMay 20, 2025\n\n`androidx.lint:lint-gradle:1.0.0-alpha05` is released. Version 1.0.0-alpha05 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/7bbd2bffb18b5a7d6ab44019d31979acc72315a7..cd41781824511ce4d5c4a05d2df4aaaee669f0bc/lint/lint-gradle).\n\n**New Features**\n\n- Add a check to warn about usages of `configurations.create` and `configurations.maybeCreate` as these cause eager realization of that configuration starting with Gradle 8.14 and thus should be replaced with `configurations.register`.\n- Add a check to catch usages of internal Kotlin Gradle Plugin APIs\n- Add a check to catch usages of `evaluationDependsOn` and `evaluationDependsOnChildren` as it is not safe with Isolated Projects feature.\n\n### Version 1.0.0-alpha04\n\nApril 23, 2025\n\n`androidx.lint:lint-gradle:1.0.0-alpha04` is released. Version 1.0.0-alpha04 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/2ffcbb08c7221e79b12c0ef234bcfb5517d10ece..7bbd2bffb18b5a7d6ab44019d31979acc72315a7/lint/lint-gradle).\n\n**New Features**\n\n- Add a check for accidental `Provider\u003cString\u003e.toString` calls as they are likely bugs.\n- Add check to catch uses of methods, properties, fields coming from internal types.\n\n**Bug Fixes**\n\n- Fix `GradleProjectIsolation` check to allow usage of `Project.isolated`.\n- Fix `WithTypeWithoutConfigureEach` check to catch uses of `Project.tasks.withType\u003cTask\u003e()` without `configureEach`.\n- Fix `InternalGradleApiUsage` check to catch fully qualified usages of internal APIs.\n\n### Version 1.0.0-alpha03\n\nDecember 11, 2024\n\n`androidx.lint:lint-gradle:1.0.0-alpha03` is released. Version 1.0.0-alpha03 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/9cd42c5cbf5e69b0223d5b0c357593175182f365..2ffcbb08c7221e79b12c0ef234bcfb5517d10ece/lint/lint-gradle).\n\n**New Features**\n\n- Catch calls to `Provider\u003c\u003e.toString` as it is nearly always a bug to do that.\n- Catch calls of Kotlin collection extension functions on `TaskContainer` as these cause eager `Task` creation.\n- Catch calls to `ConfigurableFileCollection.from` passing in a `Configuration` as that causes eager resolution of the configuration suggesting to use `project.files(configuration)` or `configuration.incoming.artifactView {}.files`.\n- Catch usages of `Property\u003cFile\u003e` suggesting to use `RegularFileProperty` or `DirectoryProperty` as it is enforcing the use directory vs file.\n\n### Version 1.0.0-alpha02\n\nSeptember 4, 2024\n\n`androidx.lint:lint-gradle:1.0.0-alpha02` is released. Version 1.0.0-alpha02 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/e1b82c49c59d8e976ce558aba5586f6c61bc9054..9cd42c5cbf5e69b0223d5b0c357593175182f365/lint/lint-gradle).\n\n**New Features**\n\n- Added a check for discouraged `GradleRunner.withPluginClasspath` API.\n- Added checks for APIs that are problematic for lazy configuration by flagging calls to `TaskContainer.withType` without calling `configureEach`.\n - Added checks for APIs that are problematic for Gradle Project Isotation by flagging calls to `Project.getRootProject`, `Project.findProject`, `Project.getParent`, `Project.findProperty`, `Project.getProperties`, `Project.hasProperty`, `Project.property`.\n\n### Version 1.0.0-alpha01\n\nFebruary 21, 2024\n\n`androidx.lint:lint-gradle:1.0.0-alpha01` is released. [Version 1.0.0-alpha01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/e1b82c49c59d8e976ce558aba5586f6c61bc9054/lint/lint-gradle)\n\n**New Features**\n\n- An initial set of lint checks for Gradle Plugin authors to help them catch mistakes in their code. They are expected to be used on Gradle projects that apply `java-gradle-plugin`. It will catch uses of internal Gradle and Android Gradle Plugin APIs and eager task configuration."]]
