تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تحسين الرموز البرمجية باستخدام عمليات فحص الوبر

بالإضافة إلى إنشاء الاختبارات للتأكد من أن تطبيقك يلبي متطلباته الوظيفية، من المهم أيضًا تشغيل الرمز باستخدام أداة الوبر للمساعدة في ضمان عدم وجود مشاكل هيكلية في التعليمات البرمجية. تساعد أداة lint في العثور على الرمز البرمجي ذي البنية غير الصحيحة والذي يمكن أن يؤثر في موثوقية وفعالية تطبيقات Android، ما يصعّب عملية صيانة الرمز. يوصى بشدة بتصحيح أي أخطاء يتم اكتشافها من الوبر قبل نشر تطبيقك.

على سبيل المثال، إذا كانت ملفات موارد XML تحتوي على مساحات اسم غير مستخدمة، سيشغل ذلك مساحة ويتطلب معالجة غير ضرورية. هناك مشاكل هيكلية أخرى، مثل استخدام العناصر التي تم إيقافها نهائيًا أو طلبات البيانات من واجهة برمجة التطبيقات التي لا تتوافق مع إصدارات واجهة برمجة التطبيقات المستهدَفة، قد تؤدي إلى تعذّر تشغيل الرمز بشكل صحيح. بإمكان Lint مساعدتك في إزالة هذه المشاكل.

لتحسين أداء الاختبار، يمكنك أيضًا إضافة تعليقات توضيحية إلى الرمز.

نظرة عامة

يوفّر Android Studio أداة لفحص الرموز تُسمى lint ويمكنها مساعدتك في تحديد المشاكل المتعلّقة بالجودة الهيكلية للرموز البرمجية وتصحيحها بدون الحاجة إلى تنفيذ التطبيق أو كتابة حالات الاختبار. يتم الإبلاغ عن كل مشكلة تكتشفها الأداة من خلال رسالة وصفية ومستوى خطورة بحيث يمكنك إعطاء الأولوية للتحسينات المهمة التي يجب إجراؤها. يمكنك أيضًا خفض مستوى خطورة المشكلة لتجاهل المشكلات التي لا تتعلق بمشروعك أو رفع مستوى الخطورة لتسليط الضوء على مشكلات معينة.

تفحص أداة lint ملفات مصدر مشروع Android بحثًا عن الأخطاء المحتملة وتحسينات التحسين من أجل الصحة والأمان والأداء وسهولة الاستخدام وإمكانية الوصول والانتشار على نطاق عالمي. عند استخدام "استوديو Android"، يتم تنفيذ عمليات فحص lint وIDE عند إنشاء تطبيقك، ولكن يمكنك تشغيل عمليات الفحص يدويًا أو تشغيل Lint من سطر الأوامر، كما هو موضّح في هذه الصفحة.

تفحص أداة lint المُدمَجة التعليمات البرمجية أثناء استخدام Android Studio. يمكنك عرض التحذيرات والأخطاء بطريقتين:

كنص منبثق في نافذة المحرّر. عندما يعثر لينت على مشكلة، فإنه يسلط الضوء على التعليمة البرمجية المسببة للمشكلات باللون الأصفر. بالنسبة إلى المشاكل الأكثر خطورة، يتم تسطير الرمز باللون الأحمر.
في نافذة نتائج الفحص لينت عند النقر على الرمز > فحص الرمز.

ملاحظة: عند تجميع الرمز البرمجي في "استوديو Android"، يتم إجراء عمليات فحص إضافية لرموز IntelliJ لتسهيل عملية مراجعة الرموز.

يوضّح الشكل 1 كيفية معالجة أداة لينت لملفات مصدر التطبيق.

سير عمل فحص الرمز باستخدام أداة Lint. — **الشكل 1.** سير عمل فحص الرموز باستخدام أداة Lit.

ملفات مصدر التطبيقات: تتألف الملفات المصدر من الملفات التي يتألف منها مشروع Android، بما في ذلك ملفات Kotlin وJava وXML، والرموز، وملفات إعداد ProGuard.
ملف lint.xml: ملف إعداد يمكنك استخدامه لتحديد أي عمليات تحقّق من الوبر تريد استبعادها وتخصيص مستويات خطورة المشاكل.
أداة لينت: أداة لفحص الرموز الثابتة يمكن تشغيلها في مشروع Android إما من سطر الأوامر أو في Android Studio. تفحص أداة لينت المشاكل المتعلقة بالتعليمات البرمجية الهيكلية التي قد تؤثر في جودة وأداء تطبيق Android.
نتائج فحص الوبر: يمكنك عرض النتائج من lint إما في وحدة التحكّم أو في نافذة نتائج الفحص في "استوديو Android". في حال تشغيل lint من سطر الأوامر، تتم كتابة النتائج في المجلد build/. للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على القسم الذي يتناول إجراء عمليات الفحص يدويًا.

