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

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

CommandUtil

public final class CommandUtil
extends Object

java.lang.Object
↳	com.android.sts.common.CommandUtil

مجموعة من الأدوات للمساعدة في تنفيذ الأوامر على الجهاز من خلال adb

ملخّص

الطرق العامة
`static CommandResult`	`runAndCheck(ITestDevice device, String cmd, int retries)` تنفيذ أمر shell على الجهاز، ويُعرِض خطأ AssumptionError إذا لم يعرض الأمر القيمة 0.
`static CommandResult`	`runAndCheck(ITestDevice device, String cmd)` تنفيذ أمر shell على الجهاز، ويُعرِض خطأ AssumptionError إذا لم يعرض الأمر القيمة 0.

الطرق العامة

runAndCheck

public static CommandResult runAndCheck (ITestDevice device, 
                String cmd, 
                int retries)

تنفيذ أمر shell على الجهاز، ويُعرِض خطأ AssumptionError إذا لم يعرض الأمر القيمة 0.

المعلمات
`device`	`ITestDevice`: الجهاز المُستخدَم
`cmd`	`String`: الأمر المطلوب تنفيذه
`retries`	`int`: عدد مرات إعادة المحاولة التي سيتمّ إجراؤها

المرتجعات
`CommandResult`	نتيجة device.executeShellV2Command

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

runAndCheck

public static CommandResult runAndCheck (ITestDevice device, 
                String cmd)

تنفيذ أمر shell على الجهاز، ويُعرِض خطأ AssumptionError إذا لم يعرض الأمر القيمة 0.

المعلمات
`device`	`ITestDevice`: الجهاز المُستخدَم
`cmd`	`String`: الأمر المطلوب تنفيذه

المرتجعات
`CommandResult`	نتيجة device.executeShellV2Command

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