fastlane 1.111.0 → 2.0.1

data/frameit/lib/frameit/frame_downloader.rb

@@ -0,0 +1,71 @@
+module Frameit
+  class FrameDownloader
+    FRAME_PATH = '.frameit/devices_frames_2'
+    HOST_URL = "https://fastlane.github.io/frameit-frames"
+
+    def download_frames
+      print_disclaimer
+
+      require 'json'
+      require 'fileutils'
+
+      UI.message("Downloading device frames...")
+      FileUtils.mkdir_p(templates_path)
+
+      frames_version = download_file("version.txt")
+      File.write(File.join(templates_path, "version.txt"), frames_version)
+      UI.important("Using frame version '#{frames_version}', you can optionally lock that version in your Framefile.json using `device_frame_version`")
+
+      files = JSON.parse(download_file("files.json"))
+      files.each_with_index do |current, index|
+        content = download_file(current, txt: "#{index + 1} of #{files.count} files")
+        File.write(File.join(templates_path, current), content)
+      end
+      File.write(File.join(templates_path, "offsets.json"), download_file("offsets.json"))
+
+      UI.success("Successfully downloaded all required image assets")
+    end
+
+    def frames_exist?(version: "latest")
+      Dir["#{templates_path}/*.png"].count > 0 && File.read(File.join(templates_path, "version.txt")).to_i > 0
+    end
+
+    def self.templates_path
+      File.join(ENV['HOME'], FRAME_PATH, Frameit.frames_version)
+    end
+
+    def templates_path
+      self.class.templates_path
+    end
+
+    def print_disclaimer
+      UI.header "Device frames disclaimer"
+      UI.important "All used device frames are available via Facebook Design: http://facebook.design/devices"
+      UI.message "----------------------------------------"
+      UI.message "While Facebook has redrawn and shares these assets for the benefit"
+      UI.message "of the design community, Facebook does not own any of the underlying"
+      UI.message "product or user interface designs."
+      UI.message "By accessing these assets, you agree to obtain all necessary permissions"
+      UI.message "from the underlying rights holders and/or adhere to any applicable brand"
+      UI.message "use guidelines before using them."
+      UI.message "Facebook disclaims all express or implied warranties with respect to these assets, including"
+      UI.message "non-infringement of intellectual property rights."
+      UI.message "----------------------------------------"
+    end
+
+    private
+
+    def download_file(path, txt: "file")
+      require 'uri'
+
+      url = File.join(HOST_URL, Frameit.frames_version, URI.escape(path))
+      UI.message("Downloading #{txt} from '#{url}' ...")
+      body = Excon.get(url).body
+      raise body if body.include?("<Error>")
+      return body
+    rescue => ex
+      UI.error(ex)
+      UI.user_error!("Error accessing URL '#{url}'")
+    end
+  end
+end

data/frameit/lib/frameit/mac_editor.rb

@@ -0,0 +1,32 @@
+module Frameit
+  # Responsible for framing Mac Screenshots
+  class MacEditor < Editor
+    def prepare_image
+      image = super
+      image.resize("#{offset['width']}x") if offset['width']
+    end
+
+    def put_device_into_background(background)
+      self.top_space_above_device = offset['titleHeight'] # needed for centering the title
+
+      @image = background.composite(image, "png") do |c|
+        c.compose "Over"
+        c.geometry offset['offset']
+      end
+
+      return image
+    end
+
+    def load_frame
+      nil # Macs don't need frames - backgrounds only
+    end
+
+    def should_add_title?
+      true # Mac screenshots always need a background
+    end
+
+    def generate_background
+      MiniMagick::Image.open(fetch_config['background']) # no resizing on the Mac
+    end
+  end
+end

data/frameit/lib/frameit/offsets.rb

@@ -0,0 +1,19 @@
+module Frameit
+  class Offsets
+    # Returns the image offset needed for a certain device type for a given orientation
+    # uses deliver to detect the screen size
+    def self.image_offset(screenshot)
+      require 'json'
+
+      unless @offsets
+        offsets_json_path = File.join(FrameDownloader.new.templates_path, "offsets.json")
+        UI.user_error!("Could not find offsets.json file at path '#{offsets_json_path}'") unless File.exist?(offsets_json_path)
+        @offsets = JSON.parse(File.read(offsets_json_path))
+      end
+
+      offset_value = @offsets["portrait"][screenshot.device_name]
+      UI.error("Tried looking for offset information for 'portrait', #{screenshot.device_name}") unless offset_value
+      return offset_value
+    end
+  end
+end

