BluetoothUtils

public class BluetoothUtils
extends Object

java.lang.Object
   ↳ com.android.tradefed.util.BluetoothUtils

وظائف مساعدة لاستدعاء BluetoothInstrumentation على الجهاز

يمكن العثور على رمز BluetoothInstrumentation من جهة الجهاز في AOSP على الرابط: frameworks/base/core/tests/bluetoothtests

ملخّص

الثوابت

String BTSNOOP_API

String BTSNOOP_CMD

String BTSNOOP_DISABLE_CMD

String BTSNOOP_ENABLE_CMD

String GOLD_BTSNOOP_LOG_PATH

String O_BUILD

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

BluetoothUtils()

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

static void cleanLogFile(ITestDevice device)

حذف ملف سجل التطفّل من الجهاز

static boolean disable(ITestDevice device)

يؤدي إلى إيقاف البلوتوث على الجهاز المحدّد

static boolean disableBtsnoopLogging(ITestDevice device, File sl4aApkFile)

إيقاف تسجيل btsnoop من خلال طلب sl4a

static boolean disableBtsnoopLogging(ITestDevice device)

إيقاف تسجيل btsnoop من خلال طلب sl4a

static boolean enable(ITestDevice device)

تفعيل البلوتوث على الجهاز المحدّد

static boolean enableBtsnoopLogging(ITestDevice device, File sl4aApkFile)

تفعيل تسجيل btsnoop من خلال طلب sl4a

static boolean enableBtsnoopLogging(ITestDevice device)

تفعيل تسجيل btsnoop من خلال طلب sl4a

static String getBluetoothMac(ITestDevice device)

Retrieves BT mac of the given device

static Set<String> getBondedDevices(ITestDevice device)

تعرض هذه الطريقة عناوين MAC لأجهزة البلوتوث التي تم ربط الجهاز المحدّد بها

static String getBtSnoopLogFilePath(ITestDevice device)

الحصول على مسار ملف سجلّ bt snoop من ملف bt_stack.config

static String runBluetoothInstrumentation(ITestDevice device, String command)

طريقة سهلة لتنفيذ أمر أدوات BT وإرجاع الناتج

static boolean runBluetoothInstrumentationWithRetry(ITestDevice device, String command)
static boolean toggleBtsnoopLogging(Sl4aClient client, boolean onOff)
static boolean unpairWithRetry(ITestDevice device)

إعادة محاولة إلغاء إقران البلوتوث مع التراجع الخطي

static void uploadLogFiles(ITestInvocationListener listener, ITestDevice device, String type, int iteration)

تحميل ملف سجلّ التتبُّع للحصول على نتائج الاختبار

الثوابت

BTSNOOP_API

public static final String BTSNOOP_API

القيمة الثابتة: "bluetoothConfigHciSnoopLog"

BTSNOOP_CMD

public static final String BTSNOOP_CMD

Constant Value: "setprop persist.bluetooth.btsnoopenable "

BTSNOOP_DISABLE_CMD

public static final String BTSNOOP_DISABLE_CMD

Constant Value: "setprop persist.bluetooth.btsnoopenable false"

BTSNOOP_ENABLE_CMD

public static final String BTSNOOP_ENABLE_CMD

القيمة الثابتة: "setprop persist.bluetooth.btsnoopenable true"

GOLD_BTSNOOP_LOG_PATH

public static final String GOLD_BTSNOOP_LOG_PATH

القيمة الثابتة: "/data/misc/bluetooth/logs/btsnoop_hci.log"

O_BUILD

public static final String O_BUILD

Constant Value: "O"

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

BluetoothUtils

public BluetoothUtils ()

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

cleanLogFile

public static void cleanLogFile (ITestDevice device)

حذف ملف سجل التطفّل من الجهاز

المعلَمات
device ITestDevice

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

إيقاف

public static boolean disable (ITestDevice device)

يؤدي إلى إيقاف البلوتوث على الجهاز المحدّد

