{"id":21944713,"url":"https://github.com/browserstack/robot-appium-app-browserstack","last_synced_at":"2025-03-22T16:15:17.163Z","repository":{"id":187105439,"uuid":"672746666","full_name":"browserstack/robot-appium-app-browserstack","owner":"browserstack","description":" Robot Appium integration with BrowserStack","archived":false,"fork":false,"pushed_at":"2024-11-21T14:58:03.000Z","size":35431,"stargazers_count":1,"open_issues_count":5,"forks_count":2,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-02-03T17:29:15.336Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"RobotFramework","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browserstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-31T04:31:26.000Z","updated_at":"2024-09-17T15:51:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"97a6f150-5c3e-41bc-8997-2197fe17af1d","html_url":"https://github.com/browserstack/robot-appium-app-browserstack","commit_stats":null,"previous_names":["browserstack/robot-appium-app-browserstack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Frobot-appium-app-browserstack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Frobot-appium-app-browserstack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Frobot-appium-app-browserstack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Frobot-appium-app-browserstack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browserstack","download_url":"https://codeload.github.com/browserstack/robot-appium-app-browserstack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244982057,"owners_count":20542300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T04:16:56.932Z","updated_at":"2025-03-22T16:15:17.138Z","avatar_url":"https://github.com/browserstack.png","language":"RobotFramework","funding_links":[],"categories":[],"sub_categories":[],"readme":"# robot-appium-app-browserstack\n\nThis repository demonstrates how to run Appium Robot tests on BrowserStack App Automate.\n\n## Based on\n\nThese code samples are currently based on:\n\n- **Appium-Python-Client:** `3.2.1`\n- **Selenium:** `4.16.0`\n- **Protocol:** `W3C`\n\n## Setup\n\n### Requirements\n\n1. Python 3.7+\n\n   \u003e **_NOTE:_** Since v1.0.0, only Python 3.7+ is supported.\n\n   - For Windows, download latest python version from [here](https://www.python.org/downloads/windows/) and run the installer executable\n   - For Mac and Linux, run `python --version` to see what python version is pre-installed. If you want a different version download from [here](https://www.python.org/downloads/)\n\n2. Package Manager pip\n\n   Note : `pip` comes installed with python 3.4+\n\n   - If `pip` is not installed, follow these instructions:\n\n     - Securely download get-pip.py by following this link: [get-pip.py](https://bootstrap.pypa.io/get-pip.py) or use following cURL command to download it:\n\n     ```sh\n     curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py\n     ```\n\n     - After dowloading, run the file :\n\n       - For Python 3\n\n         ```sh\n         python3 get-pip.py\n         ```\n\n### Install the dependencies\n\nTo install the dependencies, run the following command in project's base directory:\n\n- For Python 3\n\n  ```sh\n  pip3 install -r requirements.txt\n  ```\n\n## Getting Started\n\nGetting Started with Appium tests in Robot on BrowserStack couldn't be easier!\n\n### Run your first test :\n\n**1. Upload your Android or iOS App**\n\nUpload your Android app (.apk or .aab file) or iOS app (.ipa file) to BrowserStack servers using our REST API. Here is an example cURL request :\n\n```\ncurl -u \"YOUR_USERNAME:YOUR_ACCESS_KEY\" \\\n-X POST \"https://api-cloud.browserstack.com/app-automate/upload\" \\\n-F \"file=@/path/to/apk/file\"\n```\n\nEnsure that @ symbol is prepended to the file path in the above request. Please note the `app_url` value returned in the API response. We will use this to set the application under test while configuring the test later on.\n\n**Note**: If you do not have an .apk or .ipa file and are looking to simply try App Automate, you can download and test using our [sample Android app](https://www.browserstack.com/app-automate/sample-apps/android/WikipediaSample.apk) or [sample iOS app](https://www.browserstack.com/app-automate/sample-apps/ios/BStackSampleApp.ipa).\n\n**2. Configure and run your first test**\n\nExport BrowserStack access credentials\n- Run `export BROWSERSTACK_USERNAME=\u003cusername\u003e \u0026\u0026 export BROWSERSTACK_ACCESS_KEY=\u003caccesskey\u003e`\n  - Get your BrowserStack access credentials from [here](https://www.browserstack.com/accounts/settings)\n\nOpen `Tests/android/SingleTestAndroid.robot`\n\n- Replace `bs://\u003capp-id\u003e` with the URL obtained from app upload step\n\n- Set the device and OS version\n\n- If you have uploaded your own app update the test case\n\n- Run `robot  --outputdir . Tests/android/SingleTestAndroid.robot`\n\n- You can access the test execution results, and debugging information such as video recording, network logs on [App Automate dashboard](https://app-automate.browserstack.com/dashboard)\n\n---\n\n### **Use Local testing for apps that access resources hosted in development or testing environments :**\n\n**1. Upload your Android or iOS App**\n\nUpload your Android app (.apk or .aab file) or iOS app (.ipa file) that access resources hosted on your internal or test environments to BrowserStack servers using our REST API. Here is an example cURL request :\n\n```\ncurl -u \"YOUR_USERNAME:YOUR_ACCESS_KEY\" \\\n-X POST \"https://api-cloud.browserstack.com/app-automate/upload\" \\\n-F \"file=@/path/to/apk/file\"\n```\n\nEnsure that @ symbol is prepended to the file path in the above request. Please note the `app_url` value returned in the API response. We will use this to set the application under test while configuring the test later on.\n\n**Note**: If you do not have an .apk or .ipa file and are looking to simply try App Automate, you can download and test using our [sample Android Local app](https://www.browserstack.com/app-automate/sample-apps/android/LocalSample.apk) or [sample iOS Local app](https://www.browserstack.com/app-automate/sample-apps/ios/LocalSample.ipa).\n\n**2. Configure and run your local test**\n\nOpen `Tests/common/KeywordsFile.robot` file :\n\n- Replace `BROWSERSTACK_USERNAME` \u0026 `BROWSERSTACK_ACCESS_KEY` with your BrowserStack access credentials. Get your BrowserStack access credentials from [here](https://www.browserstack.com/accounts/settings)\n\nOpen `Tests/android/LocalTestAndroid.robot`\n\n- Replace `bs://\u003capp-id\u003e` with the URL obtained from app upload step\n\n- Set the device and OS version\n\n- If you have uploaded your own app update the test case\n\n- Run `robot  --outputdir . Tests/android/LocalTestAndroid.robot`\n\n- You can access the test execution results, and debugging information such as video recording, network logs on [App Automate dashboard](https://app-automate.browserstack.com/dashboard)\n\n**3. Configure and run your tests in parallel**\n\nTo run parallel tests we will be using the Pabot library\n\nAndroid Test\n- Run `pabot --processes \u003ccount_of_parallels\u003e Tests/android/parallel/*.robot`\n\niOS Tests\n- Run `pabot --processes \u003ccount_of_parallels\u003e Tests/ios/parallel/*.robot`\n\n## Integration with other python frameworks\n\nFor other Python frameworks samples, refer to following repositories :\n\n- [Behave](https://github.com/browserstack/behave-appium-app-browserstack)\n- [Lettuce](https://github.com/browserstack/lettuce-appium-app-browserstack)\n\nNote: For other test frameworks supported by App-Automate refer our [Developer documentation](https://www.browserstack.com/docs/)\n\n## Getting Help\n\nIf you are running into any issues or have any queries, please check [Browserstack Support page](https://www.browserstack.com/support/app-automate) or [get in touch with us](https://www.browserstack.com/contact?ref=help).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserstack%2Frobot-appium-app-browserstack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowserstack%2Frobot-appium-app-browserstack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserstack%2Frobot-appium-app-browserstack/lists"}