تشغيل أداة Lint من سطر الأوامر

إذا كنت تستخدم "استوديو Android" أو Gradle، استخدِم برنامج تضمين Gradle لاستدعاء مهمة 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 من تقرير Lit. ويمكنك بعد ذلك الانتقال إلى تقرير HTML وفتحه في المتصفّح، كما هو موضّح في الشكل 2.

إذا كان مشروعك يتضمن إصدارات مختلفة، لن تتحقّق أداة Lit إلا من الصيغة التلقائية فقط. إذا كنت تريد تشغيل أداة لينت على صيغة مختلفة، يجب كتابة اسم الصيغة بالأحرف اللاتينية الكبيرة ثم إضافة البادئة lint إليه.

./gradlew lintRelease

لمعرفة المزيد من المعلومات عن تشغيل مهام Gradle من سطر الأوامر، يمكنك الاطّلاع على مقالة إنشاء تطبيقك من سطر الأوامر.

تشغيل أداة Lint باستخدام الأداة المستقلة

إذا كنت لا تستخدم "استوديو Android" أو Gradle، يمكنك تثبيت أدوات سطر الأوامر لحزمة تطوير البرامج (SDK) لنظام التشغيل Android لاستخدام أداة لينت المستقلة. حدِّد مكان أداة الوبر على 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 على مشروع يسمى الزلازل:

$ 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/layout/preferences.xml: Warning: The resource R.layout.preferences appears to be unused [UnusedResources]
res: Warning: Missing density variation folders in res: drawable-xhdpi [IconMissingDensityFolder]
0 errors, 4 warnings

يسرد المثال على الإخراج أربعة تحذيرات بدون أي أخطاء.

هناك تحذيران يتعلقان بملف AndroidManifest.xml للمشروع:

ManifestOrder
UsesMinSdkAttributes

يرتبط تحذير واحد بملف التنسيق Preferences.xml: UnusedResources.

يرتبط تحذير واحد بدليل res: IconMissingDensityFolder.

ضبط أداة لينت لإيقاف التحذيرات

بشكل تلقائي، عند تشغيل فحص الوبر، تتحقق الأداة من جميع المشاكل التي يتيحها لينت. يمكنك أيضًا تحديد مشاكل أداة لينت للتحقق منها، كما يمكنك تحديد مستويات الخطورة للمشاكل. على سبيل المثال، يمكنك منع فحص الوبر بحثًا عن مشكلات معينة لا صلة لها بمشروعك، ويمكنك تهيئة الوبر للإبلاغ عن المشكلات غير الملحّة على مستوى خطورة أقل.

مستويات الخطورة هي:

enable
disable أو ignore
informational
warning
error
fatal

يمكنك ضبط عملية فحص الوبر لمستويات مختلفة:

عالميًا (المشروع بالكامل)
وحدة المشروع
وحدة الإنتاج
وحدة الاختبار
فتح الملفات
التدرّج الهرمي للصف
نطاقات نظام التحكم في الإصدارات (VCS)

ضبط ملف لينت

يمكنك تحديد الإعدادات المفضّلة لفحص الوبر في ملف 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 --list.

نموذج ملف lint.xml

يعرض المثال التالي محتوى ملف lint.xml:

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disable the IconMissingDensityFolder check in this project -->
    <issue id="IconMissingDensityFolder" severity="ignore" />

    <!-- Ignore the ObsoleteLayoutParam issue in the specified files -->
    <issue id="ObsoleteLayoutParam">
        <ignore path="res/layout/activation.xml" />
        <ignore path="res/layout-xlarge/activation.xml" />
    </issue>

    <!-- Ignore the UselessLeaf issue in the specified file -->
    <issue id="UselessLeaf">
        <ignore path="res/layout/main.xml" />
    </issue>

    <!-- Change the severity of hardcoded strings to "error" -->
    <issue id="HardcodedText" severity="error" />
</lint>