data/frameit/lib/frameit/options.rb

@@ -0,0 +1,46 @@
+module Frameit
+  class Options
+    def self.available_options
+      @options ||= [
+
+        FastlaneCore::ConfigItem.new(key: :white,
+                                       env_name: "FRAMEIT_WHITE_FRAME",
+                                       description: "Use white device frames",
+                                       optional: true,
+                                       is_string: false),
+        FastlaneCore::ConfigItem.new(key: :silver,
+                                     description: "Use white device frames. Alias for :white",
+                                     optional: true,
+                                     is_string: false),
+        FastlaneCore::ConfigItem.new(key: :rose_gold,
+                                     description: "Use rose gold device frames. Alias for :rose_gold",
+                                     optional: true,
+                                     is_string: false),
+        FastlaneCore::ConfigItem.new(key: :gold,
+                                     description: "Use gold device frames. Alias for :gold",
+                                     optional: true,
+                                     is_string: false),
+        FastlaneCore::ConfigItem.new(key: :force_device_type,
+                                     env_name: "FRAMEIT_FORCE_DEVICE_TYPE",
+                                     description: "Forces a given device type, useful for Mac screenshots, as their sizes vary",
+                                     optional: true,
+                                     verify_block: proc do |value|
+                                       available = ['iPhone_6_Plus', 'iPhone_5s', 'iPhone_4', 'iPad_mini', 'Mac']
+                                       unless available.include? value
+                                         UI.user_error!("Invalid device type '#{value}'. Available values: #{available}")
+                                       end
+                                     end),
+        FastlaneCore::ConfigItem.new(key: :use_legacy_iphone5s,
+                           env_name: "FRAMEIT_USE_LEGACY_IPHONE_5_S",
+                           is_string: false,
+                           description: "use iPhone 5s instead of iPhone SE frames",
+                           default_value: false),
+        FastlaneCore::ConfigItem.new(key: :use_legacy_iphone6s,
+                           env_name: "FRAMEIT_USE_LEGACY_IPHONE_6_S",
+                           is_string: false,
+                           description: "Use iPhone 6s frames instead of iPhone 7 frames",
+                           default_value: false)
+      ]
+    end
+  end
+end

data/frameit/lib/frameit/runner.rb

@@ -0,0 +1,45 @@
+require 'deliver'
+require 'fastimage'
+
+module Frameit
+  class Runner
+    def initialize
+      downloader = FrameDownloader.new
+      unless downloader.frames_exist?
+        downloader.download_frames
+      end
+    end
+
+    def run(path, color = nil)
+      unless color
+        color = Frameit::Color::BLACK
+        color = Frameit::Color::SILVER if Frameit.config[:white] || Frameit.config[:silver]
+        color = Frameit::Color::GOLD if Frameit.config[:gold]
+        color = Frameit::Color::ROSE_GOLD if Frameit.config[:rose_gold]
+      end
+
+      screenshots = Dir.glob("#{path}/**/*.{png,PNG}").uniq # uniq because thanks to {png,PNG} there are duplicates
+
+      if screenshots.count > 0
+        screenshots.each do |full_path|
+          next if full_path.include? "_framed.png"
+          next if full_path.include? ".itmsp/" # a package file, we don't want to modify that
+          next if full_path.include? "device_frames/" # these are the device frames the user is using
+          next if full_path.downcase.include? "watch" # we don't care about watches right now
+
+          UI.message("Framing screenshot '#{full_path}'")
+
+          begin
+            screenshot = Screenshot.new(full_path, color)
+            screenshot.frame!
+          rescue => ex
+            UI.error ex.to_s
+            UI.error "Backtrace:\n\t#{ex.backtrace.join("\n\t")}" if $verbose
+          end
+        end
+      else
+        UI.error "Could not find screenshots in current directory: '#{File.expand_path(path)}'"
+      end
+    end
+  end
+end

data/frameit/lib/frameit/screenshot.rb

