fastlane 1.104.0 → 1.105.0

data/lib/fastlane/actions/update_info_plist.rb

@@ -64,6 +64,10 @@ module Fastlane
         'Update a Info.plist file with bundle identifier and display name'
       end
 
+      def self.details
+        "This action allows you to modify your `Info.plist` file before building. This may be useful if you want a separate build for alpha, beta or nightly builds, but don't want a separate target."
+      end
+
       def self.available_options
         [
 
@@ -106,6 +110,40 @@ module Fastlane
       def self.author
         'tobiasstrebitzer'
       end
+
+      def self.example_code
+        [
+          'update_info_plist( # update app identifier string
+            plist_path: "path/to/Info.plist",
+            app_identifier: "com.example.newappidentifier"
+          )',
+          'update_info_plist( # Change the Display Name of your app
+            plist_path: "path/to/Info.plist",
+            display_name: "MyApp-Beta"
+          )',
+          'update_info_plist( # Target a specific `xcodeproj` rather than finding the first available one
+            xcodeproj: "path/to/Example.proj",
+            plist_path: "path/to/Info.plist",
+            display_name: "MyApp-Beta"
+          )',
+          'update_info_plist( # Advanced processing: find URL scheme for particular key and replace value
+            xcodeproj: "path/to/Example.proj",
+            plist_path: "path/to/Info.plist",
+            block: lambda { |plist|
+              urlScheme = plist["CFBundleURLTypes"].find{|scheme| scheme["CFBundleURLName"] == "com.acme.default-url-handler"}
+              urlScheme[:CFBundleURLSchemes] = ["acme-production"]
+            }
+          )',
+          'zip(
+            path: "MyApp.app",
+            output_path: "Latest.app.zip"
+          )'
+        ]
+      end
+
+      def self.category
+        :project
+      end
     end
   end
 end

data/lib/fastlane/actions/update_project_code_signing.rb

@@ -7,7 +7,7 @@ module Fastlane
       def self.run(params)
         UI.message("You shouldn't use update_project_code_signing")
         UI.message("Have you considered using the recommended way to do code signing?")
-        UI.message("https://github.com/fastlane/fastlane/tree/master/fastlane/docs/Codesigning")
+        UI.message("https://docs.fastlane.tools/codesigning/getting-started/")
 
         path = params[:path]
         path = File.join(path, "project.pbxproj")
@@ -26,7 +26,7 @@ module Fastlane
       end
 
       def self.details
-        "This feature is not yet 100% finished"
+        "Don't use this actoin, check out https://docs.fastlane.tools/codesigning/getting-started/ for more details"
       end
 
       def self.available_options
@@ -51,6 +51,14 @@ module Fastlane
       def self.is_supported?(platform)
         platform == :ios
       end
+
+      def self.example_code
+        []
+      end
+
+      def self.category
+        :deprecated
+      end
     end
   end
 end

data/lib/fastlane/actions/update_project_provisioning.rb

@@ -8,7 +8,7 @@ module Fastlane
       ROOT_CERTIFICATE_URL = "http://www.apple.com/appleca/AppleIncRootCertificate.cer"
       def self.run(params)
         UI.message("You’re updating provisioning profiles directly in your project, but have you considered easier ways to do code signing?")
-        UI.message("https://github.com/fastlane/fastlane/tree/master/fastlane/docs/Codesigning")
+        UI.message("https://docs.fastlane.tools/codesigning/GettingStarted/")
 
         # assign folder from parameter or search for xcodeproj file
         folder = params[:xcodeproj] || Dir["*.xcodeproj"].first
@@ -78,6 +78,7 @@ module Fastlane
 
       def self.details
         [
+          "You should check out the code signing gide before using this action: https://github.com/fastlane/fastlane/tree/master/fastlane/docs/Codesigning",
           "This action retrieves a provisioning profile UUID from a provisioning profile (.mobileprovision) to set",
           "up the xcode projects' code signing settings in *.xcodeproj/project.pbxproj",
           "The `target_filter` value can be used to only update code signing for specified targets",
@@ -129,6 +130,21 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include? platform
       end
+
+      def self.example_code
+        [
+          'update_project_provisioning(
+            xcodeproj: "Project.xcodeproj",
+            profile: "./watch_app_store.mobileprovision", # optional if you use sigh
+            target_filter: ".*WatchKit Extension.*", # matches name or type of a target
+            build_configuration: "Release"
+          )'
+        ]
+      end
+
+      def self.category
+        :code_signing
+      end
     end
   end
 end

data/lib/fastlane/actions/update_project_team.rb

@@ -18,7 +18,7 @@ module Fastlane
       end
 
       def self.description