المرتجعات
boolean صحيح إذا تم إيقاف الميزة بنجاح، وخطأ في الحالات الأخرى
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableBtsnoopLogging

public static boolean disableBtsnoopLogging (ITestDevice device, 
                File sl4aApkFile)

إيقاف تسجيل btsnoop من خلال طلب sl4a

المعلَمات
sl4aApkFile ‫File: موقع ملف sl4a.apk، قيمة فارغة إذا تم تثبيته
المرتجعات
boolean نجاح العملية أو عدم نجاحها
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableBtsnoopLogging

public static boolean disableBtsnoopLogging (ITestDevice device)

إيقاف تسجيل btsnoop من خلال طلب sl4a

المرتجعات
boolean نجاح العملية أو عدم نجاحها
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

تفعيل

public static boolean enable (ITestDevice device)

تفعيل البلوتوث على الجهاز المحدّد

المرتجعات
boolean صحيح إذا تم تفعيل الميزة بنجاح، وخطأ في الحالات الأخرى
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableBtsnoopLogging

public static boolean enableBtsnoopLogging (ITestDevice device, 
                File sl4aApkFile)

تفعيل تسجيل btsnoop من خلال طلب sl4a

المعلَمات
sl4aApkFile ‫File: موقع ملف sl4a.apk، قيمة فارغة إذا تم تثبيته
المرتجعات
boolean نجاح العملية أو عدم نجاحها
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableBtsnoopLogging

public static boolean enableBtsnoopLogging (ITestDevice device)

تفعيل تسجيل btsnoop من خلال طلب sl4a

المرتجعات
boolean نجاح العملية أو عدم نجاحها
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBluetoothMac

public static String getBluetoothMac (ITestDevice device)

Retrieves BT mac of the given device

المرتجعات
String عنوان MAC الخاص بتقنية البلوتوث أو قيمة فارغة إذا لم يتم العثور عليه
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBondedDevices

public static Set<String> getBondedDevices (ITestDevice device)

تعرض هذه الطريقة عناوين MAC لأجهزة البلوتوث التي تم ربط الجهاز المحدّد بها

المرتجعات
Set<String> عناوين MAC للبلوتوث
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBtSnoopLogFilePath

public static String getBtSnoopLogFilePath (ITestDevice device)

الحصول على مسار ملف سجلّ bt snoop من ملف bt_stack.config

المرتجعات
String اسم ملف bt_snoop_log أو قيمة فارغة في حال عدم العثور عليه
عمليات الطرح
DeviceNotAvailableException

runBluetoothInstrumentation

public static String runBluetoothInstrumentation (ITestDevice device, 
                String command)

طريقة سهلة لتنفيذ أمر أدوات BT وإرجاع الناتج

المعلَمات
command ‫String: سلسلة أوامر يتم إرسالها إلى أدوات BT، وهي متاحة حاليًا: enable وdisable وunpairAll وgetName وgetAddress وgetBondedDevices. يُرجى الرجوع إلى مصدر AOSP لمزيد من التفاصيل
المرتجعات
String ناتج BluetoothInstrumentation
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runBluetoothInstrumentationWithRetry

public static boolean runBluetoothInstrumentationWithRetry (ITestDevice device, 
                String command)

المعلَمات
device ITestDevice

command String

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

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

toggleBtsnoopLogging

public static boolean toggleBtsnoopLogging (Sl4aClient client, 
                boolean onOff)

المعلَمات
client Sl4aClient

onOff boolean

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

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

unpairWithRetry

public static boolean unpairWithRetry (ITestDevice device)

إعادة محاولة إلغاء إقران البلوتوث مع التراجع الخطي

المرتجعات
boolean

عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

uploadLogFiles

public static void uploadLogFiles (ITestInvocationListener listener, 
                ITestDevice device, 
                String type, 
                int iteration)

تحميل ملف سجلّ التتبُّع للحصول على نتائج الاختبار

المعلَمات
listener ITestInvocationListener

device ITestDevice

type String

iteration int

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