TouchTest TM Developer Guide

Transcription

1 TuchTest TM Develper Guide

2 SOASTA TuchTest Develper Guide 2015, SOASTA, Inc. All rights reserved. The names f actual cmpanies and prducts mentined herein may be the trademarks f their respective cmpanies. This dcument is fr infrmatinal purpses nly. SOASTA makes n warranties, express r implied, as t the infrmatin cntained within this dcument.

3 Table f Cntents Abut the Develper Guide... 1 TuchTest Dcumentatin... 2 TuchTest ios Dcumentatin... 2 TuchTest Andrid Dcumentatin... 3 TuchTest Cntinuus Integratin Dcumentatin... 3 MakeAppTuchTestable Dcumentatin... 4 Device and Architecture Supprt... 5 ios Supprted Devices... 5 Andrid Supprted Devices... 5 TuchTest Mbile Apps and Agents... 6 Prerequisites fr ios using Xcde... 7 CludTest/TuchTest Utility Sftware... 7 Prerequisites fr Andrid using Eclipse... 9 CludTest/TuchTest Utility Sftware... 9 TuchTest Wrkflws (Static/Dynamic) Static Instrumentatin f an Xcde Prject Dynamic Instrumentatin f an APP file Dynamic Instrumentatin f an IPA file iosappinstaller Utility Miscellaneus TuchTest Cnfiguratin Sharing a TuchTestable App with TuchTest Users TuchTest and ios Netwrk Link Cnditiners Install the ios TuchTestable App frm Xcde Install the TuchTestable Andrid App frm Eclipse Adding TuchTest IDs t an ios App Adding a Mbile App t CludTest Manually... 2 Appendix: MakeAppTuchTestable Reference... 4 i

4 Abut the Develper Guide This Develper Guide prvides a cmpendium f develper-nly references, additinal details nt presented in the TuchTest tutrials, and links t relevant dcumentatin acrss the TuchTest dcumentatin set (i.e. fund in bth tutrials & Knwledge Base). Additinally, Develper prerequisites, device supprt, and ther develper-centric issues are gathered here. Fr mbile web recrding and playback instructins, as well as details abut cnfiguratin and wrkflw in a given ios and platfrm, refer t the apprpriate tutrial (e.g. frm amng thse listed belw). In general, nce yu have identified the tutrial aimed at yur specific envirnment, yu shuld use that tutrial fr recrding and playback instructins. If yu are a Titanium Studi develper, using either ios r Andrid, please refer t the separate tutrial fr yur envirnment (listed belw). When in dubt, refer t the tutrial fr yur envirnment.

5 TuchTest Dcumentatin This Develper Guide serves as an index t develper-nly issues in TuchTest such as device supprt, wrkflw, as well as a guide t the TuchTest dcumentatin set which includes the CludLink Cmmunity, Knwledge Base, and Dcumentatin ndes, as well as a cmplete set f tutrials fr the varius pssible cnfiguratins using TuchTest. Fr user wrkflw, SOASTA recmmends that yu begin with either the TuchTest ios Tutrial r the TuchTest Andrid Tutrial althugh in sme cases it is apprpriate t begin with a platfrm (Titanium Studi) r Cntinuus Integratin (CI) tutrial here. Develpers shuld be aware f the envirnment-specific tutrials presented belw, all f which have been created fr the cnvenience f users develping and testing in these envirnments. TuchTest tutrials are categrized by mbile platfrm and/r cntinuus integratin platfrm belw. TuchTest ios Dcumentatin TuchTest ios Tutrial This tutrial prvides a basic intrductin t using TuchTest in the Xcde envirnment fr bth develpers and end-users wh may be testing a mbile app in an envirnment setup by a develper. Bth static instrumentatin and dynamic instrumentatin are cvered. TuchTest fr Appceleratr ios Tutrial This tutrial prvides a basic intrductin t using TuchTest in the Titanium Studi envirnment and is intended fr bth develpers and testers wrking in a develper-led mbile app envirnment. The Titanium Studi verlap with Xcde is discussed where it ccurs (fr example, as it relates t prvisining a device). TuchTest Advanced Tutrial This tutrial presents the advanced case fr using TuchTestIDs in ios envirnments t enhance the readability f mbile app tests, and additinally, delves further int the use f accessrs such as utputs, validatins, and waits t enhance mbile testing. Additinally, a cmprehensive App Actin References is included in this dcument. TuchTest OpenGL Tutrial This tutrial presents the necessary steps fr develpers t expse app internal values, such as thse used in mbile apps that utilize OpenGL and similar technlgies, fr use in TuchTest mbile app testing. TuchTest Web (Build) fr ios Tutrial This tutrial intrduces the use f the TuchTest Web app (which can be dwnladed as an Xcde prject n the TuchTest Welcme page). TuchTest Web is used t recrd web-based apps and sites n yur ios device. Once deplyed, TuchTest Web wrks with TuchTest Agent and yur CludTest desktp t enable yu t capture brwser actins easily and play them back nt any ios device(s) in just a few simple steps.