-        "Update Development Team ID"
+        "Update Xcode Development Team ID"
       end
 
       def self.details
@@ -47,6 +47,19 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include?(platform)
       end
+
+      def self.example_code
+        [
+          'update_project_team(
+            path: "Example.xcodeproj",
+            teamid: "A3ZZVJ7CNY"
+          )'
+        ]
+      end
+
+      def self.category
+        :project
+      end
     end
   end
 end

data/lib/fastlane/actions/update_urban_airship_configuration.rb

@@ -67,6 +67,20 @@ module Fastlane
       def self.is_supported?(platform)
         platform == :ios
       end
+
+      def self.example_code
+        [
+          'update_urban_airship_configuration(
+            plist_path: "AirshipConfig.plist",
+            production_app_key: "PRODKEY",
+            production_app_secret: "PRODSECRET"
+          )'
+        ]
+      end
+
+      def self.category
+        :push
+      end
     end
   end
 end

data/lib/fastlane/actions/update_url_schemes.rb

@@ -47,6 +47,14 @@ module Fastlane
         ]
       end
 
+      def self.details
+        [
+          "This action allows you to update the URL schemes of the app before building it.",
+          "For example, you can use this to set a different url scheme for the alpha",
+          "or beta version of the app."
+        ].join("\n")
+      end
+
       def self.output
         []
       end
@@ -58,6 +66,19 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include? platform
       end
+
+      def self.example_code
+        [
+          'update_url_schemes(
+            path: "path/to/Info.plist",
+            url_schemes: ["com.myapp"]
+          )'
+        ]
+      end
+
+      def self.category
+        :project
+      end
     end
   end
 end

data/lib/fastlane/actions/upload_symbols_to_crashlytics.rb

@@ -151,6 +151,16 @@ module Fastlane
       def self.is_supported?(platform)
         platform == :ios
       end
+
+      def self.example_code
+        [
+          'upload_symbols_to_crashlytics(dsym_path: "./App.dSYM.zip")'
+        ]
+      end
+
+      def self.category
+        :misc
+      end
     end
   end
 end

data/lib/fastlane/actions/upload_symbols_to_sentry.rb

@@ -137,6 +137,21 @@ module Fastlane
       def self.is_supported?(platform)
         platform == :ios
       end
+
+      def self.example_code
+        [
+          'upload_symbols_to_sentry(
+            auth_token: "...",
+            org_slug: "...",
+            project_slug: "...",
+            dsym_path: "./App.dSYM.zip"
+          )'
+        ]
+      end
+
+      def self.category
+        :misc
+      end
     end
   end
 end

data/lib/fastlane/actions/verify_build.rb

@@ -133,6 +133,7 @@ module Fastlane
       end
 
       def self.details
+        "Verifies that the built app was built using the expected build resources. This is relevant for people who build on machines that are used to build apps with different profiles, certificates and/or bundle identifiers to guard against configuration mistakes."
       end
 
       def self.available_options
@@ -185,6 +186,19 @@ module Fastlane
       def self.is_supported?(platform)
         platform == :ios
       end
+
+      def self.example_code
+        [
+          'verify_build(
+            provisioning_type: "distribution",
+            bundle_identifier: "com.example.myapp"
+          )'
+        ]
+      end
+
+      def self.category
+        :misc
+      end
     end
   end
 end

data/lib/fastlane/actions/verify_pod_keys.rb

@@ -45,8 +45,22 @@ module Fastlane
         "Verifies all keys referenced from the Podfile are non-empty"
       end
 
+      def self.details
+        "Runs a check against all keys specified in your Podfile to make sure they're more than a single character long. This is to ensure you don't deploy with stubbed keys."
+      end
+
       def self.is_supported?(platform)
-        [:ios, :mac].include? platform
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.example_code
+        [
+          'verify_pod_keys'
+        ]
+      end
+
+      def self.category
+        :building
       end
     end
   end

data/lib/fastlane/actions/verify_xcode.rb

@@ -138,6 +138,17 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include?(platform)
       end
+
+      def self.example_code
+        [
+          'verify_xcode',
+          'verify_xcode(xcode_path: "/Applications/Xcode.app")'
+        ]
+      end
+
+      def self.category
+        :building
+      end
     end
   end
 end

data/lib/fastlane/actions/version_bump_podspec.rb

@@ -74,6 +74,17 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include? platform
       end
+
+      def self.example_code
+        [
+          'version = version_bump_podspec(path: "TSMessages.podspec", bump_type: "patch")',
+          'version = version_bump_podspec(path: "TSMessages.podspec", version_number: "1.4")'
+        ]
+      end
+
+      def self.category
+        :misc
+      end
     end
   end
 end

data/lib/fastlane/actions/version_get_podspec.rb