@@ -0,0 +1,89 @@
+module Frameit
+  # Represents one screenshot
+  class Screenshot
+    attr_accessor :path # path to the screenshot
+    attr_accessor :size # size in px array of 2 elements: height and width
+    attr_accessor :screen_size # deliver screen size type, is unique per device type, used in device_name
+    attr_accessor :color # the color to use for the frame (from Frameit::Color)
+
+    # path: Path to screenshot
+    # color: Color to use for the frame
+    def initialize(path, color)
+      UI.user_error "Couldn't find file at path '#{path}'" unless File.exist? path
+      @color = color
+      @path = path
+      @size = FastImage.size(path)
+
+      @screen_size = ENV["FRAMEIT_FORCE_DEVICE_TYPE"] || Deliver::AppScreenshot.calculate_screen_size(path)
+    end
+
+    # Device name for a given screen size. Used to use the correct template
+    def device_name
+      sizes = Deliver::AppScreenshot::ScreenSize
+      case @screen_size
+      when sizes::IOS_55
+        return Frameit.config[:use_legacy_iphone6s] ? 'iPhone 6s Plus' : 'iPhone 7 Plus'
+      when sizes::IOS_47
+        return Frameit.config[:use_legacy_iphone6s] ? 'iPhone 6s' : 'iPhone 7'
+      when sizes::IOS_40
+        return Frameit.config[:use_legacy_iphone5s] ? 'iPhone 5s' : 'iPhone SE'
+      when sizes::IOS_35
+        return 'iPhone 4'
+      when sizes::IOS_IPAD
+        return 'iPad Air 2'
+      when sizes::IOS_IPAD_PRO
+        return 'iPad Pro'
+      when sizes::MAC
+        return 'MacBook'
+      else
+        UI.error "Unknown device type for size #{@screen_size} for path '#{path}'"
+      end
+    end
+
+    def color
+      if !Frameit.config[:use_legacy_iphone6s] && @color == Frameit::Color::BLACK
+        if @screen_size == Deliver::AppScreenshot::ScreenSize::IOS_55 || @screen_size == Deliver::AppScreenshot::ScreenSize::IOS_47
+          return "Matte Black" # RIP space gray
+        end
+      end
+      return @color
+    end
+
+    # Is the device a 3x device? (e.g. 6 Plus)
+    def triple_density?
+      (screen_size == Deliver::AppScreenshot::ScreenSize::IOS_55)
+    end
+
+    # Super old devices (iPhone 4)
+    def mini?
+      (screen_size == Deliver::AppScreenshot::ScreenSize::IOS_35)
+    end
+
+    def mac?
+      return device_name == 'Mac'
+    end
+
+    # The name of the orientation of a screenshot. Used to find the correct template
+    def orientation_name
+      return Orientation::PORTRAIT if size[0] < size[1]
+      return Orientation::LANDSCAPE
+    end
+
+    def portrait?
+      return (orientation_name == Orientation::PORTRAIT)
+    end
+
+    def to_s
+      self.path
+    end
+
+    # Add the device frame, this will also call the method that adds the background + title
+    def frame!
+      if self.mac?
+        MacEditor.new.frame!(self)
+      else
+        Editor.new.frame!(self)
+      end
+    end
+  end
+end

data/frameit/lib/frameit/strings_parser.rb

@@ -0,0 +1,35 @@
+module Frameit
+  # This class will parse the .string files
+  class StringsParser
+    def self.parse(path)
+      UI.user_error! "Couldn't find strings file at path '#{path}'" unless File.exist? path
+      UI.user_error! "Must be .strings file, only got '#{path}'" unless path.end_with? ".strings"
+
+      result = {}
+
+      # A .strings file is UTF-16 encoded. We only want to deal with UTF-8
+      content = `iconv -f UTF-16 -t UTF-8 '#{path}'`
+
+      content.split("\n").each_with_index do |line, index|
+        begin
+          # We don't care about comments and empty lines
+          if line.start_with? '"'
+            key = line.match(/"(.*)" \= /)[1]
+            value = line.match(/ \= "(.*)"/)[1]
+
+            result[key] = value
+          end
+        rescue => ex
+          UI.error "Error parsing #{path} line #{index + 1}: '#{line}'"
+          UI.verbose "#{ex.message}\n#{ex.backtrace.join('\n')}"
+        end
+      end
+
+      if result.empty?
+        UI.error "Empty parsing result for #{path}. Please make sure the file is valid and UTF16 Big-endian encoded"
+      end
+
+      result
+    end
+  end
+end

data/frameit/lib/frameit/template_finder.rb

