fastlane 1.111.0 → 2.0.1

data/snapshot/lib/snapshot/screenshot_rotate.rb

@@ -0,0 +1,38 @@
+require 'shellwords'
+
+module Snapshot
+  # This class takes care of rotating images
+  class ScreenshotRotate
+    # @param (String) The path in which the screenshots are located in
+    def run(path)
+      UI.verbose "Rotating the screenshots (if necessary)"
+      rotate(path)
+    end
+
+    def rotate(path)
+      Dir.glob([path, '/**/*.png'].join('/')).each do |file|
+        UI.verbose "Rotating '#{file}'"
+
+        command = nil
+        if file.end_with? "landscapeleft.png"
+          command = "sips -r -90 '#{file}'"
+        elsif file.end_with? "landscaperight.png"
+          command = "sips -r 90 '#{file}'"
+        elsif file.end_with? "portrait_upsidedown.png"
+          command = "sips -r 180 '#{file}'"
+        end
+
+        next unless command
+
+        # Only rotate if we need to
+        PTY.spawn(command) do |r, w, pid|
+          r.sync
+          r.each do |line|
+            # We need to read this otherwise things hang
+          end
+          ::Process.wait pid
+        end
+      end
+    end
+  end
+end

data/snapshot/lib/snapshot/setup.rb

@@ -0,0 +1,35 @@
+module Snapshot
+  class Setup
+    # This method will take care of creating a Snapfile and other necessary files
+    def self.create(path)
+      snapfile_path = File.join(path, 'Snapfile')
+
+      if File.exist?(snapfile_path)
+        UI.user_error!("Snapfile already exists at path '#{snapfile_path}'. Run 'snapshot' to use snapshot.")
+      end
+
+      File.write(snapfile_path, File.read("#{Snapshot::ROOT}/lib/assets/SnapfileTemplate"))
+      File.write(File.join(path, 'SnapshotHelper.swift'), File.read("#{Snapshot::ROOT}/lib/assets/SnapshotHelper.swift"))
+      File.write(File.join(path, 'SnapshotHelper2-3.swift'), File.read("#{Snapshot::ROOT}/lib/assets/SnapshotHelper2-3.swift"))
+
+      puts "✅  Successfully created SnapshotHelper.swift '#{File.join(path, 'SnapshotHelper.swift')}'".green
+      puts "✅  Successfully created SnapshotHelper2-3.swift '#{File.join(path, 'SnapshotHelper2-3.swift')} (if your UI tests are written in Swift 2.3)'".green
+      puts "✅  Successfully created new Snapfile at '#{snapfile_path}'".green
+
+      puts "-------------------------------------------------------".yellow
+      puts "Open your Xcode project and make sure to do the following:".yellow
+      puts "1) Add a new UI Test target to your project".yellow
+      puts "2) Add the ./fastlane/SnapshotHelper.swift to your UI Test target".yellow
+      puts "   You can move the file anywhere you want".yellow
+      puts "3) Call `setupSnapshot(app)` when launching your app".yellow
+      puts ""
+      puts "  let app = XCUIApplication()"
+      puts "  setupSnapshot(app)"
+      puts "  app.launch()"
+      puts ""
+      puts "4) Add `snapshot(\"0Launch\")` to wherever you want to create the screenshots".yellow
+      puts ""
+      puts "More information on GitHub: https://github.com/fastlane/fastlane/tree/master/snapshot".green
+    end
+  end
+end

data/snapshot/lib/snapshot/test_command_generator.rb

