أبيوم

getAppiumContext

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getAppiumContext()

النتائج

• <Context> context: سلسلة نصية تمثل السياق الحالي أو null تمثل 'لا يوجد سياق'

---

switchAppiumContext

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.switchAppiumContext(name)

المعلمات

الاسم	النوع	التفاصيل
name	string	سلسلة نصية تمثل سياقًا متاحًا

---

getAppiumContexts

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getAppiumContexts()

النتائج

• <Context[]> contexts: مصفوفة من السلاسل النصية التي تمثل السياقات المتاحة، مثل 'WEBVIEW'، أو 'NATIVE'

---

shake

قم بإجراء حركة اهتزاز على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.shake()

الدعم

---

lock

قفل الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.lock(seconds)

المعلمات

الاسم	النوع	التفاصيل
seconds اختياري	number	المدة التي يتم فيها قفل الشاشة (iOS فقط)

الدعم

---

unlock

فتح قفل الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.unlock()

الدعم

---

isLocked

التحقق مما إذا كان الجهاز مقفلًا أم لا.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.isLocked()

النتائج

• <boolean> isLocked: يعود True إذا كان الجهاز مقفلاً، وfalse إذا لم يكن كذلك

الدعم

---

startRecordingScreen

بدء تسجيل الشاشة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.startRecordingScreen(options)

المعلمات

الاسم	النوع	التفاصيل
options اختياري	object	معلمات الأمر التي يمكن أن تحتوي على مفاتيح مثل: remotePath, username, password, method, forceRestart, timeLimit, videoType, videoQuality, videoFps, bitRate, videoSize, bugReport (انظر المزيد من الوصف في وثائق Appium)

الدعم

---

stopRecordingScreen

إيقاف تسجيل الشاشة

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.stopRecordingScreen(remotePath, username, password, method)

المعلمات

الاسم	النوع	التفاصيل
remotePath اختياري	string	المسار إلى الموقع البعيد الذي ينبغي رفع الفيديو الناتج إليه. البروتوكولات المدعومة هي http/https، ftp. هذا الخيار له تأثير فقط إذا كانت هناك عملية تسجيل للشاشة قيد التقدم ولم يتم تعيين معلمة forceRestart إلى true. القيمة الفارغة أو سلسلة فارغة (الإعداد الافتراضي) تعني أنه يجب ترميز محتوى الملف الناتج بتنسيق Base64.
username اختياري	string	اسم المستخدم للمصادقة عن بُعد.
password اختياري	string	كلمة المرور للمصادقة عن بُعد.
method اختياري	string	اسم طريقة تحميل HTTP متعددة الأجزاء. يتم استخدام 'PUT' بشكل افتراضي.

النتائج

• <string> response: سلسلة مشفرة بتنسيق Base64. إذا تم تعيين remote_path، فإن الاستجابة تكون سلسلة فارغة

الدعم

---

getPerformanceDataTypes

إرجاع أنواع المعلومات لحالة النظام المدعومة للقراءة مثل وحدة المعالجة المركزية (cpu)، والذاكرة (memory)، وحركة الشبكة (network traffic)، والبطارية (battery).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getPerformanceDataTypes()

النتائج

• <string[]> performanceTypes: أنواع بيانات الأداء المتاحة (cpuinfo|batteryinfo|networkinfo|memoryinfo)

الدعم

---

getPerformanceData

إرجاع معلومات حالة النظام المدعومة للقراءة مثل وحدة المعالجة المركزية (cpu)، والذاكرة (memory)، وحركة الشبكة (network traffic)، والبطارية (battery).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getPerformanceData(packageName, dataType, dataReadTimeout)

المعلمات

الاسم	النوع	التفاصيل
packageName	string	اسم حزمة التطبيق
dataType	string	نوع حالة النظام الذي تريد قراءته. يجب أن يكون واحدًا من أنواع بيانات الأداء المدعومة
dataReadTimeout اختياري	number	عدد محاولات القراءة

النتائج

• <string[]> performanceData: نوع المعلومات لحالة النظام المدعومة للقراءة مثل وحدة المعالجة المركزية (cpu)، والذاكرة (memory)، وحركة الشبكة (network traffic)، والبطارية (battery)