6 TuchTest Andrid Dcumentatin TuchTest Andrid Tutrial This tutrial prvides a basic intrductin t using TuchTest in the Eclipse envirnment fr bth Andrid develpers and end-users wh may be testing a mbile app in an envirnment setup by a develper. TuchTest fr Appceleratr Andrid Tutrial This tutrial prvides a basic intrductin t using TuchTest in the Titanium Studi envirnment fr bth Andrid develpers and end-users wh may be testing a mbile app in an envirnment setup by a develper. TuchTest Web fr Andrid Tutrial This tutrial intrduces the use f the TuchTest Web app (available n the CludTest Welcme Page), which is used t recrd;webbased apps and sites n yur Andrid device. Once deplyed, TuchTest Web wrks with TuchTest Agent and yur CludTest desktp t enable yu t capture brwser actins easily and play them back nt any Andrid device(s) in just a few simple steps. TuchTest Cntinuus Integratin Dcumentatin TuchTest Jenkins CI fr ios Tutrial This tutrial presents the necessary prcedures fr incrprating TuchTest using Xcde int cntinuus integratin envirnments that utilize Jenkins/Hudsn with ios. TuchTest Jenkins CI fr Andrid Tutrial This tutrial presents the necessary prcedures fr incrprating TuchTest using Eclipse int cntinuus integratin envirnments that utilize Jenkins/Huds with Andrid. TuchTest Appceleratr Jenkins CI Tutrial - This tutrial presents the necessary prcedures fr incrprating TuchTest using Titanium Studi int cntinuus integratin envirnments that utilize Jenkins/Hudsn. TuchTest Bamb CI fr ios Tutrial This tutrial presents the necessary prcedures fr incrprating TuchTest using Xcde int cntinuus integratin envirnments that utilize Bamb CI with ios. TuchTest fr Quality Center Tutrial - This tutrial presents the necessary prcedures fr incrprating TuchTest int am HP Quality Center envirnment.

7 MakeAppTuchTestable Dcumentatin Use the fllwing list t find the TuchTest example scenaris yu need. Fr a cmplete basic ios scenari, using MATT t instrument an Xcde prject, APP, r IPA, refer t the TuchTest ios Tutrial. Fr a cmplete basic Andrid scenari, using MATT t instrument an Andrid prject in Eclipse, r APK, refer t the TuchTest Andrid Tutrial. Fr an advanced ios scenari using Xcde, with TuchTest ID examples, refer t the TuchTest Advanced Tutrial. Fr extensive Cntinuus Integratin examples f using TuchTest, including the CludTest Jenkins Plugin, MakeAppTuchTestable mdule, in cmbinatin with xcdebuild and xcrun frm within Jenkins t instrument an ios prject, APP, r IPA, refer t the TuchTest Jenkins CI fr ios Tutrial. Fr extensive Cntinuus Integratin examples f using TuchTest, including MATT, as well as Ant and ABD, t instrument an Andrid prject, r APK, refer t the TuchTest Jenkins CI fr Andrid Tutrial. If yu are using Andrid build.xml cnfiguratin, refer t the CludLink, KnwledgeBase article, Andrid build.xml cnfiguratin fr MakeAppTuchTestable.

