fastlane 2.61.0.beta.20171006010004 → 2.61.0.beta.20171007010004

Sign up to get free protection for your applications and to get access to all the features.
Files changed (82) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +6 -161
  3. data/cert/README.md +7 -166
  4. data/deliver/README.md +7 -287
  5. data/deliver/lib/deliver/runner.rb +1 -1
  6. data/fastlane/README.md +7 -209
  7. data/fastlane/lib/fastlane/actions/cocoapods.rb +27 -8
  8. data/fastlane/lib/fastlane/actions/docs/assets/FrameitGit.gif +0 -0
  9. data/fastlane/lib/fastlane/actions/docs/assets/MacExample.png +0 -0
  10. data/fastlane/lib/fastlane/actions/docs/assets/PEMRecording.gif +0 -0
  11. data/fastlane/lib/fastlane/actions/docs/assets/PilotTextTransparent.png +0 -0
  12. data/fastlane/lib/fastlane/actions/docs/assets/PilotTextTransparentSmall.png +0 -0
  13. data/fastlane/lib/fastlane/actions/docs/assets/PilotTextWhite.png +0 -0
  14. data/fastlane/lib/fastlane/actions/docs/assets/PilotTransparent.png +0 -0
  15. data/fastlane/lib/fastlane/actions/docs/assets/QuickLookScreenshot.png +0 -0
  16. data/fastlane/lib/fastlane/actions/docs/assets/ScreenshotsBig.png +0 -0
  17. data/fastlane/lib/fastlane/actions/docs/assets/ScreenshotsOverview.png +0 -0
  18. data/fastlane/lib/fastlane/actions/docs/assets/SignErrors.png +0 -0
  19. data/fastlane/lib/fastlane/actions/docs/assets/UDIDPrint.png +0 -0
  20. data/fastlane/lib/fastlane/actions/docs/assets/frameit.png +0 -0
  21. data/fastlane/lib/fastlane/actions/docs/assets/github_repo.png +0 -0
  22. data/fastlane/lib/fastlane/actions/docs/assets/htmlPage.png +0 -0
  23. data/fastlane/lib/fastlane/actions/docs/assets/htmlPagePreview.jpg +0 -0
  24. data/fastlane/lib/fastlane/actions/docs/assets/htmlPagePreviewFade.jpg +0 -0
  25. data/fastlane/lib/fastlane/actions/docs/assets/match.png +0 -0
  26. data/fastlane/lib/fastlane/actions/docs/assets/match_appstore_small.gif +0 -0
  27. data/fastlane/lib/fastlane/actions/docs/assets/match_init.gif +0 -0
  28. data/fastlane/lib/fastlane/actions/docs/assets/match_nuke.gif +0 -0
  29. data/fastlane/lib/fastlane/actions/docs/assets/pem.png +0 -0
  30. data/fastlane/lib/fastlane/actions/docs/assets/pilot.ai +5377 -16
  31. data/fastlane/lib/fastlane/actions/docs/assets/precheck.gif +0 -0
  32. data/fastlane/lib/fastlane/actions/docs/assets/precheck.png +0 -0
  33. data/fastlane/lib/fastlane/actions/docs/assets/produce.png +0 -0
  34. data/fastlane/lib/fastlane/actions/docs/assets/running-screengrab.gif +0 -0
  35. data/fastlane/lib/fastlane/actions/docs/assets/scan.png +0 -0
  36. data/fastlane/lib/fastlane/actions/docs/assets/scanHTML.png +0 -0
  37. data/fastlane/lib/fastlane/actions/docs/assets/scanHTMLFailing.png +0 -0
  38. data/fastlane/lib/fastlane/actions/docs/assets/scanScreenshot.png +0 -0
  39. data/fastlane/lib/fastlane/actions/docs/assets/screengrab.png +0 -0
  40. data/fastlane/lib/fastlane/actions/docs/assets/sigh.png +0 -0
  41. data/fastlane/lib/fastlane/actions/docs/assets/sighRecording.gif +0 -0
  42. data/fastlane/lib/fastlane/actions/docs/assets/slack.png +0 -0
  43. data/fastlane/lib/fastlane/actions/docs/assets/snapshot.gif +0 -0
  44. data/fastlane/lib/fastlane/actions/docs/assets/snapshot.png +0 -0
  45. data/fastlane/lib/fastlane/actions/docs/assets/supply.png +0 -0
  46. data/fastlane/lib/fastlane/actions/docs/assets/testSummary.png +0 -0
  47. data/fastlane/lib/fastlane/actions/docs/cert.md +2 -4
  48. data/fastlane/lib/fastlane/actions/docs/deliver.md +1 -3
  49. data/fastlane/lib/fastlane/actions/docs/frameit.md +215 -0
  50. data/fastlane/lib/fastlane/actions/docs/gym.md +17 -17
  51. data/fastlane/lib/fastlane/actions/docs/match.md +352 -0
  52. data/fastlane/lib/fastlane/actions/docs/pem.md +120 -0
  53. data/fastlane/lib/fastlane/actions/docs/pilot.md +218 -0
  54. data/fastlane/lib/fastlane/actions/docs/precheck.md +97 -0
  55. data/fastlane/lib/fastlane/actions/docs/produce.md +227 -0
  56. data/fastlane/lib/fastlane/actions/docs/scan.md +145 -0
  57. data/fastlane/lib/fastlane/actions/docs/screengrab.md +145 -0
  58. data/fastlane/lib/fastlane/actions/docs/sigh.md +187 -0
  59. data/fastlane/lib/fastlane/actions/docs/snapshot.md +333 -0
  60. data/fastlane/lib/fastlane/actions/docs/supply.md +144 -0
  61. data/fastlane/lib/fastlane/plugins/plugin_manager.rb +5 -0
  62. data/fastlane/lib/fastlane/setup/setup_ios.rb +2 -0
  63. data/fastlane/lib/fastlane/version.rb +1 -1
  64. data/frameit/README.md +7 -290
  65. data/gym/README.md +7 -300
  66. data/match/README.md +7 -420
  67. data/match/lib/match/generator.rb +1 -0
  68. data/match/lib/match/git_helper.rb +31 -12
  69. data/match/lib/match/runner.rb +11 -6
  70. data/pem/README.md +7 -188
  71. data/pilot/README.md +7 -285
  72. data/pilot/lib/pilot/build_manager.rb +13 -10
  73. data/precheck/README.md +7 -171
  74. data/produce/README.md +7 -294
  75. data/scan/README.md +7 -219
  76. data/screengrab/README.md +7 -192
  77. data/sigh/README.md +7 -262
  78. data/snapshot/README.md +7 -408
  79. data/snapshot/lib/snapshot/reset_simulators.rb +4 -2
  80. data/spaceship/lib/spaceship/test_flight/build.rb +1 -1
  81. data/supply/README.md +7 -219
  82. metadata +52 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 037bae64a6f4a5dff6a606684caf2fd56875f2f6