يوضّح هذا المثال كيفية الإبلاغ عن أنواع المشاكل المختلفة. يتم إيقاف عملية التحقّق IconMissingDensityFolder تمامًا، ويتم إيقاف عملية التحقّق ObsoleteLayoutParam فقط في الملفات المحدّدة في إعلانات <ignore ... /> المضمَّنة.

ضبط ميزة التحقّق من لينت لملفات مصدر Kotlin وJava وXML

يمكنك إيقاف ميزة التحقق من الوبر في ملفات مصدر Kotlin وJava وXML في مربّع الحوار الإعدادات المفضّلة:

اختَر ملف > الإعدادات (على نظام التشغيل Windows) أو استوديو Android > الإعدادات المفضّلة (على نظام التشغيل macOS أو Linux).
اختَر أداة التعديل > عمليات الفحص.
للإيقاف، ألغِ اختيار ملف المصدر المناسب.

يمكنك ضبط هذه الإعدادات لبيئات التطوير المتكاملة أو لمشاريع فردية من خلال اختيار الملف الشخصي المناسب.

تهيئة التحقق من الوبر في Java أو Kotlin

لإيقاف فحص الوبر تحديدًا لفئة أو طريقة في مشروع Android، أضِف التعليق التوضيحي @SuppressLint إلى هذا الرمز.

يوضّح المثال التالي كيفية إيقاف ميزة التحقق من الوبر في مشكلة NewApi في طريقة onCreate. تستمر أداة لينت في التحقق من مشكلة NewApi من خلال الطرق الأخرى ضمن هذه الفئة.

Kotlin

@SuppressLint("NewApi")
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

لغة Java

@SuppressLint("NewApi")
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

يوضّح المثال التالي كيفية إيقاف ميزة التحقق من الوبر في مشكلة ParserError في فئة FeedProvider:

Kotlin

@SuppressLint("ParserError")
class FeedProvider : ContentProvider() {

لغة Java

@SuppressLint("ParserError")
public class FeedProvider extends ContentProvider {

لإيقاف عملية التحقّق من جميع مشاكل الروابط في الملف، استخدِم الكلمة الرئيسية all:

Kotlin

@SuppressLint("all")

لغة Java

@SuppressLint("all")

ضبط ميزة "التحقق من الوبر" في ملف XML

استخدِم السمة tools:ignore لإيقاف ميزة "التحقق من الوبر" في أقسام معيّنة من ملفات XML. ضَع قيمة مساحة الاسم التالية في ملف lint.xml حتى تتعرّف أداة lint على السمة:

namespace xmlns:tools="http://schemas.android.com/tools"

يوضّح المثال التالي كيفية إيقاف ميزة التحقق من الوبر لمشكلة UnusedResources في العنصر <LinearLayout> ضمن ملف تنسيق XML. يتم اكتساب السمة ignore من خلال العناصر الثانوية للعنصر الرئيسي حيث يتم الإعلان عن السمة. في هذا المثال، يتم أيضًا إيقاف عملية التحقّق من الوبر في العنصر <TextView> الثانوي:

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:ignore="UnusedResources" >

    <TextView
        android:text="@string/auto_update_prompt" />
</LinearLayout>

لإيقاف أكثر من مشكلة، يمكنك إدراج المشاكل المطلوب إيقافها في سلسلة مفصولة بفواصل. على سبيل المثال:

tools:ignore="NewApi,StringFormatInvalid"

لإيقاف عملية التحقّق من جميع مشاكل الروابط في عنصر XML، استخدِم الكلمة الرئيسية all التالية:

tools:ignore="all"

ضبط خيارات لينت باستخدام Gradle

يتيح لك مكوّن Android الإضافي لنظام Gradle إمكانية ضبط خيارات أداة لينت معيّنة، مثل أي عمليات التحقّق التي يمكن تشغيلها أو تجاهلها، باستخدام مجموعة 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
    }
}
...

يجب أن تلتزم جميع طُرق تحليل البيانات التي تتجاوز مستوى الخطورة المحدد لمشكلة ما بترتيب الإعدادات. على سبيل المثال، يؤدي ضبط مشكلة فادحة في finalizeDsl() إلى إلغاء إيقافها في DSL الرئيسي.

إنشاء مرجع للتحذيرات

يمكنك أخذ نبذة عن مجموعة التحذيرات الحالية لمشروعك، ثم استخدام اللقطة كمرجع لعمليات الفحص المستقبلية بحيث يتم الإبلاغ عن المشاكل الجديدة فقط. تتيح لك النبذة المرجعية بدء استخدام أداة Litt لتعذُّر الإصدار بدون الحاجة إلى الرجوع ومعالجة جميع المشاكل الحالية أولاً.

