Skip to content

Latest commit

 

History

History
 
 

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ascii
ascii
 
 
assets
assets
 
 
bugs
bugs
 
 
corellium
corellium
 
 
desktop
desktop
 
 
feature
feature
 
 
flank-github-action
flank-github-action
 
 
flank-output-investigation
flank-output-investigation
 
 
flank-scripts
flank-scripts
 
 
gcloud
gcloud
 
 
hld
hld
 
 
onboarding
onboarding
 
 
refactor
refactor
 
 
stylesheets
stylesheets
 
 
architecture.md
architecture.md
 
 
binaries_used_in_flank_ios_testing.md
binaries_used_in_flank_ios_testing.md
 
 
bugsnag-logo-dark.png
bugsnag-logo-dark.png
 
 
building_updating_flank.md
building_updating_flank.md
 
 
client_generation.md
client_generation.md
 
 
cucumber_support.md
cucumber_support.md
 
 
dependencies_update_process.md
dependencies_update_process.md
 
 
exit_codes_and_exceptions.md
exit_codes_and_exceptions.md
 
 
flank_corellium.md
flank_corellium.md
 
 
flank_secrets.md
flank_secrets.md
 
 
flank_vision.md
flank_vision.md
 
 
flutter_status.md
flutter_status.md
 
 
getting_delete_permission_exception_when_using_results-dir_option.md
getting_delete_permission_exception_when_using_results-dir_option.md
 
 
host_binaries_solutions_comparison.md
host_binaries_solutions_comparison.md
 
 
hypershard_android.md
hypershard_android.md
 
 
hypershard_ios.md
hypershard_ios.md
 
 
index.md
index.md
 
 
instrumentation_tests.md
instrumentation_tests.md
 
 
investigate_flank_options.md
investigate_flank_options.md
 
 
junit_xml_comparison.md
junit_xml_comparison.md
 
 
logging.md
logging.md
 
 
mock_server.md
mock_server.md
 
 
permissions_denied_behavior.md
permissions_denied_behavior.md
 
 
pr_titles.md
pr_titles.md
 
 
readme.md
readme.md
 
 
release_process.md
release_process.md
 
 
smart_flank.md
smart_flank.md
 
 
test_artifacts.md
test_artifacts.md
 
 
test_sharding.md
test_sharding.md
 
 
update_gradle.md
update_gradle.md
 
 
using_different_environment_variables_in_different_matrices.md
using_different_environment_variables_in_different_matrices.md
 
 
windows_and_github_actions.md
windows_and_github_actions.md
 
 
windows_wsl_guide.md
windows_wsl_guide.md
 
 

readme.md

Flank Kotlin Build Status

Rewrite of Flank in Kotlin

Design decisions.

  • APIs are used for all Google Cloud interactions
  • Firebase Test Lab transparently retries VMs 3x
    • Infrastructure Failures may lead to 4 hours or more of wait times as a result, retrying VMs on failure isn't super helpful.
    • VM timeout applies only once the VM has booted. Hours spent waiting for the VM to boot aren't included in the wait time.
  • Test failures are best retried using a retry JUnit rule combined with Android Test Orchestrator and an app reset rule
    • On device retry is free since we don't need to spin up a new VM.
    • Each VM created is another opportunity for FTL to error. Even when VMs boot correctly, it's at least a 5m wait time.

Client libraries

Google provides two types of client libraries: Google API Client Libraries and Google Cloud Client Libraries.

  • google-api-services-* - legacy
    • google-api-services-storage
    • google-api-services-toolresults
    • google-api-services-testing
  • google-cloud-* - newest
    • google-cloud-storage

Discovery JSON

The discovery JSON is useful for understanding APIs and producing clients automatically. The discovery JSON contains the latest changes.

See client generation for more information.

google-cloud-storage

Published on maven central

com.google.cloud:google-cloud-storage:1.15.0

google-api-services-toolresults

Published on maven central

com.google.apis:google-api-services-toolresults:v1beta3-rev351-1.21.0

google-api-services-testing

Client may be generated manually using testing_v1.json and the master branch of apis-client-generator. Google also publishes official clients:

Clone

  • git clone https://android.googlesource.com/platform/tools/studio/google/cloud/testing
  • git checkout studio-master-dev
  • Android Studio repo

Build

  • gradle build

Mock Servers

API Discovery JSON may be converted to OpenAPI 3 using apimatic.io/transformer. See mock_server.md for details.