4
- data.tar.gz: fd553320150928a447b902cb7234ef95faf81127
3
+ metadata.gz: 4cb2ea90382210ac6e58cb72c61b1ea3fc36c709
4
+ data.tar.gz: fd4df884b0b5076e03ebb318cb3654bf61d142cf
5
5
  SHA512:
6
- metadata.gz: 4ad08b47eecd2c3c0a6398ef1e20a0c9b68356aa14cd476d226fc209370f858cb69862b16fb2bdd349fc3e59a9f30e8642fe0bf4034345905d0fa2528a3bb464
7
- data.tar.gz: 42b879aeffcb4787eb06a8626d9edd322e29f6ab80b417042bd905ae1bd23e66b336e4d2a51fef36051cb5e3e7a5bca34ca2a84ddacb97cce774954f52706455
6
+ metadata.gz: 0386e99aee64b090b09fb5947fde47f95f09815524134ca004bce77e0567f75b77b91774fb64fbc5c76a743f933fb6e04a8f17bf4d180aaddbaff9929537f6c5
7
+ data.tar.gz: db27d5a7588252afd0a7aee7754cdcfbd153f056c530d97e2a000349fc1da6a1bfcdf6b48fdee7c605e59fd7b3948e5314d4f5a78cd042e76f13b0740553165c
data/README.md CHANGED
@@ -1,189 +1,34 @@
1
1
  <h3 align="center">
2
- <img src="fastlane/assets/fastlane_text.png" alt="fastlane Logo" />
2
+ <img src="fastlane/assets/fastlane_text.png" alt="fastlane Logo" width=500 />
3
3
  </h3>
4
4
 
