fastlane 2.98.0 → 2.99.0

data/spaceship/lib/spaceship/du/du_client.rb

@@ -96,7 +96,7 @@ module Spaceship
       parse_upload_response(r)
     end
 
-    # You can find this by uploading an image in iTunes connect
+    # You can find this by uploading an image in App Store Connect
     # then look for the X-Apple-Upload-Validation-RuleSets value
     def picture_type_map
       # rubocop:enable Layout/ExtraSpacing

data/spaceship/lib/spaceship/errors.rb

@@ -68,6 +68,6 @@ module Spaceship
   # Raised when 401 is received from portal request
   class UnauthorizedAccessError < BasicPreferredInfoError; end
 
-  # Raised when 500 is received from iTunes Connect
+  # Raised when 500 is received from App Store Connect
   class InternalServerError < BasicPreferredInfoError; end
 end

data/spaceship/lib/spaceship/module.rb

@@ -1,4 +1,4 @@
 module Spaceship
   ROOT = Pathname.new(File.expand_path('../../..', __FILE__))
-  DESCRIPTION = "Ruby library to access the Apple Dev Center and iTunes Connect".freeze
+  DESCRIPTION = "Ruby library to access the Apple Dev Center and App Store Connect".freeze
 end

data/spaceship/lib/spaceship/playground.rb

@@ -33,12 +33,12 @@ module Spaceship
 
     def run
       begin
-        puts("Logging into to iTunes Connect (#{@username})...")
+        puts("Logging into to App Store Connect (#{@username})...")
         Spaceship::Tunes.login(@username)
-        puts("Successfully logged in to iTunes Connect".green)
+        puts("Successfully logged in to App Store Connect".green)
         puts("")
       rescue
-        puts("Could not login to iTunes Connect...".red)
+        puts("Could not login to App Store Connect...".red)
       end
       begin
         puts("Logging into the Developer Portal (#{@username})...")

data/spaceship/lib/spaceship/portal/portal_client.rb

@@ -28,8 +28,8 @@ module Spaceship
       return response if self.cookie.include?("myacinfo")
 
       # When the user has 2 step enabled, we might have to call this method again
-      # This only occurs when the user doesn't have a team on iTunes Connect
-      # For 2 step verification we use the iTunes Connect back-end
+      # This only occurs when the user doesn't have a team on App Store Connect
+      # For 2 step verification we use the App Store Connect back-end
       # which is enough to get the DES... cookie, however we don't get a valid
       # myacinfo cookie at that point. That means, after getting the DES... cookie
       # we have to send the login request again. This will then get us a valid myacinfo

data/spaceship/lib/spaceship/spaceauth_runner.rb

@@ -14,17 +14,17 @@ module Spaceship
 
     def run
       begin
-        puts("Logging into to iTunes Connect (#{@username})...")
+        puts("Logging into to App Store Connect (#{@username})...")
         Spaceship::Tunes.login(@username)
-        puts("Successfully logged in to iTunes Connect".green)
+        puts("Successfully logged in to App Store Connect".green)
         puts("")
       rescue
-        puts("Could not login to iTunes Connect".red)
+        puts("Could not login to App Store Connect".red)
         puts("Please check your credentials and try again.".yellow)
-        puts("This could be an issue with iTunes Connect,".yellow)
+        puts("This could be an issue with App Store Connect,".yellow)
         puts("Please try unsetting the FASTLANE_SESSION environment variable".yellow)
         puts("and re-run `fastlane spaceauth`".yellow)
-        raise "Problem connecting to iTunes Connect"
+        raise "Problem connecting to App Store Connect"
       end
 
       itc_cookie_content = Spaceship::Tunes.client.store_cookie

data/spaceship/lib/spaceship/test_flight/client.rb

@@ -164,6 +164,17 @@ module Spaceship
         testers
       end
 
+      #####################################################
+      # @!Internal Testers
+      #####################################################
+      def internal_users(app_id: nil)
+        assert_required_params(__method__, binding)
+        url = "providers/#{team_id}/apps/#{app_id}/internalUsers"
+        r = request(:get, url)
+
+        parse_response(r, 'data')
+      end
+
       ##
       # @!group Testers API
       ##
@@ -317,7 +328,7 @@ module Spaceship
 
         raise UnexpectedResponse, response.body['error'] if response.body['error']
 
-        raise UnexpectedResponse, "Temporary iTunes Connect error: #{response.body}" if response.body['statusCode'] == 'ERROR'
+        raise UnexpectedResponse, "Temporary App Store Connect error: #{response.body}" if response.body['statusCode'] == 'ERROR'
 
         return response.body['data'] if response.body['data']
 

