fastlane 1.111.0 → 2.0.1

data/screengrab/lib/screengrab/runner.rb

@@ -0,0 +1,336 @@
+
+module Screengrab
+  class Runner
+    NEEDED_PERMISSIONS = [
+      'android.permission.READ_EXTERNAL_STORAGE',
+      'android.permission.WRITE_EXTERNAL_STORAGE',
+      'android.permission.CHANGE_CONFIGURATION'
+    ].freeze
+
+    attr_accessor :number_of_retries
+
+    def initialize(executor = FastlaneCore::CommandExecutor,
+                   config = Screengrab.config,
+                   android_env = Screengrab.android_environment)
+
+      @executor = executor
+      @config = config
+      @android_env = android_env
+    end
+
+    def run
+      FastlaneCore::PrintTable.print_values(config: @config, hide_keys: [], title: "Summary for screengrab #{Fastlane::VERSION}")
+
+      app_apk_path = @config.fetch(:app_apk_path, ask: false)
+      tests_apk_path = @config.fetch(:tests_apk_path, ask: false)
+      discovered_apk_paths = Dir[File.join('**', '*.apk')]
+
+      apk_paths_provided = app_apk_path && !app_apk_path.empty? && tests_apk_path && !tests_apk_path.empty?
+
+      unless apk_paths_provided || discovered_apk_paths.any?
+        UI.error 'No APK paths were provided and no APKs could be found'
+        UI.error "Please provide APK paths with 'app_apk_path' and 'tests_apk_path' and make sure you have assembled APKs prior to running this command."
+        return
+      end
+
+      test_classes_to_use = @config[:use_tests_in_classes]
+      test_packages_to_use = @config[:use_tests_in_packages]
+
+      if test_classes_to_use && test_classes_to_use.any? && test_packages_to_use && test_packages_to_use.any?
+        UI.error "'use_tests_in_classes' and 'use_tests_in_packages' can not be combined. Please use one or the other."
+        return
+      end
+
+      if (test_classes_to_use.nil? || test_classes_to_use.empty?) && (test_packages_to_use.nil? || test_packages_to_use.empty?)
+        UI.important 'Limiting the test classes run by `screengrab` to just those that generate screenshots can make runs faster.'
+        UI.important 'Consider using the :use_tests_in_classes or :use_tests_in_packages option, and organize your tests accordingly.'
+      end
+
+      device_type_dir_name = "#{@config[:device_type]}Screenshots"
+      clear_local_previous_screenshots(device_type_dir_name)
+
+      device_serial = select_device
+
+      device_screenshots_paths = [
+        determine_external_screenshots_path(device_serial),
+        determine_internal_screenshots_path
+      ]
+
+      clear_device_previous_screenshots(device_serial, device_screenshots_paths)
+
+      app_apk_path ||= select_app_apk(discovered_apk_paths)
+      tests_apk_path ||= select_tests_apk(discovered_apk_paths)
+
+      validate_apk(app_apk_path)
+
+      install_apks(device_serial, app_apk_path, tests_apk_path)
+
+      grant_permissions(device_serial)
+
+      run_tests(device_serial, test_classes_to_use, test_packages_to_use)
+
+      number_of_screenshots = pull_screenshots_from_device(device_serial, device_screenshots_paths, device_type_dir_name)
+
+      open_screenshots_summary(device_type_dir_name)
+
+      UI.success "Captured #{number_of_screenshots} screenshots! 📷✨"
+    end
+
+    def select_device
+      devices = run_adb_command("adb devices -l", print_all: true, print_command: true).split("\n")
+      # the first output by adb devices is "List of devices attached" so remove that and any adb startup output
+      devices.reject! do |device|
+        [
+          'server is out of date',   # The adb server is out of date and must be restarted
+          'unauthorized',            # The device has not yet accepted ADB control
+          'offline',                 # The device is offline, skip it
+          '* daemon',                # Messages printed when the daemon is starting up
+          'List of devices attached' # Header of table for data we want
+        ].any? { |status| device.include? status }
+      end
+
+      UI.user_error! 'There are no connected and authorized devices or emulators' if devices.empty?
+
+      devices.select! { |d| d.include?(@config[:specific_device]) } if @config[:specific_device]
+
+      UI.user_error! "No connected devices matched your criteria: #{@config[:specific_device]}" if devices.empty?
+
+      if devices.length > 1
+        UI.important "Multiple connected devices, selecting the first one"
+        UI.important "To specify which connected device to use, use the -s (specific_device) config option"
+      end
+
+      # grab the serial number. the lines of output can look like these:
+      # 00c22d4d84aec525       device usb:2148663295X product:bullhead model:Nexus_5X device:bullhead
+      # 192.168.1.100:5555       device usb:2148663295X product:bullhead model:Nexus_5X device:genymotion
+      # emulator-5554       device usb:2148663295X product:bullhead model:Nexus_5X device:emulator
+      devices[0].match(/^\S+/)[0]
+    end
+
+    def select_app_apk(discovered_apk_paths)
+      UI.important "To not be asked about this value, you can specify it using 'app_apk_path'"
+      UI.select('Select your debug app APK', discovered_apk_paths)
+    end
+
+    def select_tests_apk(discovered_apk_paths)
+      UI.important "To not be asked about this value, you can specify it using 'tests_apk_path'"
+      UI.select('Select your debug tests APK', discovered_apk_paths)
+    end
+
+    def clear_local_previous_screenshots(device_type_dir_name)
+      if @config[:clear_previous_screenshots]
+        UI.message "Clearing #{device_type_dir_name} within #{@config[:output_directory]}"
+
+        # We'll clear the temporary directory where screenshots wind up after being pulled from
+        # the device as well, in case those got stranded on a previous run/failure
+        ['screenshots', device_type_dir_name].each do |dir_name|
+          files = screenshot_file_names_in(@config[:output_directory], dir_name)
+          File.delete(*files)
+        end
+      end
+    end
+
+    def screenshot_file_names_in(output_directory, device_type)
+      Dir.glob(File.join(output_directory, '**', device_type, '*.png'), File::FNM_CASEFOLD)
+    end
+
+    def determine_external_screenshots_path(device_serial)
+      device_ext_storage = run_adb_command("adb -s #{device_serial} shell echo \\$EXTERNAL_STORAGE",
+                                           print_all: true,
+                                           print_command: true)
+      File.join(device_ext_storage, @config[:app_package_name], 'screengrab')
+    end
+
+    def determine_internal_screenshots_path
+      "/data/data/#{@config[:app_package_name]}/app_screengrab"
+    end
+
+    def clear_device_previous_screenshots(device_serial, device_screenshots_paths)
+      UI.message 'Cleaning screenshots on device'
+
+      device_screenshots_paths.each do |device_path|
+        if_device_path_exists(device_serial, device_path) do |path|
+          run_adb_command("adb -s #{device_serial} shell rm -rf #{path}",
+                          print_all: true,
+                          print_command: true)
+        end
+      end
+    end
+
+    def validate_apk(app_apk_path)
+      unless @android_env.aapt_path
+        UI.important "The `aapt` command could not be found on your system, so your app APK could not be validated"
+        return
+      end
+
+      UI.message 'Validating app APK'
+      apk_permissions = @executor.execute(command: "#{@android_env.aapt_path} dump permissions #{app_apk_path}",
+                                          print_all: true,
+                                          print_command: true)
+
+      missing_permissions = NEEDED_PERMISSIONS.reject { |needed| apk_permissions.include?(needed) }
+
+      if missing_permissions.any?
+        UI.user_error! "The needed permission(s) #{missing_permissions.join(', ')} could not be found in your app APK"
+      end
+    end
+
+    def install_apks(device_serial, app_apk_path, tests_apk_path)
+      UI.message 'Installing app APK'
+      apk_install_output = run_adb_command("adb -s #{device_serial} install -r #{app_apk_path.shellescape}",
+                                           print_all: true,
+                                           print_command: true)
+      UI.user_error! "App APK could not be installed" if apk_install_output.include?("Failure [")
+
+      UI.message 'Installing tests APK'
+      apk_install_output = run_adb_command("adb -s #{device_serial} install -r #{tests_apk_path.shellescape}",
+                                           print_all: true,
+                                           print_command: true)
+      UI.user_error! "Tests APK could not be installed" if apk_install_output.include?("Failure [")
+    end
+
+    def grant_permissions(device_serial)
+      UI.message 'Granting the permission necessary to change locales on the device'
+      run_adb_command("adb -s #{device_serial} shell pm grant #{@config[:app_package_name]} android.permission.CHANGE_CONFIGURATION",
+                      print_all: true,
+                      print_command: true)
+
+      device_api_version = run_adb_command("adb -s #{device_serial} shell getprop ro.build.version.sdk",
+                                           print_all: true,
+                                           print_command: true).to_i
+
+      if device_api_version >= 23
+        UI.message 'Granting the permissions necessary to access device external storage'
+        run_adb_command("adb -s #{device_serial} shell pm grant #{@config[:app_package_name]} android.permission.WRITE_EXTERNAL_STORAGE",
+                        print_all: true,
+                        print_command: true)
+        run_adb_command("adb -s #{device_serial} shell pm grant #{@config[:app_package_name]} android.permission.READ_EXTERNAL_STORAGE",
+                        print_all: true,
+                        print_command: true)
+      end
+    end
+
+    def run_tests(device_serial, test_classes_to_use, test_packages_to_use)
+      @config[:locales].each do |locale|
+        UI.message "Running tests for locale: #{locale}"
+
+        instrument_command = ["adb -s #{device_serial} shell am instrument --no-window-animation -w",
+                              "-e testLocale #{locale.tr('-', '_')}",
+                              "-e endingLocale #{@config[:ending_locale].tr('-', '_')}"]
+        instrument_command << "-e class #{test_classes_to_use.join(',')}" if test_classes_to_use
+        instrument_command << "-e package #{test_packages_to_use.join(',')}" if test_packages_to_use
+        instrument_command << "#{@config[:tests_package_name]}/#{@config[:test_instrumentation_runner]}"
+
+        test_output = run_adb_command(instrument_command.join(" \\\n"),
+                                      print_all: true,
+                                      print_command: true)
+
+        UI.user_error!("Tests failed", show_github_issues: false) if test_output.include?("FAILURES!!!")
+      end
+    end
+
+    def pull_screenshots_from_device(device_serial, device_screenshots_paths, device_type_dir_name)
+      UI.message "Pulling captured screenshots from the device"
+      starting_screenshot_count = screenshot_file_names_in(@config[:output_directory], device_type_dir_name).length
+
+      UI.verbose("Starting screenshot count is: #{starting_screenshot_count}")
+
+      # Make a temp directory into which to pull the screenshots before they are moved to their final location.
+      # This makes directory cleanup easier, as the temp directory will be removed when the block completes.
+      Dir.mktmpdir do |tempdir|
+        device_screenshots_paths.each do |device_path|
+          if_device_path_exists(device_serial, device_path) do |path|
+            run_adb_command("adb -s #{device_serial} pull #{path} #{tempdir}",
+                            print_all: false,
+                            print_command: true)
+          end
+        end
+
+        # The SDK can't 100% determine what kind of device it is running on relative to the categories that
+        # supply and Google Play care about (phone, 7" tablet, TV, etc.).
+        #
+        # Therefore, we'll move the pulled screenshots from their genericly named folder to one named by the
+        # user provided device_type option value to match the directory structure that supply expects
+        move_pulled_screenshots(tempdir, device_type_dir_name)
+      end
+
+      ending_screenshot_count = screenshot_file_names_in(@config[:output_directory], device_type_dir_name).length
+
+      UI.verbose("Ending screenshot count is: #{ending_screenshot_count}")
+
+      # Because we can't guarantee the screenshot output directory will be empty when we pull, we determine
+      # success based on whether there are more screenshots there than when we started.
+      if starting_screenshot_count == ending_screenshot_count
+        UI.error "Make sure you've used Screengrab.screenshot() in your tests and that your expected tests are being run."
+        UI.user_error! "No screenshots were detected 📷❌"
+      end
+
+      ending_screenshot_count - starting_screenshot_count
+    end
+
+    def move_pulled_screenshots(pull_dir, device_type_dir_name)
+      # Glob pattern that finds the pulled screenshots directory for each locale
+      # Possible matches:
+      #   [pull_dir]/en-US/images/screenshots
+      #   [pull_dir]/screengrab/en-US/images/screenshots
+      screenshots_dir_pattern = File.join(pull_dir, '**', "screenshots")
+
+      Dir.glob(screenshots_dir_pattern, File::FNM_CASEFOLD).each do |screenshots_dir|
+        src_screenshots = Dir.glob(File.join(screenshots_dir, '*.png'), File::FNM_CASEFOLD)
+
+        # The :output_directory is the final location for the screenshots, so we begin by replacing
+        # the temp directory portion of the path, with the output directory
+        dest_dir = screenshots_dir.gsub(pull_dir, @config[:output_directory])
+
+        # Different versions of adb are inconsistent about whether they will pull down the containing
+        # directory for the screenshots, so we'll try to remove that path from the directory name when
+        # creating the destination path.
+        # See: https://github.com/fastlane/fastlane/pull/4915#issuecomment-236368649
+        dest_dir = dest_dir.gsub(%r{(app_)?screengrab/}, '')
+
+        # We then replace the last segment of the screenshots directory path with the device_type
+        # specific name, as expected by supply
+        #
+        # (Moved to: fastlane/metadata/android/en-US/images/phoneScreenshots)
+        dest_dir = File.join(File.dirname(dest_dir), device_type_dir_name)
+
+        FileUtils.mkdir_p(dest_dir)
+        FileUtils.cp_r(src_screenshots, dest_dir)
+        UI.success "Screenshots copied to #{dest_dir}"
+      end
+    end
+
+    # Some device commands fail if executed against a device path that does not exist, so this helper method
+    # provides a way to conditionally execute a block only if the provided path exists on the device.
+    def if_device_path_exists(device_serial, device_path)
+      return if run_adb_command("adb -s #{device_serial} shell ls #{device_path}",
+                                print_all: false,
+                                print_command: false).include?('No such file')
+
+      yield device_path
+    rescue
+      # Some versions of ADB will have a non-zero exit status for this, which will cause the executor to raise.
+      # We can safely ignore that and treat it as if it returned 'No such file'
+    end
+
+    def open_screenshots_summary(device_type_dir_name)
+      unless @config[:skip_open_summary]
+        UI.message "Opening screenshots summary"
+        # MCF: this isn't OK on any platform except Mac
+        run_adb_command("open #{@config[:output_directory]}/*/images/#{device_type_dir_name}/*.png",
+                        print_all: false,
+                        print_command: true)
+      end
+    end
+
+    def run_adb_command(command, print_all: false, print_command: false)
+      output = @executor.execute(command: command,
+                                 print_all: print_all,
+                                 print_command: print_command) || ''
+      output.lines.reject do |line|
+        # Debug/Warning output from ADB}
+        line.start_with?('adb: ')
+      end.join('') # Lines retain their newline chars
+    end
+  end
+end