لإنشاء لقطة أساسية، عدِّل ملف build.gradle لمشروعك على النحو التالي:

Kotlin

android {
    lint {
        baseline = file("lint-baseline.xml")
    }
}

رائع

android {
    lintOptions {
        baseline file("lint-baseline.xml")
    }
}

عند إضافة هذا السطر لأول مرة، يتم إنشاء ملف lint-baseline.xml لإنشاء خط الأساس. من ذلك الحين فصاعدًا، تقرأ الأدوات الملف فقط لتحديد المتوقع. إذا كنت تريد إنشاء أساس جديد، فاحذف الملف يدويًا وقم بتشغيل أداة لينت مرة أخرى لإعادة إنشائه.

بعد ذلك، شغِّل لينت من بيئة تطوير البرامج (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")
    }
}

إذا أضفت أي تحذيرات جديدة إلى قاعدة الرموز بعد إنشاء المتوقع، يسرد Lit الأخطاء التي تم تقديمها مؤخرًا فقط.

تحذير خط الأساس

عندما يكون خط الأساس ساري المفعول، ستتلقى تحذيرًا إعلاميًا يخبرك بأنه تمت تصفية مشكلة واحدة أو أكثر لأنها مدرجة في خط الأساس. يساعدك هذا التحذير على تذكر أنك قمت بتكوين خط أساس وأنك بحاجة إلى حل جميع المشكلات في وقت ما.

يعمل هذا التحذير المعلوماتي أيضًا على تتبُّع المشاكل التي لم يعُد يتم الإبلاغ عنها. تتيح لك هذه المعلومات معرفة ما إذا كنت قد أصلحت المشاكل فعلاً، لذا يمكنك إعادة إنشاء المتوقع بشكل اختياري لمنع الخطأ من العودة بدون اكتشافه.

ملاحظة: يتم تفعيل الإرشادات عند تشغيل عمليات الفحص في الوضع المجمّع في بيئة تطوير البرامج (IDE)، ولكن يتم تجاهلها لعمليات التحقّق داخل المحرر التي يتم تشغيلها في الخلفية عند تعديل ملف. وذلك لأن الخطوط الأساسية مخصّصة للحالات التي يشتمل فيها قاعدة التعليمات البرمجية على عدد كبير من التحذيرات الحالية، ولكنك تحتاج إلى إصلاح المشاكل محليًا أثناء لمس الرمز.

إجراء عمليات الفحص يدويًا

لتشغيل عمليات فحص لينت وبيئات IDE الأخرى التي تم ضبطها يدويًا، اختَر الرمز > رمز الفحص. تظهر نتائج الفحص في نافذة نتائج الفحص.

ضبط نطاق الفحص والملف الشخصي

اختَر الملفات التي تريد تحليلها (نطاق الفحص) وعمليات الفحص التي تريد إجرائها (الملف الشخصي للفحص) على النحو التالي:

في طريقة عرض Android، افتح مشروعك واختَر المشروع أو المجلد أو الملف الذي تريد تحليله.
من شريط القوائم، اختَر الرمز > فحص الرمز.
في مربّع الحوار تحديد نطاق الفحص، راجِع الإعدادات.

الشكل 3. راجِع إعدادات نطاق الفحص.

تختلف الخيارات التي تظهر في مربّع الحوار تحديد نطاق الفحص بناءً على ما إذا اختَرت مشروعًا أو مجلدًا أو ملفًا:
- عند اختيار مشروع أو ملف أو دليل، يعرض مربّع الحوار تحديد نطاق الفحص المسار إلى المشروع أو الملف أو الدليل الذي اخترته.
- عند اختيار أكثر من مشروع أو ملف أو دليل، يعرض مربّع الحوار تحديد نطاق الفحص زر اختيار محدّد للملفات المحدَّدة.
لتغيير ما تريد فحصه، انقر على أحد أزرار الاختيار الأخرى. يُرجى الاطّلاع على مربّع الحوار "تحديد نطاق الفحص" للحصول على وصف لجميع الحقول المحتملة في مربّع الحوار تحديد نطاق الفحص.
ضمن فحص الملف الشخصي، اختَر الملف الشخصي الذي تريد استخدامه.
انقر على حسنًا لبدء الفحص.