8 Device and Architecture Supprt Refer t TuchTest Device Supprt fr the latest updates t ios and Andrid Supprted Devices. ios Supprted Devices SOASTA TuchTest supprts ios 5.0 versin r later and the fllwing devices: iphne 3GS iphne 4 iphne 4s iphne 5 ipd Tuch (3 rd generatin) ipd Tuch (4 th generatin) ipad ipad 2 The new ipad SOASTA TuchTest Driver is nt cmpatible with the armv6 architecture. The fllwing architectures are supprted: armv7 armv7s Nte: Fr dynamic instrumentatin, ios 6 and up versins are required. Static instrumentatin is supprted in all supprted ios versins. Andrid Supprted Devices SOASTA TuchTest supprts devices running Andrid SDK (Gingerbread) r later.

9 TuchTest Mbile Apps and Agents The fllwing mbile web cmpnents are crucial rle players in TuchTest. See the linked dcumentatin fr mre abut TuchTest's mbile cmpnents. TuchTest Agent Andrid App The TuchTest Agent app fr Andrid (refer t Cnfiguring a TuchTest Agent fr a quick review f this mbile user agent). TuchTest Agent (ios) The TuchTest Agent URL fr the given CludTest instance (refer t Cnfiguring a TuchTest Agent fr a quick review f this mbile user agent). TuchTest Web fr Andrid App The TuchTest Web fr Andrid app (refer t the TuchTest Web fr Andrid Tutrial fr mre infrmatin). TuchTest Web fr ios The TuchTest Web fr ios Xcde prject is available n the Welcme page f yur CludTest instance (als refer t the TuchTest Web fr ios (Build) Tutrial fr mre infrmatin.

10 Prerequisites fr ios using Xcde An Xcde develper will need the fllwing running n a Mac OS X desktp with access t CludTest Lite r sme ther CludTest instance: Xcde (versin r later) ios Develper Prgram membership At least ne prperly prvisined device(s) (Xcde simulatrs can als be used) CludTest/TuchTest Utility Sftware A develper with Mbile Device Administratr privileges shuld perfrm the fllwing prerequisites (if yu re a CludTest Lite user yu re already a Mbile Device Administratr): Dwnlad and unarchive the MakeAppTuchTestable Utility frm the CludTest Welcme page. Yur mbile app s Xcde prject file (duplicate yur prject s target and run this utility against it using the instructins belw). If yu re using the Jenkins/Hudsn cntinuus integratin envirnment, refer t the TuchTest Jenkins CI Tutrial fr a cmplete start t finish scenari using the CludTest Jenkins/Hudsn Plugin. Nte: This archive cntains the necessary drivers fr bth the manual and autmatic prject mdificatins methds described belw. Chse whether t make yur app TuchTestable autmatically r manually. The autmatic methd is highly recmmended. Manual instructins are presented nly in this Develper Guide as an Appendix. SOASTA prvides bth methds t accmmdate differing user cncerns while sme develpers prefer t perfrm each and every step as a matter f rigr; thers are mre interested in ease f use. If yu d like t try the utility, make a sandbx in a nn-crucial lcatin and try it ut there. Fr mst users, the Using the MakeAppTuchTestable Utility autmatic methd will prvide an easier, alternate rute.

11 Fr intrepid users wh want t knw hw everything wrks, TuchTest can be added manually using the steps in Manually Adding TuchTest t an Xcde Prject appendix belw. Yu can experiment by trying it ut n a sandbx prject. A Mbile App must be added (as a repsitry bject) t CludTest. This is handled by the MakeAppTuchTestable utility in the case f the autmatic methd abve, but must be dne separately if using the manual methd. In either case, the Mbile App repsitry bject Launch URL field must minimally match the Xcde prject URL scheme field (minimally, because it des take ther arguments). Once these develper prerequisites are met, TuchTest recrding is perfrmed by any user by deplying the fllwing CludTest cmpnents: The TuchTest Agent; a per mbile device brwser agent pinted at CludTest and reachable by the Cnductr name abve. Refer t the recrding and playback instructins in the TuchTest ios Tutrial. If hybrid r web testing is used, then the TuchTest Web app is required. This is available as an Xcde prject via the Welcme page f yur CludTest instance. The CludTest (r CludTest Lite instance) fr which bth are cnfigured, and A CludTest mbile target cnfigured t use all f the abve (specified prir t recrding)