data/spaceship/lib/spaceship/test_flight/group.rb

@@ -65,7 +65,7 @@ module Spaceship::TestFlight
     # It's ok if the tester already exists, we just have to do this... don't ask
     # This will enable testing for the tester for a given app, as just creating the tester on an account-level
     # is not enough to add the tester to a group. If this isn't done the next request would fail.
-    # This is a bug we reported to the iTunes Connect team, as it also happens on the iTunes Connect UI on 18. April 2017
+    # This is a bug we reported to the App Store Connect team, as it also happens on the App Store Connect UI on 18. April 2017
     def add_tester!(tester)
       # This post request creates an account-level tester and then makes it available to the app, or just makes
       # it available to the app if it already exists

data/spaceship/lib/spaceship/test_flight/tester.rb

@@ -3,7 +3,7 @@ require_relative 'base'
 module Spaceship
   module TestFlight
     class Tester < Base
-      # @return (String) The identifier of this tester, provided by iTunes Connect
+      # @return (String) The identifier of this tester, provided by App Store Connect
       # @example
       #   "60f858b4-60a8-428a-963a-f943a3d68d17"
       attr_accessor :tester_id

data/spaceship/lib/spaceship/tunes/app_analytics.rb

@@ -0,0 +1,143 @@
+require_relative 'tunes_base'
+
+module Spaceship
+  module Tunes
+    class AppAnalytics < TunesBase
+      # @return (Integer) The app ID to grab analytics for
+      attr_accessor :apple_id
+
+      class << self
+        def factory(attrs)
+          return self.new(attrs)
+        end
+      end
+
+      def app_units
+        start_t, end_t = time_last_7_days
+
+        app_units_interval(start_t, end_t)
+      end
+
+      def app_views
+        start_t, end_t = time_last_7_days
+
+        app_views_interval(start_t, end_t)
+      end
+
+      def app_in_app_purchases
+        start_t, end_t = time_last_7_days
+
+        app_in_app_purchases_interval(start_t, end_t)
+      end
+
+      def app_sales
+        start_t, end_t = time_last_7_days
+
+        app_sales_interval(start_t, end_t)
+      end
+
+      def app_paying_users
+        start_t, end_t = time_last_7_days
+
+        app_paying_users_interval(start_t, end_t)
+      end
+
+      def app_installs
+        start_t, end_t = time_last_7_days
+
+        app_installs_interval(start_t, end_t)
+      end
+
+      def app_sessions
+        start_t, end_t = time_last_7_days
+
+        app_sessions_interval(start_t, end_t)
+      end
+
+      def app_active_devices
+        start_t, end_t = time_last_7_days
+
+        app_active_devices_interval(start_t, end_t)
+      end
+
+      def app_active_last_30_days
+        start_t, end_t = time_last_7_days
+
+        app_active_last_30_days_interval(start_t, end_t)
+      end
+
+      def app_crashes
+        start_t, end_t = time_last_7_days
+
+        app_crashes_interval(start_t, end_t)
+      end
+
+      def app_units_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['units'], start_t, end_t, "DAY")
+      end
+
+      def app_views_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['pageViewCount'], start_t, end_t, "DAY")
+      end
+
+      def app_in_app_purchases_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['iap'], start_t, end_t, "DAY")
+      end
+
+      def app_sales_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['sales'], start_t, end_t, "DAY")
+      end
+
+      def app_paying_users_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['payingUsers'], start_t, end_t, "DAY")
+      end
+
+      def app_installs_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['installs'], start_t, end_t, "DAY")
+      end
+
+      def app_sessions_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['sessions'], start_t, end_t, "DAY")
+      end
+
+      def app_active_devices_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['activeDevices'], start_t, end_t, "DAY")
+      end
+
+      def app_active_last_30_days_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['rollingActiveDevices'], start_t, end_t, "DAY")
+      end
+
+      def app_crashes_interval(start_t, end_t)
+        client.time_series_analytics([apple_id], ['crashes'], start_t, end_t, "DAY")
+      end
+
+      def time_last_7_days
+        time = Time.now
+        past = time - (60 * 60 * 24 * 7)
+        end_t   = time.strftime("%Y-%m-%dT00:00:00Z")
+        start_t = past.strftime("%Y-%m-%dT00:00:00Z")
+
+        return start_t, end_t
+      end
+
+      def time_last_30_days
+        time = Time.now
+        past = time - (60 * 60 * 24 * 30)
+        end_t   = time.strftime("%Y-%m-%dT00:00:00Z")
+        start_t = past.strftime("%Y-%m-%dT00:00:00Z")
+
+        return start_t, end_t
+      end
+
+      def time_last_90_days
+        time = Time.now
+        past = time - (60 * 60 * 24 * 90)
+        end_t   = time.strftime("%Y-%m-%dT00:00:00Z")
+        start_t = past.strftime("%Y-%m-%dT00:00:00Z")
+
+        return start_t, end_t
+      end
+    end
+  end
+end