الدعم

---

pressKeyCode

اضغط على مفتاح معين على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.pressKeyCode(keycode, metastate, flags)

المعلمات

الاسم	النوع	التفاصيل
keycode	number	رمز المفتاح للضغط عليه
metastate اختياري	number	حالة ميتا للضغط على رمز المفتاح معها
flags اختياري	number	أعلام للضغط على المفتاح

الدعم

---

longPressKeyCode

اضغط باستمرار على رمز مفتاح معين على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.longPressKeyCode(keycode, metastate, flags)

المعلمات

الاسم	النوع	التفاصيل
keycode	number	رمز المفتاح للضغط عليه على الجهاز
metastate اختياري	number	حالة ميتا للضغط على المفتاح
flags اختياري	number	أعلام للضغط على المفتاح

الدعم

---

sendKeyEvent

أرسل رمز مفتاح إلى الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.sendKeyEvent(keycode, metastate)

المعلمات

الاسم	النوع	التفاصيل
keycode	string	رمز المفتاح للضغط عليه
metastate اختياري	string	حالة ميتا للضغط على رمز المفتاح معها

الدعم

---

rotateDevice

قم بتدوير الجهاز في ثلاثة أبعاد.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.rotateDevice(x, y, z)

المعلمات

الاسم	النوع	التفاصيل
x	number	إزاحة x للاستخدام كمركز لإيماءة الدوران
y	number	إزاحة y للاستخدام كمركز لإيماءة الدوران
z	number	إزاحة z للاستخدام كمركز لإيماءة الدوران

الدعم

---

getCurrentActivity

احصل على اسم النشاط الحالي لأندرويد.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getCurrentActivity()

النتائج

• <string> activity: اسم النشاط الحالي

الدعم

---

getCurrentPackage

احصل على اسم حزمة أندرويد الحالية.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getCurrentPackage()

النتائج

• <string> package: اسم الحزمة الحالية

الدعم

---

installApp

قم بتثبيت التطبيق المحدد على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.installApp(appPath)

المعلمات

الاسم	النوع	التفاصيل
appPath	string	المسار إلى ملف التطبيق .apk

الدعم

---

activateApp

تنشيط التطبيق المحدد على الجهاز

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.activateApp(appId)

المعلمات

الاسم	النوع	التفاصيل
appId	string	معرف التطبيق (معرف الحزمة لأندرويد، معرف الحزمة لـ iOS)

الدعم

---

removeApp

إزالة تطبيق من الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.removeApp(appId)

المعلمات

الاسم	النوع	التفاصيل
appId	string	معرف التطبيق (معرف الحزمة لأندرويد، معرف الحزمة لـ iOS)

الدعم

---

terminateApp

إنهاء التطبيق المحدد على الجهاز

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.terminateApp(appId, options)

المعلمات

الاسم	النوع	التفاصيل
appId	string	معرف التطبيق (معرف الحزمة لأندرويد، معرف الحزمة لـ iOS)
options اختياري	object	خيارات الأمر. مثلاً "timeout": (أندرويد فقط) مهلة لإعادة محاولة إنهاء التطبيق (انظر المزيد في وثائق Appium)

الدعم

---

isAppInstalled

تحقق مما إذا كان التطبيق المحدد مثبتًا على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.isAppInstalled(appId)

المعلمات

الاسم	النوع	التفاصيل
appId	string	معرف التطبيق (معرف الحزمة لأندرويد، معرف الحزمة لـ iOS)

النتائج

• <boolean> isAppInstalled: تعيد true إذا كان مثبتًا، وfalse إذا لم يكن كذلك

الدعم

---

queryAppState

الحصول على حالة التطبيق المحدد على الجهاز

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.queryAppState(appId)

المعلمات

الاسم	النوع	التفاصيل
appId	string	معرف التطبيق (معرف الحزمة لأندرويد، معرف الحزمة لـ iOS)

النتائج

• <number> appStatus: 0 يعني غير مثبت. 1 يعني غير مشغل. 2 يعني يعمل في الخلفية أو معلق. 3 يعني يعمل في الخلفية. 4 يعني يعمل في المقدمة

الدعم