12 Prerequisites fr Andrid using Eclipse This guide presumes that the Andrid develper has a basic familiarity with the Eclipse develpment envirnment and has the fllwing cnfiguratin: Eclipse (versin 3.6 r later) with Andrid SDK installed alng with the Eclipse plugin. The Minimum Andrid Versin supprted fr use with TuchTest is (Gingerbread). The basic Andrid tutrial als uses the Andrid NDK tlset in cnjunctin with the Andrid mbile app, DridFish, althugh this is nt a requirement f TuchTest itself. Unless yu have a different Andrid mbile app yu d like t use with this tutrial, install the Andrid NDK tlset int yur Eclipse envirnment befre prceeding with the basic tutrial. CludTest/TuchTest Utility Sftware Develpers wh wuld als like t add TuchTest t an existing mbile app can find basic instructins fr using the MakeAppTuchTestable utility in this guide. Dwnlad and unarchive the MakeAppTuchTestable Utility frm the CludTest Welcme page. If yu re using the Jenkins/Hudsn cntinuus integratin envirnment, refer t the TuchTest Jenkins CI Tutrial fr a cmplete start t finish scenari using the CludTest Jenkins/Hudsn Plugin.

13 Nte: This archive cntains the necessary drivers fr bth the manual and autmatic methds described belw.

