TestCases Of androidhelp APIs

[riverfor]

All APIs need to test

• https://github.com/qpython-android/qpysl4a/blob/master/doc/en/APIs.rst

Please tell them one by one and give the results.

It may help for testing:
http://qr.qpy.io/

I have pushed one testcase (Testcase for setClipboard & getClipboard) as a sample.

[riverfor]

Testcase for AndroidFacade

Test Result

Clipboard APIs

• √ setClipboard(text)
• √ getClipboard()

Intent & startActivity APIs

• √ startActivity(action, uri, type, extras, wait, packagename, classname)
• makeIntent(action, uri, type, extras, categories, packagename, classname, flags)
• getIntent()
• startActivityForResult(action, uri, type, extras, packagename, classname)
• startActivityForResultIntent(intent)
• startActivityIntent(intent, wait)

SendBroadcast APIs

• sendBroadcast(action, uri, type, extras, packagename, classname)
• sendBroadcastIntent(intent)

Vibrate

• √ vibrate(duration)

NetworkStatus

• √ getNetworkStatus()

PackageVersion APIs

• requiredVersion(requiredVersion)
• getPackageVersionCode(packageName)
• getPackageVersion(packageName)

System APIs

• √ getConstants(classname)
• √ environment()
• log(message)

SendEmail

• √ sendEmail(to, subject, body, attachmentUri)

Toast, getInput, getPassword, notify APIs

• √ makeToast(message)
• getInput(title, message)(deprecated, please use dialogGetInput)
• getPassword(title, message)(deprecated, please use dialogGetPassword)
• notify(title, message, url)

Test Scripts

• Gist qpysl4a-androidfacade-startactivity-test.py
• Gist qpysl4a-androidacade-system-test.py
• Gist qpysl4a-androidacade-clipboard-test.py
• Gist qpysl4a-androidacade-vibrate-test.py
• Gist qpysl4a-androidacade-other-test.py

[riverfor]

Testcase for SmsFacade

Test Result

• √ smsGetMessageCount
• √ smsGetMessages
• √ smsSend (It requires SMS_SEND permission)
• √ dialogGetInput
• × smsMarkMessageRead (× since API 23)
• × smsDeleteMessage (× since API 23)
• smsGetMessageIds
• smsGetMessageById
• smsGetAttributes

Test Scripts

• Gist qpysl4a-smsfacade-test.py
• Gist qpysl4a-smsfacade-smssend-test.py

FAQ

Q: My QPython which is installed from google play doesn't have SMS permission.
A: Please upgrade QPython within github to get SMS permission, get qpy3_2020-01-21_google.apk
from https://github.com/qpython-android/qpython3/releases/tag/2.1.0

Q: Why can't I mark sms as read?
A: It looks like that the WRITE_SMS is also no longer available on Android (since API 23)

Related Links

• Change the Default Message App
• Add WRITE_SMS Permission and Setting as Default SMS Application

[riverfor]

Testcase for BatteryManagerFacade

Test Result

• √ batteryStartMonitoring
• √ batteryStopMonitoring
• √ readBatteryData
• √ batteryGetHealth
• √ batteryGetStatus
• √ batteryGetPlugType
• √ batteryCheckPresent
• √ batteryGetLevel
• √ batteryGetVoltage
• √ batteryGetTemperature
• √ batteryGetTechnology

Test Script

• Gist qpysl4a-batterymanagerfacade-test.py

[riverfor]

Testcase for LocationFacade

Test Result

Providers APIs

• √ locationProviders
• √ locationProviderEnabled

Location APIs

• √ startLocating
• √ stopLocating
• √ readLocation
• √ getLastKnownLocation

GEO

• √ geocode

Test Code

• Gist qpysl4a-locationfacade-test.py

[riverfor]

Testcase for ContactsFacade

Test Result

• √ contactsGetCount()
• √ pickContact()
• √ pickPhone()
• √ contactsGetAttributes()
• √ contactsGetIds()
• √ queryContent(uri, attributes, selection, selectionArgs, order)
• √ contactsGetById(id)
• queryAttributes(uri)
• contactsGet(attributes)

