اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
تشغيل الاختبارات الآلية لبرنامج CTS (الإصدار 10 من AOSP أو الإصدارات الأقدم)
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحتوي هذه الصفحة على تعليمات لتشغيل الاختبارات الآلية لبرنامج CTS على نظام التشغيل Android 10
أو إصدار أقدم.
تشغيل جلسة إعادة محاولة
إذا كان هذا هو أول اختبار تجريبي لك، قد يتعذّر اجتياز بعض الاختبارات بسبب مشاكل خارجة عن نطاق تحكّمك. على سبيل المثال، قد يكون الاتصال بالشبكة بطيئًا أو قد تكون إشارة GPS ضعيفة. لذلك، عليك إعادة إجراء الاختبارات إلى أن تكتمل جميع وحدات الاختبار ويتساوى عدد حالات تعذُّر اجتياز الاختبار في جلستَي إعادة المحاولة المتعاقبتَين. لتنفيذ جلسة إعادة محاولة على نظامَي التشغيل Android 9 و10:
run retry --retry session_number`
لتنفيذ جلسة إعادة محاولة على نظام التشغيل Android 8.1 أو إصدارات أقدم:
run cts --retry session_number
تنفيذ جلسة إعادة محاولة للاختبارات المُستخدِمة للمَعلمات التي تعذّر إكمالها
لا تتم إعادة محاولة الاختبارات التي تم اجتيازها باستخدام مَعلمات. لإجراء جلسة إعادة محاولة على الاختبار
المُستخدِم للمَعلمات الذي تعذّر إكماله فقط:
run retry --retry session_number --new-parameterized-handling
تنفيذ خطط اختبار فردية
بدلاً من تنفيذ جميع خطط الاختبار في آنٍ واحد، يمكنك تنفيذ خطط اختبار فردية.
لتشغيل خطة اختبار فردية:
حدِّد اسم خطة الاختبار التي تريد تنفيذها.
على نظام التشغيل Android 7 والإصدارات الأحدث:
list modules
على نظام التشغيل Android 6 أو الإصدارات الأقدم:
list plans
لتنفيذ خطة الاختبار:
run cts --plan test_module_or_plan_name
تحسين وقت تنفيذ الاختبار
إذا كنت تريد تحسين وقت تنفيذ الاختبار، يمكنك تقسيم الاختبارات على عدة
أجهزة. تتطلّب ميزة "تقسيم البيانات" أن يربط المضيف جهازَين على الأقل، ولكن يُنصح باستخدام ستة أجهزة أو
أكثر لتحقيق الكفاءة.
لتقسيم الاختبارات على Android 9 أو 10، شغِّل:
run cts --shard-count number_of_shards
لتقسيم الاختبارات على نظام التشغيل Android 8.1 أو الإصدارات الأقدم، شغِّل:
run cts --shards number_of_shards
تشغيل CTS على الأجهزة المزوّدة بشاشات متعددة
إذا كان جهازك يعمل بنظام التشغيل Android 10 وكان يحتوي على عدة
شاشات، عليك تنفيذ خطة اختبار cts-foldable بشكل منفصل:
run cts-foldable
تتم إضافة القيمة
من display_mode إلى حالات الاختبار التي اجتازت الاختبار أو تعذّر إكمالها لميزة "وضع الشاشة البديل"، على سبيل المثال testcase1[display_mode=0].
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ 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,["# Run CTS automated tests (AOSP 10 or lower)\n\nThis page contains instructions for running CTS automated tests on Android 10\nor lower.\n\nRun a retry session\n-------------------\n\nIf this is your first test run, there might be tests that fail due to issues\nbeyond your control. For example, a network connection might be slow or a GPS\nsignal might be weak. So, rerun (retry) the tests until all test modules are\ncompleted and the test failure numbers are the same in the last two retry\nsessions. To run a retry session for Android 9 and 10: \n\n run retry --retry \u003cvar translate=\"no\"\u003esession_number\u003c/var\u003e`\n\nTo run a retry session for Android 8.1 or lower: \n\n run cts --retry \u003cvar translate=\"no\"\u003esession_number\u003c/var\u003e\n\n| **Note:** For implementation details for CTS retry, see [Use suite retry](/docs/core/tests/tradefed/testing/through-suite/suite-retry).\n\nRun a retry session on failed parameterized tests\n-------------------------------------------------\n\nPassed parameterized tests aren't retried. To run a retry session on failed\nparameterized tests only: \n\n run retry --retry \u003cvar translate=\"no\"\u003esession_number\u003c/var\u003e --new-parameterized-handling\n\nRun individual test plans\n-------------------------\n\nInstead of running all test plans at once, you can run individual test plans.\nTo run an individual test plan:\n\n1. Identify the name of the test plan you want to run.\n\n For Android 7 and higher: \n\n list modules\n\n For Android 6 or lower: \n\n list plans\n\n2. Run the test plan:\n\n run cts --plan \u003cvar translate=\"no\"\u003etest_module_or_plan_name\u003c/var\u003e\n\n| **Note:** For a list of all CTS console commands for Android 7 and higher, see [CTS v2 command console](/compatibility/cts/command-console-v2). For a list of all CTS console commands for Android 6 or lower, see [CTS v1 command console](/compatibility/cts/command_console).\n\nImprove test execution time\n---------------------------\n\nIf you want to improve test execution time, you can shard tests across multiple\ndevices. Sharding requires the host to connect at least two devices, but six or\nmore devices are recommended for efficiency.\n\nTo shard tests on Android 9 or 10, run: \n\n run cts --shard-count \u003cvar translate=\"no\"\u003enumber_of_shards\u003c/var\u003e\n\nTo shard tests on Android 8.1 or lower, run: \n\n run cts --shards \u003cvar translate=\"no\"\u003enumber_of_shards\u003c/var\u003e\n\nRun CTS for multiscreen devices\n-------------------------------\n\nIf your device is running Android 10, and your device has multiple\nscreens, you must run the `cts-foldable` test plan separately: \n\n run cts-foldable\n\nPassed or failed test cases for alternate screen mode are appended with the\nvalue from `display_mode`, for example, `testcase1[display_mode=0]`."]]