يُظهر الشكل 4 نتائج فحص لينت وغيرها من نتائج فحص بيئة تطوير البرامج (IDE) من خلال تشغيل رمز الفحص:

الشكل 4. نتائج الفحص. اختَر المشكلة للاطّلاع على الحلّ.
في لوحة نتائج الفحص، يمكنك عرض نتائج الفحص من خلال توسيع واختيار فئات الأخطاء أو أنواعها أو المشاكل واختيارها.

تعرض لوحة تقرير الفحص تقرير الفحص لفئة الخطأ أو نوعه أو المشكلة التي تم اختيارها في لوحة نتائج الفحص كما تعرض اسم الخطأ وموقعه. حيثما أمكن، يعرض تقرير الفحص معلومات أخرى، مثل ملخص عن مشكلة، لمساعدتك في حل المشكلة.
في العرض التدرّجي للوحة نتائج الفحص، انقر بزر الماوس الأيمن على فئة أو نوع أو مشكلة لعرض قائمة السياقات.

بناءً على السياق، يمكنك إجراء ما يلي:
- الانتقال إلى المصدر
- استبعاد العناصر المحدّدة وتضمينها
- منع المشكلات.
- تعديل الإعدادات
- إدارة تنبيهات الفحص
- إعادة إجراء الفحص

للحصول على أوصاف لأزرار شريط الأدوات وعناصر قائمة السياق وحقول تقرير الفحص، يمكنك الاطّلاع على نافذة أداة نتائج الفحص.

استخدام نطاق مخصّص

استخدِم أحد النطاقات المخصَّصة المتوفّرة في "استوديو Android" على النحو التالي:

في مربّع الحوار تحديد نطاق الفحص، اختَر نطاق مخصص.
انقر على قائمة النطاق المخصّص لعرض الخيارات التالية:

الشكل 5. اختَر النطاق المخصّص الذي تريد استخدامه.
- جميع الأماكن: كل الملفات
- ملفات المشروع: جميع الملفات في المشروع الحالي.
- ملفات مصدر المشروع: ملفات المصدر في المشروع الحالي فقط
- ملفات إنتاج المشروع: ملفات الإنتاج في المشروع الحالي فقط
- ملفات اختبار المشروع: ملفات الاختبار في المشروع الحالي فقط
- الخدوش ووحدات التحكّم: ملفات المكافآت الفورية ووحدات التحكّم التي فتحتها في المشروع الحالي فقط.
- الملفات التي تم الاطّلاع عليها مؤخرًا: الملفات التي تم الاطّلاع عليها مؤخرًا في المشروع الحالي فقط.
- الملف الحالي: الملف الحالي فقط في مشروعك الحالي يظهر عند تحديد ملف أو مجلد.
- الدليل المحدّد: المجلد الحالي في مشروعك الحالي فقط. يظهر عند تحديد مجلد.
- التدرّج الهرمي للفئة: عند تحديد هذا الخيار والنقر على حسنًا، سيظهر مربّع حوار يضم كل الصفوف في المشروع الحالي. في مربّع الحوار، استخدِم الحقل البحث حسب الاسم لفلترة الصفوف التي تريد فحصها واختيارها. في حال عدم فلترة قائمة الصفوف، يفحص فحص الرمز جميع الفئات.
إذا كنت قد أعددت VCS للمشروع، تتوفر أيضًا خيارات لقصر البحث على الملفات التي تم تعديلها فقط.
انقر على حسنًا.

إنشاء نطاق مخصّص

عندما تريد فحص مجموعة مختارة من الملفات والأدلة التي لا تغطيها أي من النطاقات المخصّصة المتاحة حاليًا، يمكنك إنشاء نطاق مخصّص:

في مربّع الحوار تحديد نطاق الفحص، اختَر نطاق مخصص.
انقر على النقاط الثلاث بعد قائمة النطاق المخصّص.

الشكل 6. اختيار مربّع الحوار "نطاق الفحص"

سيظهر مربّع الحوار النطاقات.

الشكل 7. أنشِئ نطاقًا مخصّصًا.
انقر على الزر في أعلى يمين مربّع الحوار لتحديد نطاق جديد.
في قائمة إضافة نطاق التي تظهر، اختَر محلي.
يتم استخدام كل من النطاقات المحلية والمشتركة في المشروع لميزة فحص الرمز. يمكن أيضًا استخدام النطاق المشترك مع ميزات المشروع الأخرى التي تحتوي على حقل نطاق. على سبيل المثال، عند النقر على تعديل الإعدادات لتغيير إعدادات البحث عن الاستخدامات، سيتضمّن مربّع الحوار الناتج حقل نطاق حيث يمكنك اختيار نطاق مشترك.