---

hideKeyboard

إخفاء لوحة المفاتيح الظاهرة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.hideKeyboard(strategy, key, keyCode, keyName)

المعلمات

الاسم	النوع	التفاصيل
strategy اختياري	string	استراتيجية إخفاء لوحة المفاتيح (UIAutomation فقط)، الاستراتيجيات المتاحة - 'press', 'pressKey', 'swipeDown', 'tapOut', 'tapOutside', 'default'
key اختياري	string	قيمة المفتاح إذا كانت الاستراتيجية هي 'pressKey'
keyCode اختياري	string	رمز المفتاح إذا كانت الاستراتيجية هي 'pressKey'
keyName اختياري	string	اسم المفتاح إذا كانت الاستراتيجية هي 'pressKey'

الدعم

---

isKeyboardShown

ما إذا كانت لوحة المفاتيح الظاهرة معروضة أم لا.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.isKeyboardShown()

النتائج

• <boolean> isKeyboardShown: True إذا كانت لوحة المفاتيح معروضة

الدعم

---

pushFile

وضع ملف على الجهاز في مكان معين.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.pushFile(path, data)

المعلمات

الاسم	النوع	التفاصيل
path	string	المسار لتثبيت البيانات فيه
data	string	محتويات الملف في تنسيق base64

الدعم

---

pullFile

استرجاع ملف من نظام ملفات الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.pullFile(path)

المعلمات

الاسم	النوع	التفاصيل
path	string	المسار على الجهاز لسحب الملف منه

النتائج

• <string> response: محتويات الملف في تنسيق base64

الدعم

---

pullFolder

استرجاع مجلد من نظام ملفات الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.pullFolder(path)

المعلمات

الاسم	النوع	التفاصيل
path	string	المسار إلى مجلد كامل على الجهاز

الدعم

---

toggleAirplaneMode

تبديل وضع الطيران على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.toggleAirplaneMode()

الدعم

---

toggleData

تبديل حالة خدمة البيانات.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.toggleData()

الدعم

---

toggleWiFi

تبديل حالة خدمة WiFi.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.toggleWiFi()

الدعم

---

toggleLocationServices

تبديل حالة خدمة الموقع.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.toggleLocationServices()

الدعم

---

toggleNetworkSpeed

ضبط سرعة الشبكة (محاكي فقط)

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.toggleNetworkSpeed(netspeed)

المعلمات

الاسم	النوع	التفاصيل
netspeed	string	نوع الشبكة - 'full','gsm', 'edge', 'hscsd', 'gprs', 'umts', 'hsdpa', 'lte', 'evdo'

الدعم

---

openNotifications

فتح إشعارات أندرويد (محاكي فقط).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.openNotifications()

الدعم

---

startActivity

بدء نشاط أندرويد من خلال توفير اسم الحزمة واسم النشاط.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.startActivity(appPackage, appActivity, appWaitPackage, appWaitActivity, intentAction, intentCategory, intentFlags, optionalIntentArguments, dontStopAppOnReset)

المعلمات

الاسم	النوع	التفاصيل
appPackage	string	اسم التطبيق
appActivity	string	اسم النشاط
appWaitPackage اختياري	string	اسم التطبيق للانتظار له
appWaitActivity اختياري	string	اسم النشاط للانتظار له
intentAction=android.intent.action.MAIN اختياري	string	إجراء القصد الذي سيتم استخدامه لبدء النشاط
intentCategory=android.intent.category.LAUNCHER اختياري	string	فئة القصد التي سيتم استخدامها لبدء النشاط
intentFlags=0x10200000 اختياري	string	العلامات التي سيتم استخدامها لبدء النشاط
optionalIntentArguments اختياري	string	وسيطات القصد الإضافية التي سيتم استخدامها لبدء النشاط
dontStopAppOnReset اختياري	string	لا يوقف عملية التطبيق قيد الاختبار، قبل بدء التطبيق باستخدام adb

الدعم

---

getSystemBars

استرجاع معلومات الظهور والحدود لشريط الحالة وشريط التنقل.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getSystemBars()

النتائج

• <object[]> systemBars: معلومات حول ظهور وحدود شريط الحالة وشريط التنقل

