Test suites
To test your Android apps on BrowserStack using Flutter,upload your test suite in .apk
format to BrowserStack servers. Use our REST API endpoints to upload and manage your test-suites on BrowserStack.
Upload a test suite
Upload an Flutter test suite (.apk
file) using File System method.
Request parameters
Request
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/flutter-integration-tests/v2/android/test-suite" \
-F "file=@/path/to/test/file/app-flutter-androidTest.apk" \
-F "custom_id=SampleTest"
-
file File
File to upload. Ensure that the request’s content type is set to
multipart/form-data
. In cURL, you can do this using-F
option. Eitherfile
orurl
parameter is required. -
url String
Remote URL to your test-suite. Ensure that it’s a publicly accessible URL as BrowserStack will attempt to download the test-suite from this location. Either
file
orurl
parameter is required. -
custom_id String
Custom ID for the test-suite. Accepted characters are
A-Z
,a-z
,0-9
,.
,-
,_
. All other characters are ignored. Character limit is 100.
Response attributes 200
application/json
Response
{
"test_suite_name": "app-flutter-androidTest.apk",
"test_suite_url": "bs://89c874f21852ba57957a3fdc33f47514288c4ba1",
"test_suite_id": "89c874f21852ba57957a3fdc33f47514288c4ba1",
"uploaded_at": "2020-09-09 15:35:00 UTC",
"custom_id": "SampleTest",
"shareable_id": "user/SampleTest",
"framework": "Flutter",
"expiry": "2020-10-09 15:35:00 UTC",
}
-
test_suite_name String
Filename of the uploaded test-suite.
-
test_suite_url String
Unique identifier returned upon successful upload of your test-suite on BrowserStack. This value can be used later to specify the test-suite for your flutter test execution.
Example:bs://c8ddcb5649a8280ca800075bfd8f151115bba6b3
-
test_suite_id String
Unique identifier returned upon successful upload of your test-suite on BrowserStack.
Example:c8ddcb5649a8280ca800075bfd8f151115bba6b3
-
uploaded_at String
Test-suite upload timestamp.
-
framework String
Name of the automation framework. This is set to flutter by default.
-
custom_id String
Custom ID defined for the uploaded test-suite.
Example:SampleTest
. Accepted characters areA-Z
,a-z
,0-9
,.
,-
,_
. All other characters are ignored. Character limit is 100. -
shareable_id String
Shareable ID allows other users in your organization to test with an flutter test-suite you uploaded .
Example:user/SampleTest
-
expiry String
By default, an uploaded test-suite expires in 30 days. Upon expiry, the uploaded test-suite is deleted from BrowserStack servers and thus can no longer be tested.
List uploaded test suites
Retrieve a list of recently uploaded test suites. By default, it returns the last 10 uploaded test suites from your BrowserStack group.
Request parameters
Request
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X GET "https://api-cloud.browserstack.com/app-automate/flutter-integration-tests/v2/android/test-suites"
No parameter required.
Response attributes 200
application/json
Response
{
"test_suites" : [
{
"test_suite_name": "app-flutter-androidTest.apk",
"test_suite_url": "bs://89c874f21852ba57957a3fdc33f47514288c4ba1",
"test_suite_id": "89c874f21852ba57957a3fdc33f47514288c4ba1",
"uploaded_at": "2020-09-09 15:35:00 UTC",
"custom_id": "SampleTest",
"shareable_id": "user/SampleTest",
"framework": "Flutter",
"expiry": "2020-10-09 15:35:00 UTC"
},
{...}
]
}
-
test_suites Array
List of recently uploaded test-suites.
-
test_suite_name String
Filename of the uploaded test-suite.
-
test_suite_url String
Unique identifier returned upon successful upload of your test-suite on BrowserStack. This value can be used later to specify the test-suite for your Flutter test execution.
Example:bs://c8ddcb5649a8280ca800075bfd8f151115bba6b3
-
test_suite_id String
Unique identifier returned upon successful upload of your test-suite on BrowserStack.
Example:c8ddcb5649a8280ca800075bfd8f151115bba6b3
-
uploaded_at String
Test-suite upload timestamp.
-
framework String
Name of the automation framework. This is set to Flutter by default.
-
custom_id String
Custom ID defined for the uploaded test-suite.
Example:SampleTest
. Accepted characters areA-Z
,a-z
,0-9
,.
,-
,_
. All other characters are ignored. Character limit is 100. -
shareable_id String
Shareable ID allows other users in your organization to test with an Flutter test-suite you uploaded .
Example:user/SampleTest
-
expiry String
By default, an uploaded test-suite expires in 30 days. Upon expiry, the uploaded test-suite is deleted from BrowserStack servers and thus can no longer be tested.
-
shareable_id String
Shareable ID allows other users in your organization to test an app you uploaded .
Example:steve/SampleApp
-
Get test suite details
Get details of an uploaded test suite. You can use the test suite ID from the recently uploaded test suite
Request parameters
Request
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X GET "https://api-cloud.browserstack.com/app-automate/flutter-integration-tests/v2/android/test-suites/225a6b96e570c911b1847a1e6a276b963aa5224a"
-
test_suite_id* String
Test-suite ID of the uploaded test-suite.
Response attributes 200
application/json
Response
{
"test_suite" : {
"test_suite_name": "app-flutter-androidTest.apk",
"test_suite_url": "bs://89c874f21852ba57957a3fdc33f47514288c4ba1",
"test_suite_id": "89c874f21852ba57957a3fdc33f47514288c4ba1",
"uploaded_at": "2020-09-09 15:35:00 UTC",
"custom_id": "SampleTest",
"shareable_id": "user/SampleTest",
"framework": "Flutter",
"expiry": "2020-10-09 15:35:00 UTC",
}
}
-
test_suite Object
Details of the uploaded test-suite
-
test_suite_name String
Filename of the uploaded test-suite.
-
test_suite_url String
Unique identifier returned upon successful upload of your test-suite on BrowserStack. This value can be used later to specify the test-suite for your test execution.
Example:bs://c8ddcb5649a8280ca800075bfd8f151115bba6b3
-
test_suite_id String
Unique identifier returned upon successful upload of your test-suite on BrowserStack.
Example:c8ddcb5649a8280ca800075bfd8f151115bba6b3
-
uploaded_at String
Test-suite upload timestamp.
-
framework String
Name of the automation framework. This is set to by default.
-
custom_id String
Custom ID defined for the uploaded test-suite.
Example:SampleTest
. Accepted characters areA-Z
,a-z
,0-9
,.
,-
,_
. All other characters are ignored. Character limit is 100. -
shareable_id String
Shareable ID allows other users in your organization to test with an test-suite you uploaded .
Example:user/SampleTest
-
expiry String
By default, an uploaded test-suite expires in 30 days. Upon expiry, the uploaded test-suite is deleted from BrowserStack servers and thus can no longer be tested.
-
Delete a test suite
Delete an uploaded test suite. Note that test suites once deleted cannot be recovered. You can use the test suite ID from the recently uploaded test suite.
Request parameters
Request
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X DELETE "https://api-cloud.browserstack.com/app-automate/flutter-integration-tests/v2/android/test-suites/6bdddb46b33a063b38286a08fa26015a2ea57a23"
-
test_suite_id* String
Test-suite ID of the uploaded test-suite.
Response attributes 200
application/json
Response
{
"success": {
"message": "Test Suite with url bs://6c4a46de7b0361585594fd3e5464bddff95d581b was deleted."
}
}
-
success Object
This is returned when the test-suite is successfully deleted from BrowserStack servers.
-
message String
Confirmation message for test-suite deletion.
-
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.