14 TuchTest Wrkflws (Static/Dynamic) When yu make a mbile app TuchTestable, yu d s by instrumenting it using either a static r dynamic methd with the MakeAppTuchTestable utility. The MATT utility supprts tw instrumentatin methds: static and dynamic. Dynamic instrumentatin ccurs when MATT instruments a cmpiled file (i.e. an IPA r APP file). This methd requires SOASTA 51 (TuchTest ) and can be applied t ios versin 6 and 7 nly. Static instrumentatin ccurs when MATT instruments a prject file (i.e..xcdeprj). Static instrumentatin is available in all TuchTest releases and fr all supprted ios versins. Because there are many pssible wrkflws in a develpment envirnment, the pssible steps are presented belw a la carte. Fr each wrkflw there will be (minimally): Nte: A First step; used t retrieve the surce prject (all wrkflws) In between the first and last steps, each Jenkins jb will have:! A CludTest Plugin, MakeAppTuchTestable step;! with ne r mre Build steps,! and ne r mre Install/Run steps A Last step; t Play the Cmpsitin Prvisining and cdesigning can be perfrmed either using the CludTest Jenkins Plugin, MATT, Advanced steps t enter the APP/IPA ptinal parameters (refer t the relevant sectins). Or, authenticatin steps can be dne using xcrun. There is a ne-time prvisining prfile step that shuld be run prir t running the cmplete Jenkins jb. In general, yu will delay the MATT step nly until the last lgical pint (i.e., nly after the GIT if yu're using static instrumentatin, after the APP step if fr dynamic using a simulatr(s), and after the IPA step fr dynamic using physical devices. Static Instrumentatin f an Xcde Prject In this wrkflw, yu'll apply MATT t the Xcde prject itself, using the prject parameter. Apply MATT using the prject parameter (static nly) Build the APP using xcdebuild (ptinal) Build the IPA using xcrun Run/install using either Xcde r iosappinstaller

15 Dynamic Instrumentatin f an APP file In this wrkflw, yu'll apply MATT t the cmpiled APP file using the appbundle parameter. Build the APP using Xcde r xcdebuild Apply MATT t the cmpiled APP using appbundle Run App n ios Simulatr using Xcde r iosappinstaller Dynamic Instrumentatin f an IPA file In this wrkflw, yu'll delay applying MATT until the IPA is created Build the APP using xcdebuild Build the IPA file using xcrun, Apply MATT t the cmpiled IPA using ipa Install the app n the device using Xcde r iosappinstaller.

16 iosappinstaller Utility Using the newly TuchTestable APP r IPA yu can nw easily: Deply the TuchTestable app t an ios device r simulatr. SOASTA prvides the iosappinstaller Utility fr this purpse. Yu can dwnlad the latest iosappinstaller Utility frm the Central > Welcme page, Dwnlads sectin f yur wn server instance. Unzip the utility at this time if yu have yet t d s and nte the cntents f the resulting iosappinstaller flder. Fr a Simulatr, use:./bin/is_sim_launcher -app Fr an iphne r ipad, use:./bin/is_app_installer -ipa

17 Miscellaneus TuchTest Cnfiguratin Sharing a TuchTestable App with TuchTest Users Develpers and testers can use TuchTest (via its CludTest instance) t make the TuchTestable app available t ther users. Refer t the CludLink, KnwledgeBase article, Uplading a Mbile App IPA r APK. Then, pint yur users t Dwnlad a Mbile App IPA r APK TuchTest and ios Netwrk Link Cnditiners Refer t the CludLink, KnwledgeBase article, Using an ios Netwrk Link Cnditiner with TuchTest fr instructins.

18 Install the ios TuchTestable App frm Xcde Using the new scheme that was added t yur Xcde prject by the MakeAppTuchTestable utility, yu can nw easily: Deply the TuchTestable app t an ios device r simulatr. Prepare the ios device fr TuchTest recrding r playback using the instructins in the TuchTest ios Tutrial. T deply and run the TuchTestable app, select the -TuchTest scheme frm the drp-dwn and the ios device r simulatr n which yu d like t run, then click the Run buttn.

19 Install the TuchTestable Andrid App frm Eclipse After ding a Refresh n yur Andrid prject yu are ready t install it. After installing t a device r simulatr, prepare the Andrid device fr TuchTest recrding r playback using the instructins in the TuchTest Andrid Tutrial. 1. Cnnect the Andrid Device t the desktp client running Eclipse via USB. Yu can als use a simulatr. A physical device must have the fllwing set: The stck brwser n the device shuld supprt launch f native apps The Develper Optins, USB Debugging bx shuld be enabled The Security, Unknwn surces bx shuld be enabled 2. Click the Run buttn n the tlbar t build the prject and push it t the Andrid Device. If the Andrid device is cnnected, and n Andrid Virtual Device (AVD) is running, the app is installed t the device. If mre than ne device r emulatr cmbinatin is available, then a selectin bx appears fr yu t chse If n device is cnnected, the Andrid Virtual Device (AVD) will run and the Dridfish app will be installed t it instead. The AVD must be using SDK r later. When all f the cnditins and steps abve are cmpleted, the app is pushed nt the Andrid Device. The Eclipse Cnsle will indicate success and the app will launch. [ :05:21 - DridFish] [ :05:21 - DridFish] Andrid Launch! [ :05:21 - DridFish] adb is running nrmally. [ :05:21 - DridFish] Perfrming rg.peter.dridfish.dridfish activity launch [ :05:21 - DridFish] Autmatic Target Mde: using device '015d15b4da23f411' [ :05:21 - DridFish] Uplading DridFish.apk nt device '015d15b4da23f411' [ :05:23 - DridFish] Installing DridFish.apk... [ :05:26 - DridFish] Success! [ :05:26 - DridFish] Starting activity rg.peter.dridfish.dridfish n device 015d15b4da23f411 [ :05:26 - DridFish] ActivityManager: Starting: Intent { act=andrid.intent.actin.main cat=[andrid.intent.categry.launcher] cmp=rg.peter.dridfish/.dridfish }

20 Adding TuchTest IDs t an ios App Fr ios develpers, SOASTA TuchTest prvides TuchTest Driver t enhance mbile app lcatrs as an integral part f tuch-testing. This is nt necessary fr Andrid prjects. Unlike the prir Xcde examples, this sectin uses the example app, Tuches. TIP: Please refer t the TuchTest Advanced Tutrial fr a cmplete A-Z example f hw t add tuchtestids t a mbile app. The use f tuchtestid in Lcatrs in the sample app, Tuches, is described belw. Nte: Use the tuchtestid cnditinally in a manner that guarantees it is nt part f cde that gets submitted t the App Stre. Fr example, by using: #ifdef TOUCHTESTDRIVER 1. Identify the surce file where the view is initialized. One example f where views can be initialized is in the methd, awakefrmnib. 2. Include the TuchTest header file in the surce file with the initializatin f the view by using: #ifdef TOUCHTESTDRIVER #imprt "TuchTestDriver.h" #endif 3. Next, call the settuchtestid methd n each view that will be lcated. The string parameter t tuchtestid is the value that yu want t be used t lcate the element, in this case yellwsquare, bluesquare and pinksquare. Fr example, #ifdef TOUCHTESTDRIVER [firstpieceview settuchtestid:@ yellwsquare ]; [secndpieceview settuchtestid:@ bluesquare ]; [thirdpieceview settuchtestid:@ pinksquare ]; #endif The blue lines in the screensht belw were added t the given surce file.

21 The sample app, Tuches, demnstrates the use f settuchtestid. In this example, each TuchTestID crrespnds t a square in Tuches. The clip belw was recrded using Tuches. Nte that the tuchtestdriverid is shwn where present.

22 A

23 Adding a Mbile App t CludTest Manually In cases where manual prject integratin has been used, it will be necessary t manually add a mbile app t CludTest. 1. Select Central > Mbile Apps and then click New. The Mbile App frm appears. 2. Enter the app name as it will appear in the drp-dwn fr user selectin. Generally, this will als be the Xcde prject name. 3. Optinally, enter a descriptin and an app versin number. Versin number will generally match Xcde prject details. 4. Only ios is supprted currently. Fr this release, TuchTest supprts ios 5.0+ versins nly). 5. Set the Supprted Device Type t Universal, iphne, r ipad. 6. In the Launch URL field, prvide the unique URL Scheme yu defined in XCde, plus any additinal arguments relevant t yur mbile app. Fr example, sasta-mbile-test-app-6ea1a5d f0c704262:// key1=value1&key2=value2&key3=value3 B