الشكل 8. اختَر نطاقًا مشتركًا من مربّع الحوار البحث عن الاستخدامات.
أدخِل اسمًا للنطاق وانقر على حسنًا.
تتم تعبئة الجزء الأيسر من مربّع حوار النطاقات بالخيارات التي تتيح لك تحديد النطاق المخصّص.
من القائمة، اختَر مشروع.
تظهر قائمة بالمشاريع المتاحة.

ملاحظة: يمكنك إنشاء نطاق مخصّص للمشاريع أو الحِزم. الخطوات هي نفسها.
وسِّع مجلدات المشروع، واختَر ما تريد إضافته إلى النطاق المخصّص، واختَر ما إذا كنت تريد تضمينه أو استبعاده.

الشكل 9. تحديد نطاق مخصّص
- تضمين: أدرِج هذا المجلد وملفاته، ولكن لا تضمِّن أيًا من مجلداته الفرعية.
- التضمين بشكل متكرّر: يمكنك تضمين هذا المجلد وملفاته بالإضافة إلى مجلداته الفرعية وملفاته.
- استبعاد: استبعِد هذا المجلد وملفاته، ولكن لا تستبعِد أيًا من مجلداته الفرعية.
- الاستبعاد بشكل متكرر: استبعِد هذا المجلد وملفاته بالإضافة إلى مجلداته الفرعية وملفاته.
يوضّح الشكل 10 أنّه تم تضمين المجلد الرئيسي وأنّ مجلدَي java وres يتم تضمينهما بشكل متكرر. يشير اللون الأزرق إلى مجلد مضمّن بشكل جزئي، ويشير اللون الأخضر إلى المجلدات والملفات التي يتم تضمينها بشكل متكرر.

الشكل 10. مثال على نمط لنطاق مخصّص.
- إذا اختَرت المجلد java ونقرت على استبعاد بشكل متكرر، يختفي التظليل باللون الأخضر على المجلد java وجميع المجلدات والملفات ضمنه.
- إذا اخترت ملف MainActivity.kt المميّز باللون الأخضر ونقرت على استبعاد، لن يظهر MainActivity.kt باللون الأخضر، ولكن سيبقى كل شيء آخر ضمن مجلد java باللون الأخضر.
انقر على حسنًا. سيظهر النطاق المخصّص في أسفل القائمة.

مراجعة الملفات الشخصية للفحص وتعديلها

يتضمن "استوديو Android" مجموعة مختارة من ملفات لينت والملفات الشخصية الأخرى للفحص التي يتم تحديثها من خلال تحديثات Android. يمكنك استخدام هذه الملفات الشخصية كما هي أو تعديل أسمائها وأوصافها ودرجة خطورتها ونطاقاتها. يمكنك أيضًا تفعيل مجموعات كاملة من الملفات الشخصية أو ملفات شخصية فردية وإيقافها ضمن مجموعة.

للوصول إلى إعدادات عمليات الفحص:

اختَر ملف > الإعدادات. (على نظام التشغيل Windows) أو استوديو Android > الإعدادات المفضّلة (على نظام التشغيل macOS أو Linux).
اختَر أداة التعديل > عمليات الفحص.

تعرض لوحة عمليات الفحص قائمة بعمليات الفحص المتوافقة وأوصافها.

**الشكل 11.** عمليات الفحص المتاحة وأوصافها

اختَر قائمة الملف الشخصي للتبديل بين الفحصَين التلقائي (استوديو Android) والمشروع التلقائي للمشروع (المشروع النشط).

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة IntelliJ إدارة الملفات الشخصية.
في قائمة عمليات الفحص في اللوحة اليمنى، اختَر فئة ملف شخصي ذات مستوى أعلى أو وسِّع مجموعة واختَر ملفًا شخصيًا محددًا.

عند اختيار فئة ملف شخصي، يمكنك تعديل جميع عمليات الفحص في تلك الفئة باعتبارها عملية فحص واحدة.
اختَر قائمة عرض إجراءات المخطط لنسخ عمليات الفحص وإعادة تسميتها وإضافة أوصاف إليها وتصديرها واستيرادها.
عند الانتهاء من ذلك، انقر على حسنًا.