@@ -0,0 +1,36 @@
+module Frameit
+  # Responsible for finding the correct device
+  class TemplateFinder
+    # This will detect the screen size and choose the correct template
+    def self.get_template(screenshot)
+      return nil if screenshot.mac?
+
+      filename = "Apple #{screenshot.device_name} #{screenshot.color}"
+
+      templates = Dir["#{FrameDownloader.templates_path}/#{filename}.{png,jpg}"] # ~/.frameit folder
+
+      UI.verbose "Looking for #{filename} and found #{templates.count} template(s)"
+
+      if templates.count == 0
+        if screenshot.screen_size == Deliver::AppScreenshot::ScreenSize::IOS_35
+          UI.important "Unfortunately 3.5\" device frames were discontinued. Skipping screen '#{screenshot.path}'"
+          UI.error "Looked for: '#{filename}.png'"
+        elsif screenshot.color == Frameit::Color::ROSE_GOLD || screenshot.color == Frameit::Color::GOLD
+          # Unfortunately not every device type is available in rose gold or gold
+          # This is why we can't have nice things #yatusabes
+          # fallback to a white iPhone, which looks similar
+          UI.important("Unfortunatey device type '#{screenshot.device_name}' is not available in #{screenshot.color}, falling back to silver...")
+          screenshot.color = Frameit::Color::SILVER
+          return self.get_template(screenshot)
+        else
+          UI.error("Couldn't find template for screenshot type '#{filename}'")
+          UI.error("Please run `frameit download_frames` to download the latest frames")
+        end
+        return filename if Helper.test?
+        return nil
+      else
+        return templates.first.tr(" ", "\ ")
+      end
+    end
+  end
+end

data/gym/README.md