24 where sasta-mbile-test-appid:// is the name f yur mbile app including the :// and additinal arguments are in the frm key1=value1&key2=value2. Nte: Withut a crrectly frmed Launch URL testing will nt happen. 7. Optinally, imprt an app image fr yur mbile app t visually represent the crrelatin f TuchTest Agent with yur app. Supprted image types include JPEG, PNG, and GIF. Images can be pre-edited t the requisite 57 pixels wide by 57 pixels tall. Images that are nt crpped will be shrunk t fit within the requisite dimensins. Click Save t create this mbile app bject in CludTest. C

25 Appendix: MakeAppTuchTestable Reference SOASTA 51 greatly imprved cmmand line help fr the MakeAppTuchTestable utility. The cmplete reference nw includes all f the fllwing additinal cntent fr IPA and APP dynamic instrumenting. Updated MakeAppTuchTestable Help This release features greatly imprved cmmand line help fr the MakeAppTuchTestable utility. The cmplete reference nw includes all f the fllwing additinal cntent fr IPA, APP, and APK dynamic instrumenting. Usage: sh MakeAppTuchTestable/bin/MakeAppTuchTestable -prject PATH [OPTIONS] Required parameters: prject <prjectpath> Path f the Xcde prject directry (e.g. ~/ Dcuments/MyApp/MyApp.xcdeprj) target <name> the name f the Xcde target t mdify url <url> username <username> passwrd <passwrd> Example: the CludTest URL (e.g. cncert) The CludTest user name the CludTest passwrd sh MakeAppTuchTestable/bin/MakeAppTuchTestable -prject ~/Dcuments/MyApp/ MyApp.xcdeprj -target MyApp -url -username bb - passwrd pass IPA required parameters: Chse nly ne f the fllwing arguments: -prject,-ipa, r -appfile. Nte: IPA and APP instrumenting is unavailable fr ios 5 apps. ipa <ipafilepath> Path f the ios IPA Kile (e.g. ~/Dcuments/ MyApp.ipa) appfile <appfilepath> Path f the ios app Kile (e.g. ~/Dcuments/ MyApp.app). IPA ptinal parameters: The fllwing parameters are ptinal fr IPA instrumenting (but may be required in sme cases): -signingidentity <signingidentityname> The name f the signing identity t be used fr cdesigning the applicatin (e.g. "ios Distributin: Develper Name"). D

