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

SandboxConfigUtil

public class SandboxConfigUtil
extends Object

java.lang.Object
↳	com.android.tradefed.sandbox.SandboxConfigUtil

فئة أدوات لإدارة IConfiguration عند استخدام وضع الحماية.

ملخّص

وظائف الإنشاء العامة
`SandboxConfigUtil()`

الطرق العامة
`static File`	`dumpConfigForVersion(String classpath, IRunUtil runUtil, String[] args, SandboxConfigDump.DumpCmd dump, File globalConfig)`
`static File`	`dumpConfigForVersion(File rootDir, IRunUtil runUtil, String[] args, SandboxConfigDump.DumpCmd dump, File globalConfig)` أنشئ عملية فرعية استنادًا إلى حِزم Tf من أي إصدار، وقم بتفريغ `IConfiguration` xml استنادًا إلى مَعلمات سطر الأوامر.
`static File`	`dumpConfigForVersion(String classpath, IRunUtil runUtil, String[] args, SandboxConfigDump.DumpCmd dump, File globalConfig, boolean skipJavaCheck)` أنشئ عملية فرعية استنادًا إلى حِزم Tf من أي إصدار، وقم بتفريغ `IConfiguration` xml استنادًا إلى مَعلمات سطر الأوامر.
`static File`	`dumpFilteredGlobalConfig( exclusionPatterns)` أنشئ ملفّ إعدادات عامًا يتضمّن ملف تخزين المفاتيح فقط لإتاحته في العملية الفرعية.

وظائف الإنشاء العامة

SandboxConfigUtil

public SandboxConfigUtil ()

الطرق العامة

dumpConfigForVersion

public static File dumpConfigForVersion (String classpath, 
                IRunUtil runUtil, 
                String[] args, 
                SandboxConfigDump.DumpCmd dump, 
                File globalConfig)

المعلمات
`classpath`	`String`
`runUtil`	`IRunUtil`
`args`	`String`
`dump`	`SandboxConfigDump.DumpCmd`
`globalConfig`	`File`

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

عمليات الرمي
`SandboxConfigurationException`

dumpConfigForVersion

public static File dumpConfigForVersion (File rootDir, 
                IRunUtil runUtil, 
                String[] args, 
                SandboxConfigDump.DumpCmd dump, 
                File globalConfig)

أنشئ عملية فرعية استنادًا إلى حِزم Tf من أي إصدار، وقم بتفريغ IConfiguration xml استنادًا إلى مَعلمات سطر الأوامر.

المعلمات
`rootDir`	`File`: الدليل الذي يحتوي على جميع ملفات JAR من TF
`runUtil`	‫`IRunUtil`: `IRunUtil` المراد استخدامه لتشغيل الأمر
`args`	`String`: وسيطات سطر الأوامر
`dump`	`SandboxConfigDump.DumpCmd`: `DumpCmd` يشغّل بعض النواتج.
`globalConfig`	`File`: الملف الذي يصف الإعدادات العامة المطلوب استخدامها

المرتجعات
`File`	`ERROR(/File)` يحتوي على ملف xml من سطر الأوامر

عمليات الرمي
`ConfigurationException`	إذا لم تنجح عملية التصدير

dumpConfigForVersion

public static File dumpConfigForVersion (String classpath, 
                IRunUtil runUtil, 
                String[] args, 
                SandboxConfigDump.DumpCmd dump, 
                File globalConfig, 
                boolean skipJavaCheck)

أنشئ عملية فرعية استنادًا إلى حِزم Tf من أي إصدار، وقم بتفريغ IConfiguration xml استنادًا إلى مَعلمات سطر الأوامر.

المعلمات
`classpath`	‫`String`: مسار الحِزم المطلوب استخدامه لتشغيل مساحة المحاكاة
`runUtil`	‫`IRunUtil`: `IRunUtil` المراد استخدامه لتشغيل الأمر
`args`	`String`: وسيطات سطر الأوامر
`dump`	`SandboxConfigDump.DumpCmd`: `DumpCmd` يشغّل بعض النواتج.
`globalConfig`	`File`: الملف الذي يصف الإعدادات العامة المطلوب استخدامها
`skipJavaCheck`	‫`boolean`: ما إذا كان سيتم تخطّي فحص إصدار Java أم لا

المرتجعات
`File`	`ERROR(/File)` يحتوي على ملف xml من سطر الأوامر

عمليات الرمي
`SandboxConfigurationException`	إذا لم تنجح عملية التصدير

dumpFilteredGlobalConfig

public static File dumpFilteredGlobalConfig ( exclusionPatterns)

أنشئ ملفّ إعدادات عامًا يتضمّن ملف تخزين المفاتيح فقط لإتاحته في العملية الفرعية.

المعلمات
`exclusionPatterns`

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