Mobile Scripts Python OpenSDK

Prerequisites
Before using some of the below methods, we will need to obtain an API key, agent ID and device UDID which are all can be extracted from TestProject UI, no worries it really simple.
1.Navigate to TestProject API Page: https://app.testproject.io/#/integrations/api, get your API Key, or create one if you do not have one.
   3. In the Agents tab, press on the desired agent, devices and copy the UDID, read more about how to do it here.
   4. Copy the Agent ID which you can find on the Agents page here.
Get a list of connected mobile devices
The bellow Python script will get the agent connected devices based on agent ID. Make sure to supply the API key and Agent ID which you obtained as described before. 
1
import requests as req
2
​
3
api_key = ""  # Your API Key, which you get from TestProject UI https://app.testproject.io/#/integrations/api
4
agent_id = ""  # The Agent ID which you also retrieve from the TestProject UI https://app.testproject.io/#/agents
5
base = f"https://api.testproject.io/v2"
6
​
7
​
8
def get_agent_devices():
9
    data = {"Authorization": api_key}
10
    res = req.get(url=f"{base}/agents/{agent_id}/devices", headers=data)
11
    print(res.status_code, res.text)
12
​
13
​
14
if __name__ == '__main__':
15
    get_agent_devices()
Copied!
Get agent state
The agent can be in 5 different states: Disconnected, Idle, Development, Recording, Executing. to start your CI the agent should be in Ready state. Use the below Python script for validating the agent state. 
1
import requests as req
2
​
3
api_key = ""  # Your API Key, which you get from TestProject UI https://app.testproject.io/#/integrations/api
4
agent_id = ""  # The Agent ID which you also retrieve from the TestProject UI https://app.testproject.io/#/agents
5
base = f"https://api.testproject.io/v2"
6
​
7
​
8
def get_agent_state():
9
    data = {"Authorization": api_key}
10
    res = req.get(url=f"{base}/agents/{agent_id}/state", headers=data)
11
    print(res.status_code, res.text)
12
​
13
​
14
if __name__ == '__main__':
15
    get_agent_state()
16
​
Copied!
Get installed applications
Below is the Python code to query the agent API to get the installed applications on the connected device. The response will be a JSON array of all installed applications on the device selected.
1
import requests as req
2
​
3
port = "8585"  # This is the feault Agent communication port
4
base = f"http://localhost:{port}"
5
udid = ""  # UDID of the device to pull the apps from
6
​
7
​
8
def get_list_of_installed_applications():
9
    res = req.get(url=f"{base}/api/devices/{udid}/apps")
10
    print(res.status_code, res.text)
11
​
12
​
13
if __name__ == '__main__':
14
    get_list_of_installed_applications()
15
    
Copied!
Installing an APK/IPA in Runtime with OpenSDK 
TestProject takes care of IPA/APK installations and deployment process out of the box when using recorded tests or when uploading the code binaries to TestProject cloud. If you prefer to use a local CI with the OpenSDK, the process to install an IPA/APK programmatically on a device in Runtime will be the same as using fluent Appium commands.  The below Python script will deploy and install locally saved APK/IPA on the connected device and execute the example test script. 
You can reinstall the application if the 'noReset' capability is provided with the value of 'true'.
Prerequisites: TestProject agent is installed, registered and in Ready state, the latest version of TestProject OpenSDK is installed, developer key is provided (can be obtained from the integration area as described above).
​
If no token is provided in the constructor of the driver, it will use the environment variable TP_DEV_TOKEN
​
1
from selenium.webdriver.common.by import By
Copied!
1
from src.testproject.sdk.drivers import webdriver
2
import pytest
3
​
4
​
5
@pytest.fixture
6
def driver():
7
​
8
    device_udid = "emulator-5554"  # This is the Device UDID
9
    desired_capabilities = {
10
        "app": "C:\\Test\\testproject-demo-app.apk",
11
        "udid": device_udid,
12
        "platformName": "Android",  # You can change this to IOS if you are installing an IPA
13
        "fullReset": "true",
14
    }
15
​
16
    #  Replace 'token' with your developer token https://app.testproject.io/#/integrations/sdk
17
    driver = webdriver.Remote(token="kJCeheorpsyq8u4Z17k0JQyBck1qLIf5ZrynbI6t7Fk1", desired_capabilities=desired_capabilities)
18
​
19
    yield driver
20
​
21
    driver.close_app()
22
    driver.quit()
23
​
24
​
25
#  This simple test will install the TestProject application inside the path above and run those simple steps.
26
#  It will re install the app using the fullReset capability.
27
def test_install(driver):
28
    textfield_name = (By.ID, "name")
29
    textfield_password = (By.ID, "password")
30
    button_dologin = (By.ID, "login")
31
​
32
    username = "TestProject"
33
    password = "12345"
34
​
35
    driver.find_element(*textfield_name).send_keys(username)
36
    driver.find_element(*textfield_password).send_keys(password)
37
    driver.find_element(*button_dologin).click()
38
​
39
​
Copied!
You can also install an IPA for an IOS device by changing the 'platformName' to IOS.

Execution Speed & Adaptive Wait

Using Page object model and Page Factory with TestProject

Last modified 1yr ago

Copy link

Contents

Prerequisites

Get a list of connected mobile devices

Get agent state

Get installed applications

Installing an APK/IPA in Runtime with OpenSDK