fastlane-plugin-bluepillar 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +80 -9
- data/lib/fastlane/plugin/bluepillar/actions/bluepillar_action.rb +51 -38
- data/lib/fastlane/plugin/bluepillar/version.rb +1 -1
- metadata +3 -5
- data/lib/fastlane/plugin/bluepillar/actions/bin/bluepill +0 -0
- data/lib/fastlane/plugin/bluepillar/actions/bin/bp +0 -0
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 071bf5223799436bceb3ce41983416fa2467c206
|
|
4
|
+
data.tar.gz: 04eb1ebfde9987004a3ec4e977557294e5d9ef9c
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: d3719169805df892843ff46d9cfaf83f8dac3d5ff515de2ada5a0cf36707de59f7db74ecc9c582fd5614370f78956894c48aeea3b93afcfea380537331f80cb1
|
|
7
|
+
data.tar.gz: 3c7b263e8db987af9ceb48009149923e20170083548082972f4bad4588b6a192e7d42dd01f3e6e8e2b448e3369ded1ba0ea803e8b3b6e71f304d9eb9ca5e3525
|
data/README.md
CHANGED
|
@@ -2,25 +2,100 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://rubygems.org/gems/fastlane-plugin-bluepillar)
|
|
4
4
|
|
|
5
|
+
<a href="https://travis-ci.org/Shashikant86/fastlane-plugin-bluepillar/"><img src="https://img.shields.io/travis/Shashikant86/fastlane-plugin-bluepillar.svg" /></a>
|
|
6
|
+
|
|
5
7
|
## Getting Started
|
|
6
8
|
|
|
7
|
-
This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-bluepillar`, add it to your project by running:
|
|
9
|
+
This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin to run XCUI Tests in parallel using Linkedin's Bluepill tool. To get started with `fastlane-plugin-bluepillar`, add it to your project by running:
|
|
10
|
+
|
|
11
|
+
|
|
8
12
|
|
|
9
13
|
```bash
|
|
10
14
|
fastlane add_plugin bluepillar
|
|
11
15
|
```
|
|
12
16
|
|
|
17
|
+
|
|
18
|
+
### Pre-requisite
|
|
19
|
+
|
|
20
|
+
[Bluepill](https://github.com/linkedin/bluepill) homebrew package doesn't work well as it's lacking `bp` binary.
|
|
21
|
+
We have to manually download `bluepill` and `bp` binaries from the Bluepill releases page on [Github](https://github.com/linkedin/bluepill/releases) and put in PATH. This plugin expect it inside `/usr/local/bin/` where all the other binaries live, so that we have `/usr/local/bin/bluepill` and `/usr/local/bin/bp` binaries in place.
|
|
22
|
+
|
|
23
|
+
### Fastlane Setup
|
|
24
|
+
|
|
25
|
+
We can setup Fastlane using some BluePill optins and Derived data.
|
|
26
|
+
|
|
27
|
+
##### BluePill Options
|
|
28
|
+
|
|
29
|
+
There are so many options available for the Bluepill but we just need few of them to get going and keep other options as default. This plugin provides basic 7 options as follows
|
|
30
|
+
|
|
31
|
+
* `app` : PATH to your application. This is usually in the derived data `/Products/Debug-iphonesimulator/YOUR_APP.app`
|
|
32
|
+
|
|
33
|
+
* `runner_app_path` : PATH to UI Test runner app. This is usually in derived data `/Products/Debug-iphonesimulator\YOUR_UITEST_SCHEME-Runner.app` If you have a space in the Scheme name then you have to amend it with backslash in your path.
|
|
34
|
+
|
|
35
|
+
* `scheme_path` : This is path to your scheme. This is usually in the `YOUR_PROJECT.xcodeproj/xcshareddata/xcschemes/YOUR_SCHEME.xcscheme`
|
|
36
|
+
|
|
37
|
+
* `output_dir` : This is a directory where Bluepill will generate reports.
|
|
38
|
+
|
|
39
|
+
* `num_sims` : Number of simulators to be launched.
|
|
40
|
+
|
|
41
|
+
* `runtime` : The iOS version we want to run test against. Note we have to pass it as nested string like this `'"iOS 10.3"'`
|
|
42
|
+
|
|
43
|
+
* `device`: The simulator to be used. We have to pass it as `'iPad Air'` or `'iPhone 6'`
|
|
44
|
+
|
|
45
|
+
##### Generate Derived Data for Bluepill
|
|
46
|
+
|
|
47
|
+
It's good idea to generate derived data in the project itself using `build for testing` option.
|
|
48
|
+
You can do that using Fastlane `scan` like this
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
scan(
|
|
52
|
+
scheme: YOUR_SCHEME,
|
|
53
|
+
build_for_testing: true,
|
|
54
|
+
derived_data_path: "./bluepill",
|
|
55
|
+
buildlog_path: "./bluepill/logs/"
|
|
56
|
+
)
|
|
57
|
+
```
|
|
58
|
+
This will generate derived data inside `bluepill` directory.
|
|
59
|
+
|
|
60
|
+
##### Configure Fastfile
|
|
61
|
+
Now that, all the Bluepill options are in place and we have generated derived data, we can configure lane in our `Fastfile` like this:
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
lane :test do
|
|
66
|
+
app: 'bluepill/Build/Products/Debug-iphonesimulator/Bluepillar.app',
|
|
67
|
+
runner_app_path: 'bluepill/Build/Products/Debug-iphonesimulator/BluepillarUITests-Runner.app',
|
|
68
|
+
scheme_path: 'Bluepillar.xcodeproj/xcshareddata/xcschemes/Bluepillar.xcscheme',
|
|
69
|
+
output_dir: 'bluepill_output/',
|
|
70
|
+
num_sims: '3',
|
|
71
|
+
runtime: '"iOS 10.3"',
|
|
72
|
+
device: 'iPad Air'
|
|
73
|
+
end
|
|
74
|
+
|
|
75
|
+
```
|
|
76
|
+
Now that we can run test using fastlane like this :
|
|
77
|
+
|
|
78
|
+
$ fastlane test
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
|
|
13
82
|
## About bluepillar
|
|
14
83
|
|
|
15
|
-
Run XCUITests in Parallel using Bluepill
|
|
84
|
+
Run XCUITests in Parallel using Bluepill. [Bluepill](https://github.com/linkedin/bluepill) is a tool from LinkedIn to run XCUI tests in the parallel.
|
|
16
85
|
|
|
17
|
-
**Note to author:** Add a more detailed description about this plugin here. If your plugin contains multiple actions, make sure to mention them here.
|
|
18
86
|
|
|
19
87
|
## Example
|
|
20
88
|
|
|
21
|
-
|
|
89
|
+
There is sample example project available on Github [Bluepillar-Demo](https://github.com/Shashikant86/Bluepillar-Demo). Just clone it, replace the path to derived data and run
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
$ git clone git@github.com:Shashikant86/Bluepillar-Demo.git
|
|
93
|
+
$ bundle install
|
|
94
|
+
$ bundle exec fastlane test
|
|
95
|
+
|
|
96
|
+
You can see sample report in the `sample_bluepill_output` directory.
|
|
97
|
+
|
|
22
98
|
|
|
23
|
-
**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)
|
|
24
99
|
|
|
25
100
|
## Run tests for this plugin
|
|
26
101
|
|
|
@@ -46,7 +121,3 @@ If you have trouble using plugins, check out the [Plugins Troubleshooting](https
|
|
|
46
121
|
## Using _fastlane_ Plugins
|
|
47
122
|
|
|
48
123
|
For more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://docs.fastlane.tools/plugins/create-plugin/).
|
|
49
|
-
|
|
50
|
-
## About _fastlane_
|
|
51
|
-
|
|
52
|
-
_fastlane_ is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out [fastlane.tools](https://fastlane.tools).
|
|
@@ -1,33 +1,44 @@
|
|
|
1
1
|
module Fastlane
|
|
2
2
|
module Actions
|
|
3
3
|
class BluepillarAction < Action
|
|
4
|
+
BLUEPILL_PATH = '/usr/local/bin/bluepill'
|
|
5
|
+
BP_PATH = '/usr/local/bin/bp'
|
|
4
6
|
def self.run(params)
|
|
5
7
|
UI.message("Starting XCTests using the bluepillar fastlane plugin!")
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
8
|
+
unless File.exist?(BLUEPILL_PATH)
|
|
9
|
+
UI.user_error!("You must download bluepill binary from Github and put it in /usr/local/bin/bluepill to carry on execution")
|
|
10
|
+
end
|
|
11
|
+
|
|
12
|
+
unless File.exist?(BP_PATH)
|
|
13
|
+
UI.user_error!("You must download bp binary from Github and put it in /usr/local/bin/bp to carry on execution")
|
|
14
|
+
end
|
|
15
|
+
|
|
16
|
+
bluepill_app_path = params[:app]
|
|
17
|
+
bluepill_runner_app_path = params[:runner_app_path]
|
|
18
|
+
bluepill_scheme_path = params[:scheme_path]
|
|
19
|
+
bluepill_num_sims = params[:num_sims]
|
|
20
|
+
bluepill_output_dir = params[:output_dir]
|
|
21
|
+
bluepill_runtime = params[:runtime]
|
|
22
|
+
bluepill_device = params[:device]
|
|
23
|
+
processed_device = bluepill_device.gsub(/ /, '\ ')
|
|
24
|
+
|
|
25
|
+
|
|
13
26
|
command = [
|
|
14
|
-
|
|
27
|
+
'bluepill',
|
|
15
28
|
'-a',
|
|
16
|
-
|
|
29
|
+
bluepill_app_path,
|
|
17
30
|
'-u',
|
|
18
|
-
|
|
31
|
+
bluepill_runner_app_path,
|
|
19
32
|
'-s',
|
|
20
|
-
|
|
33
|
+
bluepill_scheme_path,
|
|
21
34
|
'-o',
|
|
22
|
-
|
|
35
|
+
bluepill_output_dir,
|
|
23
36
|
'-r',
|
|
24
|
-
|
|
37
|
+
bluepill_runtime,
|
|
25
38
|
'-n',
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
# '-d',
|
|
30
|
-
# ios_device,
|
|
39
|
+
bluepill_num_sims,
|
|
40
|
+
'-d',
|
|
41
|
+
processed_device,
|
|
31
42
|
]
|
|
32
43
|
Actions.sh(command.join(' '))
|
|
33
44
|
end
|
|
@@ -50,13 +61,7 @@ module Fastlane
|
|
|
50
61
|
|
|
51
62
|
def self.available_options
|
|
52
63
|
[
|
|
53
|
-
|
|
54
|
-
env_name: "BLUEPILLAR_BINARY_PATH",
|
|
55
|
-
description: "Path to bluepill and bp binary which can be downloaded from Github. Hack till homebrew install WIP ",
|
|
56
|
-
is_string: true,
|
|
57
|
-
optional: false),
|
|
58
|
-
|
|
59
|
-
FastlaneCore::ConfigItem.new(key: :app_path,
|
|
64
|
+
FastlaneCore::ConfigItem.new(key: :app,
|
|
60
65
|
env_name: "BLUEPILLAR_APP_PATH",
|
|
61
66
|
description: "Path to the main app to be build for the bluepill in the Derived Data",
|
|
62
67
|
is_string: true,
|
|
@@ -68,42 +73,50 @@ module Fastlane
|
|
|
68
73
|
is_string: true,
|
|
69
74
|
optional: false),
|
|
70
75
|
|
|
71
|
-
FastlaneCore::ConfigItem.new(key: :
|
|
76
|
+
FastlaneCore::ConfigItem.new(key: :scheme_path,
|
|
72
77
|
env_name: "BLUEPILLAR_XCTEST_SCHEME_PATH",
|
|
73
78
|
description: "Path to the scheme to be build for the bluepill in the .xcodeproj",
|
|
74
79
|
is_string: true,
|
|
75
80
|
optional: false),
|
|
76
81
|
|
|
77
|
-
FastlaneCore::ConfigItem.new(key: :
|
|
82
|
+
FastlaneCore::ConfigItem.new(key: :output_dir,
|
|
78
83
|
env_name: "BLUEPILLAR_REPORT_PATH",
|
|
79
84
|
description: "Path to store simulator logs and test reports",
|
|
80
85
|
is_string: true,
|
|
81
86
|
optional: false),
|
|
82
87
|
|
|
83
|
-
FastlaneCore::ConfigItem.new(key: :
|
|
88
|
+
FastlaneCore::ConfigItem.new(key: :num_sims,
|
|
84
89
|
env_name: "BLUEPILLAR_SUMULATORS",
|
|
85
90
|
description: "Number of sumulators to be launched",
|
|
91
|
+
default_value: "3",
|
|
86
92
|
is_string: true,
|
|
87
93
|
optional: true),
|
|
88
94
|
|
|
89
|
-
FastlaneCore::ConfigItem.new(key: :
|
|
95
|
+
FastlaneCore::ConfigItem.new(key: :runtime,
|
|
90
96
|
env_name: "BLUEPILLAR_IOS_VERSION",
|
|
91
97
|
description: "The iOS version to be used for testing",
|
|
98
|
+
default_value: '"iOS 10.3"',
|
|
99
|
+
is_string: true,
|
|
100
|
+
optional: true),
|
|
101
|
+
|
|
102
|
+
FastlaneCore::ConfigItem.new(key: :device,
|
|
103
|
+
env_name: "BLUEPILLAR_IOS_DEVICE",
|
|
104
|
+
description: "The iOS device to be used for testing",
|
|
105
|
+
default_value: "'iPhone 6'",
|
|
92
106
|
is_string: true,
|
|
93
107
|
optional: true),
|
|
94
108
|
]
|
|
95
109
|
end
|
|
96
110
|
|
|
97
111
|
def self.example_code
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
)
|
|
112
|
+
[' bluepillar(
|
|
113
|
+
app: "bluepill/Build/Products/Debug-iphonesimulator/Bluepillar.app",
|
|
114
|
+
runner_app_path: "bluepill/Build/Products/Debug-iphonesimulator/BluepillarUITests-Runner.app",
|
|
115
|
+
scheme_path: "Bluepillar.xcodeproj/xcshareddata/xcschemes/Bluepillar.xcscheme",
|
|
116
|
+
output_dir: "bluepill_output/",
|
|
117
|
+
num_sims: "3",
|
|
118
|
+
runtime: '"iOS 10.3"',
|
|
119
|
+
)
|
|
107
120
|
']
|
|
108
121
|
end
|
|
109
122
|
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: fastlane-plugin-bluepillar
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.2.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Shashikant86
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2017-04-
|
|
11
|
+
date: 2017-04-14 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: pry
|
|
@@ -103,8 +103,6 @@ files:
|
|
|
103
103
|
- LICENSE
|
|
104
104
|
- README.md
|
|
105
105
|
- lib/fastlane/plugin/bluepillar.rb
|
|
106
|
-
- lib/fastlane/plugin/bluepillar/actions/bin/bluepill
|
|
107
|
-
- lib/fastlane/plugin/bluepillar/actions/bin/bp
|
|
108
106
|
- lib/fastlane/plugin/bluepillar/actions/bluepillar_action.rb
|
|
109
107
|
- lib/fastlane/plugin/bluepillar/helper/bluepillar_helper.rb
|
|
110
108
|
- lib/fastlane/plugin/bluepillar/version.rb
|
|
@@ -131,5 +129,5 @@ rubyforge_project:
|
|
|
131
129
|
rubygems_version: 2.6.8
|
|
132
130
|
signing_key:
|
|
133
131
|
specification_version: 4
|
|
134
|
-
summary: Run XCUITests in Parallel using Bluepill
|
|
132
|
+
summary: Fastlane Plugin to Run XCUITests in Parallel using Bluepill.
|
|
135
133
|
test_files: []
|
|
Binary file
|
|
Binary file
|