step.yml

title: Bluepill Build/Test for iOS
summary: Build and run parallel UI/Unit tests for iOS using LinkedIn's bluepill testing tool
description: Run tests in parallel by using multiple simulators. Generate a JUnit report after each test run.
website: https://github.com/HealthEngineAU/bitrise-step-bluepill-build-test-for-ios
source_code_url: https://github.com/HealthEngineAU/bitrise-step-bluepill-build-test-for-ios
support_url: https://github.com/HealthEngineAU/bitrise-step-bluepill-build-test-for-ios/issues
host_os_tags:
  - osx-10.10
project_type_tags:
  - ios
type_tags:
  - build
  - test
is_requires_admin_user: true
is_always_run: false
is_skippable: false
inputs:
  - bluepill_version: bluepill_5_1_1__xcode_11_2
    opts:
      title: "Bluepill Version"
      summary: "Which version of Bluepill to install/run?"
      is_required: true
      value_options:
      - bluepill_5_1_1__xcode_11_2
      - bluepill_5_0_0__xcode_11_0
      - bluepill_4_1_1__xcode_10_2
      - bluepill_3_1_1__xcode_10_1
      - bluepill_3_1_0__xcode_10_0
      - bluepill_2_4_0__xcode_9_4
      - bluepill_2_3_1__xcode_9_3
      - bluepill_2_2_0__xcode_9_2
      - bluepill_2_1_0__xcode_9_1
      - bluepill_2_0_2__xcode_9_0
      - bluepill_1_1_2__xcode_8_3
  - target_name: ""
    opts:
      title: "Target Name"
      summary: "Target name in bundle (e.g. 'MyApp')"
      is_expand: true
      is_required: true
  - scheme: ""
    opts:
      title: "Scheme"
      summary: "Xcode scheme (e.g. 'MyApp')"
      is_expand: true
      is_required: true
  - workspace: ""
    opts:
      title: "Workspace File"
      summary: "Xcode workspace file (e.g. MyApp.xcworkspace)"
      is_expand: true
      is_required: true
  - device_type: "iPhone 11"
    opts:
      title: "Device Type"
      summary: "iOS Device to build/run (e.g. 'iPhone 11', 'iPad Pro (12.9-inch) (3rd generation)')"
      is_expand: true
      is_required: true
  - ios_version: "13.2"
    opts:
      title: "iOS Version"
      summary: "iOS Version to build/run simulators (e.g. '12.4', '13.2')"
      is_expand: true
      is_required: true
  - derived_data_path: ""
    opts:
      title: "Derived Data Path"
      summary: "Derived data directory (e.g. 'build')"
      is_expand: true
      is_required: true
  - generate_coverage: "true"
    opts:
      title: "Generate Coverage"
      summary: "Generate code coverage for the build."
      is_required: true
      value_options:
      - "true"
      - "false"
  - bluepill_output_dir: "bluepill-output"
    opts:
      title: "Bluepill Logs Path"
      summary: "Directory to place all the bluepill logs/results files. Individual test reports will sit inside this directory, named like: \"iPhone SE - 12.2 - TIMESTAMP\""
      is_expand: true
      is_required: true
  - num_simulators: 4
    opts:
      title: "Num. Simulators (-n)"
      summary: "Number of iOS simulators to run in parallel."
      is_expand: true
      is_required: true
  - failure_tolerance: 0
    opts:
      title: "Failure Tolerance (-f)"
      summary: "Number of times to retry on test failures."
      is_expand: true
      is_required: true
  - retry_only_failed_tests: "false"
    opts:
      title: "Only Retry Failed Tests? (-F)"
      summary: "When Failure Tolerance is above zero, only retry tests that failed."
      is_required: true
      value_options:
      - "true"
      - "false"
  - additional_xcodebuild_args: ""
    opts:
      title: "Additional Xcodebuild Arguments"
      summary: "Additional arguments to send to `xcodebuild`"
      is_expand: true
      is_required: false
  - additional_bluepill_args: ""
    opts:
      title: "Additional Bluepill Arguments"
      summary: "See https://github.com/linkedin/bluepill for a full list of supported argumentss."
      is_expand: true
      is_required: false
  - fail_build_if_coverage_fails: "false"
    opts:
      title: "Fail Build on Invalid Coverage Data"
      summary: "Fail the build if Bluepill fails to gather valid coverage data (e.g. `${bluepill_output_dir}/${target_name}.app.coverage.txt`)"
      value_options:
      - "false"
      - "true"
  - test_result_env_var: "TEST_RESULTS"
    opts:
      title: "Test Results Output Environment Variable"
      summary: "Environment variable to capture test results as a human-readable string. This will also produce a Markdown-formatted copy with the `_MARKDOWN` suffix. e.g. (`MY_RESULT` and `MY_RESULT_MARKDOWN`)"
      is_expand: true
      is_required: true