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

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

GoogleTradefedSandbox

public class GoogleTradefedSandbox
extends TradefedSandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox
	↳	com.google.android.tradefed.sandbox.GoogleTradefedSandbox

التخصّص الداخلي TradefedSandbox الذي سيتم استخدامه في البنية الأساسية للمختبر يجب أن يلبّي هذا العنوان حاجة التنزيل للنسخة المناسبة المرتبطة بالإصدار. قد نتمكّن من نقل هذه الميزة إلى "مشروع Android المفتوح المصدر" (AOSP) إذا تمكّنا في يوم من الأيام من الاعتماد على واجهة برمجة التطبيقات AOSP API لتنزيل الإصدارات.

ملخّص

طُرق وضع التصميم العامة
`GoogleTradefedSandbox()`

الإجراءات العامة
`String`	`createClasspath(File workingDir)` لا يستخدم Google Tradefed Sandbox سوى ملفات jar داخل دليل العمل.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` تم قطع اتصال الوضع الخاص بالتنفيذ الرئيسي: عندما لا يظهر إعداد في العنصر الرئيسي، نعود إلى المشغّل البسيط حيث نحاول إعداد وضع الحماية باستخدام المعلومات المعروفة حاليًا وملء دليل العمل لإنشاء الإعداد بالكامل في الدليل الذي يتضمّن إصدارًا.
`Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger)`
`IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)`
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`void`	`tearDown()` نظِّف أي حالات أو ملفات أو بيئة ربما تم تغييرها.

طُرق محمية
`File`	`dumpGlobalConfig(IConfiguration config, Set<String> exclusionPatterns)` تفريغ الإعدادات العامة التي تمّت فلترتها من بعض العناصر
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` إعداد `IInvocationContext` وتسلسله

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

GoogleTradefedSandbox

public GoogleTradefedSandbox ()

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

createClasspath

public String createClasspath (File workingDir)

لا يستخدم Google Tradefed Sandbox سوى ملفات jar داخل دليل العمل.

المعلَمات
`workingDir`	‫`File`: دليل العمل الحالي لوضع الحماية

المرتجعات
`String`	تمثّل هذه السمة مسار الفئة المطلوب استخدامه.

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

createThinLauncherConfig

public IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

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

المعلَمات
`args`	‫`String`: وسيطات سطر الأوامر الأصلية
`keyStoreClient`	`IKeyStoreClient`: عميل ملف تخزين المفاتيح الحالي الذي سيتم استخدامه لإنشاء عمليات الإعداد.
`runUtil`	‫`IRunUtil`: `IRunUtil` الحالي لتنفيذ أوامر المضيف
`globalConfig`	`File`: الإعداد العام الذي سيتم استخدامه لتشغيل العمليات الفرعية في TF.

المرتجعات
`IConfiguration`	ملف يشير إلى XML الخاص بإعدادات TF للعناصر NON_VERSIONED تعرِض هذه الدالة قيمة فارغة إذا تعذّر إنشاء إعدادات مشغّل التطبيقات الخفيف.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger)

المعلَمات
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`

المرتجعات
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

المعلَمات
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`args`	`String`

القيم المُعادة
`IFolderBuildInfo`

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

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

المعلَمات
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

القيم المُعادة
`File`

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

tearDown

public void tearDown ()

نظِّف أي حالات أو ملفات أو بيئة ربما تم تغييرها.

طُرق محمية

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

تفريغ الإعدادات العامة التي تمّت فلترتها من بعض العناصر

المعلَمات
`config`	`IConfiguration`
`exclusionPatterns`	`Set`

القيم المُعادة
`File`

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

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

إعداد IInvocationContext وتسلسله

المعلَمات
`context`	`IInvocationContext`: `IInvocationContext` المطلوب إعداده
`config`	`IConfiguration`: `IConfiguration` وضع الحماية

المرتجعات
`File`	`IInvocationContext` الذي تم تحويله إلى سلسلة

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