@@ -0,0 +1,118 @@
+module Snapshot
+  # Responsible for building the fully working xcodebuild command
+  class TestCommandGenerator
+    class << self
+      def generate(device_type: nil)
+        parts = prefix
+        parts << "xcodebuild"
+        parts += options
+        parts += destination(device_type)
+        parts += build_settings
+        parts += actions
+        parts += suffix
+        parts += pipe
+
+        parts
+      end
+
+      def prefix
+        ["set -o pipefail &&"]
+      end
+
+      # Path to the project or workspace as parameter
+      # This will also include the scheme (if given)
+      # @return [Array] The array with all the components to join
+      def project_path_array
+        proj = Snapshot.project.xcodebuild_parameters
+        return proj if proj.count > 0
+        UI.user_error!("No project/workspace found")
+      end
+
+      def options
+        config = Snapshot.config
+
+        options = []
+        options += project_path_array
+        options << "-sdk '#{config[:sdk]}'" if config[:sdk]
+        options << "-derivedDataPath '#{derived_data_path}'"
+
+        options
+      end
+
+      def build_settings
+        build_settings = []
+        build_settings << "FASTLANE_SNAPSHOT=YES"
+
+        build_settings
+      end
+
+      def actions
+        actions = []
+        actions << :clean if Snapshot.config[:clean]
+        actions << :build # https://github.com/fastlane/snapshot/issues/246
+        actions << :test
+
+        actions
+      end
+
+      def suffix
+        []
+      end
+
+      def pipe
+        ["| tee #{xcodebuild_log_path.shellescape} | xcpretty #{Snapshot.config[:xcpretty_args]}"]
+      end
+
+      def find_device(device_name, os_version = Snapshot.config[:ios_version])
+        # We might get this error message
+        # > The requested device could not be found because multiple devices matched the request.
+        #
+        # This happens when you have multiple simulators for a given device type / iOS combination
+        #   { platform:iOS Simulator, id:1685B071-AFB2-4DC1-BE29-8370BA4A6EBD, OS:9.0, name:iPhone 5 }
+        #   { platform:iOS Simulator, id:A141F23B-96B3-491A-8949-813B376C28A7, OS:9.0, name:iPhone 5 }
+        #
+        simulators = FastlaneCore::DeviceManager.simulators
+        # Sort devices with matching names by OS version, largest first, so that we can
+        # pick the device with the newest OS in case an exact OS match is not available
+        name_matches = simulators.find_all { |sim| sim.name.strip == device_name.strip }
+                                 .sort_by { |sim| Gem::Version.new(sim.os_version) }
+                                 .reverse
+        name_matches.find { |sim| sim.os_version == os_version } || name_matches.first
+      end
+
+      def device_udid(device_name, os_version = Snapshot.config[:ios_version])
+        device = find_device(device_name, os_version)
+
+        device ? device.udid : nil
+      end
+
+      def destination(device_name)
+        os = device_name =~ /^Apple TV/ ? "tvOS" : "iOS"
+        os_version = Snapshot.config[:ios_version] || Snapshot::LatestOsVersion.version(os)
+
+        device = find_device(device_name, os_version)
+        if device.nil?
+          UI.user_error!("No device found named '#{device_name}' for version '#{os_version}'")
+          return
+        elsif device.os_version != os_version
+          UI.important("Using device named '#{device_name}' with version '#{device.os_version}' because no match was found for version '#{os_version}'")
+        end
+        value = "platform=#{os} Simulator,id=#{device.udid},OS=#{os_version}"
+
+        return ["-destination '#{value}'"]
+      end
+
+      def xcodebuild_log_path
+        file_name = "#{Snapshot.project.app_name}-#{Snapshot.config[:scheme]}.log"
+        containing = File.expand_path(Snapshot.config[:buildlog_path])
+        FileUtils.mkdir_p(containing)
+
+        return File.join(containing, file_name)
+      end
+
+      def derived_data_path
+        Snapshot.cache[:derived_data_path] ||= (Snapshot.config[:derived_data_path] || Dir.mktmpdir("snapshot_derived"))
+      end
+    end
+  end
+end

data/snapshot/lib/snapshot/update.rb

@@ -0,0 +1,29 @@
+module Snapshot
+  # Migrate helper files
+  class Update
+    # @return [Array] A list of helper files (usually just one)
+    def self.find_helper
+      Dir["./**/SnapshotHelper.swift"]
+    end
+
+    def update
+      paths = self.class.find_helper
+
+      UI.message "Found the following SnapshotHelper:"
+      paths.each { |p| UI.message "\t#{p}" }
+      UI.important "Are you sure you want to automatically update the helpers listed above?"
+      UI.message "This will overwrite all its content with the latest code."
+      UI.message "The underlying API will not change. You can always migrate manually by looking at"
+      UI.message "https://github.com/fastlane/fastlane/blob/master/snapshot/lib/assets/SnapshotHelper.swift"
+
+      return 1 unless UI.confirm("Overwrite configuration files?")
+
+      paths.each do |path|
+        UI.message "Updating '#{path}'..."
+        File.write(path, File.read("#{Snapshot::ROOT}/lib/assets/SnapshotHelper.swift"))
+      end
+
+      UI.success "Successfully updated helper files"
+    end
+  end
+end

data/spaceship/README.md