26 -prvisiningprfile <prfilepath> -entitlementsfile <entitlementsfilepath> Path f the Prvisining prkile t be used fr building IPA Kile. Path f the entitlements Kile t be used fr cdesigning the applicatin Nte: If a instrumented app prduces the fllwing errr: This crash is related t instrumenting : client has neither applicatin- identikier nr keychain- access- grups entitlements Then, the - entitlementskile parameter (abve) must be used t re- wrap the given app. IPA Example: sh MakeAppTuchTestable/bin/MakeAppTuchTestable -ipa ~/Dcuments/MyApp.ipa - url -username bb -passwrd pass E

27 APK required parameters: Chse either f the fllwing arguments: -prject r -apk. -apk <apkfilepath> Path f the Andrid APK Kile (e.g. ~/ Dcuments/MyApp.apk) -andridsdk <andridsdkpath> Path f the directry where Andrid SDK is lcated. APK ptinal parameters: The fllwing parameters are ptinal fr APK instrumenting (but may be required in sme cases): -keystre <keystrepath> -strepass <keystrepasswrd> -keypass <privatekeypasswrd> -alias <aliasname> -dntcnfiguremanifest APK Example: Path f the keystre t be used t sign the APK Kile. Passwrd f the keystre t be used t sign the APK Kile. Passwrd f the private key (if different than the keystre passwrd) t be used t sign the APK Kile. Alias fr the key t be used t sign the APK key. Only the Kirst 8 characters f the alias are used. Skip the Andrid manifest cnkiguratin step. Befre using this ptin, please make sure that yu have cnkigured the AndridManifest.xml Kile t insert changes required by TuchTest befre building the APK Kile. sh MakeAppTuchTestable/bin/MakeAppTuchTestable -apk ~/Dcuments/ MyApp.apk andridsdk ~/Dcuments/andrid-sdk -url cncert -username bb -passwrd pass F

28 Other MATT Optinal parameters: -tenant <tenant> -infplistfile -custmrulesfile -launchurl -appbjectname -dntcreateapp -universalapp -verwriteapp -previewmde -prxyserver <server> -prxyprt <prt> -prxyusername <username> -prxypasswrd <passwrd> -versin -reprterrrs -dntreprterrrs The CludTest tenant the user is assciated with The prject's Inf.plist file. If this parameter is nt included, then MakeAppTuchTestable will try t autmatically lcate it. The prject's custm_rules.xml file. If this parameter is nt included, then MakeAppTuchTestable will try t autmatically lcate it. The URL that TuchTest shuld use t start the app. Example: my-app://launch If this parameter is nt included, then MakeAppTuchTestable will autgenerate a URL. IMPORTANT: D nt use spaces r underscres in yur custm launch URL(s). Name f the Mbile App bject created in the CludTest server Dn't create a Mbile App bject in the CludTest server Create a Mbile App bject cmpatible with bth ios and Andrid in the CludTest server If the Mbile App bject already exists, replace it Run in Preview mde t examine the cnsle utput fr these parameters. If this parameter is nt included, then MakeAppTuchTestable runs in full mde and the prject is changed. HTTP prxy server name HTTP prxy prt number HTTP prxy user name (if any) HTTP prxy passwrd (if any) Print Utility Versin Utility will autmatically reprt errrs t SOASTA alng with any relevant Kiles. Utility will nt reprt any errrs t SOASTA (Fgbugz). G

29 -addheadersearchpath -usefrceladlinkerflag -remvelibraryfrmbuildphase Add TuchTest header Kiles t "Header Search Paths" build setting. Add - frce_lad Klag t the "Other Linker Flags" build setting. If the user des nt want the library t be added t the "Link Binary With Libraries" step f Build Phases, this argument will prevent that. H

30 I

31 SOASTA, Inc. 444 Castr St. Muntain View, CA