data/screengrab/lib/screengrab/setup.rb

@@ -0,0 +1,16 @@
+module Screengrab
+  class Setup
+    # This method will take care of creating a screengrabfile and other necessary files
+    def self.create(path)
+      screengrabfile_path = File.join(path, 'Screengrabfile')
+
+      if File.exist?(screengrabfile_path)
+        UI.user_error!("Screengrabfile already exists at path '#{screengrabfile_path}'. Run 'screengrab' to use screengrab.")
+      end
+
+      File.write(screengrabfile_path, File.read("#{Screengrab::ROOT}/lib/assets/ScreengrabfileTemplate"))
+
+      UI.success("Successfully created new Screengrabfile at '#{screengrabfile_path}'")
+    end
+  end
+end

data/sigh/README.md

@@ -0,0 +1,256 @@
+<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;
+  <b>sigh</b> &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;
+  <a href="https://github.com/fastlane/fastlane/tree/master/gym">gym</a> &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/sigh.png" height="110">
+</p>
+
+sigh
+============
+
+[![Twitter: @FastlaneTools](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/sigh/LICENSE)
+[![Gem](https://img.shields.io/gem/v/sigh.svg?style=flat)](http://rubygems.org/gems/sigh)
+
+###### Because you would rather spend your time building stuff than fighting provisioning
+
+`sigh` can create, renew, download and repair provisioning profiles (with one command). It supports App Store, Ad Hoc, Development and Enterprise profiles and supports nice features, like auto-adding all test devices.
+
+Get in contact with the developer on Twitter: [@FastlaneTools](https://twitter.com/FastlaneTools)
+
+-------
+<p align="center">
+    <a href="#features">Features</a> &bull;
+    <a href="#installation">Installation</a> &bull;
+    <a href="#usage">Usage</a> &bull;
+    <a href="#resign">Resign</a> &bull;
+    <a href="#how-does-it-work">How does it work?</a> &bull;
+    <a href="#tips">Tips</a> &bull;
+    <a href="#need-help">Need help?</a>
+</p>
+
+-------
+
+<h5 align="center"><code>sigh</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>
+
+# Features
+
+- **Download** the latest provisioning profile for your app
+- **Renew** a provisioning profile, when it has expired
+- **Repair** a provisioning profile, when it is broken
+- **Create** a new provisioning profile, if it doesn't exist already
+- Supports **App Store**, **Ad Hoc** and **Development** profiles
+- Support for **multiple Apple accounts**, storing your credentials securely in the Keychain
+- Support for **multiple Teams**
+- Support for **Enterprise Profiles**
+
+To automate iOS Push profiles you can use [pem](https://github.com/fastlane/fastlane/tree/master/pem).
+
+##### [Like this tool? Be the first to know about updates and new fastlane tools](https://tinyletter.com/krausefx)
+
+### Why not let Xcode do the work?
+
+- ```sigh``` can easily be integrated into your CI-server (e.g. Jenkins)
+- Xcode sometimes invalidates [all existing profiles](assets/SignErrors.png)
+- You have control over what happens
+- You still get to have the signing files, which you can then use for your build scripts or store in git
+
+See ```sigh``` in action:
+
+![assets/sighRecording.gif](assets/sighRecording.gif)
+
+# Installation
+
+**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 provisioning profiles. Use `sigh` directly only if you want full control over what's going on and know more about codesigning.
+
+    sudo gem install fastlane
+
+Make sure, you have the latest version of the Xcode command line tools installed:
+
+    xcode-select --install
+
+# Usage
+
+    fastlane sigh
+
+Yes, that's the whole command!
+
+```sigh``` will create, repair and download profiles for the App Store by default.
+
+You can pass your bundle identifier and username like this:
+
+    fastlane sigh -a com.krausefx.app -u username
+
+If you want to generate an **Ad Hoc** profile instead of an App Store profile:
+
+    fastlane sigh --adhoc
+
+If you want to generate a **Development** profile:
+
+    fastlane sigh --development
+
+To generate the profile in a specific directory:
+
+    fastlane sigh -o "~/Certificates/"
+
+To download all your provisioning profiles use
+
+    fastlane sigh download_all
+
+For a list of available parameters and commands run
+
+    fastlane sigh --help
+
+### Advanced
+
+By default, ```sigh``` will install the downloaded profile on your machine. If you just want to generate the profile and skip the installation, use the following flag:
+
+    fastlane sigh --skip_install
+
+To save the provisioning profile under a specific name, use the -q option:
+
+    fastlane sigh -a com.krausefx.app -u username -q "myProfile.mobileprovision"
+
+If for some reason you don't want `sigh` to verify that the code signing identity is installed on your local machine:
+
+    fastlane sigh --skip_certificate_verification
+
+If you need the provisioning profile to be renewed regardless of its state use the `--force` option. This gives you a profile with the maximum lifetime. `--force` will also add all available devices to this profile.
+
+    fastlane sigh --force
+
+By default, `sigh` will include all certificates on development profiles, and first certificate on other types. If you need to specify which certificate to use you can either use the environment variable `SIGH_CERTIFICATE`, or pass the name or expiry date of the certificate as argument:
+
+    fastlane sigh -c "SunApps GmbH"
+
+For a list of available parameters and commands run
+
+    fastlane sigh --help
+
+
+### Use with [`fastlane`](https://github.com/fastlane/fastlane/tree/master/fastlane)
+
+`sigh` becomes really interesting when used in [`fastlane`](https://github.com/fastlane/fastlane/tree/master/fastlane) in combination with [`cert`](https://github.com/fastlane/fastlane/tree/master/cert).
+
+Update your `Fastfile` to contain the following code:
+
+```ruby
+lane :beta do
+  cert
+  sigh(force: true)
+end
+```
+
+`force: true` will make sure to re-generate the provisioning profile on each run.
+This will result in `sigh` always using the correct signing certificate, which is installed on the local machine.
+
+
+# Repair
+
+`sigh` can automatically repair all your existing provisioning profiles which are expired or just invalid.
+
+    fastlane sigh repair
+
+# Resign
+
+If you generated your `ipa` file but want to apply a different code signing onto the ipa file, you can use `sigh resign`:
+
+    fastlane sigh resign
+
+`sigh` will find the ipa file and the provisioning profile for you if they are located in the current folder.
+
+You can pass more information using the command line:
+
+    fastlane sigh resign ./path/app.ipa --signing_identity "iPhone Distribution: Felix Krause" -p "my.mobileprovision"
+
+# Manage
+
+With `sigh manage` you can list all provisioning profiles installed locally.
+
+    fastlane sigh manage
+
+Delete all expired provisioning profiles
+
+    fastlane sigh manage -e
+
+Or delete all `iOS Team Provisioning Profile` by using a regular expression
+
+    fastlane sigh manage -p "iOS\ ?Team Provisioning Profile:"
+
+## Environment Variables
+
+Run `fastlane sigh --help` to get a list of all available environment variables.
+
+If you're using [cert](https://github.com/fastlane/fastlane/tree/master/cert) in combination with [fastlane](https://github.com/fastlane/fastlane/tree/master/fastlane) the signing certificate will automatically be selected for you. (make sure to run `cert` before `sigh`)
+
+# How does it work?
+
+`sigh` will access the `iOS Dev Center` to download, renew or generate the `.mobileprovision` file. It uses [spaceship](https://spaceship.airforce) to communicate with Apple's web services.
+
+## How is my password stored?
+`sigh` uses the [CredentialsManager](https://github.com/fastlane/fastlane/tree/master/credentials_manager) from `fastlane`.
+
+# 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
+- [`gym`](https://github.com/fastlane/fastlane/tree/master/gym): Building your iOS apps has never been easier
+- [`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).
+
+It will show you the `mobileprovision` files like this:
+![assets/QuickLookScreenshot.png](assets/QuickLookScreenshot.png)
+
+## App Identifier couldn't be found
+
+If you also want to create a new App Identifier on the Apple Developer Portal, check out [produce](https://github.com/fastlane/fastlane/tree/master/produce), which does exactly that.
+
+## What happens to my Xcode managed profiles?
+
+`sigh` will never touch or use the profiles which are created and managed by Xcode. Instead `sigh` will manage its own set of provisioning profiles.
+
+# Need help?
+Please submit an issue on GitHub and provide information about your setup
+
+# Code of Conduct
+Help us keep `sigh` 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.