data/spaceship/lib/spaceship/tunes/app_details.rb

@@ -78,7 +78,7 @@ module Spaceship
         end
       end
 
-      # Push all changes that were made back to iTunes Connect
+      # Push all changes that were made back to App Store Connect
       def save!
         client.update_app_details!(application.apple_id, raw_data)
       rescue Spaceship::Tunes::Error => ex

data/spaceship/lib/spaceship/tunes/app_image.rb

@@ -2,7 +2,7 @@ require_relative 'tunes_base'
 
 module Spaceship
   module Tunes
-    # Represents an image hosted on iTunes Connect. Used for icons, screenshots, etc
+    # Represents an image hosted on App Store Connect. Used for icons, screenshots, etc
     class AppImage < TunesBase
       HOST_URL = "https://is1-ssl.mzstatic.com/image/thumb"
 

data/spaceship/lib/spaceship/tunes/app_screenshot.rb

@@ -2,7 +2,7 @@ require_relative 'app_image'
 
 module Spaceship
   module Tunes
-    # Represents a screenshot hosted on iTunes Connect
+    # Represents a screenshot hosted on App Store Connect
     class AppScreenshot < Spaceship::Tunes::AppImage
       attr_accessor :device_type
 

data/spaceship/lib/spaceship/tunes/app_status.rb

@@ -25,7 +25,7 @@ module Spaceship
       # Developer rejected this version/binary
       DEVELOPER_REJECTED = "Developer Rejected"
 
-      # You have to renew your Apple account to keep using iTunes Connect
+      # You have to renew your Apple account to keep using App Store Connect
       PENDING_CONTRACT = "Pending Contract"
 
       UPLOAD_RECEIVED = "Upload Received"
@@ -36,7 +36,7 @@ module Spaceship
       REMOVED_FROM_SALE = "Removed From Sale"
       # INVALID_BINARY = "Invalid Binary"
 
