for all these features you'll need qt 5.14 · 2020. 1. 31. · how to proﬁle a qt app on...

Testing&ProfilingQtonAndroid

BogDanVatră,ProgrammeratKDAB

It'sallaboutQt5.14!

p.2

Forallthesefeaturesyou'llneedQt5.14!

What'snewonQt5.14forAndroid?

What'snewonQt5.14forAndroid? p.3


HowtouseQtTestonAndroid

HowtouseAVDsforrunningtests

HowtoprofileaQtapponAndroid

HowtouseaddresssanitizeronAndroid

Androidmultiarchbuildinonego


thebiggestfeatureaddedsinceImadetheQtonAndroidport

bydefaultallABIs(armeabi-v7a,arm64-v8,x86&x86_64)arebuilt

allowsyoutodecidewhichABI(s)youwanttobuildfor:

fromcommandline:$qmakeANDROID_ABIS="armeabi-v7aarm64-v8a"

AndroidAppBundles(aab)


AndroidAppBundles(aab)isthenew(preferred)waytodistributeyourappsonGooglePlay

generatesandservesoptimizedAPKsforeachuser’sdeviceconfiguration

supportsdynamicfeaturemodules,viaplaycorelibrary

fromcommandline:$makeaab

Seehttps://developer.android.com/guide/app-bundleformoreinfo

https://developer.android.com/guide/app-bundle

QtonAndroid5.14bringsmore


Sameasfor.aabyoucannowcreatean.apkfilefromcommandline:$makeapk

reworkedassetssupport:nowitlistsallthefilesandfolders.

loadQtpluginsdirectlyfromandroidlibsfolder

afewmore,checkhttps://www.kdab.com/qt-for-android-better-than-ever-before/formoreinfo

https://www.kdab.com/qt-for-android-better-than-ever-before/


HowtouseQtTestonAndroid p.7






Howdoweruntestsondesktop?


howdoweruntestsondesktop?$makecheck

HowdidweusedtoruntestsonAndroid?


usuallywedidn't

therewere(atleast?)twoscriptswhichusedtohelp

thesescriptsneverworkedproperly;(

Okayokay,but...


howshouldweruntestsonAndroid?$makecheck

...


ThisishowwearegoingtoruntestsonAndroidusingQt5.14:$makecheck

Yes,nowit'sthateasy!

Areyoukidding?!?!


25minutesjusttellustorun:$makecheck

Holdyourhorses...:)


ThereareafewAndroidspecificthingswhichyoureallyneedtoknow:

sayhellotoandroidtestrunner

howtobuild&runyourtestsefficiently

howtorunyourtestsonaspecificdevice/emulator

howtopassargumentstoandroidtestrunner

howtopassargumentstoyourtest

Sayhellotoandroidtestrunner


androidtestrunnerisanewtooladdedtoQt5.14which:

createsthe.apk(ifit'snotalreadycreated)

installsthe.apk

runsthefirstActivityfromAndroidManifest.xmluse--activityparametertospecifyanotherone

checksthetestresults

ifspecified,pullsthetestsoutputfilesinthebuildfolder

Beaware:multipleinstanceswillwaitforeachothertocomplete!

Howtobuild&runyourtestsefficiently


buildonlytheneededABIs

buildyourAPKsinparallel!

runthetests

1 $qmakeANDROID_ABIS="x86_64"2 $make-j$(nproc)apk3 $makecheck

Howtorunyourtestsonaspecificdevice


UseANDROID_DEVICE_SERIALenvironmentvariable

$ANDROID_DEVICE_SERIAL="emulator-5554"makecheck

Howtopassargumentstoandroidtestrunner


UseTESTARGSvariabletopassparamstoandroidtestrunner

$makeTESTARGS="--timeout600"check

Howtopassargumentstoyourtest


useTESTARGSvariabletopassparamstoandroidtestrunner

use--paramtopassparamstothetestitself

$makeTESTARGS="---oout.xml,xml-oout.txt,txt-o-,tap-vs"check

--followingparamswillbepasseddirectlytotestapp

-oout.xml,xmlstoresthetestsresultsinout.xml

-oout.txt,txtstoresthetestsresultsinout.txt

-o-,tapprints(tostdout)tapformat

-vsenablesloggingofeverysignalemission

out.xmlandout.txtarepulledbyandroidtestrunnertotestbuildfolder


HowtouseAVDsforrunningtests p.19






Plumbing


usesdkmanagertoinstalltheemulatorandasystemimage$.../tools/bin/sdkmanager"emulator""system-images;android-29;default;x86_64"

useavdmanagertocreateanAVD$.../tools/bin/avdmanagercreateavd-ntest-k"system-images;android-29;default;x86_64"

choosecustomhardwareprofilechooseyesforhw.gpu.enabled

StartanAVD


useemulatortool$.../tools/emulator-avdtest

pass--no-windowparamtoemulatorfordockerhosts


HowtoprofileaQtapponAndroid p.22






HowtouseGoogletoolstodoprofiling


Whatwearegoingtocover:

howtouseNDKtoolstodoC/C++profiling

WhatweareNOTgoingtocover:

howtodoQMLprofiling

howtodoJavaprofiling

Steps:


build&installtheapplicationusingQtCreator

useNDKtoolstostartprofilerecording

starttheapplication

stoptheapplication

generateareportusingtheNDKtools

Build&installtheapplication


buildyourQt5.14app(inreleasemode)usingQtCreatorpreQt5.14stripsthe.sofilesinyourandroid-builddir,whichwillcasethereportsteptonotshowyouanysymbols

doNOTsignyourapplicationsigningtheapplicationwillremovethedebugablemanifestflag.

installtheapplicationonthetargetdevice

UseNDKtoolstostartprofilerecording


gotondk_folder/simpleperffolder

run./app_profiler.pytostartrecordingtheprofilingdata.Passatleast:--appparametertospecifythepackagename--libparametertospecifywhereisthebuilddirofyourapplicationformoreparameterspleasecheckhttps://android.googlesource.com/platform/system/extras/+/master/simpleperf/doc/android_application_profiling.md

$./app_profiler.py--apporg.qtproject.example.profile\--lib/home/bogdan/projects/build-profile-Release/android-build

Waitabituntiltheprofilerisreadyforrecording.

https://android.googlesource.com/platform/system/extras/+/master/simpleperf/doc/android_application_profiling.md



Start&stoptheapplication


starttheapplication

stoptheapplication

waituntil./app_profiler.pypullstherecordedprofiledata

GenerateareportusingtheNDKtools


Thereareacoupleofreportingtoolsinthatfolder,themostimportantonesare:

report.pyisawrapperoftheperfreportcommandonthehost#Reportcallgraph$./report.py-g

report_html.pygeneratesreport.htmlfilebasedontheprofilingdata#Generateinteractivechartstatistics,sampletableandflamegraphs,basedonperf.data$./report_html.py

Whattolookfor


qtMainLoopThreaisthethreadthatcallsyourmainfunctionusuallythisisthethreadthatyou'relookingfor

QtThread,QQmlThreadareQtinternalthreadsusedbyQmlEngine(Renderer)

RenderThread,Binder:XXXXXXareAndroidinternalthreads

unnamedthreadsusuallyareAndroidinternalthreads,butmightbeapplication'stoo

It'shighlyrecommendedtoexplicitlynameallyourapplicationthreads(useQThread::setObjectNamebeforeyoustartit)


HowtouseaddresssanitizeronAndroid p.30






SamesupportasyoufindonGNU/Linux

HowtouseaddresssanitizeronAndroid p.31

firstclasssupportforaddresssanitizeronAndroidinQt5.14$qmakeCONFIG+=sanitizerCONFIG+=sanitize_address$makeapk

Yep,that'sallyouneedtodo!

Caveats:

itseemsitworksonlyonarm64-v8

itseemsitworksonlyonAndroid9+

itworkedformeonlyonGoogle'sPixel3

Thankyou!

www.kdab.com

[email protected]

for all these features you'll need qt 5.14 · 2020. 1. 31. · how to proﬁle a qt app on...

Documents