اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

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

CtsTestLauncher

public class CtsTestLauncher
extends Object implements IBuildReceiver, IConfigurationReceiver, IDeviceTest, IInvocationContextReceiver, IMetricCollectorReceiver, IRemoteTest, IShardableTest

java.lang.Object
↳	com.google.android.tradefed.testtype.CtsTestLauncher

IRemoteTest لتشغيل الاختبارات على عملية تثبيت منفصلة لحزمة CTS

يُطلق عملية Java خارجية لتشغيل الاختبارات. يُستخدم لتشغيل إصدار محدّد تم تنزيله من CTS وإعداده، وسيتم استخدام الإصدار الحالي من Tradefed الذي تم تشغيله لإكمال ملفات JAR الناقصة.

ملخّص

طُرق وضع التصميم العامة
`CtsTestLauncher()`
`CtsTestLauncher(int shardCount, int shardIndex)`

الإجراءات العامة
`String`	`buildClasspath()` تنشئ هذه السمة مسار الفئة الذي تستخدمه العملية الفرعية لتشغيل CTS
`List<String>`	`buildJavaCmd(String classpath)` تنشئ هذه السمة سطر أوامر Java الذي سيتم تنفيذه في عملية فرعية.
`String`	`getConfigName()`
`ITestDevice`	`getDevice()` احصل على الجهاز الخاضع للاختبار.
`CommandResult`	`getResult()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` تُجري الاختبارات وتُبلغ المستمع بالنتيجة.
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setConfigName(String config)`
`void`	`setConfiguration(IConfiguration configuration)` يُدرِج `IConfiguration` المستخدَم.
`void`	`setCtsVersion(int version)`
`void`	`setDevice(ITestDevice device)` أدخِل الجهاز الخاضع للاختبار.
`void`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setMetricCollectors(List<IMetricCollector> collectors)` تضبط هذه السمة قائمة `IMetricCollector` المحدّدة للتشغيل التجريبي.
`Collection<IRemoteTest>`	`split(int shardCountHint)` نسخة بديلة من `split()` توفّر أيضًا shardCount الذي تتم محاولة تنفيذه.

طُرق محمية
`IRunUtil`	`getRunUtil()`
`String`	`getSystemJava()`
`void`	`setRunAsRoot(boolean runAsRoot)`

طُرق وضع التصميم العامة

CtsTestLauncher

public CtsTestLauncher ()

CtsTestLauncher

public CtsTestLauncher (int shardCount, 
                int shardIndex)

المعلَمات
`shardCount`	`int`
`shardIndex`	`int`

الإجراءات العامة

buildClasspath

public String buildClasspath ()

تنشئ هذه السمة مسار الفئة الذي تستخدمه العملية الفرعية لتشغيل CTS

المرتجعات
`String`	سلسلة تحتوي على مسار الفئة الكامل.

عمليات الطرح
`IOException`

buildJavaCmd

public List<String> buildJavaCmd (String classpath)

تنشئ هذه السمة سطر أوامر Java الذي سيتم تنفيذه في عملية فرعية.

المعلَمات
`classpath`	‫`String`: يتطلّب مسار فئة Java لملفات JAR تشغيل CTS/XTS

المرتجعات
`List<String>`	ArrayList مع سطر الأوامر والمَعلمات في Java

عمليات الطرح
`DeviceNotAvailableException`

getConfigName

public String getConfigName ()

المرتجعات
`String`

getDevice

public ITestDevice getDevice ()

احصل على الجهاز الخاضع للاختبار.

المرتجعات
`ITestDevice`	`ITestDevice`

getResult

public CommandResult getResult ()

المرتجعات
`CommandResult`

ضربة طويلة

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

تُجري الاختبارات وتُبلغ المستمع بالنتيجة.

المعلَمات
`testInfo`	`TestInformation`: عنصر `TestInformation` يحتوي على معلومات مفيدة لتنفيذ الاختبارات.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` نتائج الاختبار

عمليات الطرح
`DeviceNotAvailableException`

setBuild

public void setBuild (IBuildInfo buildInfo)

المعلَمات
`buildInfo`	`IBuildInfo`

setConfigName

public void setConfigName (String config)

المعلَمات
`config`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

المعلَمات
`configuration`	`IConfiguration`

setCtsVersion

public void setCtsVersion (int version)

المعلَمات
`version`	`int`

setDevice

public void setDevice (ITestDevice device)

أدخِل الجهاز الخاضع للاختبار.

المعلَمات
`device`	`ITestDevice`: `ITestDevice` المطلوب استخدامه

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

المعلَمات
`invocationContext`	`IInvocationContext`

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

تضبط هذه السمة قائمة IMetricCollector المحدّدة للتشغيل التجريبي.

المعلَمات
`collectors`	`List`

تقسيم

public Collection<IRemoteTest> split (int shardCountHint)

نسخة بديلة من split() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه. ويكون ذلك مفيدًا لبعض أدوات تشغيل الاختبار التي لا يمكنها اتخاذ قرار بشكل عشوائي في بعض الأحيان.

المعلَمات
`shardCountHint`	`int`: عدد الأجزاء التي تمت محاولة إنشائها.

المرتجعات
`Collection<IRemoteTest>`	مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو `null` إذا كان الاختبار غير قابل للتجزئة حاليًا

طُرق محمية

getRunUtil

protected IRunUtil getRunUtil ()

المرتجعات
`IRunUtil`

getSystemJava

protected String getSystemJava ()

المرتجعات
`String`

setRunAsRoot

protected void setRunAsRoot (boolean runAsRoot)

المعلَمات
`runAsRoot`	`boolean`