This project is a fastlane plugin. To get started with
fastlane-plugin-xbluepill, add it to your project by running:
fastlane add_plugin xbluepill
It is a fastlane plugin that allows to use bluepill (linkedin library) as a fastlane command. It supports Xcode 10.0. There are some differences from other plugins:
- Supports Xcode 10;
- No need to build your project before using the plugin. Builds you project by itself and put xctestrun file automatically;
- Can reset all simulators if needed (removes all current simulators and recreates default from scratch);
Supported options are almost the same as in Bluepill. But there are some differences since plugin builds a project by itself:
|Config Arguments||Command Line Arguments||Explanation||Required||Default value|
||-a||The path to the host application to execute (your .app)||N||n/a|
||The path to the
||The path to the
||Your test scheme.||Y||n/a|
||Delete and re-create all iOS and tvOS simulators.||N||false|
||-o||Directory where to put output log files (bluepill only)||Y||n/a|
|config||-c||Read options from the specified configuration file instead of the command line||N||n/a|
|device||-d||On which device to run the app.||N||iPhone 6|
|exclude||-x||Exclude a testcase in the set of tests to run (takes priority over
|headless||-H||Run in headless mode (no GUI).||N||off|
|xcode-path||-X||Path to xcode.||N||xcode-select -p|
|include||-i||Include a testcase in the set of tests to run (unless specified in
|json-output||-J||Print test timing information in JSON format.||N||off|
|junit-output||-j||Print results in JUnit format.||N||true|
|list-tests||-l||Only list tests in bundle||N||false|
|num-sims||-n||Number of simulators to run in parallel. (bluepill only)||N||4|
|plain-output||-p||Print results in plain text.||N||true|
|printf-config||-P||Print a configuration file suitable for passing back using the
|error-retries||-R||Number of times to recover from simulator/app crashing/hanging and continue running||N||5|
|failure-tolerance||-f||Number of times to retry on test failures||N||0|
|runtime||-r||What runtime to use.||N||iOS 11.1|
|stuck-timeout||-S||Timeout in seconds for a test that seems stuck (no output).||N||300s|
|test-timeout||-T||Timeout in seconds for a test that is producing output.||N||300s|
|test-bundle-path||-t||The path to the test bundle to execute (single .xctest).||N||n/a|
|additional-unit-xctests||n/a||Additional XCTest bundles that is not Plugin folder||N||n/a|
|additional-ui-xctests||n/a||Additional XCTUITest bundles that is not Plugin folder||N||n/a|
|repeat-count||-C||Number of times we'll run the entire test suite (used for load testing).||N||1|
|no-split||-N||Test bundles you don't want to be packed into different groups to run in parallel.||N||n/a|
|quiet||-q||Turn off all output except fatal errors.||N||YES|
|reuse-simulator||n/a||Enable reusing simulators between test bundles||N||NO|
|diagnostics||n/a||Enable collection of diagnostics in outputDir in case of test failures||N||NO|
|runner-app-path||-u||The test runner for UI tests.||N||n/a|
|screenshots-directory||n/a||Directory where simulator screenshots for failed ui tests will be stored||N||n/a|
|video-paths||-V||A list of videos that will be saved in the simulators||N||n/a|
|image-paths||-I||A list of images that will be saved in the simulators||N||n/a|
Check out the example
Fastfile to see how to use this plugin. Try it by cloning the repo, running
fastlane install_plugins and
bundle exec fastlane test.
Note to author: Please set up a sample project to make it easy for users to explore what your plugin does. Provide everything that is necessary to try out the plugin in this project (including a sample Xcode/Android project if necessary)
Run tests for this plugin
To run both the tests, and code style validation, run
To automatically fix many of the styling issues, use
Issues and Feedback
For any other issues and feedback about this plugin, please submit it to this repository.
If you have trouble using plugins, check out the Plugins Troubleshooting guide.
Using fastlane Plugins
For more information about how the
fastlane plugin system works, check out the Plugins documentation.
fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.
License of Bluepill
BSD 2-CLAUSE LICENSE
Copyright 2016 LinkedIn Corporation. All Rights Reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.