الدعم

---

getDeviceTime

الحصول على الوقت على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getDeviceTime()

النتائج

• <string> time: الوقت على الجهاز

الدعم

---

getDisplayDensity

الحصول على كثافة العرض من الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getDisplayDensity()

النتائج

• <*>

الدعم

---

touchId

محاكاة حدث touch id (محاكي iOS فقط). لتمكين هذه الميزة، يجب تعيين قدرة allowTouchIdEnroll إلى true ويجب تسجيل المحاكي. عندما تقوم بتعيين allowTouchIdEnroll إلى true، فإنه سيقوم بتسجيل المحاكي بشكل افتراضي. يمكن تبديل حالة التسجيل. هذا الاستدعاء سيعمل فقط إذا كانت عملية Appium أو تطبيقها الأصلي (مثل Terminal.app أو Appium.app) لديها حق الوصول إلى إمكانية وصول Mac OS في تفضيلات النظام > الأمان والخصوصية > الخصوصية > إمكانية الوصول.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchId(match)

المعلمات

الاسم	النوع	التفاصيل
match	boolean	هل نحن نحاكي لمسة ناجحة (true) أم لمسة فاشلة (false)

الدعم

---

toggleEnrollTouchId

تبديل حالة تسجيل المحاكي المسجل لقبول touchId (محاكي iOS فقط). لتمكين هذه الميزة، يجب تعيين قدرة allowTouchIdEnroll إلى true. عندما يتم تعيين allowTouchIdEnroll إلى true، فإن المحاكي سيكون مسجلاً بشكل افتراضي، و'تبديل تسجيل Touch ID' يغير حالة التسجيل. هذا الاستدعاء سيعمل فقط إذا كانت عملية Appium أو تطبيقها الأصلي (مثلاً، Terminal.app أو Appium.app) لديه حق الوصول إلى إمكانية وصول Mac OS في تفضيلات النظام > الأمان والخصوصية > الخصوصية > إمكانية الوصول.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.toggleEnrollTouchId(enabled)

المعلمات

الاسم	النوع	التفاصيل
enabled=true اختياري	boolean	يساوي true إذا كان يجب تمكين تسجيل TouchID

الدعم

---

launchApp

تشغيل تطبيق على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

تنبيه

أمر البروتوكول هذا مهمل
بالنسبة لنظام iOS، استخدم driver.execute('mobile: launchApp', { ... })، وبالنسبة لنظام Android، استخدم driver.execute('mobile: activateApp', { ... }).

الاستخدام

driver.launchApp()

الدعم

---

closeApp

إغلاق تطبيق على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

تنبيه

أمر البروتوكول هذا مهمل
استخدم driver.execute('mobile: terminateApp', { ... }) بدلاً من ذلك

الاستخدام

driver.closeApp()

الدعم

---

background

إرسال التطبيق الذي يعمل حالياً لهذه الجلسة إلى الخلفية.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

تنبيه

أمر البروتوكول هذا مهمل
استخدم driver.execute('mobile: backgroundApp', { ... }) بدلاً من ذلك

الاستخدام

driver.background(seconds)

المعلمات

الاسم	النوع	التفاصيل
seconds=null	number, null	مهلة لاستعادة التطبيق، إذا كانت 'null' فلن تتم استعادة التطبيق

الدعم

---

endCoverage

الحصول على بيانات تغطية الاختبار.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.endCoverage(intent, path)

المعلمات

الاسم	النوع	التفاصيل
intent	string	القصد للبث
path	string	المسار إلى ملف .ec

الدعم

---

getStrings

الحصول على سلاسل التطبيق.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getStrings(language, stringFile)

المعلمات

الاسم	النوع	التفاصيل
language اختياري	string	رمز اللغة
stringFile اختياري	string	المسار إلى ملف السلاسل

النتائج

• <object> appStrings: جميع السلاسل المعرفة من تطبيق للغة المحددة واسم ملف السلاسل

الدعم

---

setValueImmediate

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.setValueImmediate(elementId, text)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف العنصر الذي تم إرجاعه في مكالمة سابقة لـ Find Element(s)
text	string	النص المراد تعيينه للعنصر