-      # Get the app status matching based on a string (given by iTunes Connect)
+      # Get the app status matching based on a string (given by App Store Connect)
       def self.get_from_string(text)
         mapping = {
           'readyForSale' => READY_FOR_SALE,

data/spaceship/lib/spaceship/tunes/app_submission.rb

@@ -2,7 +2,7 @@ require_relative 'tunes_base'
 
 module Spaceship
   module Tunes
-    # Represents a submission for review of an iTunes Connect Application
+    # Represents a submission for review of an App Store Connect Application
     # This class handles the submission of all review information and documents
     class AppSubmission < TunesBase
       # @return (Spaceship::Tunes::Application) A reference to the application

data/spaceship/lib/spaceship/tunes/app_trailer.rb

@@ -2,7 +2,7 @@ require_relative 'tunes_base'
 
 module Spaceship
   module Tunes
-    # Represents a preview video hosted on iTunes Connect. Used for icons, screenshots, etc
+    # Represents a preview video hosted on App Store Connect. Used for icons, screenshots, etc
     class AppTrailer < TunesBase
       attr_accessor :video_asset_token
 

data/spaceship/lib/spaceship/tunes/app_version.rb

@@ -11,7 +11,7 @@ require_relative 'app_status'
 
 module Spaceship
   module Tunes
-    # Represents an editable version of an iTunes Connect Application
+    # Represents an editable version of an App Store Connect Application
     # This can either be the live or the edit version retrieved via the app
     # rubocop:disable Metrics/ClassLength
     class AppVersion < TunesBase
@@ -76,7 +76,7 @@ module Spaceship
       # @return (Spaceship::Tunes::AppImage) the structure containing information about the large watch icon (1024x1024)
       attr_accessor :watch_app_icon
 
-      # @return (Integer) a unqiue ID for this version generated by iTunes Connect
+      # @return (Integer) a unqiue ID for this version generated by App Store Connect
       attr_accessor :version_id
 
       ####
@@ -398,7 +398,7 @@ module Spaceship
         true
       end
 
-      # Push all changes that were made back to iTunes Connect
+      # Push all changes that were made back to App Store Connect
       def save!
         client.update_app_version!(application.apple_id, self.version_id, raw_data)
       end
@@ -423,7 +423,7 @@ module Spaceship
       end
 
       # This method will generate the required keys/values
-      # for iTunes Connect to validate the uploaded image
+      # for App Store Connect to validate the uploaded image
       def generate_image_metadata(image_data, original_file_name)
         {
           assetToken: image_data["token"],
@@ -497,7 +497,7 @@ module Spaceship
           screenshot_data = client.upload_screenshot(self, upload_file, device, is_messages)
 
           # Since October 2016 we also need to pass the size, height, width and checksum
-          # otherwise iTunes Connect validation will fail at a later point
+          # otherwise App Store Connect validation will fail at a later point
           new_screenshot = {
             "value" => {
               "assetToken" => screenshot_data["token"],
@@ -697,7 +697,7 @@ module Spaceship
         raise "Unexpected state: missing device details for #{device}" unless device_details.key?(data_field)
         return device_details[data_field]
       rescue => ex
-        raise "iTunes Connect error: #{ex}"
+        raise "App Store Connect error: #{ex}"
       end
 
       def setup_screenshots

data/spaceship/lib/spaceship/tunes/app_version_history.rb

@@ -2,7 +2,7 @@ require_relative 'app_version_states_history'
 
 module Spaceship
   module Tunes
-    # Represents a read only version of an iTunes Connect Versions State History
+    # Represents a read only version of an App Store Connect Versions State History
     class AppVersionHistory < TunesBase
       # @return (Spaceship::Tunes::Application) A reference to the application
       #   this version is for

data/spaceship/lib/spaceship/tunes/app_version_states_history.rb

@@ -2,7 +2,7 @@ require_relative 'tunes_base'
 
 module Spaceship
   module Tunes
-    # Represents a read only version of an iTunes Connect Versions State History
+    # Represents a read only version of an App Store Connect Versions State History
     class AppVersionStatesHistory < TunesBase
       # @return (String) the state
       attr_reader :state_key

data/spaceship/lib/spaceship/tunes/application.rb

@@ -1,5 +1,6 @@
 require_relative '../test_flight/group'
 require_relative '../test_flight/build'
+require_relative 'app_analytics'
 require_relative 'app_details'
 require_relative 'app_ratings'
 require_relative 'app_submission'
@@ -14,7 +15,7 @@ require_relative 'version_set'
 module Spaceship
   module Tunes
     class Application < TunesBase
-      # @return (String) The App identifier of this app, provided by iTunes Connect
+      # @return (String) The App identifier of this app, provided by App Store Connect
       # @example
       #   "1013943394"
       attr_accessor :apple_id
@@ -24,7 +25,7 @@ module Spaceship
       #   "Spaceship App"
       attr_accessor :name
 
-      # @return (String) The Vendor ID provided by iTunes Connect
+      # @return (String) The Vendor ID provided by App Store Connect
       # @example
       #   "1435592086"
       attr_accessor :vendor_id
@@ -37,7 +38,7 @@ module Spaceship
       # @return (String) Last modified
       attr_accessor :last_modified
 
-      # @return (Integer) The number of issues provided by iTunes Connect
+      # @return (Integer) The number of issues provided by App Store Connect
       attr_accessor :issues_count
 
       # @return (String) The URL to a low resolution app icon of this app (340x340px). Might be nil
@@ -75,7 +76,7 @@ module Spaceship
           end
         end
 
-        # Creates a new application on iTunes Connect
+        # Creates a new application on App Store Connect
         # @param name (String): The name of your app as it will appear on the App Store.
         #   This can't be longer than 255 characters.
         # @param primary_language (String): If localized app information isn't available in an
@@ -136,6 +137,16 @@ module Spaceship
         "https://itunesconnect.apple.com/WebObjects/iTunesConnect.woa/ra/ng/app/#{self.apple_id}"
       end
 
+      def analytics
+        if self.live_version.nil?
+          raise 'Analytics are only available for live apps.'
+        end
+
+        attrs = {}
+        attrs[:apple_id] = self.apple_id
+        Spaceship::Tunes::AppAnalytics.factory(attrs)
+      end
+
       # @return (Hash) Contains the reason for rejection.
       #  if everything is alright, the result will be
       #  `{"sectionErrorKeys"=>[], "sectionInfoKeys"=>[], "sectionWarningKeys"=>[], "replyConstraints"=>{"minLength"=>1, "maxLength"=>4000}, "appNotes"=>{"threads"=>[]}, "betaNotes"=>{"threads"=>[]}, "appMessages"=>{"threads"=>[]}}`