5
- fastlane
6
- ============
7
-
8
5
  [![Twitter: @FastlaneTools](https://img.shields.io/badge/contact-@FastlaneTools-blue.svg?style=flat)](https://twitter.com/FastlaneTools)
9
6
  [![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/fastlane/fastlane/blob/master/LICENSE)
10
7
  [![Gem](https://img.shields.io/gem/v/fastlane.svg?style=flat)](https://rubygems.org/gems/fastlane)
11
8
  [![Build Status](https://img.shields.io/circleci/project/fastlane/fastlane/master.svg?style=flat)](https://circleci.com/gh/fastlane/fastlane)
12
9
 
13
- #### ✨ Check out [docs.fastlane.tools](https://docs.fastlane.tools) on how to get started with fastlane ✨
14
-
15
10
  `fastlane` is a tool for iOS and Android developers to automate tedious tasks like generating screenshots, dealing with provisioning profiles, and releasing your application.
16
11
 
17
- Use a lane to define your process:
18
-
19
- ```ruby
20
- lane :beta do
21
- increment_build_number
22
- cocoapods
23
- match
24
- testflight
25
- sh "./customScript.sh"
26
- slack
27
- end
28
- ```
29
-
30
- Then to deploy a new 'beta' version of your app just run
31
- `fastlane beta` :rocket:
32
-
33
-
34
-
35
- | | fastlane |
36
- |----------|------------|
37
- :sparkles: | Connect iOS and Android build tools into one workflow (both _fastlane_ tools and third party tools)
38
- :monorail: | Define different `deployment lanes` for App Store deployment, beta builds, or testing
39
- :ship: | Deploy from any computer, including a CI server
40
- :wrench: | Extend and customise functionality
41
- :thought_balloon: | Never remember any difficult commands, just `fastlane`
42
- :tophat: | Easy setup assistant to get started in a few minutes
43
- :email: | Automatically pass on information from one build step to another (*e.g.* path to the `ipa` file)
44
- :page_with_curl: | Store **everything** in Git. Never lookup build commands on your CI system again.
45
- :rocket: | Saves you **hours** for every app update you release
46
- :pencil2: | Flexible configuration using a fully customisable `Fastfile`
47
- :mountain_cableway: | Implement a fully working Continuous Delivery process
48
- :ghost: | [Jenkins Integration](https://docs.fastlane.tools/best-practices/continuous-integration/#jenkins-integration): Show output directly in test results
49
- :book: | Automatically generate Markdown documentation of your lane configurations
50
- :hatching_chick: | Over 170 built-in integrations and 170 plugins available
51
- :computer: | Support for iOS and Android apps
52
- :octocat: | Full Git and Mercurial support
53
-
54
- <hr />
55
- <h4 align="center">
56
- Check out the new <a href="https://docs.fastlane.tools/">fastlane docs</a>
57
- </h4>
58
- <hr />
59
-
60
- ##### Like this tool? [Be the first to know about updates and new fastlane tools](https://tinyletter.com/fastlane-tools).
61
-
62
- ## Installation
63
- Make sure you have the latest version of the Xcode command line tools installed:
64
-
65
- ```
66
- xcode-select --install
67
- ```
68
-
69
- ### Choose your installation method:
70
-
71
- <table width="100%" >
72
- <tr>
73
- <th width="33%"><a href="http://brew.sh">Homebrew</a></td>
74
- <th width="33%">Installer Script</td>
75
- <th width="33%">Rubygems</td>
76
- </tr>
77
- <tr>
78
- <td width="33%" align="center">macOS</td>
79
- <td width="33%" align="center">macOS</td>
80
- <td width="33%" align="center">macOS or Linux with Ruby 2.0.0 or above</td>
81
- </tr>
82
- <tr>
83
- <td width="33%"><code>brew cask install fastlane</code></td>
84
- <td width="33%"><a href="https://download.fastlane.tools/">Download the zip file</a>. Then double click on the <code>install</code> script (or run it in a terminal window).</td>
85
- <td width="33%"><code>sudo gem install fastlane -NV</code></td>
86
- </tr>
87
- </table>
88
-
89
- ## Quick Start
90
-
91
- Get started distributing your first app with fastlane within minutes:
92
-
93
- [Create your first Fastfile](https://fabric.io/features/distribution?utm_campaign=github_readme)
94
-
95
- Want to learn more? Explore guides for [iOS](https://docs.fastlane.tools/getting-started/ios/setup/)
96
- or [Android](https://docs.fastlane.tools/getting-started/android/setup/).
97
-
98
- ## System Requirements
99
-
100
- Currently, _fastlane_ is officially supported to run on macOS. Support for other operating systems is limited and untested at this point in time. _fastlane_ uses system APIs that may not be implemented on other platforms, for example, we use the Ruby `fork` method for sub-process management, which isn't available on Windows.
101
-
102
- ## Available Commands
103
-
104
- Typically you'll use `fastlane` by triggering individual lanes:
105
-
106
- fastlane [lane_name]
107
-
108
- #### Other Commands
109
-
110
- - `fastlane actions`: List all available `fastlane` actions
111
- - `fastlane action [action_name]`: Shows a more detailed description of an action
112
- - `fastlane lanes`: Lists all available lanes with description
113
- - `fastlane list`: Lists all available lanes without description
114
- - `fastlane new_action`: Create a new action *(integration)* for fastlane
115
- - `fastlane env`: Print out the fastlane ruby environment when submitting an issue
116
-
117
-
118
- If you'd like to take a look at a project already using `fastlane` check out [fastlane-examples](https://github.com/fastlane/examples) which includes `fastlane` setups by Wikipedia, Product Hunt, MindNode, and more.
119
-
120
12
  <hr />
121
- <h4 align="center">
122
- Check out the new <a href="https://docs.fastlane.tools/">fastlane docs</a>
123
- </h4>
13
+ <h2 align="center">
14
+ All fastlane docs were moved to <a href="https://docs.fastlane.tools/">docs.fastlane.tools</a>
15
+ </h2>
124
16
  <hr />
125
17
 
126
- ## [`fastlane`](https://fastlane.tools) Toolchain
127
-
128
- In addition to `fastlane`'s commands, you also have access to these `fastlane` tools:
129
-
130
- - [`deliver`](https://github.com/fastlane/fastlane/tree/master/deliver): Upload screenshots, metadata, and your app to the App Store
131
- - [`supply`](https://github.com/fastlane/fastlane/tree/master/supply): Upload your Android app and its metadata to Google Play
132
- - [`snapshot`](https://github.com/fastlane/fastlane/tree/master/snapshot): Automate taking localized screenshots of your iOS and tvOS apps on every device
133
- - [`screengrab`](https://github.com/fastlane/fastlane/tree/master/screengrab): Automate taking localized screenshots of your Android app on every device
134
- - [`frameit`](https://github.com/fastlane/fastlane/tree/master/frameit): Quickly put your screenshots into the right device frames
135
- - [`pem`](https://github.com/fastlane/fastlane/tree/master/pem): Automatically generate and renew your push notification profiles
136
- - [`sigh`](https://github.com/fastlane/fastlane/tree/master/sigh): Because you would rather spend your time building stuff than fighting provisioning
137
- - [`produce`](https://github.com/fastlane/fastlane/tree/master/produce): Create new iOS apps on iTunes Connect and Dev Portal using the command line
138
- - [`cert`](https://github.com/fastlane/fastlane/tree/master/cert): Automatically create and maintain iOS code signing certificates
139
- - [`spaceship`](https://github.com/fastlane/fastlane/tree/master/spaceship): Ruby library to access the Apple Dev Center and iTunes Connect
140
- - [`pilot`](https://github.com/fastlane/fastlane/tree/master/pilot): The best way to manage your TestFlight testers and builds from your terminal
141
- - [`boarding`](https://github.com/fastlane/boarding): The easiest way to invite your TestFlight beta testers
142
- - [`gym`](https://github.com/fastlane/fastlane/tree/master/gym): Building your iOS apps has never been easier
143
- - [`match`](https://github.com/fastlane/fastlane/tree/master/match): Easily sync your certificates and profiles across your team using Git
144
- - [`scan`](https://github.com/fastlane/fastlane/tree/master/scan): The easiest way to run tests for your iOS and Mac apps
145
- - [`precheck`](https://github.com/fastlane/fastlane/tree/master/precheck): Check your app using a community driven set of App Store review rules to avoid being rejected
146
-
147
- ## Metrics
148
-
149
- _fastlane_ tracks a few key metrics to understand how developers are using the tool and to help us know what areas need improvement. No personal/sensitive information is ever collected. Metrics that are collected include:
150
-
151
- * The number of successes, errors, and crashes for _fastlane_ and each action run in a Fastfile
152
- * The running time of _fastlane_
153
- * The method by which _fastlane_ was installed
154
- * Whether _fastlane_ is being run on CI
155
- * The platform (e.g. iOS, Android) for which _fastlane_ is run
156
- * A hash of the app identifier or package name, which helps us anonymously identify unique usage of _fastlane_
157
-
158
- We have recently changed the destination service to which these metrics are reported, as well as the format of the data, but the data that is collected has not changed.
159
-
160
- You can easily opt-out of metrics collection by adding `opt_out_usage` at the top of your `Fastfile` or by setting the environment variable `FASTLANE_OPT_OUT_USAGE`. Participating helps us provide the best possible support for _fastlane_, so we hope you'll consider it a plus! :heavy_plus_sign:
161
-
162
- ## Crash Reporting
163
-
164
- In order to continuously improve stability, _fastlane_ will record crash reports with sanitized stack traces. Sanitization removes personal information from the stack trace and error message (including home directories, _fastlane_ path, gem paths, environment variables, and parameters).
165
-
166
- You can easily opt-out of crash reporting by adding `opt_out_crash_reporting` at the top of your `Fastfile` or by setting the environment variable `FASTLANE_OPT_OUT_CRASH_REPORTING`. Just like metrics mentioned above, participating helps us provide the best possible support for _fastlane_, so we hope you'll consider it a plus! :heavy_plus_sign:
167
-
168
18
  ## Need Help?
169
19
 
170
20
  Before submitting a new GitHub issue, please make sure to
171
21
 
172
22
  - Check out [docs.fastlane.tools](https://docs.fastlane.tools)
173
- - Check out the README pages on [this repo](https://github.com/fastlane/fastlane)
174
23
  - Search for [existing GitHub issues](https://github.com/fastlane/fastlane/issues)
175
24
 
176
25
  If the above doesn't help, please [submit an issue](https://github.com/fastlane/fastlane/issues) on GitHub and provide information about your setup, in particular the output of the `fastlane env` command.
177
26
 
178
27
  **Note**: If you want to report a regression in _fastlane_ (something that has worked before, but broke with a new release), please mark your issue title as such using `[Regression] Your title here`. This enables us to quickly detect and fix regressions.
179
28
 
180
- ## Special Thanks
181
-
182
- Thanks to all [contributors](https://github.com/fastlane/fastlane/graphs/contributors) for extending and improving `fastlane`.
183
-
184
- ## Speakers
29
+ ## Contribute to _fastlane_
185
30
 
186
- Are you giving a talk on fastlane? Great! [Let us know](https://fastlane.tools/speaking) so we can help you give the best possible presentation.
31
+ Check out [CONTRIBUTING.md](CONTRIBUTING.md) for more information on how to help with _fastlane_.
187
32
 
188
33
  ## Code of Conduct
189
34
 
data/cert/README.md CHANGED
@@ -1,176 +1,17 @@
1
1
  <h3 align="center">
2
- <a href="https://github.com/fastlane/fastlane/tree/master/fastlane">
3
- <img src="../fastlane/assets/fastlane.png" width="150" />
2
+ <a href="https://docs.fastlane.tools/actions/cert">
3
+ <img src="https://raw.githubusercontent.com/fastlane/fastlane/master/fastlane/assets/fastlane.png" width="100" />
4
4
  <br />
5
5
  fastlane
6
6
  </a>
7
7
  </h3>
8
- <p align="center">
9
- <a href="https://github.com/fastlane/fastlane/tree/master/deliver">deliver</a> &bull;
10
- <a href="https://github.com/fastlane/fastlane/tree/master/snapshot">snapshot</a> &bull;
11
- <a href="https://github.com/fastlane/fastlane/tree/master/frameit">frameit</a> &bull;
12
- <a href="https://github.com/fastlane/fastlane/tree/master/pem">pem</a> &bull;
13
- <a href="https://github.com/fastlane/fastlane/tree/master/sigh">sigh</a> &bull;
14
- <a href="https://github.com/fastlane/fastlane/tree/master/produce">produce</a> &bull;
15
- <b>cert</b> &bull;
16
- <a href="https://github.com/fastlane/fastlane/tree/master/spaceship">spaceship</a> &bull;
17
- <a href="https://github.com/fastlane/fastlane/tree/master/pilot">pilot</a> &bull;
18
- <a href="https://github.com/fastlane/boarding">boarding</a> &bull;
19
- <a href="https://github.com/fastlane/fastlane/tree/master/gym">gym</a> &bull;
20
- <a href="https://github.com/fastlane/fastlane/tree/master/scan">scan</a> &bull;
21
- <a href="https://github.com/fastlane/fastlane/tree/master/match">match</a> &bull;
22
- <a href="https://github.com/fastlane/fastlane/tree/master/precheck">precheck</a>
23
- </p>
24
8
 
25
- -------
9
+ ------
26
10
 
27
11
  <p align="center">
28
- <img src="assets/cert.png" height="110">
29
- </p>
30
-
31
- cert
32
- ============
33
-
34
- [![Twitter: @FastlaneTools](https://img.shields.io/badge/contact-@FastlaneTools-blue.svg?style=flat)](https://twitter.com/fastlanetools)
35
- [![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/fastlane/fastlane/blob/master/cert/LICENSE)
36
-
37
- ###### Automatically create and maintain iOS code signing certificates.
38
-
39
- `cert` is focused exclusively on code signing. You can create new code signing identities for different environments (development and distribution) and use any existing valid certificates installed locally.
40
-
41
- Get in contact with the developers on Twitter: [@FastlaneTools](https://twitter.com/FastlaneTools)
42
-
43
- -------
44
- <p align="center">
45
- <a href="#installation">Installation</a> &bull;
46
- <a href="#why">Why?</a> &bull;
47
- <a href="#usage">Usage</a> &bull;
48
- <a href="#how-does-it-work">How does it work?</a> &bull;
49
- <a href="#tips">Tips</a> &bull;
50
- <a href="#need-help">Need help?</a>
12
+ <a href="https://docs.fastlane.tools/actions/cert">
13
+ <img src="https://raw.githubusercontent.com/fastlane/fastlane/master/cert/assets/cert.png" height="110">
14
+ </a>
51
15
  </p>
52
16
 
53
- -------
54
-
55
- <h5 align="center"><code>cert</code> is part of <a href="https://fastlane.tools">fastlane</a>: The easiest way to automate beta deployments and releases for your iOS and Android apps.</h5>
56
-
57
-
58
-
59
- # Installation
60
-
61
- **Note**: It is recommended to use [match](https://github.com/fastlane/fastlane/tree/master/match) according to the [codesigning.guide](https://codesigning.guide) for generating and maintaining your certificates. Use `cert` directly only if you want full control over what's going on and know more about codesigning.
62
-
63
- sudo gem install fastlane
64
-
65
- Make sure, you have the latest version of the Xcode command line tools installed:
66
-
67
- xcode-select --install
68
-
69
- # Why?
70
-
71
- Please check out [this guide](https://github.com/fastlane/fastlane/blob/master/cert/ManualSteps.md) which shows how to manually create an iOS code signing profile and a provisioning profile using the Apple Developer Portal.
72
-
73
- **After** checking out the [guide](https://github.com/fastlane/fastlane/blob/master/cert/ManualSteps.md), take a look how `cert` and [`sigh`](https://github.com/fastlane/fastlane/tree/master/sigh) do all that for you.
74
-
75
- ![assets/cert.gif](assets/cert.gif)
76
-
77
- In the gif I used `cert && sigh`, which will first create an iOS code signing certificate and then a provisioning profile for your app if `cert` succeeded.
78
-
79
- ##### [Do you like fastlane? Be the first to know about updates and new fastlane tools](https://tinyletter.com/fastlane-tools)
80
-
81
- # Usage
82
-
83
- **Note**: It is recommended to use [match](https://github.com/fastlane/fastlane/tree/master/match) according to the [codesigning.guide](https://codesigning.guide) for generating and maintaining your certificates. Use `cert` directly only if you want full control over what's going on and know more about codesigning.
84
-
85
- ```
86
- fastlane cert
87
- ```
88
-
89
- This will check if any of the available signing certificates is installed on your local machine.
90
-
91
- Only if a new certificate needs to be created, `cert` will
92
-
93
- - Create a new private key
94
- - Create a new signing request
95
- - Generate, downloads and installs the certificate
96
- - Import all the generated files into your Keychain
97
-
98
-
99
- `cert` will never revoke your existing certificates. If you can't create any more certificates, `cert` will raise an exception, which means, you have to revoke one of the existing certificates to make room for a new one.
100
-
101
-
102
- You can pass your Apple ID:
103
-
104
- fastlane cert -u cert@krausefx.com
105
-
106
- For a list of available commands run
107
-
108
- fastlane cert --help
109
-
110
- Keep in mind, there is no way for `cert` to download existing certificates + private keys from the Apple Developer Portal, as the private key never leaves your computer.
111
-
112
- ## Environment Variables
113
-
114
- Run `fastlane cert --help` to get a list of all available environment variables.
115
-
116
- ## Use with [`sigh`](https://github.com/fastlane/fastlane/tree/master/sigh)
117
-
118
- `cert` becomes really interesting when used in [`fastlane`](https://github.com/fastlane/fastlane/tree/master/fastlane) in combination with [`sigh`](https://github.com/fastlane/fastlane/tree/master/sigh).
119
-
120
- Update your `Fastfile` to contain the following code:
121
-
122
- ```ruby
123
- lane :beta do
124
- cert
125
- sigh(force: true)
126
- end
127
- ```
128
-
129
- `force: true` will make sure to re-generate the provisioning profile on each run.
130
- This will result in `sigh` always using the correct signing certificate, which is installed on the local machine.
131
-
132
-
133
- ## How is my password stored?
134
- `cert` uses the [password manager](https://github.com/fastlane/fastlane/tree/master/credentials_manager) from `fastlane`. Take a look the [CredentialsManager README](https://github.com/fastlane/fastlane/blob/master/credentials_manager/README.md) for more information.
135
-
136
- # Tips
137
-
138
- ## [`fastlane`](https://fastlane.tools) Toolchain
139
-
140
- - [`fastlane`](https://fastlane.tools): The easiest way to automate beta deployments and releases for your iOS and Android apps
141
- - [`deliver`](https://github.com/fastlane/fastlane/tree/master/deliver): Upload screenshots, metadata and your app to the App Store
142
- - [`snapshot`](https://github.com/fastlane/fastlane/tree/master/snapshot): Automate taking localized screenshots of your iOS app on every device
143
- - [`frameit`](https://github.com/fastlane/fastlane/tree/master/frameit): Quickly put your screenshots into the right device frames
144
- - [`pem`](https://github.com/fastlane/fastlane/tree/master/pem): Automatically generate and renew your push notification profiles
145
- - [`sigh`](https://github.com/fastlane/fastlane/tree/master/sigh): Because you would rather spend your time building stuff than fighting provisioning
146
- - [`produce`](https://github.com/fastlane/fastlane/tree/master/produce): Create new iOS apps on iTunes Connect and Dev Portal using the command line
147
- - [`spaceship`](https://github.com/fastlane/fastlane/tree/master/spaceship): Ruby library to access the Apple Dev Center and iTunes Connect
148
- - [`pilot`](https://github.com/fastlane/fastlane/tree/master/pilot): The best way to manage your TestFlight testers and builds from your terminal
149
- - [`boarding`](https://github.com/fastlane/boarding): The easiest way to invite your TestFlight beta testers
150
- - [`gym`](https://github.com/fastlane/fastlane/tree/master/gym): Building your iOS apps has never been easier
151
- - [`scan`](https://github.com/fastlane/fastlane/tree/master/scan): The easiest way to run tests of your iOS and Mac app
152
- - [`match`](https://github.com/fastlane/fastlane/tree/master/match): Easily sync your certificates and profiles across your team using git
153
- - [`precheck`](https://github.com/fastlane/fastlane/tree/master/precheck): Check your app using a community driven set of App Store review rules to avoid being rejected
154
-
155
- ##### [Do you like fastlane? Be the first to know about updates and new fastlane tools](https://tinyletter.com/fastlane-tools)
156
-
157
- ## Use the 'Provisioning Quicklook plugin'
158
- Download and install the [Provisioning Plugin](https://github.com/chockenberry/Provisioning) to easily preview provisioning profile files and certificates.
159
-
160
- # Need help?
161
-
162
- Before submitting a new GitHub issue, please make sure to
163
-
164
- - Check out [docs.fastlane.tools](https://docs.fastlane.tools)
165
- - Check out the README pages on [this repo](https://github.com/fastlane/fastlane)
166
- - Search for [existing GitHub issues](https://github.com/fastlane/fastlane/issues)
167
-
168
- If the above doesn't help, please [submit an issue](https://github.com/fastlane/fastlane/issues) on GitHub and provide information about your setup, in particular the output of the `fastlane env` command.
169
-
170
- # Code of Conduct
171
- Help us keep `cert` open and inclusive. Please read and follow our [Code of Conduct](https://github.com/fastlane/fastlane/blob/master/CODE_OF_CONDUCT.md).
172
-
173
- # License
174
- This project is licensed under the terms of the MIT license. See the LICENSE file.
175
-
176
- > This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.
17
+ <h3 align="center">The <i>cert</i> docs were moved to <a href='https://docs.fastlane.tools/actions/cert'>docs.fastlane.tools</a></h3>
data/deliver/README.md CHANGED
@@ -1,297 +1,17 @@
1
1
  <h3 align="center">
2
- <a href="https://github.com/fastlane/fastlane/tree/master/fastlane">
3
- <img src="../fastlane/assets/fastlane.png" width="150" />
2
+ <a href="https://docs.fastlane.tools/actions/deliver">
3
+ <img src="https://raw.githubusercontent.com/fastlane/fastlane/master/fastlane/assets/fastlane.png" width="100" />
4
4
  <br />
5
5
  fastlane
6
6
  </a>
7
7
  </h3>
8
- <p align="center">
9
- <b>deliver</b> &bull;
10
- <a href="https://github.com/fastlane/fastlane/tree/master/snapshot">snapshot</a> &bull;
11
- <a href="https://github.com/fastlane/fastlane/tree/master/frameit">frameit</a> &bull;
12
- <a href="https://github.com/fastlane/fastlane/tree/master/pem">pem</a> &bull;
13
- <a href="https://github.com/fastlane/fastlane/tree/master/sigh">sigh</a> &bull;
14
- <a href="https://github.com/fastlane/fastlane/tree/master/produce">produce</a> &bull;
15
- <a href="https://github.com/fastlane/fastlane/tree/master/cert">cert</a> &bull;
16
- <a href="https://github.com/fastlane/fastlane/tree/master/spaceship">spaceship</a> &bull;
17
- <a href="https://github.com/fastlane/fastlane/tree/master/pilot">pilot</a> &bull;
18
- <a href="https://github.com/fastlane/boarding">boarding</a> &bull;
19
- <a href="https://github.com/fastlane/fastlane/tree/master/gym">gym</a> &bull;
20
- <a href="https://github.com/fastlane/fastlane/tree/master/scan">scan</a> &bull;
21
- <a href="https://github.com/fastlane/fastlane/tree/master/match">match</a> &bull;
22
- <a href="https://github.com/fastlane/fastlane/tree/master/precheck">precheck</a>
23
- </p>
24
-
25
- -------
26
-
27
- <p align="center">
28
- <img src="assets/deliver.png" height="110">
29
- </p>
30
8
 
31
- deliver
32
- ============
33
-
34
- [![Twitter: @FastlaneTools](https://img.shields.io/badge/contact-@FastlaneTools-blue.svg?style=flat)](https://twitter.com/FastlaneTools)
35
- [![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/fastlane/fastlane/blob/master/deliver/LICENSE)
36
-
37
- ###### Upload screenshots, metadata and your app to the App Store using a single command
38
-
39
- `deliver` uploads screenshots, metadata and binaries to iTunes Connect. Use `deliver` to submit your app for App Store review.
40
-
41
- Get in contact with the developer on Twitter: [@FastlaneTools](https://twitter.com/FastlaneTools)
42
-
43
- -------
9
+ ------
44
10
 
45
11
  <p align="center">
46
- <a href="#features">Features</a> &bull;
47
- <a href="#installation">Installation</a> &bull;
48
- <a href="#quick-start">Quick Start</a> &bull;
49
- <a href="#usage">Usage</a> &bull;
50
- <a href="#tips">Tips</a> &bull;
51
- <a href="#need-help">Need help?</a>
12
+ <a href="https://docs.fastlane.tools/actions/deliver">
13
+ <img src="https://raw.githubusercontent.com/fastlane/fastlane/master/deliver/assets/deliver.png" height="110">
14
+ </a>
52
15
  </p>
53
16
 
54
- -------
55
-
56
- <h5 align="center"><code>deliver</code> is part of <a href="https://fastlane.tools">fastlane</a>: The easiest way to automate beta deployments and releases for your iOS and Android apps.</h5>
57
-
58
- # Features
59
- - Upload hundreds of localised screenshots completely automatically
60
- - Upload a new ipa/pkg file to iTunes Connect without Xcode from any Mac
61
- - Maintain your app metadata locally and push changes back to iTunes Connect
62
- - Easily implement a real Continuous Deployment process using [fastlane](https://fastlane.tools)
63
- - Store the configuration in git to easily deploy from **any** Mac, including your Continuous Integration server
64
- - Get a HTML preview of the fetched metadata before uploading the app metadata and screenshots to iTC
65
- - Automatically uses [precheck](https://github.com/fastlane/fastlane/tree/master/precheck) to ensure your app has the highest chances of passing app review the first time
66
-
67
- To upload builds to TestFlight check out [pilot](https://github.com/fastlane/fastlane/tree/master/pilot).
68
-
69
- ##### [Do you like fastlane? Be the first to know about updates and new fastlane tools](https://tinyletter.com/fastlane-tools)
70
-
71
- # Installation
72
-
73
- Install the gem
74
-
75
- sudo gem install fastlane
76
-
77
- Make sure, you have the latest version of the Xcode command line tools installed:
78
-
79
- xcode-select --install
80
-
81
- # Quick Start
82
-
83
- The guide will create all the necessary files for you, using the existing app metadata from iTunes Connect.
84
-
85
- - ```cd [your_project_folder]```
86
- - ```fastlane deliver init```
87
- - Enter your iTunes Connect credentials
88
- - Enter your app identifier
89
- - Enjoy a good drink, while the computer does all the work for you
90
-
91
- From now on, you can run `fastlane deliver` to deploy a new update, or just upload new app metadata and screenshots.
92
-
93
- # Usage
94
-
95
- Check out your local `./fastlane/metadata` and `./fastlane/screenshots` folders (if you don't use [fastlane](https://fastlane.tools) it's `./metadata` instead)
96
-
97
- ![assets/metadata.png](assets/metadata.png)
98
-
99
- You'll see your metadata from iTunes Connect. Feel free to store the metadata in git (not the screenshots). You can now modify it locally and push the changes back to iTunes Connect.
100
-
101
- Run `fastlane deliver` to upload the app metadata from your local machine
102
-
103
- ```
104
- fastlane deliver
105
- ```
106
-
107
- Provide the path to an `ipa` file to upload and submit your app for review:
108
-
109
- ```
110
- fastlane deliver --ipa "App.ipa" --submit_for_review
111
- ```
112
-
113
- or you can specify path to `pkg` file for macOS apps:
114
-
115
- ```
116
- fastlane deliver --pkg "MacApp.pkg"
117
- ```
118
-
119
- If you use [fastlane](https://fastlane.tools) you don't have to manually specify the path to your `ipa`/`pkg` file.
120
-
121
- This is just a small sub-set of what you can do with `deliver`, check out the full documentation in [Deliverfile.md](https://github.com/fastlane/fastlane/blob/master/deliver/Deliverfile.md)
122
-
123
- Download existing screenshots from iTunes Connect
124
-
125
- ```
126
- fastlane deliver download_screenshots
127
- ```
128
-
129
- Download existing metadata from iTunes Connect
130
-
131
- ```
132
- fastlane deliver download_metadata
133
- ```
134
-
135
- To get a list of available options run
136
-
137
- ```
138
- fastlane deliver --help
139
- ```
140
-
141
-
142
- Select a previously uploaded build and submit it for review.
143
-
144
- ```
145
- fastlane deliver submit_build --build_number 830
146
- ```
147
-
148
- Check out [Deliverfile.md](https://github.com/fastlane/fastlane/blob/master/deliver/Deliverfile.md) for more options.
149
-
150
- Already using `deliver` and just updated to 1.0? Check out the [Migration Guide](https://github.com/fastlane/fastlane/blob/master/deliver/MigrationGuide.md).
151
-
152
- # Credentials
153
-
154
- A detailed description about how your credentials are handled is available in a [credentials_manager](https://github.com/fastlane/fastlane/tree/master/credentials_manager).
155
-
156
- ### How does this thing even work? Is magic involved? 🎩
157
-
158
- Your password will be stored in the macOS keychain, but can also be passed using environment variables. (More information available on [CredentialsManager](https://github.com/fastlane/fastlane/tree/master/credentials_manager))
159
-
160
- Before actually uploading anything to iTunes, ```deliver``` will generate a HTML summary of the collected data.
161
-
162
- `deliver` uses the following techniques under the hood:
163
-
164
- - The iTMSTransporter tool is used to upload the binary to iTunes Connect. iTMSTransporter is a command line tool provided by Apple.
165
- - For all metadata related actions `deliver` uses [spaceship](https://github.com/fastlane/fastlane/tree/master/spaceship)
166
-
167
- # Tips
168
-
169
- ## [`fastlane`](https://fastlane.tools) Toolchain
170
-
171
- - [`fastlane`](https://fastlane.tools): The easiest way to automate beta deployments and releases for your iOS and Android apps
172
- - [`snapshot`](https://github.com/fastlane/fastlane/tree/master/snapshot): Automate taking localized screenshots of your iOS app on every device
173
- - [`frameit`](https://github.com/fastlane/fastlane/tree/master/frameit): Quickly put your screenshots into the right device frames
174
- - [`pem`](https://github.com/fastlane/fastlane/tree/master/pem): Automatically generate and renew your push notification profiles
175
- - [`sigh`](https://github.com/fastlane/fastlane/tree/master/sigh): Because you would rather spend your time building stuff than fighting provisioning
176
- - [`produce`](https://github.com/fastlane/fastlane/tree/master/produce): Create new iOS apps on iTunes Connect and Dev Portal using the command line
177
- - [`cert`](https://github.com/fastlane/fastlane/tree/master/cert): Automatically create and maintain iOS code signing certificates
178
- - [`spaceship`](https://github.com/fastlane/fastlane/tree/master/spaceship): Ruby library to access the Apple Dev Center and iTunes Connect
179
- - [`pilot`](https://github.com/fastlane/fastlane/tree/master/pilot): The best way to manage your TestFlight testers and builds from your terminal
180
- - [`boarding`](https://github.com/fastlane/boarding): The easiest way to invite your TestFlight beta testers
181
- - [`gym`](https://github.com/fastlane/fastlane/tree/master/gym): Building your iOS apps has never been easier
182
- - [`scan`](https://github.com/fastlane/fastlane/tree/master/scan): The easiest way to run tests of your iOS and Mac app
183
- - [`match`](https://github.com/fastlane/fastlane/tree/master/match): Easily sync your certificates and profiles across your team using git
184
- - [`precheck`](https://github.com/fastlane/fastlane/tree/master/precheck): Check your app using a community driven set of App Store review rules to avoid being rejected
185
-
186
-
187
- ##### [Do you like fastlane? Be the first to know about updates and new fastlane tools](https://tinyletter.com/fastlane-tools)
188
-
189
- ## Available language codes
190
- ```
191
- no, en-US, en-CA, fi, ru, zh-Hans, nl-NL, zh-Hant, en-AU, id, de-DE, sv, ko, ms, pt-BR, el, es-ES, it, fr-CA, es-MX, pt-PT, vi, th, ja, fr-FR, da, tr, en-GB
192
- ```
193
-
194
- ## Default values
195
-
196
- Deliver has a special `default` language code which allows you to provide values that are not localised, and which will be used as defaults when you don’t provide a specific localised value.
197
-
198
- In order to use `default`, you will need to tell `deliver` which languages your app uses. You can do this in either of two ways:
199
- 1. Create the folders named with the language in the metadata folder (i.e. fastlane/metadata/en-US or fastlane/metadata/de-DE)
200
- 2. Add the following to your `Deliverfile` `languages(['en-US','de-DE'])`
201
-
202
- You can use this either in json within your `Deliverfile` and/or as folders in your metadata folder. `deliver` will take the union of both language sets from the `Deliverfile` and from the metadata folder and create on single set of languages which will be enabled.
203
-
204
- Imagine that you have localised data for the following language codes: ```en-US, de-DE, el, it```
205
-
206
- You can set the following in your `Deliverfile`
207
-
208
- ```ruby
209
- release_notes({
210
- 'default' => "Shiny and new”,
211
- 'de-DE' => "glänzend und neu"
212
- })
213
- ```
214
-
215
- Deliver will use "Shiny and new" for en-US, el and it.
216
-
217
- It will use "glänzend und neu" for de-DE.
218
-
219
- You can do the same with folders
220
-
221
- ```
222
- default
223
- keywords.txt
224
- marketing_url.txt
225
- name.txt
226
- privacy_url.txt
227
- support_url.txt
228
- release_notes.txt
229
- en-US
230
- description.txt
231
- de-DE
232
- description.txt
233
- el
234
- description.txt
235
- it
236
- description.txt
237
- ```
238
-
239
- In this case, default values for keywords, urls, name and release notes are used in all localisations, but each language has a fully localised description
240
-
241
-
242
-
243
- ## Automatically create screenshots
244
-
245
- If you want to integrate `deliver` with [snapshot](https://github.com/fastlane/fastlane/tree/master/snapshot), check out [fastlane](https://fastlane.tools)!
246
-
247
- ## Jenkins integration
248
- Detailed instructions about how to set up `deliver` and `fastlane` in `Jenkins` can be found in the [fastlane README](https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Jenkins.md).
249
-
250
- ## Firewall Issues
251
-
252
- `deliver` uses the iTunes Transporter to upload metadata and binaries. In case you are behind a firewall, you can specify a different transporter protocol using
253
-
254
- ```
255
- DELIVER_ITMSTRANSPORTER_ADDITIONAL_UPLOAD_PARAMETERS="-t DAV" fastlane deliver
256
- ```
257
-
258
- ## HTTP Proxy
259
- iTunes Transporter is a Java application bundled with Xcode. In addition to utilizing the `DELIVER_ITMSTRANSPORTER_ADDITIONAL_UPLOAD_PARAMETERS="-t DAV"`, you need to configure the transporter application to use the proxy independently from the system proxy or any environment proxy settings. You can find the configuration file within Xcode:
260
-
261
- ```bash
262
- TOOLS_PATH=$( xcode-select -p )
263
- REL_PATH='../Applications/Application Loader.app/Contents/itms/java/lib/net.properties'
264
- echo "$TOOLS_PATH/$REL_PATH"
265
- ```
266
-
267
- Add necessary proxy configuration values to the net.properties according to [Java Proxy Configuration](http://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html).
268
-
269
- As an alternative to editing the properties files, proxy configuration can be specified on the command line directly:
270
-
271
- ```bash
272
- DELIVER_ITMSTRANSPORTER_ADDITIONAL_UPLOAD_PARAMETERS="-t DAV -Dhttp.proxyHost=myproxy.com -Dhttp.proxyPort=8080"
273
- ```
274
-
275
- ## Limit
276
- Apple has a limit of 150 binary uploads per day.
277
-
278
- ## Editing the ```Deliverfile```
279
- Change syntax highlighting to *Ruby*.
280
-
281
- # Need help?
282
-
283
- Before submitting a new GitHub issue, please make sure to
284
-
285
- - Check out [docs.fastlane.tools](https://docs.fastlane.tools)
286
- - Check out the README pages on [this repo](https://github.com/fastlane/fastlane)
287
- - Search for [existing GitHub issues](https://github.com/fastlane/fastlane/issues)
288
-
289
- If the above doesn't help, please [submit an issue](https://github.com/fastlane/fastlane/issues) on GitHub and provide information about your setup, in particular the output of the `fastlane env` command.
290
-
291
- # Code of Conduct
292
- Help us keep `deliver` open and inclusive. Please read and follow our [Code of Conduct](https://github.com/fastlane/fastlane/blob/master/CODE_OF_CONDUCT.md).
293
-
294
- # License
295
- This project is licensed under the terms of the MIT license. See the LICENSE file.
296
-
297
- > This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.
17
+ <h3 align="center">The <i>deliver</i> docs were moved to <a href='https://docs.fastlane.tools/actions/deliver'>docs.fastlane.tools</a></h3>