diff options
author | Yang Gu <yang.gu@intel.com> | 2010-10-14 20:34:42 +0800 |
---|---|---|
committer | Denis Kenzior <denkenz@gmail.com> | 2010-10-14 09:44:51 -0500 |
commit | 4605dbbde3f5a8879ca8eac3efd58fe182ae7a77 (patch) | |
tree | 326a781b03ffd49a4b6edc5d9d2d14df82f09240 | |
parent | ab6daaf9fd46543fcd3fb791250e6578e2d8cc4e (diff) | |
download | phonesim-4605dbbde3f5a8879ca8eac3efd58fe182ae7a77.tar.gz |
doc: Describe the scriptable feature
-rw-r--r-- | doc/scriptable.txt | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/scriptable.txt b/doc/scriptable.txt new file mode 100644 index 0000000..670bd21 --- /dev/null +++ b/doc/scriptable.txt @@ -0,0 +1,55 @@ +With the support of QtScript, now phonesim is scriptable, which means you may +manipulate or extend phonesim's functionality using ECMA script language +(defined in ECMA-262). At the same time, some D-Bus interface and dedicated +methods are also defined to facilitate this feature. As a result, full test +automation can be achieved (Without this, if you want to initiate an incoming +call, you have to do some operations manually within phonesim GUI). Below are +several examples: + +1. call.js (stand for incoming call and copy it to /tmp/call/) +tabRegistration.gbIncomingCall.leCaller.text = "12345"; +tabRegistration.gbIncomingCall.pbIncomingCall.click(); + +Then set the path of script and run the script with its name: + +dbus-send --session --print-reply --dest=org.ofono.phonesim / +org.ofono.phonesim.Script.SetPath string:/tmp/call + +dbus-send --session --print-reply --dest=org.ofono.phonesim / +org.ofono.phonesim.Script.Run string:call.js + +Now you have simulated an incoming call. + +PS: If you want to know the hierarchy of UI elements, check the file +src/controlbase.ui + +2. sms.js (stand for incoming sms and copy it to /tmp/sms/) +tabSMS.gbMessage1.leMessageSender.text = "Yang"; +tabSMS.gbMessage1.leSMSClass.text = "1"; +tabSMS.gbMessage1.teSMSText.setPlainText("Sent from phonesim"); +tabSMS.gbMessage1.pbSendSMSMessage.click(); + +Then do the similar things as first example: + +dbus-send --session --print-reply --dest=org.ofono.phonesim / +org.ofono.phonesim.Script.SetPath string:/tmp/sms + +dbus-send --session --print-reply --dest=org.ofono.phonesim / +org.ofono.phonesim.Script.Run string:sms.js + +Now you have simulated an incoming sms. + +3. Get the current path for script +dbus-send --session --print-reply --dest=org.ofono.phonesim / +org.ofono.phonesim.Script.GetPath + +4. Make script return some string +The string can be any string, number, bool, date, etc in JavaScript, but it +couldn't be a object because of some side effect. Refer "QScriptValue Class +Reference" for details. +For example, if you want to know the current incoming number, you may write a +script as below: +// number.js +tabRegistration.gbIncomingCall.leCaller.text + +After running the script the similar way as above, you may get the number. |