@@ -0,0 +1,288 @@
+<h3 align="center">
+  <a href="https://github.com/fastlane/fastlane/tree/master/fastlane">
+    <img src="../fastlane/assets/fastlane.png" width="150" />
+    <br />
+    fastlane
+  </a>
+</h3>
+<p align="center">
+  <a href="https://github.com/fastlane/fastlane/tree/master/deliver">deliver</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/snapshot">snapshot</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/frameit">frameit</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/pem">pem</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/sigh">sigh</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/produce">produce</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/cert">cert</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/spaceship">spaceship</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/pilot">pilot</a> &bull;
+  <a href="https://github.com/fastlane/boarding">boarding</a> &bull;
+  <b>gym</b> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/scan">scan</a> &bull;
+  <a href="https://github.com/fastlane/fastlane/tree/master/match">match</a>
+</p>
+-------
+
+<p align="center">
+  <img src="assets/gym.png" height="110">
+</p>
+
+gym
+============
+
+[![Twitter: @KauseFx](https://img.shields.io/badge/contact-@FastlaneTools-blue.svg?style=flat)](https://twitter.com/FastlaneTools)
+[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/fastlane/fastlane/blob/master/gym/LICENSE)
+[![Gem](https://img.shields.io/gem/v/gym.svg?style=flat)](http://rubygems.org/gems/gym)
+
+###### Building your app has never been easier
+
+Get in contact with the developer on Twitter: [@FastlaneTools](https://twitter.com/FastlaneTools)
+
+-------
+<p align="center">
+    <a href="#whats-gym">Features</a> &bull;
+    <a href="#installation">Installation</a> &bull;
+    <a href="#usage">Usage</a> &bull;
+    <a href="#tips">Tips</a> &bull;
+    <a href="#need-help">Need help?</a>
+</p>
+
+-------
+
+<h5 align="center"><code>gym</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>
+
+# What's gym?
+
+`gym` builds and packages iOS and macOS apps for you. It takes care of all the heavy lifting and makes it super easy to generate a signed `ipa` or `app` file :muscle:
+
+`gym` is a replacement for [shenzhen](https://github.com/nomad/shenzhen).
+
+### Before `gym`
+
+```
+xcodebuild clean archive -archivePath build/MyApp \
+                         -scheme MyApp
+xcodebuild -exportArchive \
+           -exportFormat ipa \
+           -archivePath "build/MyApp.xcarchive" \
+           -exportPath "build/MyApp.ipa" \
+           -exportProvisioningProfile "ProvisioningProfileName"
+```
+
+### With `gym`
+
+```
+fastlane gym
+```
+
+### Why `gym`?
+
+`gym` uses the latest APIs to build and sign your application which results in much faster build times.
+
+              |  Gym Features
+--------------------------|------------------------------------------------------------
+:rocket:            | `gym` builds 30% faster than other build tools like [shenzhen](https://github.com/nomad/shenzhen)
+:checkered_flag: | Beautiful inline build output
+:book:     | Helps you resolve common build errors like code signing issues
+:mountain_cableway: | Sensible defaults: Automatically detect the project, its schemes and more
+:link:  | Works perfectly with [fastlane](https://fastlane.tools) and other tools
+:package: | Automatically generates an `ipa` and a compressed `dSYM` file
+:bullettrain_side: | Don't remember any complicated build commands, just `gym`
+:wrench:  | Easy and dynamic configuration using parameters and environment variables
+:floppy_disk:   | Store common build settings in a `Gymfile`
+:outbox_tray: | All archives are stored and accessible in the Xcode Organizer
+:computer: | Supports both iOS and Mac applications
+
+![assets/gymScreenshot.png](assets/gymScreenshot.png)
+
+-----
+
+![assets/gym.gif](assets/gym.gif)
+
+# Installation
+
+    sudo gem install fastlane
+
+Make sure, you have the latest version of the Xcode command line tools installed:
+
+    xcode-select --install
+
+# Usage
+
+    fastlane gym
+
+That's all you need to build your application. If you want more control, here are some available parameters:
+
+    fastlane gym --workspace "Example.xcworkspace" --scheme "AppName" --clean
+
+If you need to use a different xcode install, use xcode-select or define DEVELOPER_DIR:
+
+    DEVELOPER_DIR="/Applications/Xcode6.2.app" gym
+
+For a list of all available parameters use
+
+    fastlane gym --help
+
+If you run into any issues, use the `verbose` mode to get more information
+
+    fastlane gym --verbose
+
+In general, if you run into issues while exporting the archive, try using:
+
+    fastlane gym --use_legacy_build_api
+
+Set the right export method if you're not uploading to App Store or TestFlight:
+
+    fastlane gym --export_method ad-hoc
+
+To pass boolean parameters make sure to use `gym` like this:
+
+    fastlane gym --include_bitcode true --include_symbols false
+
+To access the raw `xcodebuild` output open `~/Library/Logs/gym`
+
+# Gymfile
+
+Since you might want to manually trigger a new build but don't want to specify all the parameters every time, you can store your defaults in a so called `Gymfile`.
+
+Run `fastlane gym init` to create a new configuration file. Example:
+
+```ruby
+scheme "Example"
+
+sdk "iphoneos9.0"
+
+clean true
+
+output_directory "./build"    # store the ipa in this folder
+output_name "MyApp"           # the name of the ipa file
+```
+
+## Export options
+
+Since Xcode 7, `gym` is using new Xcode API which allows us to specify export options using `plist` file. By default `gym` creates this file for you and you are able to modify some parameters by using `export_method`, `export_team_id`, `include_symbols` or `include_bitcode`. If you want to have more options, like creating manifest file or app thinning, you can provide your own `plist` file:
+
+```ruby
+export_options "./ExportOptions.plist"
+```
+
+or you can provide hash of values directly in the `Gymfile`:
+
+```ruby
+export_options(
+  method: "ad-hoc",
+  manifest: {
+    appURL: "https://example.com/My App.ipa",
+  },
+  thinning: "<thin-for-all-variants>"
+)
+```
+
+For the list of available options run `xcodebuild -help`.
+
+## Setup code signing
+
+- [More information on how to get started with codesigning](https://docs.fastlane.tools/codesigning/getting-started/)
+- [Docs on how to set up your Xcode project](https://docs.fastlane.tools/codesigning/xcode-project/)
+
+## Automating the whole process
+
+`gym` works great together with [fastlane](https://fastlane.tools), which connects all deployment tools into one streamlined workflow.
+
+Using `fastlane` you can define a configuration like
+
+```ruby
+lane :beta do
+  scan
+  gym(scheme: "MyApp")
+  crashlytics
+end
+```
+
+You can then easily switch between the beta provider (e.g. `testflight`, `hockey`, `s3` and more).
+
+For more information visit the [fastlane GitHub page](https://github.com/fastlane/fastlane/tree/master/fastlane).
+
+# How does it work?
+
+`gym` uses the latest APIs to build and sign your application. The 2 main components are
+
+- `xcodebuild`
+- [xcpretty](https://github.com/supermarin/xcpretty)
+
+When you run `gym` without the `--silent` mode it will print out every command it executes.
+
+To build the archive `gym` uses the following command:
+
+```
+set -o pipefail && \
+xcodebuild -scheme 'Example' \
+-project './Example.xcodeproj' \
+-configuration 'Release' \
+-destination 'generic/platform=iOS' \
+-archivePath '/Users/felixkrause/Library/Developer/Xcode/Archives/2015-08-11/ExampleProductName 2015-08-11 18.15.30.xcarchive' \
+archive | xcpretty
+```
+
+After building the archive it is being checked by `gym`. If it's valid, it gets packaged up and signed into an `ipa` file.
+
+`gym` automatically chooses a different packaging method depending on the version of Xcode you're using.
+
+### Xcode 7 and above
+
+```
+/usr/bin/xcrun path/to/xcbuild-safe.sh -exportArchive \
+-exportOptionsPlist '/tmp/gym_config_1442852529.plist' \
+-archivePath '/Users/fkrause/Library/Developer/Xcode/Archives/2015-09-21/App 2015-09-21 09.21.56.xcarchive' \
+-exportPath '/tmp/1442852529'
+```
+
+`gym` makes use of the new Xcode 7 API which allows us to specify the export options using a `plist` file. You can find more information about the available options by running `xcodebuild --help`.
+
+Using this method there are no workarounds for WatchKit or Swift required, as it uses the same technique Xcode uses when exporting your binary.
+
+Note: the [xcbuild-safe.sh script](https://github.com/fastlane/fastlane/tree/master/gym/lib/assets/wrap_xcodebuild/xcbuild-safe.sh) wraps around xcodebuild to workaround some incompatibilities.
+
+### Xcode 6 and below
+
+```
+/usr/bin/xcrun /path/to/PackageApplication4Gym -v \
+'/Users/felixkrause/Library/Developer/Xcode/Archives/2015-08-11/ExampleProductName 2015-08-11 18.15.30.xcarchive/Products/Applications/name.app' -o \
+'/Users/felixkrause/Library/Developer/Xcode/Archives/2015-08-11/ExampleProductName.ipa' \
+--sign "identity" --embed "provProfile"
+```
+
+Note: the official PackageApplication script is replaced by a custom PackageApplication4Gym script. This script is obtained by applying a [set of patches](https://github.com/fastlane/fastlane/tree/master/gym/lib/assets/package_application_patches) on the fly to fix some known issues in the official Xcode PackageApplication script.
+
+Afterwards the `ipa` file is moved to the output folder. The `dSYM` file is compressed and moved to the output folder as well.
+
+# Tips
+## [`fastlane`](https://fastlane.tools) Toolchain
+
+- [`fastlane`](https://fastlane.tools): The easiest way to automate beta deployments and releases for your iOS and Android apps
+- [`deliver`](https://github.com/fastlane/fastlane/tree/master/deliver): Upload screenshots, metadata and your app to the App Store
+- [`snapshot`](https://github.com/fastlane/fastlane/tree/master/snapshot): Automate taking localized screenshots of your iOS app on every device
+- [`frameit`](https://github.com/fastlane/fastlane/tree/master/frameit): Quickly put your screenshots into the right device frames
+- [`pem`](https://github.com/fastlane/fastlane/tree/master/pem): Automatically generate and renew your push notification profiles
+- [`produce`](https://github.com/fastlane/fastlane/tree/master/produce): Create new iOS apps on iTunes Connect and Dev Portal using the command line
+- [`cert`](https://github.com/fastlane/fastlane/tree/master/cert): Automatically create and maintain iOS code signing certificates
+- [`spaceship`](https://github.com/fastlane/fastlane/tree/master/spaceship): Ruby library to access the Apple Dev Center and iTunes Connect
+- [`pilot`](https://github.com/fastlane/fastlane/tree/master/pilot): The best way to manage your TestFlight testers and builds from your terminal
+- [`boarding`](https://github.com/fastlane/boarding): The easiest way to invite your TestFlight beta testers
+- [`scan`](https://github.com/fastlane/fastlane/tree/master/scan): The easiest way to run tests of your iOS and Mac app
+- [`match`](https://github.com/fastlane/fastlane/tree/master/match): Easily sync your certificates and profiles across your team using git
+
+##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
+
+## Use the 'Provisioning Quicklook plugin'
+Download and install the [Provisioning Plugin](https://github.com/chockenberry/Provisioning).
+
+# Need help?
+Please submit an issue on GitHub and provide information about your setup
+
+# Code of Conduct
+Help us keep `gym` open and inclusive. Please read and follow our [Code of Conduct](https://github.com/fastlane/fastlane/blob/master/CODE_OF_CONDUCT.md).
+
+# License
+This project is licensed under the terms of the MIT license. See the LICENSE file.
+
+> 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.