الدعم

---

replaceValue

استبدال القيمة في العنصر مباشرة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.replaceValue(elementId, value)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف العنصر الذي تم إرجاعه في مكالمة سابقة لـ Find Element(s)
value	string	القيمة المراد استبدالها في العنصر

الدعم

---

getSettings

استرجاع الإعدادات الحالية على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getSettings()

النتائج

• <object> settings: JSON بجميع الإعدادات المحددة حالياً، انظر واجهة برمجة تطبيقات الإعدادات

الدعم

---

updateSettings

تحديث الإعدادات الحالية على الجهاز.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.updateSettings(settings)

المعلمات

الاسم	النوع	التفاصيل
settings	object	كائن مفتاح/قيمة مع الإعدادات المراد تحديثها

الدعم

---

receiveAsyncResponse

رد عنوان URL للتنفيذ غير المتزامن لـ JavaScript.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.receiveAsyncResponse(response)

المعلمات

الاسم	النوع	التفاصيل
response	object	الرد لتلقيه على الجهاز

الدعم

---

gsmCall

إجراء مكالمة GSM (محاكي فقط).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.gsmCall(phoneNumber, action)

المعلمات

الاسم	النوع	التفاصيل
phoneNumber	string	رقم الهاتف للاتصال به
action	string	الإجراء - 'call', 'accept', 'cancel', 'hold'

الدعم

---

gsmSignal

ضبط قوة إشارة GSM (محاكي فقط).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.gsmSignal(signalStrength, signalStrengh)

المعلمات