Test Script

• Gist qpysl4a-contactsfacade-test.py

[riverfor]

Testcase for Phonefacade

Test Result

PhoneStat APIs

• √ startTrackingPhoneState()
• √ stopTrackingPhoneState()
• √ readPhoneState()

Call & Dia APIs

• √ phoneCallNumber(number)
• √ phoneDialNumber(number)
• phoneCall(uri)
• phoneDial(uri)

Get information APIs

• √ getCellLocation()
• √ getNetworkOperator()
• √ getNetworkOperatorName()
• getNetworkType()
• getPhoneType()
• √ getSimCountryIso()
• √ getSimOperator()
• √ getSimOperatorName()
• getSimSerialNumber()
• √ getSimState()
• getSubscriberId()
• √ getVoiceMailAlphaTag()
• √ getVoiceMailNumber()
• √ checkNetworkRoaming()
• getDeviceId()
• √ getDeviceSoftwareVersion()
• √ getLine1Number()
• √ getNeighboringCellInfo()

Test Scripts

• Gist qpysl4a-phonefacade-test.py
• Gist qpysl4a-phonefacade-phonedialnumber-test.py
• Gist qpysl4a-phonefacade-phonecallnumber-test.py

[riverfor]

TestCase for UiFacade

Test Results

Dialog

• dialogCreateInput(title, message, defaultText, inputType)
• dialogCreatePassword(title, message)
• dialogGetInput(title, message, defaultText)
• dialogGetPassword(title, message)
• dialogCreateSeekBar(start, maximum, title)
• dialogCreateTimePicker(hour, minute, is24hour)
• dialogCreateDatePicker(year, month, day)

NFCBeamMessage

• dialogCreateNFCBeamMaster(title, message, inputType)
• NFCBeamMessage(content, title, message)
• dialogCreateNFCBeamSlave(title, message)

Progress

• dialogCreateSpinnerProgress(message, maximumProgress)
• dialogSetCurrentProgress(current)
• dialogSetMaxProgress(max)
• dialogCreateHorizontalProgress(title, message, maximumProgress)

Alert

• dialogCreateAlert(title, message)

Dialog Control

• dialogSetPositiveButtonText(text)
• dialogSetNegativeButtonText(text)
• dialogSetNeutralButtonText(text)
• dialogSetItems(items)
• dialogSetSingleChoiceItems(items, selected)
• dialogSetMultiChoiceItems(items, selected)
• addContextMenuItem(label, event, eventData)
• addOptionsMenuItem(label, event, eventData, iconName)
• dialogGetResponse()
• dialogGetSelectedItems()
• dialogDismiss()
• dialogShow()

Layout

• fullShow(layout)
• fullDismiss()
• fullQuery()
• fullQueryDetail(id)
• fullSetProperty(id)
• fullSetList(id, list)
• fullKeyOverride(keycodes, enable)

WebView

• webViewShow()

Test Scripts

• Gist qpysl4a-qsl4aapp-sample.py

[riverfor]

TestCase for MediaPlayerFacade

Test Result

• mediaPlay(url, tag, play)
• mediaPlayPause(tag)
• mediaPlayStart(tag)
• mediaPlayClose(tag)
• mediaIsPlaying(tag)
• mediaPlaySetLooping(enabled, tag)
• mediaPlaySeek(msec, tag)

[riverfor]

TestCase for PreferencesFacade

Test Result

• prefGetValue(key, filename)
• prefPutValue(key, value, filename)
• prefGetAll(filename)

[riverfor]

TestCase for QPyInterfaceFacade

Test Result

• √ executeQPy(script)

Test Script

• Gist qpysl4a-qpyinterfacefacade-test.py

[riverfor]

TestCase for TextToSpeechFacade

Test Result

• ttsSpeak(message)
• ttsIsSpeaking()

[riverfor]

TestCase for EyesFreeFacade

Test Result

• ttsSpeak(message)