@@ -45,6 +45,16 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include? platform
       end
+
+      def self.example_code
+        [
+          'version = version_get_podspec(path: "TSMessages.podspec")'
+        ]
+      end
+
+      def self.category
+        :misc
+      end
     end
   end
 end

data/lib/fastlane/actions/xcode_install.rb

@@ -37,6 +37,7 @@ module Fastlane
       end
 
       def self.details
+        "Makes sure a specific version of Xcode is installed. If that's not the case, it will automatically be downloaded by the [xcode_install](https://github.com/neonichu/xcode-install) gem. This will make sure to use the correct Xcode for later actions."
       end
 
       def self.available_options
@@ -80,6 +81,16 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include?(platform)
       end
+
+      def self.example_code
+        [
+          'xcode_install(version: "7.1")'
+        ]
+      end
+
+      def self.category
+        :building
+      end
     end
   end
 end

data/lib/fastlane/actions/xcode_select.rb

@@ -37,6 +37,10 @@ module Fastlane
         "Change the xcode-path to use. Useful for beta versions of Xcode"
       end
 
+      def self.details
+        "Select and build with the Xcode installed at the provided path. Use the `xcversion` action if you want to select an Xcode based on a version specifier or you don't have known, stable paths as may happen in a CI environment."
+      end
+
       def self.author
         "dtrenz"
       end
@@ -44,6 +48,16 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include? platform
       end
+
+      def self.example_code
+        [
+          'xcode_select "/Applications/Xcode6.1.app"'
+        ]
+      end
+
+      def self.category
+        :building
+      end
     end
   end
 end

data/lib/fastlane/actions/xcode_server_get_assets.rb

@@ -289,6 +289,19 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :mac].include? platform
       end
+
+      def self.example_code
+        [
+          'xcode_server_get_assets(
+            host: "10.99.0.59", # Specify Xcode Server\'s Host or IP Address
+            bot_name: "release-1.3.4" # Specify the particular Bot
+          )'
+        ]
+      end
+
+      def self.category
+        :testing
+      end
     end
   end
 end

data/lib/fastlane/actions/xcodebuild.rb

@@ -56,6 +56,21 @@ module Fastlane
         [:ios, :mac].include? platform
       end
 
+      def self.example_code
+        [
+          'xcodebuild(
+            archive: true,
+            archive_path: "./build-dir/MyApp.xcarchive",
+            scheme: "MyApp",
+            workspace: "MyApp.xcworkspace"
+          )'
+        ]
+      end
+
+      def self.category
+        :building
+      end
+
       def self.run(params)
         unless Helper.test?
           UI.user_error!("xcodebuild not installed") if `which xcodebuild`.length == 0
@@ -355,7 +370,7 @@ module Fastlane
       end
 
       def self.details
-        "More information on GitHub: https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Actions.md#xcodebuild"
+        "**Note**: `xcodebuild` is a complex command, so it is recommended to use [gym](https://github.com/fastlane/fastlane/tree/master/gym) for building your ipa file and [scan](https://github.com/fastlane/fastlane/tree/master/scan) for testing your app instead."
       end
 
       def self.author
@@ -374,6 +389,16 @@ module Fastlane
         "Archives the project using `xcodebuild`"
       end
 
+      def self.example_code
+        [
+          'xcarchive'
+        ]
+      end
+
+      def self.category
+        :building
+      end
+
       def self.author
         "dtrenz"
       end
@@ -404,6 +429,16 @@ module Fastlane
         XcodebuildAction.run(params_hash)
       end
 
+      def self.example_code
+        [
+          'xcbuild'
+        ]
+      end
+
+      def self.category
+        :building
+      end
+
       def self.description
         "Builds the project using `xcodebuild`"
       end
@@ -443,6 +478,16 @@ module Fastlane
         "Cleans the project using `xcodebuild`"
       end
 
+      def self.example_code
+        [
+          'xcclean'
+        ]
+      end
+
+      def self.category
+        :building
+      end
+
       def self.author
         "dtrenz"
       end
@@ -478,6 +523,16 @@ module Fastlane
         "Exports the project using `xcodebuild`"
       end
 
+      def self.example_code
+        [
+          'xcexport'
+        ]
+      end
+
+      def self.category
+        :building
+      end
+
       def self.author
         "dtrenz"
       end
@@ -512,6 +567,18 @@ module Fastlane
         XcodebuildAction.run(params_hash)
       end
 
+      def self.example_code
+        [
+          'xctest(
+            destination: "name=iPhone 7s,OS=10.0"
+          )'
+        ]
+      end
+
+      def self.category
+        :building
+      end
+
       def self.description
         "Runs tests on the given simulator"
       end