بالإضافة إلى إنشاء اختبارات للتأكّد من أنّ تطبيقك يستوفي متطلباته الوظيفية، من المهم أيضًا تشغيل الرمز من خلال أداة lint للمساعدة في التأكّد من أنّ الرمز لا يتضمّن أي مشاكل هيكلية. تساعد أداة lint في العثور على الرموز البرمجية ذات البنية الضعيفة التي يمكن أن تؤثر في موثوقية تطبيقات Android وكفاءتها وتجعل من الصعب صيانة الرموز البرمجية. ننصحك بشدة بتصحيح أي أخطاء تكتشفها أداة lint قبل نشر تطبيقك.
على سبيل المثال، إذا كانت ملفات موارد XML تحتوي على مساحات أسماء غير مستخدمة، فإنّ ذلك يستهلك مساحة ويتطلب معالجة غير ضرورية. وقد تؤدي المشاكل الهيكلية الأخرى، مثل استخدام عناصر متوقفة نهائيًا أو طلبات بيانات من واجهة برمجة التطبيقات غير متوافقة مع إصدارات واجهة برمجة التطبيقات المستهدَفة، إلى تعذُّر تشغيل الرمز البرمجي بشكل صحيح. يمكن أن يساعدك Lint في حلّ هذه المشاكل.
لتحسين أداء التحليل، يمكنك أيضًا إضافة تعليقات توضيحية إلى الرمز البرمجي.
Android CLI
تنزيل Android CLIجرِّب Android CLI لتحليل ملفك
على سبيل المثال، استخدِم الأمر
android studio analyze-file عندما تحتاج إلى تحليل ملفك بحثًا عن الأخطاء والتحذيرات ومشاكل lint.android studio analyze-file <path>نظرة عامة
يوفّر "استوديو Android" أداة لفحص الرموز البرمجية تُعرف باسم lint يمكن أن تساعدك في تحديد المشاكل المتعلّقة بجودة بنية الرمز البرمجي وتصحيحها بدون الحاجة إلى تنفيذ التطبيق أو كتابة إطارات اختبار. يتم الإبلاغ عن كل مشكلة ترصدها الأداة من خلال رسالة وصفية ومستوى خطورة، ما يتيح لك تحديد أولويات التحسينات المهمة التي يجب إجراؤها. يمكنك أيضًا خفض مستوى خطورة مشكلة ما لتجاهل المشاكل التي لا صلة لها بمشروعك أو رفع مستوى الخطورة لتسليط الضوء على مشاكل معيّنة.
تفحص أداة lint ملفات مصدر مشروع Android بحثًا عن الأخطاء المحتملة وتحسينات الأداء من حيث الصحة والأمان والأداء وسهولة الاستخدام وتسهيل الاستخدام والتدويل. عند استخدام "استوديو Android"، يتم إجراء عمليات فحص lint وIDE التي تم ضبطها عند إنشاء تطبيقك. ومع ذلك، يمكنك إجراء عمليات الفحص يدويًا أو تشغيل lint من سطر الأوامر، كما هو موضّح في هذه الصفحة.
تتحقّق أداة lint المضمّنة من الرمز البرمجي أثناء استخدامك "استوديو Android". يمكنك الاطّلاع على التحذيرات والأخطاء بطريقتَين:
- كنص منبثق في نافذة المحرِّر وعندما يعثر على مشكلة، يميّز الرمز الذي يتضمّن المشكلة باللون الأصفر. بالنسبة إلى المشاكل الأكثر خطورة، يضع خطًا أحمر تحت الرمز.
- في نافذة نتائج الفحص الخاصة بأداة lint عند النقر على الرمز > فحص الرمز
ملاحظة: عند تجميع الرمز البرمجي في "استوديو Android"، يتم إجراء عمليات فحص إضافية للرمز البرمجي في IntelliJ لتبسيط عملية مراجعة الرمز البرمجي. احرص على تحديث استوديو Android قدر الإمكان لضمان توفُّر أحدث قواعد وعمليات فحص أداة Lint.
يوضّح الشكل 1 كيفية معالجة أداة lint لملفات مصدر التطبيق.
- ملفات مصدر التطبيق
- تتكوّن ملفات المصدر من الملفات التي يتألف منها مشروع Android، بما في ذلك ملفات Kotlin وXML والرموز وملفات إعداد ProGuard.
- ملف
lint.xml - ملف إعداد يمكنك استخدامه لتحديد أي عمليات تحقّق من الأخطاء تريد استبعادها وتخصيص مستويات خطورة المشاكل.
- أداة lint
- هي أداة لفحص الرموز الثابتة يمكنك تشغيلها في مشروع Android إما من سطر الأوامر أو في "استوديو Android". تتحقّق أداة lint من مشاكل الرموز البرمجية الهيكلية التي قد تؤثر في جودة تطبيق Android وأدائه.
- نتائج فحص الأخطاء
- يمكنك الاطّلاع على نتائج أداة lint إما في وحدة التحكّم أو في نافذة نتائج الفحص في "استوديو Android". في حال تشغيل
lintمن سطر الأوامر، تتم كتابة النتائج في المجلدbuild/. لمزيد من التفاصيل، يُرجى الاطّلاع على القسم حول إجراء عمليات الفحص يدويًا.
تشغيل أداة Lint من سطر الأوامر
إذا كنت تستخدم "استوديو Android" أو Gradle، استخدِم برنامج تضمين Gradle لاستدعاء مهمة lint لمشروعك من خلال إدخال أحد الأوامر التالية من الدليل الجذري لمشروعك:
ملاحظة: احرص على تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android قدر الإمكان لاستخدام أحدث قواعد lint.
- على Windows:
gradlew lint
- على نظام التشغيل Linux أو macOS:
./gradlew lint
ينبغي أن تظهر مُخرجات مشابهة لما يلي:
> Task :app:lintDebug Wrote HTML report to file:<path-to-project>/app/build/reports/lint-results-debug.html
عندما تكمل أداة lint عمليات التحقّق، فإنها توفر مسارات لإصدارات XML وHTML من تقرير lint. يمكنك بعد ذلك الانتقال إلى تقرير HTML وفتحه في متصفحك، كما هو موضح في الشكل 2.
إذا كان مشروعك يتضمّن تنويعات تصميم، ستتحقّق أداة lint من التنويعة التلقائية فقط. إذا أردت تشغيل أداة lint على صيغة مختلفة، عليك كتابة اسم الصيغة بأحرف كبيرة وإضافة البادئة lint.
./gradlew lintRelease
ملاحظة: لا يتم تشغيل Lint تلقائيًا كجزء من عملية الإنشاء. ننصحك بشدة بتشغيل أداة lint بشكل صريح كجزء من عملية إنشاء التكامل المستمر حتى تتمكّن من الاطّلاع على أحدث عمليات التحقّق من الأخطاء عند إنشاء الرمز المصدر الحالي.
لمزيد من المعلومات حول تنفيذ مهام Gradle من سطر الأوامر، يُرجى الاطّلاع على مقالة إنشاء تطبيقك من سطر الأوامر.
تشغيل أداة lint باستخدام الأداة المستقلة
إذا لم تكن تستخدم "استوديو Android" أو Gradle،
ثبِّت أدوات سطر الأوامر في حزمة تطوير البرامج (SDK) لنظام التشغيل Android
لاستخدام أداة lint المستقلة. ابحث عن أداة lint
في android_sdk/cmdline-tools/version/bin/lint.
ملاحظة: إذا حاولت تشغيل الأداة المستقلة على مشروع Gradle، سيظهر لك
خطأ. يجب دائمًا استخدام gradle lint (على نظام التشغيل Windows) أو ./gradlew
lint (على نظام التشغيل macOS أو Linux) لتشغيل أداة lint في مشروع Gradle.
لتشغيل lint على قائمة ملفات في دليل مشروع، استخدِم الأمر التالي:
lint [flags] <project directory>
على سبيل المثال، يمكنك إصدار الأمر التالي لفحص الملفات ضمن دليل myproject وأدلته الفرعية. يطلب معرّف المشكلة MissingPrefix من أداة lint البحث فقط عن سمات XML التي لا تحتوي على بادئة مساحة الاسم Android.
lint --check MissingPrefix myproject
للاطّلاع على القائمة الكاملة للعلامات ووسيطات سطر الأوامر التي تتيحها الأداة، استخدِم الأمر التالي:
lint --help
يوضّح المثال التالي مخرجات وحدة التحكّم عند تشغيل الأمر lint على مشروع باسم Earthquake:
$ lint Earthquake Scanning Earthquake: ............................................................................................................................... Scanning Earthquake (Phase 2): ....... AndroidManifest.xml:23: Warning: <uses-sdk> tag appears after <application> tag [ManifestOrder] <uses-sdk android:minSdkVersion="7" /> ^ AndroidManifest.xml:23: Warning: <uses-sdk> tag should specify a target API level (the highest verified version; when running on later versions, compatibility behaviors may be enabled) with android:targetSdkVersion="?" [UsesMinSdkAttributes] <uses-sdk android:minSdkVersion="7" /> ^ res: Warning: Missing density variation folders in res: drawable-xhdpi [IconMissingDensityFolder] 0 errors, 4 warnings
يعرض مثال الإخراج ثلاثة تحذيرات ولا يعرض أي أخطاء.
يتعلّق تحذيران بملف AndroidManifest.xml الخاص بالمشروع:
ManifestOrderUsesMinSdkAttributes
يتعلّق تحذير واحد بدليل res:
IconMissingDensityFolder.
ضبط أداة lint لإيقاف التحذيرات
بشكل تلقائي، عند إجراء فحص lint، تتحقّق الأداة من جميع المشاكل التي تتيحها أداة lint. يمكنك أيضًا حصر المشاكل التي يجب أن تتحقّق منها أداة lint، ويمكنك تحديد مستويات الخطورة للمشاكل. على سبيل المثال، يمكنك إيقاف فحص lint لمشاكل معيّنة لا تتعلّق بمشروعك، ويمكنك ضبط lint للإبلاغ عن المشاكل غير الحرجة بمستوى خطورة أقل.
مستويات الخطورة هي:
enabledisableأوignoreinformationalwarningerrorfatal
يمكنك ضبط فحص الأخطاء البرمجية لمستويات مختلفة:
- على مستوى العالم (المشروع بأكمله)
- وحدة المشروع
- وحدة الإنتاج
- وحدة الاختبار
- فتح الملفات
- التسلسل الهرمي للفئات
- نطاقات نظام التحكّم في الإصدارات (VCS)
ضبط ملف lint
يمكنك تحديد إعداداتك المفضّلة للتحقّق من الأخطاء في ملف lint.xml. إذا كنت تنشئ هذا الملف يدويًا، ضَعه في الدليل الجذري لمشروع Android.
يتكوّن ملف lint.xml من علامة رئيسية <lint> تتضمّن عنصرًا فرعيًا واحدًا أو أكثر من عناصر <issue>. تحدّد أداة Lint قيمة فريدة لسمة id لكل <issue>:
<?xml version="1.0" encoding="UTF-8"?> <lint> <!-- list of issues to configure --> </lint>
لتغيير مستوى خطورة مشكلة معيّنة أو إيقاف فحص الأخطاء البرمجية للمشكلة،
اضبط سمة الخطورة في علامة <issue>.
ملاحظة: للحصول على قائمة كاملة بالمشاكل التي تتيحها أداة lint ومعرّفات المشاكل المقابلة لها، نفِّذ الأمر lint --list. يجب تشغيل الخيار --list من أداة lint المستقلة.
نموذج ملف lint.xml
يعرض المثال التالي محتوى ملف lint.xml:
<?xml version="1.0" encoding="UTF-8"?> <lint> <!-- Disable the ComposableNaming check in this project --> <issue id="ComposableNaming" severity="ignore" /> <!-- Ignore the ComposeUnrememberedState issue in the specified files --> <issue id="ComposeUnrememberedState"> <ignore path="src/main/java/com/example/myapp/MainActivity.kt" /> <ignore path="src/main/java/com/example/myapp/ui/components/SpecialButton.kt" /> </issue> <!-- Ignore the ComposeModifierMissing issue in the specified file --> <issue id="ComposeModifierMissing"> <ignore path="src/main/java/com/example/myapp/ui/screens/HomeScreen.kt" /> </issue> <!-- Change the severity of hardcoded strings to "error" --> <issue id="HardcodedText" severity="error" /> </lint>
يوضّح هذا المثال كيفية ضبط أنواع المشاكل المختلفة. يتم إيقاف عملية التحقّق من ComposableNaming بالكامل، ويتم إيقاف عملية التحقّق من ComposeUnrememberedState فقط في الملفات المحدّدة في بيانات <ignore ... /> المرفقة.
ضبط عملية التحقّق من الأخطاء في ملفات Kotlin وXML المصدر
يمكنك إيقاف فحص الأخطاء في ملفات Kotlin وXML المصدر في مربّع الحوار الإعدادات المفضّلة:
- اختَر ملف > الإعدادات (على نظام التشغيل Windows) أو استوديو Android > الإعدادات المفضّلة (على نظام التشغيل macOS أو Linux).
- انقر على المحرِّر > عمليات الفحص.
- لإيقاف هذه الميزة، ألغِ اختيار ملف المصدر المناسب.
يمكنك ضبط هذه الإعدادات إما لبيئة التطوير المتكاملة أو لمشاريع فردية من خلال اختيار الملف الشخصي المناسب.
ضبط عملية التحقّق من الأخطاء في Kotlin
لإيقاف فحص Lint لفئة أو دالة معيّنة في مشروع Android،
أضِف التعليق التوضيحي @SuppressLint إلى هذا الرمز.
يوضّح المثال التالي كيفية إيقاف فحص الأخطاء لمشكلة NewApi في دالة معيّنة. تواصل أداة lint التحقّق من مشكلة NewApi في الدوال الأخرى لهذه الفئة.
@SuppressLint("NewApi") fun logNotificationChannelInfo() { // Uses NotificationChannel (requires API 26+) // ... }
ويمكن تحقيق ذلك على أي دالة مركّبة. يوضّح مقتطف الرمز التالي كيفية إيقاف عمليات التحقّق من NewApi في أي دالة مركّبة.
@SuppressLint("NewApi") @Composable fun MyComposable() { // ... }
يوضّح المثال التالي كيفية إيقاف فحص الأخطاء في الرمز البرمجي لمشكلة ParserError في فئة FeedProvider:
@SuppressLint("ParserError") class FeedProvider : ContentProvider() {
لإيقاف التحقّق من جميع مشاكل lint في الملف، استخدِم الكلمة الرئيسية all:
@SuppressLint("all")
يمكنك استخدام التعليق التوضيحي نفسه لإيقاف عمليات التحقّق من الأخطاء في أي دالة مركّبة.
ضبط فحص الأخطاء في XML
استخدِم السمة tools:ignore لإيقاف فحص lint لأقسام معيّنة من ملفات XML. ضَع قيمة مساحة الاسم التالية في ملف lint.xml
لكي تتعرّف أداة lint على السمة:
namespace xmlns:tools="http://schemas.android.com/tools"يوضّح المثال التالي كيفية إيقاف فحص الأخطاء في الرمز البرمجي لمشكلة UnusedResources في عنصر <resources> في ملف strings.xml. يتم اكتساب السمة ignore من خلال العناصر الفرعية للعنصر الرئيسي الذي تم فيه تحديد السمة. في هذا المثال، يتم أيضًا إيقاف فحص الأخطاء لجميع عناصر <string> المضمّنة:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="UnusedResources" > <string name="app_name">My App</string> <string name="unused_string">Unused String</string> </resources>
لإيقاف أكثر من مشكلة واحدة، أدرِج المشاكل التي تريد إيقافها في سلسلة مفصولة بفواصل. على سبيل المثال:
tools:ignore="NewApi,StringFormatInvalid"
To suppress checking for all lint issues in the XML element, use the all
keyword:
tools:ignore="all"
ضبط خيارات lint باستخدام Gradle
يتيح لك المكوّن الإضافي لنظام Gradle المتوافق مع Android ضبط خيارات معيّنة لأداة lint، مثل عمليات التحقّق التي يتم إجراؤها أو تجاهلها، وذلك باستخدام قسم lint{} في ملف build.gradle على مستوى الوحدة.
يوضّح مقتطف الرمز التالي بعض السمات التي يمكنك ضبطها:
Kotlin
android { ... lint { // Turns off checks for the issue IDs you specify. disable += "TypographyFractions" + "TypographyQuotes" // Turns on checks for the issue IDs you specify. These checks are in // addition to the default lint checks. enable += "RtlHardcoded" + "RtlCompat" + "RtlEnabled" // To enable checks for only a subset of issue IDs and ignore all others, // list the issue IDs with the 'check' property instead. This property overrides // any issue IDs you enable or disable using the properties above. checkOnly += "NewApi" + "InlinedApi" // If set to true, turns off analysis progress reporting by lint. quiet = true // If set to true (default), stops the build if errors are found. abortOnError = false // If set to true, lint only reports errors. ignoreWarnings = true // If set to true, lint also checks all dependencies as part of its analysis. // Recommended for projects consisting of an app with library dependencies. checkDependencies = true } } ...
أنيق
android { ... lint { // Turns off checks for the issue IDs you specify. disable 'TypographyFractions','TypographyQuotes' // Turns on checks for the issue IDs you specify. These checks are in // addition to the default lint checks. enable 'RtlHardcoded','RtlCompat', 'RtlEnabled' // To enable checks for only a subset of issue IDs and ignore all others, // list the issue IDs with the 'check' property instead. This property overrides // any issue IDs you enable or disable using the properties above. checkOnly 'NewApi', 'InlinedApi' // If set to true, turns off analysis progress reporting by lint. quiet true // If set to true (default), stops the build if errors are found. abortOnError false // If set to true, lint only reports errors. ignoreWarnings true // If set to true, lint also checks all dependencies as part of its analysis. // Recommended for projects consisting of an app with library dependencies. checkDependencies true } } ...
تراعي جميع طرق lint التي تتجاوز مستوى الخطورة المحدّد لمشكلة ما ترتيب الإعدادات. على سبيل المثال، يؤدي ضبط مشكلة على أنّها خطيرة في finalizeDsl() إلى إلغاء إيقافها في لغة DSL الرئيسية.
إنشاء مرجع للتحذيرات
يمكنك أخذ لقطة من مجموعة التحذيرات الحالية لمشروعك، ثم استخدام اللقطة كخط أساس لعمليات الفحص المستقبلية بحيث يتم الإبلاغ عن المشاكل الجديدة فقط. تتيح لك لقطة المرجع البدء في استخدام أداة lint لإيقاف عملية الإنشاء بدون الحاجة إلى الرجوع ومعالجة جميع المشاكل الحالية أولاً.
لإنشاء لقطة أساسية، عدِّل ملف build.gradle الخاص بمشروعك على النحو التالي:
Kotlin
android { lint { baseline = file("lint-baseline.xml") } }
أنيق
android { lintOptions { baseline file("lint-baseline.xml") } }
عند إضافة هذا السطر لأول مرة، يتم إنشاء ملف lint-baseline.xml لإنشاء
المرجع. ومنذ ذلك الحين، تقرأ الأدوات الملف فقط لتحديد المرجع. إذا أردت إنشاء مرجع جديد، احذف الملف يدويًا وشغِّل أداة lint مرة أخرى لإعادة إنشائه.
بعد ذلك، شغِّل lint من بيئة التطوير المتكاملة (IDE) من خلال اختيار الرمز البرمجي > فحص الرمز البرمجي أو من سطر الأوامر على النحو التالي. تتم طباعة موقع ملف lint-baseline.xml في الناتج. قد يختلف موقع الملف في الإعدادات عن الموقع الموضّح هنا:
$ ./gradlew lintDebug -Dlint.baselines.continue=true ... Wrote XML report to file:///app/lint-baseline.xml Created baseline file /app/lint-baseline.xml
يؤدي تشغيل lint إلى تسجيل جميع
المشاكل الحالية في ملف lint-baseline.xml. تُسمى مجموعة المشاكل الحالية المرجع. يمكنك التحقّق من ملف lint-baseline.xml
في نظام التحكّم في الإصدارات إذا أردت مشاركته مع الآخرين.
تخصيص الخط الأساسي
إذا أردت إضافة أنواع معيّنة فقط من المشاكل إلى المرجع، حدِّد
المشاكل التي تريد إضافتها من خلال تعديل ملف build.gradle الخاص بمشروعك على النحو التالي:
Kotlin
android { lint { checkOnly += "NewApi" + "HandlerLeak" baseline = file("lint-baseline.xml") } }
أنيق
android { lintOptions { checkOnly 'NewApi', 'HandlerLeak' baseline file("lint-baseline.xml") } }
إذا أضفت أي تحذيرات جديدة إلى قاعدة الرموز البرمجية بعد إنشاء المرجع، ستعرض أداة lint فقط الأخطاء التي تم تقديمها حديثًا.
تحذير بشأن المرجع
عندما يكون المرجع ساريًا، ستتلقّى تحذيرًا إعلاميًا يخبرك بأنّه تمّت فلترة مشكلة واحدة أو أكثر لأنّها مدرَجة في المرجع. يساعدك هذا التحذير في تذكُّر أنّك أعددت مرجعًا وأنّك بحاجة إلى حلّ جميع المشاكل في وقت ما.
يتتبّع هذا التحذير الإعلامي أيضًا المشاكل التي لم يعُد يتم الإبلاغ عنها. تتيح لك هذه المعلومات معرفة ما إذا كنت قد أصلحت المشاكل فعليًا، حتى تتمكّن من إعادة إنشاء المرجع الأساسي بشكل اختياري لمنع ظهور خطأ مرة أخرى بدون اكتشافه.
ملاحظة: يتم تفعيل المراجع عند إجراء عمليات الفحص في وضع الدُفعات في بيئة التطوير المتكاملة، ولكن يتم تجاهلها في عمليات التحقّق داخل المحرِّر التي يتم إجراؤها في الخلفية عند تعديل ملف. ويرجع ذلك إلى أنّ المراجع الأساسية مخصّصة للحالات التي تحتوي فيها قاعدة الرموز البرمجية على عدد كبير من التحذيرات الحالية، ولكنّك تريد إصلاح المشاكل محليًا أثناء تعديل الرمز البرمجي.
إجراء عمليات الفحص يدويًا
لتشغيل عمليات فحص lint وغيرها من عمليات فحص IDE التي تم ضبطها يدويًا، اختَر الرمز > فحص الرمز. تظهر نتائج الفحص في نافذة نتائج الفحص.
ضبط نطاق الفحص والملف الشخصي
اختَر الملفات التي تريد تحليلها (نطاق الفحص) وعمليات الفحص التي تريد تنفيذها (ملف الفحص) على النحو التالي:
- في عرض Android، افتح مشروعك واختَر المشروع أو المجلد أو الملف الذي تريد تحليله.
- من شريط القوائم، اختَر Code (الرمز) > Inspect Code (فحص الرمز).
في مربّع الحوار تحديد نطاق الفحص (Specify Inspection Scope)، راجِع الإعدادات.
الشكل 3: راجِع إعدادات نطاق الفحص. تختلف الخيارات التي تظهر في مربّع الحوار تحديد نطاق الفحص حسب ما إذا كنت قد اخترت مشروعًا أو مجلدًا أو ملفًا:
- عند اختيار مشروع أو ملف أو دليل واحد، يعرض مربّع الحوار تحديد نطاق الفحص المسار إلى المشروع أو الملف أو الدليل الذي اخترته.
- عند اختيار أكثر من مشروع أو ملف أو دليل، يعرض مربّع الحوار تحديد نطاق الفحص زر اختيار محدّدًا للملفات المحدّدة.
لتغيير ما تريد فحصه، اختَر أحد أزرار الاختيار الأخرى. يُرجى الاطّلاع على مربّع حوار "تحديد نطاق الفحص" للحصول على وصف لجميع الحقول المحتملة في مربّع حوار تحديد نطاق الفحص.
- ضمن الملف الشخصي للفحص، اختَر الملف الشخصي الذي تريد استخدامه.
انقر على حسنًا لتشغيل الفحص.
يعرض الشكل 4 نتائج فحص lint وIDE الأخرى من عملية تشغيل فحص الرمز:
الشكل 4. نتائج الفحص اختَر مشكلة للاطّلاع على الحلّ. -
في لوحة نتائج الفحص، يمكنك الاطّلاع على نتائج الفحص من خلال توسيع واختيار فئات الأخطاء أو أنواعها أو المشاكل.
تعرض لوحة تقرير الفحص تقرير الفحص لفئة الخطأ أو نوعه أو المشكلة المحدّدة في لوحة نتائج الفحص، كما تعرض اسم الخطأ وموقعه. يعرض تقرير الفحص معلومات أخرى، مثل ملخّص المشكلة، لمساعدتك في حلّها، وذلك في الحالات التي ينطبق فيها ذلك.
في العرض التدرّجي للحساب في لوحة نتائج الفحص، انقر بزر الماوس الأيمن على فئة أو نوع أو مشكلة لعرض قائمة السياق.
استنادًا إلى السياق، يمكنك إجراء ما يلي:
- الانتقال إلى المصدر
- استبعاد العناصر المحدّدة وتضمينها
- إخفاء المشاكل
- عدِّل الإعدادات.
- إدارة تنبيهات الفحص
- أعِد إجراء الفحص.
للاطّلاع على أوصاف أزرار شريط الأدوات وعناصر قائمة السياقات وحقول تقرير الفحص، يُرجى مراجعة نافذة أداة نتائج الفحص.
استخدام نطاق مخصّص
استخدِم أحد النطاقات المخصّصة المتوفّرة في "استوديو Android" على النحو التالي:
- في مربّع الحوار تحديد نطاق الفحص (Specify Inspection Scope)، اختَر نطاق مخصّص (Custom scope).
انقر على قائمة النطاق المخصّص لعرض الخيارات:
الشكل 5. اختَر النطاق المخصّص الذي تريد استخدامه. - جميع الأماكن: جميع الملفات
- ملفات المشروع: جميع الملفات في المشروع الحالي
- ملفات المصدر في المشروع: ملفات المصدر في المشروع الحالي فقط
- ملفات الإنتاج في المشروع: ملفات الإنتاج في المشروع الحالي فقط.
- ملفات اختبار المشروع: ملفات الاختبار في المشروع الحالي فقط.
- الملفات المؤقتة ووحدات التحكّم: الملفات المؤقتة ووحدات التحكّم المفتوحة فقط في المشروع الحالي.
- الملفات التي تم عرضها مؤخرًا: الملفات التي تم عرضها مؤخرًا في المشروع الحالي فقط
- الملف الحالي: الملف الحالي فقط في مشروعك الحالي يظهر عند اختيار ملف أو مجلد.
- الدليل المحدّد: المجلد الحالي في مشروعك الحالي فقط يظهر هذا الخيار عند اختيار مجلد.
- التسلسل الهرمي للفئات: عند تحديد هذا الخيار والنقر على حسنًا، يظهر مربّع حوار يحتوي على جميع الفئات في المشروع الحالي. في مربّع الحوار، استخدِم حقل البحث حسب الاسم لفلترة الصفوف التي تريد فحصها واختيارها. إذا لم تتم فلترة قائمة الفئات، سيتم فحص جميع الفئات.
- انقر على حسنًا.
إذا كان لديك نظام تحكّم في الإصدارات (VCS) تم ضبطه للمشروع، تتوفّر أيضًا خيارات لتقييد البحث على الملفات التي تم تعديلها فقط.
إنشاء نطاق مخصّص
عندما تريد فحص مجموعة من الملفات والأدلة التي لا يغطيها أي من النطاقات المخصصة المتاحة، يمكنك إنشاء نطاق مخصص:
- في مربّع الحوار تحديد نطاق الفحص (Specify Inspection Scope)، اختَر نطاق مخصّص (Custom scope).
انقر على النقاط الثلاث بعد قائمة النطاق المخصّص.
الشكل 6. مربّع حوار "تحديد نطاق الفحص" يظهر مربّع الحوار النطاقات.
الشكل 7. أنشئ نطاقًا مخصّصًا. - انقر على الزر
في أعلى يمين مربّع الحوار لتحديد نطاق جديد. - في قائمة إضافة نطاق التي تظهر، اختَر محلي.
يتم استخدام كل من النطاقين المحلي والمشترك داخل المشروع لميزة فحص الرمز. يمكن أيضًا استخدام نطاق مشترَك مع ميزات المشروع الأخرى التي تحتوي على حقل نطاق. على سبيل المثال، عند النقر على تعديل الإعدادات
لتغيير
إعدادات العثور على الاستخدامات، يحتوي مربّع الحوار الناتج على حقل النطاق حيث يمكنك
اختيار نطاق مشترك.
الشكل 8 اختَر نطاقًا مشتركًا من مربّع الحوار العثور على الاستخدامات. - أدخِل اسمًا للنطاق وانقر على حسنًا.
تتم تعبئة الجزء الأيسر من مربّع الحوار النطاقات بخيارات تتيح لك تحديد النطاق المخصّص.
- من القائمة، اختَر مشروع.
ستظهر قائمة بالمشاريع المتاحة.
ملاحظة: يمكنك إنشاء النطاق المخصّص للمشاريع أو الحِزم. الخطوات هي نفسها.
وسِّع مجلدات المشروع، واختَر ما تريد إضافته إلى النطاق المخصّص، واختَر ما إذا كنت تريد تضمينه أو استبعاده.
الشكل 9. حدِّد نطاقًا مخصّصًا. - تضمين: يمكنك تضمين هذا المجلد وملفاته، ولكن لا تضمِّن أيًا من مجلداته الفرعية.
- التضمين بشكل متكرر: يمكنك تضمين هذا المجلد وملفاته بالإضافة إلى مجلداته الفرعية وملفاتها.
- استبعاد: استبعاد هذا المجلد وملفاته، ولكن لا تستبعد أيًا من مجلداته الفرعية.
- استبعاد متكرر: لاستبعاد هذا المجلد وملفاته بالإضافة إلى مجلداته الفرعية وملفاتها
يوضّح الشكل 10 أنّه تم تضمين المجلد main، وأنّ المجلدَين java وres تم تضمينهما بشكل متكرر. يشير اللون الأزرق إلى مجلد مضمّن جزئيًا، ويشير اللون الأخضر إلى المجلدات والملفات المضمّنة بشكل متكرر.
الشكل 10: مثال على نمط لنطاق مخصّص - إذا اخترت المجلد java ونقرت على استبعاد بشكل متكرر، سيختفي التمييز الأخضر من المجلد java وجميع المجلدات والملفات ضمنه.
- إذا اخترت ملف MainActivity.kt المميّز باللون الأخضر ونقرت على استبعاد، لن يظل ملف MainActivity.kt مميّزًا باللون الأخضر، ولكن سيظل كل شيء آخر ضمن مجلد java باللون الأخضر.
- انقر على موافق. يظهر النطاق المخصّص في أسفل القائمة.
مراجعة الملفات الشخصية للفحص وتعديلها
يحتوي "استوديو Android" على مجموعة من ملفات تعريف lint وملفات تعريف الفحص الأخرى التي يتم تحديثها من خلال تحديثات Android. يمكنك استخدام هذه الملفات الشخصية كما هي أو تعديل أسمائها وأوصافها ومستويات خطورتها و نطاقاتها. يمكنك أيضًا تفعيل مجموعات كاملة من الملفات الشخصية أو ملفات شخصية فردية ضمن مجموعة وإيقافها.
للوصول إلى إعدادات عمليات التفتيش:
- انقر على ملف > الإعدادات. (على نظام التشغيل Windows) أو استوديو Android > الإعدادات المفضّلة (على نظام التشغيل macOS أو Linux).
- انقر على المحرِّر > عمليات الفحص.
-
تعرض لوحة عمليات الفحص قائمة بعمليات الفحص المتوافقة وأوصافها.
الشكل 11: عمليات الفحص المتوافقة وأوصافها اختَر قائمة الملف الشخصي للتبديل بين عمليات الفحص التلقائية (استوديو Android) والتلقائية للمشروع (المشروع النشط).
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة إدارة الملفات الشخصية في IntelliJ.
في قائمة عمليات الفحص في اللوحة اليمنى، اختَر فئة ملف شخصي ذات مستوى أعلى أو وسِّع مجموعة واختَر ملفًا شخصيًا معيّنًا.
عند اختيار فئة ملف شخصي، يمكنك تعديل جميع عمليات الفحص في هذه الفئة كعملية فحص واحدة.
- انقر على قائمة عرض إجراءات المخطط
لنسخ عمليات الفحص وإعادة تسميتها وإضافة أوصاف إليها وتصديرها واستيرادها. - عند الانتهاء، انقر على حسنًا.