الاسم	النوع	التفاصيل
signalStrength	string	قوة الإشارة في النطاق [0, 4]
signalStrengh اختياري	string	قوة الإشارة في النطاق [0, 4]. يرجى أيضًا تعيين هذه المعلمة بنفس القيمة إذا كنت تستخدم Appium v1.11.0 أو أقل (انظر https://github.com/appium/appium/issues/12234).

الدعم

---

powerCapacity

ضبط نسبة البطارية (محاكي فقط).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.powerCapacity(percent)

المعلمات

الاسم	النوع	التفاصيل
percent	number	قيمة النسبة المئوية في النطاق [0, 100]

الدعم

---

powerAC

ضبط حالة شاحن البطارية إلى متصل أو غير متصل (محاكي فقط).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.powerAC(state)

المعلمات

الاسم	النوع	التفاصيل
state	string	ضبط الحالة. on أو off

الدعم

---

gsmVoice

ضبط حالة صوت GSM (محاكي فقط).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.gsmVoice(state)

المعلمات

الاسم	النوع	التفاصيل
state	string	حالة صوت GSM - 'unregistered', 'home', 'roaming', 'searching', 'denied', 'off', 'on'

الدعم

---

sendSms

محاكاة رسالة SMS (محاكي فقط).

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.sendSms(phoneNumber, message)

المعلمات

الاسم	النوع	التفاصيل
phoneNumber	string	رقم الهاتف لإرسال الرسالة القصيرة إليه
message	string	رسالة SMS

الدعم

---

fingerPrint

المصادقة على المستخدمين باستخدام مسح بصمات أصابعهم على المحاكيات المدعومة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.fingerPrint(fingerprintId)

المعلمات

الاسم	النوع	التفاصيل
fingerprintId	number	بصمات الأصابع المخزنة في نظام مخزن مفاتيح Android (من 1 إلى 10)

الدعم

---

setClipboard

ضبط محتوى الحافظة النظامية

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.setClipboard(content, contentType, label)

المعلمات

الاسم	النوع	التفاصيل
content	string	محتوى الحافظة الفعلي المشفر بتنسيق base64
contentType اختياري	string	نوع المحتوى للحصول عليه. Plaintext، Image، URL. يدعم Android النص العادي فقط
label اختياري	string	تسمية بيانات الحافظة لنظام Android

النتائج

• <string> response: الرد من خادم Appium

الدعم

---

getClipboard

الحصول على محتوى الحافظة النظامية

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getClipboard(contentType)

المعلمات

الاسم	النوع	التفاصيل
contentType اختياري	string	نوع المحتوى للحصول عليه. Plaintext، Image، URL. يدعم Android النص العادي فقط

النتائج

• <string> response: محتوى الحافظة كسلسلة مشفرة بالنظام الأساسي 64 أو سلسلة فارغة إذا كانت الحافظة فارغة

الدعم

---

touchPerform

هذه الوظيفة متاحة فقط من داخل السياق الأصلي. يعمل 'Touch Perform' بشكل مشابه لتفاعلات اللمس الفردية الأخرى، باستثناء أن هذا يسمح لك بربط أكثر من إجراء لمس واحد معًا كأمر واحد. هذا مفيد لأن أوامر Appium يتم إرسالها عبر الشبكة وهناك تأخير بين الأوامر. يمكن أن يجعل هذا التأخير بعض تفاعلات اللمس مستحيلة لأن بعض التفاعلات تحتاج إلى أن تتم في تسلسل واحد. على سبيل المثال، يتطلب السحب الرأسي الضغط لأسفل، والانتقال إلى إحداثي y مختلف، ثم التحرير. لكي يعمل، لا يمكن أن يكون هناك تأخير بين التفاعلات.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchPerform(actions)

المعلمات

الاسم	النوع	التفاصيل
actions	object[]	نوع الإجراء المراد تنفيذه (مثل moveTo، release، press، tap، wait)

مثال

// do a horizontal swipe by percentage
const startPercentage = 10;
const endPercentage = 90;
const anchorPercentage = 50;

const { width, height } = driver.getWindowSize();
const anchor = height * anchorPercentage / 100;
const startPoint = width * startPercentage / 100;
const endPoint = width * endPercentage / 100;
driver.touchPerform([
  {
    action: 'press',
    options: {
      x: startPoint,
      y: anchor,
    },
  },
  {
    action: 'wait',
    options: {
      ms: 100,
    },
  },
  {
    action: 'moveTo',
    options: {
      x: endPoint,
      y: anchor,
    },
  },
  {
    action: 'release',
    options: {},
  },
]);

الدعم

---

multiTouchPerform

هذه الوظيفة متاحة فقط داخل سياق أصلي. قم بتنفيذ تسلسل إجراءات اللمس المتعدد.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.multiTouchPerform(actions)

المعلمات

الاسم	النوع	التفاصيل
actions	object[]	نوع الإجراء المراد تنفيذه (مثل moveTo، release، press، tap، wait)

الدعم

---

executeDriverScript

يتيح لك هذا الأمر تحديد سكريبت WebdriverIO كسلسلة نصية ونقله إلى خادم Appium للتنفيذ المحلي على الخادم نفسه. يساعد هذا النهج في تقليل التأخير المحتمل المرتبط بكل أمر. لاستخدام هذا الأمر مع Appium 2.0، يجب أن يكون لديك مكون execute-driver-plugin مثبتًا.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.executeDriverScript(script, type, timeout)

المعلمات

الاسم	النوع	التفاصيل
script	string	السكريبت المراد تنفيذه. لديه وصول إلى كائن 'driver' الذي يمثل جلسة WebdriverIO متصلة بالخادم الحالي.
type اختياري	string	اللغة/الإطار المستخدم في السكريبت. حاليًا، يتم دعم 'webdriverio' فقط وهو الافتراضي.
timeout اختياري	number	عدد الميلي ثانية التي يجب أن يُسمح للسكريبت بالتشغيل قبل أن يتم إيقافه بواسطة خادم Appium. الافتراضي هو ما يعادل ساعة واحدة.

النتائج

• <object> result: كائن يحتوي على حقلين: 'result'، وهو القيمة المرجعة للسكريبت نفسه، و'logs'، الذي يحتوي على 3 حقول داخلية، 'log'، 'warn'، و'error'، والتي تحتوي على مصفوفة من السلاسل النصية التي تم تسجيلها بواسطة console.log، console.warn، و console.error في تنفيذ السكريبت.

---

getEvents

الحصول على الأحداث المخزنة في خادم appium.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getEvents(type)

المعلمات

الاسم	النوع	التفاصيل
type	string[]	الحصول على الأحداث التي تمت تصفيتها بالنوع إذا تم توفير النوع.

النتائج

• <object> result: تجزئة JSON للأحداث مثل {'commands' => [{'cmd' => 123455, ....}], 'startTime' => 1572954894127, }.

الدعم

---

logEvent

تخزين حدث مخصص.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.logEvent(vendor, event)

المعلمات

الاسم	النوع	التفاصيل
vendor	string	اسم البائع. سيكون 'vendor' في 'vendor:event'.
event	string	اسم الحدث. سيكون 'event' في 'vendor:event'.

الدعم

---

compareImages

تقوم هذه الميزة بإجراء مقارنات للصور باستخدام إمكانيات إطار OpenCV. يرجى ملاحظة أنه لكي تعمل هذه الوظيفة، يجب تثبيت كل من إطار OpenCV ووحدة opencv4nodejs على الجهاز الذي يعمل عليه خادم Appium. علاوة على ذلك، ستحتاج إلى تثبيت مكون images-plugin لاستخدام هذه الميزة مع Appium 2.0.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.compareImages(mode, firstImage, secondImage, options)

المعلمات

الاسم	النوع	التفاصيل
mode=matchFeatures	string	واحد من أوضاع المقارنة الممكنة: 'matchFeatures'، 'getSimilarity'، 'matchTemplate'. 'matchFeatures' هو الافتراضي.
firstImage	string	بيانات الصورة. يتم دعم جميع تنسيقات الصور التي تقبلها مكتبة OpenCV نفسها.
secondImage	string	بيانات الصورة. يتم دعم جميع تنسيقات الصور التي تقبلها مكتبة OpenCV نفسها.
options=[object Object]	object	يعتمد محتوى هذا القاموس على قيمة mode الفعلية. انظر الوثائق على وحدة appium-support للحصول على مزيد من التفاصيل.

النتائج

• <object> result: يعتمد محتوى القاموس الناتج على قيم mode و options الفعلية. انظر الوثائق على وحدة appium-support للحصول على مزيد من التفاصيل.

---

implicitWait

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

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.implicitWait(ms)

المعلمات

الاسم	النوع	التفاصيل
ms	number	مقدار الوقت، بالمللي ثانية، للانتظار على عنصر.

الدعم

---

getLocationInView

تحديد موقع العنصر على الشاشة بمجرد تمرير الشاشة لعرضه.

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

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getLocationInView(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف العنصر الذي سيتم توجيه الأمر إليه

النتائج

• <Object> location: إحداثيات X و Y للعنصر على الصفحة.

الدعم

---

sendKeys

إرسال تسلسل ضربات المفاتيح إلى العنصر النشط

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.sendKeys(value)

المعلمات

الاسم	النوع	التفاصيل
value	string[]	تسلسل المفاتيح لكتابته. يجب توفير مصفوفة.

الدعم

---

availableIMEEngines

سرد جميع المحركات المتاحة على الجهاز. لاستخدام محرك، يجب أن يكون موجودًا في هذه القائمة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.availableIMEEngines()

النتائج

• <String[]> engines: قائمة المحركات المتاحة

الدعم

---

getActiveIMEEngine

الحصول على اسم محرك IME النشط. سلسلة الاسم خاصة بالمنصة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getActiveIMEEngine()

النتائج

• <String> engine: اسم محرك IME النشط

الدعم

---

isIMEActivated

يشير إلى ما إذا كان إدخال IME نشطًا في الوقت الحالي

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.isIMEActivated()

النتائج

• <Boolean> isActive: true إذا كان إدخال IME متاحًا ونشطًا حاليًا، false في غير ذلك

الدعم

---

deactivateIMEEngine

يقوم بإلغاء تنشيط محرك IME النشط حاليًا.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.deactivateIMEEngine()

الدعم

---

activateIMEEngine

جعل المحرك متاحًا

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.activateIMEEngine(engine)

المعلمات

الاسم	النوع	التفاصيل
engine	string	اسم المحرك لتنشيطه

الدعم

---

asyncScriptTimeout

ضبط المدة، بالمللي ثانية، التي يُسمح للنصوص البرمجية غير المتزامنة التي يتم تنفيذها بواسطة /session/:sessionId/execute_async بالتشغيل قبل إلغائها وإرجاع خطأ Timeout إلى العميل.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.asyncScriptTimeout(ms)

المعلمات

الاسم	النوع	التفاصيل
ms	number	مقدار الوقت، بالمللي ثانية، الذي يُسمح للأوامر محدودة الوقت بالتشغيل

الدعم

---

submit

إرسال عنصر نموذج.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.submit(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر النموذج المراد إرساله

الدعم

---

getElementSize

تحديد حجم العنصر بالبكسل. سيتم إرجاع الحجم ككائن JSON مع خصائص width و height.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getElementSize(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف العنصر الذي سيتم توجيه الأمر إليه

النتائج

• <Object> size: عرض وارتفاع العنصر، بالبكسل.

الدعم

---

getElementLocation

تحديد موقع العنصر على الصفحة. تشير النقطة (0, 0) إلى الزاوية العلوية اليسرى من الصفحة. يتم إرجاع إحداثيات العنصر ككائن JSON بخصائص x و y.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getElementLocation(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف العنصر الذي سيتم توجيه الأمر إليه

النتائج

• <Object> location: إحداثيات X و Y للعنصر على الصفحة.

الدعم

---

touchClick

نقرة واحدة على الجهاز الذي يدعم اللمس.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchClick(element)

المعلمات

الاسم	النوع	التفاصيل
element	string	معرف العنصر للنقر عليه مرة واحدة.

الدعم

---

touchDown

الإصبع لأسفل على الشاشة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchDown(x, y)

المعلمات

الاسم	النوع	التفاصيل
x	number	إحداثي x على الشاشة
y	number	إحداثي y على الشاشة

الدعم

---

touchUp

الإصبع لأعلى على الشاشة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchUp(x, y)

المعلمات

الاسم	النوع	التفاصيل
x	number	إحداثي x على الشاشة
y	number	إحداثي y على الشاشة

الدعم

---

touchMove

تحريك الإصبع على الشاشة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchMove(x, y)

المعلمات

الاسم	النوع	التفاصيل
x	number	إحداثي x على الشاشة
y	number	إحداثي y على الشاشة

الدعم

---

touchLongClick

الضغط المطول على شاشة اللمس باستخدام أحداث حركة الإصبع.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchLongClick(element)

المعلمات

الاسم	النوع	التفاصيل
element	string	معرف العنصر للضغط المطول عليه

الدعم

---

touchFlick

النقر على شاشة اللمس باستخدام أحداث حركة الإصبع. يبدأ أمر النقر هذا في موقع معين على الشاشة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.touchFlick(xoffset, yoffset, element, speed, xspeed, yspeed)

المعلمات

الاسم	النوع	التفاصيل
xoffset اختياري	number	إزاحة x بالبكسل للنقر بها
yoffset اختياري	number	إزاحة y بالبكسل للنقر بها
element اختياري	string	معرف العنصر الذي يبدأ منه النقر
speed اختياري	number	السرعة بالبكسل في الثانية
xspeed اختياري	number	سرعة x بالبكسل في الثانية
yspeed اختياري	number	سرعة y بالبكسل في الثانية

الدعم

---

getOrientation

الحصول على اتجاه الجهاز الحالي.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getOrientation()

النتائج

• <String> orientation: الاتجاه الحالي المطابق لقيمة محددة في ScreenOrientation: LANDSCAPE|PORTRAIT.

الدعم

---

setOrientation

ضبط اتجاه الجهاز

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.setOrientation(orientation)

المعلمات

الاسم	النوع	التفاصيل
orientation	string	اتجاه المتصفح الجديد كما هو محدد في ScreenOrientation: LANDSCAPE|PORTRAIT

الدعم

---

getLogs

الحصول على السجل لنوع سجل معين. يتم إعادة ضبط مخزن السجل بعد كل طلب.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getLogs(type)

المعلمات

الاسم	النوع	التفاصيل
type	string	نوع السجل

النتائج

• <Object[]> logs: قائمة إدخالات السجل.

الدعم

---

getLogTypes

الحصول على أنواع السجلات المتاحة.

أمر أبيوم. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

driver.getLogTypes()

النتائج

• <String[]> logTypes: قائمة أنواع السجلات المتاحة.

الدعم