{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.ecosystem","extensionKey":"508fc997-b9e5-4cff-a7b0-92cecde27d7f/0701025f-8cc5-45af-9ba8-51dcdcf20177/static/redirection-by-easy-apps-macro","text":"Redirection","parameters":{"guestParams":{"isAddedByApp":true},"extensionId":"ari:cloud:ecosystem::extension/508fc997-b9e5-4cff-a7b0-92cecde27d7f/0701025f-8cc5-45af-9ba8-51dcdcf20177/static/redirection-by-easy-apps-macro","extensionTitle":"Redirection"}}},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"green","style":"bold","text":"UP TO DATE","localId":"012feb3d-797a-4188-b483-223b4b0c8e5a"}}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"e6db77ed-d5af-4589-9942-f12c6178c7f5"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuration","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Client configuration in ","type":"text"},{"text":"$HOME/.greenspector/config.yml","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The main configuration file must be located in ","type":"text"},{"text":"$HOME/.greenspector/config.yml","type":"text","marks":[{"type":"em"}]},{"text":". To initialize it, simply use the command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt init -a -p ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"greenspectorApi","type":"text","marks":[{"type":"code"}]},{"text":" is your GREENSPECTOR Server API URL (for example ","type":"text"},{"text":"https://app.greenspector.com/api","type":"text","marks":[{"type":"link","attrs":{"href":"https://app.greenspector.com/api"}}]},{"text":");","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"privateToken","type":"text","marks":[{"type":"code"}]},{"text":" is your private token, available in the ","type":"text"},{"text":"Preferences","type":"text","marks":[{"type":"em"}]},{"text":" screen on your GREENSPECTOR Web Interface.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The file ","type":"text"},{"text":"$HOME/.greenspector/config.yml","type":"text","marks":[{"type":"em"}]},{"text":" should now exists.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"To check your configuration, type:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt ping","type":"text"}]},{"type":"paragraph","content":[{"text":"This command will tell you whether your basic configuration and credentials are correct or not. If correct, you should have the message \"Server pinged with success\".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Optional proxy configuration","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The proxy can be automatically detected.","type":"text"}]},{"type":"paragraph","content":[{"text":"In windows, the CLI automatically detects ","type":"text"},{"text":"WPAD","type":"text","marks":[{"type":"code"}]},{"text":" settings or PAC configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"In linux or mac, the CLI automatically detects env variable ","type":"text"},{"text":"HTTPS_PROXY","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"HTTP_PROXY or","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"FTP_PROXY","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"text":"If previous gspt ping does not work in your work office, you probably need to configure a proxy to allow the CLI to access Internet.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can check if you need to configure a proxy. Use a 4G mobile network for your PC and try to use the CLI. If it works, you need to configure a proxy.","type":"text"}]},{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"proxyUrl","type":"text","marks":[{"type":"code"}]},{"text":" property simply by using the command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt set-proxy\nor\ngspt set-proxy --proxyUrl ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want more details on this option, you can run the command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt set-proxy -h","type":"text"}]},{"type":"paragraph","content":[{"text":"Example for proxy without authentication:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt set-proxy --proxyUrl \"http://testproxy.local:3112/\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Example for proxy with authentication:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt set-proxy --proxyUrl \"http://myuser:mypassword%241%2C%21@testproxy.local:3112/\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Using --proxyUrl, If you have password with specials characters, you need to encode the password to use as url. You can use this ","type":"text"},{"text":"https://smalldev.tools/url-encoder-online","type":"text","marks":[{"type":"link","attrs":{"href":"https://smalldev.tools/url-encoder-online"}}]}]},{"type":"paragraph","content":[{"text":"For example, the password mypassword$1,! devient mypassword%241%2C%21","type":"text"}]},{"type":"paragraph","content":[{"text":"Example for proxy with authentification with interactive mode:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt set-proxy\n\nEnter the Proxy Protocol (http or https)\nProxy Protocol:\nhttp\n\nEnter the Proxy Host\nProxy Host:\ntestproxy.local\n\nEnter the Proxy Port\nProxy Port:\n3112\n\nIs this proxy authenticated? (y/N)\ny\n\nEnter the Proxy Username:\nmyuser\n\nEnter the Proxy Password:\nmypassword$1,!\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"You do not need to encode password in this interactive mode","type":"text"}]},{"type":"paragraph","content":[{"text":"To check your configuration, type:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt ping","type":"text"}]},{"type":"paragraph","content":[{"text":"This command will tell you whether your basic configuration and credentials are correct or not. If correct, you should have the message \"Server pinged with success\".","type":"text"}]},{"type":"paragraph","content":[{"text":"you can get these errors if you misconfigured your proxy:","type":"text"}]},{"type":"table","attrs":{"layout":"wide"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[799.0]},"content":[{"type":"paragraph","content":[{"text":"Error","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"Cause","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[799.0]},"content":[{"type":"paragraph","content":[{"text":". because an auto detection of your browser is set, you, you can find","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"Bad port","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[799.0]},"content":[{"type":"paragraph","content":[{"text":"Error: Get \"","type":"text"},{"text":"https://app.greenspector.com/api/ping","type":"text","marks":[{"type":"link","attrs":{"href":"https://app.greenspector.com/api/ping"}}]},{"text":"\": Proxy Authentication Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"Bad user or password","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[799.0]},"content":[{"type":"paragraph","content":[{"text":"Error: Get \"","type":"text"},{"text":"https://app.greenspector.com/api/ping","type":"text","marks":[{"type":"link","attrs":{"href":"https://app.greenspector.com/api/ping"}}]},{"text":"\": proxyconnect tcp: dial tcp 149.202.59.166:3129: i/o timeout","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"Bad Host","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[799.0]},"content":[{"type":"paragraph","content":[{"text":"Error: parse \"","type":"text"},{"text":"http://myuser:mypassword","type":"text","marks":[{"type":"link","attrs":{"href":"http://user2password1"}}]},{"text":"\": invalid port \":mypassword\" after host","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"Need to encode password","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[799.0]},"content":[{"type":"paragraph","content":[{"text":"Error: Get \"","type":"text"},{"text":"https://app.greenspector.com/api/ping","type":"text","marks":[{"type":"link","attrs":{"href":"https://app.greenspector.com/api/ping"}}]},{"text":"\": proxyconnect tcp: tls: first record does not look like a TLS handshake","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[157.0]},"content":[{"type":"paragraph","content":[{"text":"Bad protocol, use http instead of https or the opposite","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Tips:","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not know the proxy host of your office and your browser is configured automatically to discover the proxy, you can get the following file via your browser :","type":"text"}]},{"type":"paragraph","content":[{"text":"wpad./wpad.dat","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Example : ","type":"text"},{"text":"https://wpad.myorganisation.fr/wpad.dat","type":"text","marks":[{"type":"link","attrs":{"href":"https://wpad.myorganisation.fr/wpad.dat"}}]}]},{"type":"paragraph","content":[{"text":"If you open this file, you can find the host and port for the proxy.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Current working folder configuration in ","type":"text"},{"text":"$CURRENT_FOLDER/.greenspector/config.yml","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"In order to be able to use all the features of the GREENSPECTOR CLI, you also need a configuration file in your current working folder (","type":"text"},{"text":"$CURRENT_FOLDER/.greenspector/config.yml","type":"text","marks":[{"type":"em"}]},{"text":"). This file contains the following fields:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"$CURRENT_FOLDER/.greenspector/config.yml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"application: \nversion: \nenvironment: \n\tplatform: \n\tos: \n\tversion: \n\tdevice: \n\tbrowsers: ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"$CURRENT_FOLDER/.greenspector/config.yml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"application: MyFirstApplication\nversion: 0.1.2\nenvironment:\n\tplatform: mobile\n\tos: android\n\tversion: \"7\"\n\tdevice: nexus6\n\tbrowsers:\n\t- chrome","type":"text"}]},{"type":"paragraph","content":[{"text":"You do not have to manually edit this configuration file, you can simply initialize it with the command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt initprojectconfiguration -a \"\" -v \"\"\nor\ngspt ipc -a \"\" -v \"\"","type":"text"}]},{"type":"paragraph","content":[{"text":"This command will automatically set the fields ","type":"text"},{"text":"application","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"version","type":"text","marks":[{"type":"code"}]},{"text":" in you configuration file, other fields will be updated when you will start using CLI commands related to the Power Test Bench/Cloud service.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Usage","type":"text"}]},{"type":"paragraph","content":[{"text":"To use GREENSPECTOR Command Line, go to any folder and type the command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt ","type":"text"}]},{"type":"paragraph","content":[{"text":"You will find below a list of the available commands.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Help","type":"text"}]},{"type":"paragraph","content":[{"text":"The help of GREENSPECTOR Command Line is built in a tree way. You will only see one help level at a time.","type":"text"}]},{"type":"paragraph","content":[{"text":"Choose one of the following commands, depending on the level of help you need: general help, command help or subcommand help.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt -h\ngspt -h\ngspt -h","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Ping","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this command to test the connection to your GREENSPECTOR Server and check that your settings are correct:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt ping","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Meter","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature groups all the commands related to the Meter service:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt meter ","type":"text"}]},{"type":"paragraph","content":[{"text":"Before using ","type":"text"},{"text":"meter","type":"text","marks":[{"type":"code"}]},{"text":" command, you have to define the application and the version you are working on by setting the configuration file in the current folder by following instructions in paragraph ","type":"text"},{"text":"CLI#Current working folder configuration in $CURRENT_FOLDER/.greenspector/config.yml","type":"text","marks":[{"type":"link","attrs":{"href":"https://greenspector.atlassian.net/wiki/pages/resumedraft.action?draftId=43679773#CLI-Currentworkingfolderconfigurationin$CURRENT_FOLDER/.greenspector/config.yml"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Send measures","type":"text"}]},{"type":"paragraph","content":[{"text":"Use this subcommand to send the results files from the current folder to the server:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt meter send-measures","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature will read all the results files in the current folder and send their contents to your GREENSPECTOR Server.","type":"text"},{"type":"hardBreak"},{"text":"Please note that these files are deleted when they are successfully sent.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Power Test Cloud/Bench","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature groups all the commands related to the Power Test Cloud/Bench service:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt testbench ","type":"text"}]},{"type":"paragraph","content":[{"text":"Before using ","type":"text"},{"text":"testbench","type":"text","marks":[{"type":"code"}]},{"text":" command, you have to define the application and the version you are working on by setting the configuration file in the current folder by following instructions in paragraph ","type":"text"},{"text":"CLI#Current working folder configuration in $CURRENT_FOLDER/.greenspector/config.yml","type":"text","marks":[{"type":"link","attrs":{"href":"https://greenspector.atlassian.net/wiki/pages/resumedraft.action?draftId=43679773#CLI-Currentworkingfolderconfigurationin$CURRENT_FOLDER/.greenspector/config.yml"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Set the environment","type":"text"}]},{"type":"paragraph","content":[{"text":"To use the ","type":"text"},{"text":"testbench","type":"text","marks":[{"type":"code"}]},{"text":" command, you first need to set the environment for your project.","type":"text"},{"type":"hardBreak"},{"text":"To do so, you should use this command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt testbench set-environment","type":"text"}]},{"type":"paragraph","content":[{"text":"This command will ask you to select one environment among the available ones on your server. To select one, simply type the number for the environment you want when asked to.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Run a measure on a website (only available for android)","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature allows you to run a measure of a website on the Power Test Cloud/Bench.","type":"text"},{"type":"hardBreak"},{"text":"To use this feature, you have to first configure the application name, version and the environment to run the measure on.","type":"text"},{"type":"hardBreak"},{"text":"The command to run is:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt testbench measure-url --url ","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt testbench measure-url --url https://greenspector.com/\ngspt testbench measure-url --url https://greenspector.com/ --iterations 5 --browser chrome --networkMode 4G\ngspt testbench measure-url --url https://www.mozilla.org/fr/ --browser firefox --report","type":"text"}]},{"type":"paragraph","content":[{"text":"The options are :","type":"text"}]},{"type":"paragraph","content":[{"text":"1 - ","type":"text"},{"text":"--url","type":"text","marks":[{"type":"code"}]},{"text":": The URL to benchmark. ","type":"text"},{"text":"Mandatory option","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"2 - ","type":"text"},{"text":"--iterations","type":"text","marks":[{"type":"code"}]},{"text":": Number of iterations of measure you want. (Default: 1). ","type":"text"},{"text":"Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"3 - ","type":"text"},{"text":"--browser","type":"text","marks":[{"type":"code"}]},{"text":": Browser you want to run the measure on. (Default: Google Chrome). ","type":"text"},{"text":"Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"4 - ","type":"text"},{"text":"--networkMode: The network mode for the test. Values can be \"WIFI\", \"4G\", \"3G\" or \"2G\". (Default: WIFI). Optional","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"5 - ","type":"text"},{"text":"--report","type":"text","marks":[{"type":"code"}]},{"text":": Automatically generate the test report in the ","type":"text"},{"text":".greenspector","type":"text","marks":[{"type":"code"}]},{"text":" folder and wait for the job to end. (Default: false). ","type":"text"},{"text":"Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This command will send a measure request to the server. After this measure has run on the Power Test Bench/Cloud, you will find the results on the web interface.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Benchmark one or more app (only available for android)","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature allows you to benchmark your Android application on the Power Test Cloud/Bench.","type":"text"},{"type":"hardBreak"},{"text":"To use this feature, you have to first configure the application name, version and the environment to run the measure on.","type":"text"},{"type":"hardBreak"},{"text":"The command to run is:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt testbench benchmark-apk --app ","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"gspt testbench benchmark-apk --app target/final.apk # local path to apk\ngspt testbench benchmark-apk --app https://demo/demo.apk # apk from public url\ngspt testbench benchmark-apk --app com.microsoft.office.outlook # package name to download the apk from the PlayStore\ngspt testbench benchmark-apk --app target/main.apk --apkFile target/app-module.apk --apkFile target/commons.apk --networkMode 3G # three apk to install and launch benchmark in 3G\ngspt testbench benchmark-apk --app target/final.apk --iterations 5 --report # Launch 5 iterations of the benchmark and wait for the report\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The options are :","type":"text"}]},{"type":"paragraph","content":[{"text":"1 - ","type":"text"},{"text":"--app","type":"text","marks":[{"type":"code"}]},{"text":": The APK(s) to benchmark. (If set multiple times, all the APK will be installed but only the first one will be launched and monitored). The apk file could be a local path, a public URL or a package name to download from the PlayStore. ","type":"text"},{"text":"Optional if the applications to benchmark are already installed on phone","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"2 - ","type":"text"},{"text":"--iterations","type":"text","marks":[{"type":"code"}]},{"text":": Number of iterations of measure you want. (Default: 1). ","type":"text"},{"text":"Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"3 - ","type":"text"},{"text":"--report","type":"text","marks":[{"type":"code"}]},{"text":": (","type":"text"},{"text":"Beta feature","type":"text","marks":[{"type":"strong"}]},{"text":") Automatically generate the test report in the ","type":"text"},{"text":".greenspector","type":"text","marks":[{"type":"em"}]},{"text":" folder and wait for the job to end. (Default: false). ","type":"text"},{"text":"Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"4 - ","type":"text"},{"text":"--networkMode: The network mode for the test. Values can be \"WIFI\", \"4G\", \"3G\" or \"2G\". (Default: WIFI). Optional","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command will send a measure request to the server. After this measure has run on the Power Test Bench/Cloud, you will find the results on the Web Interface.","type":"text"}]},{"type":"paragraph","content":[{"text":"Some options are deprecated:","type":"text"}]},{"type":"paragraph","content":[{"text":"1 - ","type":"text"},{"text":"--apkFile","type":"text","marks":[{"type":"code"}]},{"text":": The APK(s) to benchmark. (If set multiple times, all the APK will be installed but only the first one will be launched and monitored). The apk file could be a local path, a public URL or a package name to download from the PlayStore. ","type":"text"},{"text":"Optional if the applications to benchmark are already installed on phone. ","type":"text","marks":[{"type":"strong"}]},{"text":" This option is deprecated, use --app.","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"2 - ","type":"text"},{"text":"--apkFiles: The APK(s) to benchmark. (If set multiple times, all the APK will be installed but only the first one will be monitored). Mandatory option: Minimum 1. This option is deprecated, use --app.","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Run your custom functional tests on your app / website","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature allows you to run your custom functional tests on your Android application, iOS application or web site on the Power Test Cloud/Bench.","type":"text"},{"type":"hardBreak"},{"text":"To use this feature, you have to first configure the application name, version and the environment to run the measure on.","type":"text"},{"type":"hardBreak"},{"text":"The command to run is:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# To run Greenspector DSL tests\ngspt testbench custom-tests --app --testsSuite --monitoredPackage \n# To run android tests (uiautomator, espresso)\ngspt testbench custom-tests --app --app --app --testPackage --monitoredPackage ","type":"text"}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# To run Greenspector DSL tests\ngspt testbench custom-tests --app target/demo.apk --testsSuite suite1:tests/file1.testgb --monitoredPackage com.greenspector.demo.app\n\ngspt testbench custom-tests --app target/demo.ipa --testsSuite suite1:tests/file1.testgb,tests/file2.tgb --testsSuite suite2:tests/file3.testgb --monitoredPackage com.greenspector.demo.app\n\ngspt testbench custom-tests --app fr.francetv.pluzz --testsSuite launch:./script.testgb --monitoredPackage fr.francetv.pluzz --iterations=1\n\n# Other examples to run android tests without GDSL (uiautomator, espresso)\n\ngspt testbench custom-tests --app target/demo.apk --app target/testuiautomator-debug-androidTest.apk --app target/testuiautomator-debug.apk --testPackage com.greenspector.demo.tests --monitoredPackage com.greenspector.demo.app\n\ngspt testbench custom-tests --app https://dl.greenspector.com/demo/demo.apk --app https://dl.greenspector.com/demo/testuiautomator-debug-androidTest.apk --app https://dl.greenspector.com/demo/testuiautomator-debug.apk\n --testPackage com.greenspector.demo.tests --monitoredPackage com.greenspector.demo\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The options are:","type":"text"}]},{"type":"paragraph","content":[{"text":"1 - ","type":"text"},{"text":"--app","type":"text","marks":[{"type":"code"}]},{"text":": Precise the APP (android or iOS app) you want to measure. For android, if you do not have GDSL tests, you put the APKs which contain your functional tests to launch. Prefer separate APKs for your app and for your tests. The app could be a local file path to an ipa or an apk, a public URL to a ipa or apk or a package name to download from the PlayStore, or an url to install ipa from Apple store","type":"text"}]},{"type":"paragraph","content":[{"text":"2 - ","type":"text"},{"text":"--testPackage","type":"text","marks":[{"type":"code"}]},{"text":": For each APK containing functional tests you want to launch (i.e. UI Automator or Espresso tests), precise the name of the android package (i.e. package in file ","type":"text"},{"text":"AndroidManifest.xml","type":"text","marks":[{"type":"em"}]},{"text":"). All tests in those Android packages will be launched. ","type":"text"},{"text":"Only for non GDSL test. Mandatory option: Minimum 1 if --testsSuite is not used","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"3 - ","type":"text"},{"text":"--testsSuite","type":"text","marks":[{"type":"code"}]},{"text":": For each suite, precise the suite name and the lists of test files writen with Greenspector DSL. All test files will be launched in the specified order. ","type":"text"},{"text":"Mandatory option: Minimum 1 if --testPackage is not used","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"4 - ","type":"text"},{"text":"--monitoredPackage","type":"text","marks":[{"type":"code"}]},{"text":": For each Android application you want to monitored, precise the name of the android package to get metrics about the process (process data, process CPU…). Probes can monitor multi package at a time. In this case, metrics are agreggated. For website, choose the browser where the tests runs (i.e. ","type":"text"},{"text":"com.android.chrome","type":"text","marks":[{"type":"code"}]},{"text":"). ","type":"text"},{"text":"Mandatory option: Minimum 1","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"5 - ","type":"text"},{"text":"--iterations","type":"text","marks":[{"type":"code"}]},{"text":": Number of iterations of measure you want. (Default: 1). ","type":"text"},{"text":"Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"6 - ","type":"text"},{"text":"--report","type":"text","marks":[{"type":"code"}]},{"text":": Automatically generate the test report in the ","type":"text"},{"text":".greenspector","type":"text","marks":[{"type":"em"}]},{"text":" folder and wait for the job to end.(Default: false). ","type":"text"},{"text":"Optional","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This command will send a measure request to the server. After this measure will ran on the Power Test Bench/Cloud, you will find the results on the Web Interface.","type":"text"}]},{"type":"paragraph","content":[{"text":"7 - ","type":"text"},{"text":"--extra: ","type":"text","marks":[{"type":"code"}]},{"text":"Use to transmit extras parameters to your instrumentation with the format name=value ","type":"text"},{"text":"(ie ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"--extra annotation=com.greenspector.demo.test.MyAnnotation","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}},{"type":"strong"}]},{"text":" add the following parameters to your instrumentation ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"-e annotation com.greenspector.demo.test.MyAnnotation","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}},{"type":"strong"}]},{"text":"). ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"Thus you can filter your tests for ","type":"text"},{"text":"example","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":" using those extras parameters : ","type":"text"},{"text":"https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner","type":"text","marks":[{"type":"textColor","attrs":{"color":"#212121"}},{"type":"link","attrs":{"href":"https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner"}}]},{"text":").","type":"text","marks":[{"type":"textColor","attrs":{"color":"#212121"}}]},{"text":" It can also be used ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"to fill parameters on GDSL file. (exemple ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"--extra PARAMETERNAME=\"value\" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}},{"type":"strong"}]},{"text":"will replace all ${PARAMETERNAME} in the GDSL file by value)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":". Optional","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#091e42"}}]}]},{"type":"paragraph","content":[{"text":"8 - ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"--networkMode: The network mode for the test. Values can be \"WIFI\", \"4G\", \"3G\" or \"2G\". (Default: WIFI). Optional","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"9 - ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#1d1c1d"}}]},{"text":"--","type":"text","marks":[{"type":"code"}]},{"text":"disable-dumpsys: Disable Android System Monitoring. By default, this is enabled and will add one iteration to your job for more detailed metrics (Views, Activity, OpenSSL Sockets, ...). If you don't need these metrics, you can disable this iteration, it will reduce testing time.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#1d1c1d"}}]}]},{"type":"paragraph","content":[{"text":"10 - ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#1d1c1d"}}]},{"text":"--","type":"text","marks":[{"type":"code"}]},{"text":"only-dumpsys: Run only a Android System Monitoring iteration. This iteration will only be able to retrieve Android System metrics (Views, Activity, OpenSSL Sockets, ...).","type":"text","marks":[{"type":"textColor","attrs":{"color":"#1d1c1d"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Some options are deprecated:","type":"text"}]},{"type":"paragraph","content":[{"text":"1 - ","type":"text"},{"text":"--apkFile","type":"text","marks":[{"type":"code"}]},{"text":": Precise the APKs you want to measure and the APKs which contain your functional tests to launch. Prefer separate APKs for your app and for your tests. The apk file could be a local path, a public URL or a package name to download from the PlayStore. ","type":"text"},{"text":"This option is deprecated, use --app","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"1 - ","type":"text"},{"text":"--apkFiles","type":"text","marks":[{"type":"code"}]},{"text":": Precise the APKs you want to measure and the APKs which contain your functional tests to launch. Prefer separate APKs for your app and for your tests. ","type":"text"},{"text":"This option is deprecated, use --app","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"2 - ","type":"text"},{"text":"--testPackages","type":"text","marks":[{"type":"code"}]},{"text":": For each APK containing functional tests you want to launch (i.e. UIAutomator or Espresso tests), precise the name of the android package (i.e. package in file ","type":"text"},{"text":"AndroidManifest.xml","type":"text","marks":[{"type":"em"}]},{"text":"). All tests in those Android packages will be launched. ","type":"text"},{"text":"T","type":"text","marks":[{"type":"strong"}]},{"text":"his option is deprecated, use --testPackage","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"3 - ","type":"text"},{"text":"--monitoredPackages","type":"text","marks":[{"type":"code"}]},{"text":": The package name of the Android application to monitor with the probes to get metrics about the process (process data, process CPU…). Probes can monitor only one package at a time. For website, choose the browser where the tests runs (i.e. ","type":"text"},{"text":"com.android.chrome","type":"text","marks":[{"type":"code"}]},{"text":"). ","type":"text"},{"text":"This option is deprecated, use --","type":"text","marks":[{"type":"strong"}]},{"text":"monitoredPackage","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Related articles","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"contentbylabel","parameters":{"macroParams":{"showLabels":{"value":"false"},"max":{"value":"5"},"spaces":{"value":"com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@185bfa9a"},"showSpace":{"value":"false"},"sort":{"value":"modified"},"reverse":{"value":"true"},"type":{"value":"page"},"cql":{"value":"label = \"cli\" and type = \"page\" and space = \"DOCUMENTATION\""},"labels":{"value":"kb-how-to-article"}},"macroMetadata":{"macroId":{"value":"8b1fff7b-0d57-42db-9c96-160277037b6c"},"schemaVersion":{"value":"4"},"title":"Filter by label (Content by label)"}}}}],"version":1}