TestDevice.MicrodroidBuilder

public static class TestDevice.MicrodroidBuilder
extends Object

java.lang.Object
   ↳ com.android.tradefed.device.TestDevice.MicrodroidBuilder


أداة إنشاء تُستخدَم لإنشاء Microdroid TestDevice.

ملخّص

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

TestDevice.MicrodroidBuilder addAssignableDevice(String sysfsNode)

تضيف هذه السمة جهازًا لتخصيصه لجهاز microdroid.

TestDevice.MicrodroidBuilder addBootFile(File localFile, String remoteFileName)

تضيف هذه السمة ملفًا سيتم إرساله إلى ERROR(/#TEST_ROOT) لتشغيل الجهاز.

TestDevice.MicrodroidBuilder addExtraIdsigPath(String extraIdsigPath)

تضيف هذه السمة ملف idsig إضافيًا إلى القائمة.

TestDevice.MicrodroidBuilder addTestDeviceOption(String optionName, String valueText)

تضبط هذه السمة TestDeviceOptions لجهاز TestDevice في microdroid.

ITestDevice build(TestDevice device)

يبدأ Micrdroid TestDevice على TestDevice المحدّد.

TestDevice.MicrodroidBuilder cpuAffinity(String affinity)

تحدّد هذه السمة وحدات المعالجة المركزية (CPU) للمضيف التي يمكن تشغيل وحدات المعالجة المركزية الافتراضية (vCPU) عليها.

TestDevice.MicrodroidBuilder cpuTopology(String cpuTopology)

يضبط هذا الإجراء إعدادات بنية وحدة المعالجة المركزية.

TestDevice.MicrodroidBuilder debugLevel(String debugLevel)

تضبط هذه السمة مستوى تصحيح الأخطاء.

TestDevice.MicrodroidBuilder dumpDt(String dumpDt)

يضبط المسار الذي سيتم فيه تفريغ ملف blob لشجرة الأجهزة.

TestDevice.MicrodroidBuilder enableEarlycon(boolean enableEarlycon)

تتيح هذه السمة سجلات earlycon للجهاز الظاهري.

TestDevice.MicrodroidBuilder forceStartAdbd(boolean forceStartAdbd)

يتم استدعاء `vm start-adbd` بشكل إلزامي بين `vm run` و `adb forward`

ملاحظة: في مستويات واجهة برمجة التطبيقات القديمة (قبل الإصدار 36 من حزمة SDK)، لا تنفّذ هذه الدالة أي عملية.

static TestDevice.MicrodroidBuilder fromDevicePath(String apkPath, String configPath)

تنشئ هذه الدالة أداة إنشاء Microdroid لمسار حزمة APK وملف إعداد الحمولة المحدّدَين في حزمة APK.

static TestDevice.MicrodroidBuilder fromDevicePathWithPayloadBinaryName(String apkPath, String payloadBinaryName)

تنشئ هذه الدالة أداة إنشاء Microdroid لمسار APK واسم الحمولة الثنائية المحدّدَين في حزمة APK.

static TestDevice.MicrodroidBuilder fromFile(File apkFile, String configPath)

تُنشئ هذه الدالة أداة إنشاء Microdroid لحزمة APK وملف إعداد الحمولة في حزمة APK المحدّدة.

TestDevice.MicrodroidBuilder gki(String version)

تم إيقاف هذه الطريقة نهائيًا. استخدِم os(String).

TestDevice.MicrodroidBuilder hugePages(boolean hintHugePages)

تحدِّد هذه السياسة ما إذا كان سيتم إرسال تلميح إلى النواة بشأن الصفحات الكبيرة الشفافة.

TestDevice.MicrodroidBuilder instanceIdFile(String instanceIdPath)

تضبط هذه السمة مسار instance_id.

TestDevice.MicrodroidBuilder instanceImgFile(String instanceImgPath)

تضبط هذه السمة مسار ملف instance.img.

TestDevice.MicrodroidBuilder memoryMib(int memoryMib)

تضبط هذه السمة مقدار ذاكرة الوصول العشوائي التي سيتم منحها للجهاز الظاهري.

TestDevice.MicrodroidBuilder name(String name)

تضبط هذه السمة اسم الجهاز الافتراضي.

TestDevice.MicrodroidBuilder numCpus(int num)

تضبط هذه السمة عدد وحدات المعالجة المركزية الافتراضية (vCPU) في الجهاز الافتراضي.

TestDevice.MicrodroidBuilder os(String os)

يستخدم إصدارًا غير تلقائي من نظام التشغيل Microdroid.

TestDevice.MicrodroidBuilder protectedVm(boolean isProtectedVm)

تحدِّد هذه السمة ما إذا كان سيتم حماية الجهاز الظاهري أم لا.

TestDevice.MicrodroidBuilder ramdump(boolean useRamdump)

تحدِّد هذه السياسة ما إذا كان سيتم إيقاف تشغيل نواة الأعطال لعمليات تفريغ ذاكرة الوصول العشوائي.

TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs(long timeoutMs)

تضبط هذه السمة المهلة المحدّدة لاتصال adb بجهاز TestDevice في microdroid بالملّي ثانية.

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

addAssignableDevice

public TestDevice.MicrodroidBuilder addAssignableDevice (String sysfsNode)

تضيف هذه السمة جهازًا لتخصيصه لجهاز microdroid.

المعلَمات
sysfsNode String: مسار عقدة sysfs المطلوب تعيينها

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء Microdroid

addBootFile

public TestDevice.MicrodroidBuilder addBootFile (File localFile, 
                String remoteFileName)

تضيف هذه السمة ملفًا سيتم إرساله إلى ERROR(/#TEST_ROOT) لتشغيل الجهاز.

استخدِم هذه الطريقة إذا كان بدء تشغيل microdroid يتطلّب ملفًا. في ما عدا ذلك، استخدِم TestDevice.pushFile.

المعلَمات
localFile File: الملف المحلي على المضيف

remoteFileName String: اسم الملف البعيد على الجهاز

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء microdroid

addExtraIdsigPath

public TestDevice.MicrodroidBuilder addExtraIdsigPath (String extraIdsigPath)

تضيف هذه السمة ملف idsig إضافيًا إلى القائمة.

المعلَمات
extraIdsigPath String

المرتجعات
TestDevice.MicrodroidBuilder

addTestDeviceOption

public TestDevice.MicrodroidBuilder addTestDeviceOption (String optionName, 
                String valueText)

تضبط هذه السمة TestDeviceOptions لجهاز TestDevice في microdroid.

المعلَمات
optionName String: اسم TestDeviceOption المطلوب ضبطه

valueText String: القيمة

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء microdroid

إنشاء

public ITestDevice build (TestDevice device)

يبدأ Micrdroid TestDevice على TestDevice المحدّد.

المعلَمات
device TestDevice

القيم المُعادة
ITestDevice

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

cpuAffinity

public TestDevice.MicrodroidBuilder cpuAffinity (String affinity)

تحدّد هذه السمة وحدات المعالجة المركزية (CPU) للمضيف التي يمكن تشغيل وحدات المعالجة المركزية الافتراضية (vCPU) عليها. التنسيق هو قائمة وحدات معالجة مركزية مفصولة بفواصل أو نطاقات وحدات معالجة مركزية لتشغيل وحدات المعالجة المركزية الافتراضية عليها، مثل "0,1-3,5" لاختيار وحدات المعالجة المركزية 0 و1 و2 و3 و5 على الجهاز المضيف. أو يمكن أن تكون هذه القيمة قائمة مفصولة بنقطتين رأسيتين لعمليات تعيين وحدة المعالجة المركزية الافتراضية لوحدة المعالجة المركزية المضيفة، مثلاً "0=0:1=1:2=2" لربط وحدة المعالجة المركزية الافتراضية 0 بوحدة المعالجة المركزية المضيفة 0، وهكذا.

لا تتوفّر هذه الميزة إلا في Android T.

المعلَمات
affinity String

المرتجعات
TestDevice.MicrodroidBuilder

cpuTopology

public TestDevice.MicrodroidBuilder cpuTopology (String cpuTopology)

تضبط هذه السمة إعدادات بنية وحدة المعالجة المركزية. القيم المسموح بها: "one_cpu" و "match_host".

المعلَمات
cpuTopology String

المرتجعات
TestDevice.MicrodroidBuilder

debugLevel

public TestDevice.MicrodroidBuilder debugLevel (String debugLevel)

تضبط هذه السمة مستوى تصحيح الأخطاء.

القيم المسموح بها: "none" و "full". يتوافق نظام التشغيل Android T أيضًا مع "app_only".

المعلَمات
debugLevel String

المرتجعات
TestDevice.MicrodroidBuilder

dumpDt

public TestDevice.MicrodroidBuilder dumpDt (String dumpDt)

يضبط المسار الذي سيتم فيه تفريغ ملف blob لشجرة الأجهزة.

القيم المسموح بها: null و "path".

المعلَمات
dumpDt String

المرتجعات
TestDevice.MicrodroidBuilder

enableEarlycon

public TestDevice.MicrodroidBuilder enableEarlycon (boolean enableEarlycon)

تتيح هذه السمة سجلات earlycon للجهاز الظاهري.

ملاحظة: في مستويات واجهة برمجة التطبيقات القديمة (قبل الإصدار 36 من حزمة SDK)، لا تنفّذ هذه الدالة أي عملية.

المعلَمات
enableEarlycon boolean

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء microdroid

forceStartAdbd

public TestDevice.MicrodroidBuilder forceStartAdbd (boolean forceStartAdbd)

يتم استدعاء `vm start-adbd` بشكل إلزامي بين `vm run` و `adb forward`

ملاحظة: في مستويات واجهة برمجة التطبيقات القديمة (قبل الإصدار 36 من حزمة SDK)، لا تنفّذ هذه الدالة أي عملية.

المعلَمات
forceStartAdbd boolean

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء microdroid

fromDevicePath

public static TestDevice.MicrodroidBuilder fromDevicePath (String apkPath, 
                String configPath)

تنشئ هذه الدالة أداة إنشاء Microdroid لمسار حزمة APK وملف إعداد الحمولة المحدّدَين في حزمة APK.

المعلَمات
apkPath String

configPath String

المرتجعات
TestDevice.MicrodroidBuilder

fromDevicePathWithPayloadBinaryName

public static TestDevice.MicrodroidBuilder fromDevicePathWithPayloadBinaryName (String apkPath, 
                String payloadBinaryName)

تنشئ هذه الدالة أداة إنشاء Microdroid لمسار APK واسم الحمولة الثنائية المحدّدَين في حزمة APK.

المعلَمات
apkPath String

payloadBinaryName String

المرتجعات
TestDevice.MicrodroidBuilder

fromFile

public static TestDevice.MicrodroidBuilder fromFile (File apkFile, 
                String configPath)

تُنشئ هذه الدالة أداة إنشاء Microdroid لحزمة APK وملف إعداد الحمولة في حزمة APK المحدّدة.

المعلَمات
apkFile File

configPath String

المرتجعات
TestDevice.MicrodroidBuilder

gki

public TestDevice.MicrodroidBuilder gki (String version)

تم إيقاف هذا الإجراء نهائيًا.
استخدِم os(String).

استخدام نواة GKI بدلاً من نواة microdroid

المعلَمات
version String: إصدار GKI المطلوب استخدامه

المرتجعات
TestDevice.MicrodroidBuilder

hugePages

public TestDevice.MicrodroidBuilder hugePages (boolean hintHugePages)

تحدِّد هذه السياسة ما إذا كان سيتم إرسال تلميح إلى النواة بشأن الصفحات الكبيرة الشفافة.

المعلَمات
hintHugePages boolean

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء Microdroid

instanceIdFile

public TestDevice.MicrodroidBuilder instanceIdFile (String instanceIdPath)

تضبط هذه السمة مسار instance_id.

المعلَمات
instanceIdPath String: : مسار instanceId

المرتجعات
TestDevice.MicrodroidBuilder

instanceImgFile

public TestDevice.MicrodroidBuilder instanceImgFile (String instanceImgPath)

تضبط هذه السمة مسار ملف instance.img.

المعلَمات
instanceImgPath String

المرتجعات
TestDevice.MicrodroidBuilder

memoryMib

public TestDevice.MicrodroidBuilder memoryMib (int memoryMib)

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

المعلَمات
memoryMib int

المرتجعات
TestDevice.MicrodroidBuilder

الاسم

public TestDevice.MicrodroidBuilder name (String name)

تضبط هذه السمة اسم الجهاز الظاهري.

المعلَمات
name String

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء microdroid

numCpus

public TestDevice.MicrodroidBuilder numCpus (int num)

تضبط هذه السمة عدد وحدات المعالجة المركزية الافتراضية (vCPU) في الجهاز الافتراضي. يكون الإعداد التلقائي بالقيمة 1.

لا تتوفّر هذه الميزة إلا في Android T.

المعلَمات
num int

المرتجعات
TestDevice.MicrodroidBuilder

os

public TestDevice.MicrodroidBuilder os (String os)

يستخدم إصدارًا غير تلقائي من نظام التشغيل Microdroid.

المعلَمات
os String: إصدار نظام التشغيل Microdroid الذي سيتم استخدامه

المرتجعات
TestDevice.MicrodroidBuilder

protectedVm

public TestDevice.MicrodroidBuilder protectedVm (boolean isProtectedVm)

تحدِّد هذه السمة ما إذا كان سيتم حماية الجهاز الظاهري أم لا.

المعلَمات
isProtectedVm boolean

المرتجعات
TestDevice.MicrodroidBuilder

ramdump

public TestDevice.MicrodroidBuilder ramdump (boolean useRamdump)

تحدِّد هذه السياسة ما إذا كان سيتم إيقاف تشغيل نواة الأعطال لعمليات تفريغ ذاكرة الوصول العشوائي.

المعلَمات
useRamdump boolean

المرتجعات
TestDevice.MicrodroidBuilder أداة إنشاء microdroid

setAdbConnectTimeoutMs

public TestDevice.MicrodroidBuilder setAdbConnectTimeoutMs (long timeoutMs)

يضبط هذا الخيار المهلة المحدّدة لاتصال adb بجهاز TestDevice في microdroid بالملّي ثانية.

يجب أن تكون هذه القيمة موجبة لتجنُّب تعليق الاختبار.

المعلَمات
timeoutMs long: المهلة بالملي ثانية

المرتجعات
TestDevice.MicrodroidBuilder