@@ -0,0 +1,191 @@
+<h3 align="center">
+  <a href="https://github.com/fastlane/fastlane/tree/master/fastlane">
+    <img src="../fastlane/assets/fastlane.png" width="100" />
+    <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;
+  <b>spaceship</b> &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/spaceship.png" width="470">
+</p>
+-------
+
+[![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/spaceship/LICENSE)
+[![Gem](https://img.shields.io/gem/v/spaceship.svg?style=flat)](http://rubygems.org/gems/spaceship)
+
+`spaceship` exposes both the Apple Developer Center and the iTunes Connect API. This fast and powerful API powers parts of fastlane, and can be leveraged for more advanced fastlane features. Scripting your Developer Center workflow has never been easier!
+
+Get in contact with the creators on Twitter: [@FastlaneTools](https://twitter.com/fastlanetools)
+
+-------
+<p align="center">
+    <a href="#whats-spaceship">Why?</a> &bull;
+    <a href="#usage">Usage</a> &bull;
+    <a href="#installation">Installation</a> &bull;
+    <a href="#technical-details">Technical Details</a> &bull;
+    <a href="#need-help">Need help?</a>
+</p>
+
+-------
+
+<h5 align="center"><code>spaceship</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 spaceship?
+
+Up until now, the [fastlane tools](https://fastlane.tools) used web scraping to interact with Apple's web services. With spaceship it is possible to directly access the underlying APIs using a simple HTTP client only.
+
+Using spaceship, the execution time of [sigh](https://github.com/fastlane/fastlane/tree/master/sigh) was reduced from over 1 minute to less than 5 seconds.
+
+spaceship uses a combination of 3 different API endpoints, used by the Apple Developer Portal and Xcode. As no API offers everything we need, spaceship combines all APIs for you. [More details about the APIs](#technical-details).
+
+More details about why spaceship is useful on [spaceship.airforce](https://spaceship.airforce).
+
+> No matter how many apps or certificates you have, spaceship **can** handle your scale.
+
+Enough words, here is some code:
+
+```ruby
+Spaceship.login
+
+# Create a new app
+app = Spaceship.app.create!(bundle_id: "com.krausefx.app", name: "Spaceship App")
+
+# Use an existing certificate
+cert = Spaceship.certificate.production.all.first
+
+# Create a new provisioning profile
+profile = Spaceship.provisioning_profile.app_store.create!(bundle_id: app.bundle_id,
+                                                         certificate: cert)
+
+# Print the name and download the new profile
+puts "Created Profile " + profile.name
+profile.download
+```
+
+## Speed
+
+How fast are tools using `spaceship` compared to web scraping?
+
+![assets/SpaceshipRecording.gif](assets/SpaceshipRecording.gif)
+
+# Installation
+
+    sudo gem install fastlane
+
+# Usage
+
+## Playground
+
+To try `spaceship`, just run `fastlane spaceship`. It will automatically start the `spaceship playground`. It makes it super easy to try `spaceship` :rocket:
+
+![assets/docs/Playground.png](assets/docs/Playground.png)
+
+This requires you to install `pry` using `sudo gem install pry`. `pry` is not installed by default, as most [fastlane](https://fastlane.tools) users won't need the `spaceship playground`. You can add the `pry` dependency to your `Gemfile`.
+
+## Apple Developer Portal API
+
+##### Open [DeveloperPortal.md](docs/DeveloperPortal.md) for code samples
+
+## iTunes Connect API
+
+##### Open [iTunesConnect.md](docs/iTunesConnect.md) for code samples
+
+## 2 Step Verification
+
+When your Apple account has 2 factor verification enabled, you'll automatically be asked to verify your identity using your phone. The resulting session will be stored in `~/.spaceship/[email]/cookie`. The session should be valid for about one month, however there is no way to test this without actually waiting for over a month.
+
+Since your CI system probably doesn't allow you to input values (like the verification code), you can use `spaceauth`:
+
+```sh
+spaceauth -u apple@krausefx.com
+```
+
+This will authenticate you and provide a string that can be transferred to your CI system:
+
+```
+export FASTLANE_SESSION='---\n- !ruby/object:HTTP::Cookie\n  name: DES5c148586dfd451e55afbaaa5f62418f91\n  value: HSARMTKNSRVTWFla1+yO4gVPowH17VaaaxPFnUdMUegQZxqy1Ie1c2v6bM1vSOzIbuOmrl/FNenlScsd/NbF7/Lw4cpnL15jsyg0TOJwP32tC/NguPiyOaaaU+jrj4tf4uKdIywVaaaFSRVT\n  domain: idmsa.apple.com\n  for_domain: true\n  path: "/"\n  secure: true\n  httponly: true\n  expires: 2016-04-27 23:55:56.000000000 Z\n  max_age: \n  created_at: 2016-03-28 16:55:57.032086000 -07:00\n  accessed_at: 2016-03-28 19:11:17.828141000 -07:00\n'
+```
+
+Copy everything from `---\n` to your CI server and provide it as environment variable named `FASTLANE_SESSION`.
+
+### _spaceship_ in use
+
+All [fastlane tools](https://fastlane.tools) that communicate with Apple's web services in some way, use _spaceship_ to do so.
+
+# Technical Details
+
+## HTTP Client
+
+Up until now all [fastlane tools](https://fastlane.tools) used web scraping to interact with Apple's web services. `spaceship` uses a simple HTTP client only, resulting in much less overhead and extremely improved speed.
+
+Advantages of `spaceship` (HTTP client) over web scraping:
+
+- Blazing fast :rocket: 90% faster than previous methods
+- No more overhead by loading images, HTML, JS and CSS files on each page load
+- Great test coverage by stubbing server responses
+- Resistant against design changes of the Apple Developer Portal
+- Automatic re-trying of requests in case a timeout occurs
+
+## API Endpoints
+
+Overview of the used API endpoints
+
+- `https://idmsa.apple.com`: Used to authenticate to get a valid session
+- `https://developerservices2.apple.com`:
+ - Get a list of all available provisioning profiles
+ - Register new devices
+- `https://developer.apple.com`:
+ - List all devices, certificates, apps and app groups
+ - Create new certificates, provisioning profiles and apps
+ - Disable/enable services on apps and assign them to app groups
+ - Delete certificates and apps
+ - Repair provisioning profiles
+ - Download provisioning profiles
+ - Team selection
+- `https://itunesconnect.apple.com`:
+ - Managing apps
+ - Managing beta testers
+ - Submitting updates to review
+ - Managing app metadata
+- `https://du-itc.itunesconnect.apple.com`:
+ - Upload icons, screenshots, trailers ...
+
+`spaceship` uses all those API points to offer this seamless experience.
+
+## Magic involved
+
+`spaceship` does a lot of magic to get everything working so neatly:
+
+- **Sensible Defaults**: You only have to provide the mandatory information (e.g. new provisioning profiles contain all devices by default)
+- **Local Validation**: When pushing changes back to the Apple Dev Portal `spaceship` will make sure only valid data is sent to Apple (e.g. automatic repairing of provisioning profiles)
+- **Various request/response types**: When working with the different API endpoints, `spaceship` has to deal with `JSON`, `XML`, `txt`, `plist` and sometimes even `HTML` responses and requests.
+- **Automatic Pagination**: Even if you have thousands of apps, profiles or certificates, `spaceship` **can** handle your scale. It was heavily tested by first using `spaceship` to create hundreds of profiles and then accessing them using `spaceship`.
+- **Session, Cookie and CSRF token**: All the security aspects are handled by `spaceship`.
+- **Profile Magic**: Create and upload code signing requests, all managed by `spaceship`
+- **Multiple Spaceship**: You can launch multiple `spaceships` with different Apple accounts to do things like syncing the registered devices.
+
+# Code of Conduct
+Help us keep `fastlane` 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.

data/spaceship/lib/assets/languageMapping.json

@@ -0,0 +1,240 @@
+[
+    {
+        "locale": "cmn-Hans",
+        "name": "Simplified Chinese",
+        "game-center": true,
+        "itc_locale": "zh-Hans"        
+    },
+    {
+        "locale": "cmn-Hant",
+        "name": "Traditional Chinese",
+        "game-center": true,
+        "itc_locale": "zh-Hant"
+    },
+    {
+        "locale": "da-DK",
+        "name": "Danish",
+        "game-center": true,
+        "alternatives": [
+            "da"
+        ],
+        "itc_locale": "da"
+    },
+    {
+        "locale": "nl-NL",
+        "name": "Dutch",
+        "game-center": true,
+        "alternatives": [
+            "nl"
+        ]
+    },
+    {
+        "locale": "en-AU",
+        "name": "Australian English",
+        "game-center": false
+    },
+    {
+        "locale": "en-AU",
+        "name": "English_Australian",
+        "game-center": false
+    },
+    {
+        "locale": "en-CA",
+        "name": "Canadian English",
+        "game-center": false
+    },
+    {
+        "locale": "en-CA",
+        "name": "English_CA",
+        "game-center": false
+    },
+    {
+        "locale": "en-GB",
+        "name": "UK English",
+        "game-center": true
+    },
+    {
+        "locale": "en-GB",
+        "name": "English_UK",
+        "game-center": true
+    },
+    {
+        "locale": "en-US",
+        "name": "English",
+        "game-center": true
+    },
+    {
+        "locale": "fi-FI",
+        "name": "Finnish",
+        "game-center": true,
+        "alternatives": [
+            "fi"
+        ],
+        "itc_locale": "fin"
+    },
+    {
+        "locale": "fr-CA",
+        "name": "Canadian French",
+        "game-center": false
+    },
+    {
+        "locale": "fr-CA",
+        "name": "French_CA",
+        "game-center": false
+    },
+    {
+        "locale": "fr-FR",
+        "name": "French",
+        "game-center": true,
+        "alternatives": [
+            "fr"
+        ]
+    },
+    {
+        "locale": "de-DE",
+        "name": "German",
+        "game-center": true,
+        "alternatives": [
+            "de"
+        ]
+    },
+    {
+        "locale": "el-GR",
+        "name": "Greek",
+        "game-center": true,
+        "alternatives": [
+            "el"
+        ],
+        "itc_locale": "el"
+    },
+    {
+        "locale": "id-ID",
+        "name": "Indonesian",
+        "game-center": true,
+        "alternatives": [
+            "id"
+        ],
+        "itc_locale": "id"
+    },
+    {
+        "locale": "it-IT",
+        "name": "Italian",
+        "game-center": true,
+        "alternatives": [
+            "it"
+        ],
+        "itc_locale": "it"
+    },
+    {
+        "locale": "ja-JP",
+        "name": "Japanese",
+        "game-center": true,
+        "alternatives": [
+            "ja"
+        ],
+        "itc_locale": "ja"
+    },
+    {
+        "locale": "ko-KR",
+        "name": "Korean",
+        "game-center": true,
+        "alternatives": [
+            "ko"
+        ],
+        "itc_locale": "ko"
+    },
+    {
+        "locale": "ms-MY",
+        "name": "Malay",
+        "game-center": true,
+        "alternatives": [
+            "ms"
+        ],
+        "itc_locale": "ms"
+    },
+    {
+        "locale": "no-NO",
+        "name": "Norwegian",
+        "game-center": true,
+        "alternatives": [
+            "no"
+        ],
+        "itc_locale": "no"
+    },
+    {
+        "locale": "pt-BR",
+        "name": "Brazilian Portuguese",
+        "game-center": true
+    },
+    {
+        "locale": "pt-PT",
+        "name": "Portuguese",
+        "game-center": true,
+        "alternatives": [
+            "pt"
+        ]
+    },
+    {
+        "locale": "ru-RU",
+        "name": "Russian",
+        "game-center": true,
+        "alternatives": [
+            "ru"
+        ],
+        "itc_locale": "ru"
+    },
+    {
+        "locale": "es-MX",
+        "name": "Mexican Spanish",
+        "game-center": false
+    },
+    {
+        "locale": "es-MX",
+        "name": "Spanish_MX",
+        "game-center": false
+    },
+    {
+        "locale": "es-ES",
+        "name": "Spanish",
+        "game-center": true,
+        "alternatives": [
+            "es"
+        ]
+    },
+    {
+        "locale": "sv-SE",
+        "name": "Swedish",
+        "game-center": true,
+        "alternatives": [
+            "sv"
+        ],
+        "itc_locale": "sv"
+    },
+    {
+        "locale": "th-TH",
+        "name": "Thai",
+        "game-center": true,
+        "alternatives": [
+            "th"
+        ],
+        "itc_locale": "th"
+    },
+    {
+        "locale": "tr-TR",
+        "name": "Turkish",
+        "game-center": true,
+        "alternatives": [
+            "tr"
+        ],
+        "itc_locale": "tr"
+    },
+    {
+        "locale": "vi-VI",
+        "name": "Vietnamese",
+        "game-center": true,
+        "alternatives": [
+            "vi"
+        ],
+        "itc_locale": "vi"
+    }
+]