fastlane-plugin-mobile_common 0.4.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4ec68c605fa1814ceb2c574e02d76a0f12e4a799
+  data.tar.gz: c4f8082a22038d952ed0757f60ab605f8c769965
+SHA512:
+  metadata.gz: ea4984ec99b0c5a344f7fc3e41d49ae67102b507ae7708361b81315bfc043492ad3f4fc057a02e97328a2a69ad8dd85b2ebe0729548bf2e8de3452eff723c3e3
+  data.tar.gz: c4b39a8f5ddd49b1d2bbadd0e125ae05b27113295e1ca77b7953a4999cd60ae7ce5932d7050685288b37b9a09234a13e145ffb7114b130f56dc747bfd3ba5cea

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Alexander Semenov <alexs@2kgroup.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,58 @@
+# mobile_common plugin
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-mobile_common)
+
+## Getting Started
+
+This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-mobile_common`, add it to your project by running:
+
+```bash
+fastlane add_plugin mobile_common
+```
+
+## About mobile_common
+
+Collection of common CI actions for Android, iOS and MacOSX projects - like unit tests, app publishing, version increment, screenshots, etc.
+
+**Note to author:** Add a more detailed description about this plugin here. If your plugin contains multiple actions, make sure to mention them here.
+
+## Actions
+* __update_changelog__ - gets contents of CHANGELOG_CURRENT.md and appends them to CHANGELOG.md, adding app version and current date
+* __commit_changelog__ - commits and pushes to repo changes, made by `update_changelog` action
+* __ios_publish_beta__ - publishes already built iOS binary to itunes connect, bumps version, performs much of other automation, see description
+* __prepare_git_repository__ - pulls all changes from given branch and sets up local branch to track remote one. Useful for jenkins
+* __push_version_changes__ - commits target version changes to repository and pushes created commit
+* __prepare_snapfiles__ - creates individual Snapfile for each given device/locale combination, to let run snapshot on each of them individually, and have individual report 
+
+## Example
+
+Check out the [example `Fastfile`](fastlane/Fastfile) to see how to use this plugin. Try it by cloning the repo, running `fastlane install_plugins` and `bundle exec fastlane test`.
+
+## Run tests for this plugin
+
+To run both the tests, and code style validation, run
+
+```
+rake
+```
+
+To automatically fix many of the styling issues, use
+```
+rubocop -a
+```
+
+## Issues and Feedback
+
+For any other issues and feedback about this plugin, please submit it to this repository.
+
+## Troubleshooting
+
+If you have trouble using plugins, check out the [Plugins Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/) guide.
+
+## Using _fastlane_ Plugins
+
+For more information about how the `fastlane` plugin system works, check out the [Plugins documentation](https://docs.fastlane.tools/plugins/create-plugin/).
+
+## About _fastlane_
+
+_fastlane_ is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out [fastlane.tools](https://fastlane.tools).

data/lib/assets/Snapfile-template

@@ -0,0 +1,9 @@
+# The name of the scheme which contains the UI Tests
+scheme 'IOSClient'
+
+configuration 'UITesting'
+
+clear_previous_screenshots # remove the '#' to clear all previously generated screenshots before creating new ones
+
+# For more information about all available options run
+# snapshot --help

data/lib/fastlane/plugin/mobile_common.rb

@@ -0,0 +1,16 @@
+require 'fastlane/plugin/mobile_common/version'
+
+module Fastlane
+  module MobileCommon
+    # Return all .rb files inside the "actions" and "helper" directory
+    def self.all_classes
+      Dir[File.expand_path('**/{actions,helper}/*.rb', File.dirname(__FILE__))]
+    end
+  end
+end
+
+# By default we want to import all available actions and helpers
+# A plugin can contain any number of actions and plugins
+Fastlane::MobileCommon.all_classes.each do |current|
+  require current
+end

data/lib/fastlane/plugin/mobile_common/actions/commit_changelog.rb

@@ -0,0 +1,49 @@
+module Fastlane
+  module Actions
+    module SharedValues
+    end
+
+    class CommitChangelogAction < Action
+      def self.run(params)
+        # fastlane will take care of reading in the parameter and fetching the environment variable:
+        app_suffix = params[:app_suffix]
+        changelog_filename_suffix = "_#{app_suffix}" unless app_suffix.to_s == ''
+
+        # 		ensure we have not staged anything except changelog
+        sh("git reset HEAD")
+        # 		adding changed files, we need to add uplevel because this code is executed inside 'fastlane' folder
+        sh("git add CHANGELOG#{changelog_filename_suffix}.md")
+        sh("git add CHANGELOG_CURRENT#{changelog_filename_suffix}.md")
+        sh("git commit -m \"Changelog update #{app_suffix}\"")
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        "Commits changelog changes to git, which were made by 'update_changelog' action"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :app_suffix,
+                                       env_name: "FL_COMMIT_CHANGELOG_APP_SUFFIX", # The name of the environment variable
+                                       description: "Suffix, added to changelog filenames, used to split changelogs for different app flavors in same repository", # a short description of this parameter
+                                       is_string: true,
+                                       default_value: "",
+                                       optional: true)
+        ]
+      end
+
+      def self.authors
+        # So no one will ever forget your contribution to fastlane :) You are awesome btw!
+        ["SemenovAlexander"]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/actions/ios_publish_beta.rb

@@ -0,0 +1,204 @@
+module Fastlane
+  module Actions
+    module SharedValues
+      DEPLOYED_BUILD_NUMBER = :DEPLOYED_BUILD_NUMBER
+      NEW_BUILD_NUMBER = :NEW_BUILD_NUMBER
+    end
+
+    class IosPublishBetaAction < Action
+      def self.run(params)
+        # this is required for
+        require 'fastlane/plugin/versioning'
+        require 'fastlane/plugin/get_product_bundle_id'
+
+        # read params
+        git_branch = params[:git_branch]
+        artifacts_directory = params[:artifacts_directory]
+        build_targets = Array(params[:build_targets])
+        build_targets_version_increment = Array(params[:build_targets_version_increment])
+        build_targets_version_increment = build_targets if build_targets_version_increment.empty? || build_targets_version_increment.nil?
+
+        app_suffix = params[:app_suffix]
+        app_suffix = "" unless app_suffix # if suffix was not passed - use empty string
+        xcodeproj = params[:xcodeproj]
+        ipa_dir = params[:ipa_source_directory]
+
+		distribute_external = params[:distribute_external]
+		external_groups = Array(params[:groups])
+
+        # removing old artifacts to be sure, we are building from scratch
+        sh("mkdir -p #{artifacts_directory}") # first - we need to ensure, we have artifacts directory
+
+        sh("rm -rf #{artifacts_directory}/*.*")
+
+        # copy artifacts to for jenkins
+        sh("cp -r *.ipa #{artifacts_directory}")
+        sh("cp -r *.dSYM.zip #{artifacts_directory}")
+
+        build_number = other_action.get_build_number_from_plist(
+          target: build_targets.first,
+          xcodeproj: xcodeproj
+        )
+
+        version_number = other_action.get_version_number_from_plist(
+          target: build_targets.first,
+          xcodeproj: xcodeproj
+        )
+
+        changelog_filename_suffix = "_#{app_suffix}" unless app_suffix.to_s == ''
+        changelog = other_action.update_changelog(
+          version: "#{version_number} (#{build_number})",
+          current_log_filename: "CHANGELOG_CURRENT#{changelog_filename_suffix}.md",
+          log_filename: "CHANGELOG#{changelog_filename_suffix}.md"
+        )
+        Actions.lane_context[SharedValues::UPDATE_CHANGELOG_CURRENT] = changelog
+
+        # for now pilot doesn't see submitted binary even after processing is complete.
+        # Probably some issue in TestFlight, so we deploy build to testers manually on each new version.
+        build_targets.each do |build_target|
+          bundle_id = other_action.get_product_bundle_id(project_filepath: xcodeproj, scheme: build_target)
+          ipa_path = File.join(Dir.pwd, ipa_dir, "#{build_target}.ipa")
+          UI.message "Uploading ipa #{ipa_path} for bunlde id #{bundle_id}"
+          other_action.pilot(
+            skip_submission: false,
+            ipa: ipa_path,
+            skip_waiting_for_build_processing: false,
+            changelog: changelog,
+            app_identifier: bundle_id,
+            distribute_external: distribute_external,
+            groups: external_groups
+          )
+        end
+        other_action.commit_changelog(
+          app_suffix: app_suffix
+        )
+
+        git_tag_folder_prefix = app_suffix.downcase
+        # add separator between prefix and `beta` word in tag folder if we have app suffix
+        git_tag_folder_prefix += '_' unless git_tag_folder_prefix == ''
+        other_action.add_git_tag(
+          tag: "builds/#{git_tag_folder_prefix}beta/#{build_number}"
+        )
+
+        Actions.lane_context[SharedValues::DEPLOYED_BUILD_NUMBER] = build_number
+        build_targets_version_increment.each do |build_target|
+          other_action.increment_build_number_in_plist(
+            xcodeproj: xcodeproj,
+            target: build_target
+          )
+        end
+
+        new_build_number = Actions.lane_context[SharedValues::BUILD_NUMBER]
+        new_version_number = version_number
+        Actions.lane_context[SharedValues::NEW_BUILD_NUMBER] = new_build_number
+
+        other_action.push_version_changes(
+          commit_message: "NO-TRACK Version Code Bump #{new_build_number} #{app_suffix} [ci skip]",
+          xcodeproj: xcodeproj,
+          git_branch: git_branch
+        )
+        # this action adds build number to props file for jenkins. this will be added as version to Jira
+        sh "echo JIRA_NEXT_VERSION=#{new_version_number}.#{new_build_number} > fastlane/version.props"
+        UI.important "Don't forget to check TestFlight build availability in Itunes Connect!!!"
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.output
+        # Define the shared values you are going to provide
+        # Example
+        [
+          ['UPDATE_CHANGELOG_CURRENT', 'Current version changelog string representation, you can send it to slack, for instance'],
+          ['DEPLOYED_BUILD_NUMBER', 'Build number of build, which was deployed to ITunesConnect'],
+          ['NEW_BUILD_NUMBER', 'Build number after increment']
+        ]
+      end
+
+      def self.description
+        "Builds new app version and deploys it to Apple TestFlight. Also updates app changelog."
+      end
+
+      def self.details
+        "Action does following for each given target:
+         * increment build number by 1
+         * uploads newly built build to Apple TestFlight
+         * copies current changelog to common one
+         * commits version bump
+         * pushes all changes
+
+          IMPORTANT! You should build and archive app before calling this action."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :git_branch,
+                                       env_name: "FL_IOS_PUBLISH_BETA_GIT_BRANCH",
+                                       description: "Git branch to push back changelog and version updates",
+                                       default_value: "master"),
+          FastlaneCore::ConfigItem.new(key: :build_targets,
+                                       env_name: "FL_IOS_PUBLISH_BETA_TARGETS",
+                                       description: "Array of Xcode targets to publish. Project should have dedicated scheme for each target",
+                                       type: Array,
+                                       verify_block: proc do |value|
+                                         UI.user_error!("XCode targets to publish not specified, pass using `build_targets: ['target_name1', 'target_name2']`") unless value and !value.empty?
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :build_targets_version_increment,
+                                       env_name: "FL_IOS_PUBLISH_BETA_TARGETS_VERSION_INCREMENT",
+                                       description: "Array of Xcode targets to increment build number, if nil - build_targets will be used. Project should have dedicated scheme for each target",
+                                       type: Array,
+                                       optional: true,
+                                       verify_block: proc do |value|
+                                         UI.user_error!("XCode targets to increment build number not specified, pass using `build_targets: ['target_name1', 'target_name2']`") unless value and !value.empty?
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :xcodeproj,
+                                       env_name: "FL_IOS_PUBLISH_BETA_XCODEPROJ",
+                                       description: "Path to Xcode project to find targets",
+                                       verify_block: proc do |value|
+                                         UI.user_error!("Please pass the path to the project, not the workspace") if value.end_with? ".xcworkspace"
+                                         UI.user_error!("Could not find Xcode project at path '#{File.expand_path(value)}'") unless File.exist?(value)
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :artifacts_directory,
+                                       env_name: "FL_IOS_PUBLISH_BETA_ARTIFACTS_DIRECTORY",
+                                       description: "Directory to store build artifacts like IPA files",
+                                       default_value: "artifacts"),
+          FastlaneCore::ConfigItem.new(key: :ipa_source_directory,
+                                       env_name: "FL_IOS_PUBLISH_BETA_IPA_SOURCE_DIRECTORY",
+                                       description: "Directory with IPA files for each target, which should be uploaded to itunesconnect. By default - root dir is used",
+                                       default_value: ""),
+          FastlaneCore::ConfigItem.new(key: :app_suffix,
+                                       env_name: "FL_IOS_PUBLISH_BETA_APP_SUFFIX",
+                                       description: "Suffix, added to changelog filenames, used to split changelogs for different app flavors in same repository",
+                                       default_value: "",
+                                       is_string: true,
+                                       optional: true),
+          FastlaneCore::ConfigItem.new(key: :distribute_external,
+                                       env_name: "FL_IOS_PUBLISH_BETA_APP_DISTRIBUTE_EXTERNAL",
+                                       description: "Should the build be distributed to external testers?. By default - false",
+                                  	   is_string: false,
+                                       default_value: false,
+                                       optional: true),
+          FastlaneCore::ConfigItem.new(key: :groups,
+                                       env_name: "FL_IOS_PUBLISH_BETA_APP_GROUPS",
+                                       description: "Names/ids of groups of external testers. By default - used one group 'External'",
+                                       type: Array,
+                                       default_value: ["External"],
+                                       optional: true,
+                                       verify_block: proc do |value|
+                                         UI.user_error!("External test groups to assosiate testers not specified, pass using `groups: ['tester_group1', 'tester_group2']`") unless value and !value.empty?
+                                       end)
+        ]
+      end
+
+      def self.authors
+        # So no one will ever forget your contribution to fastlane :) You are awesome btw!
+        ["SemenovAlexander"]
+      end
+
+      def self.is_supported?(platform)
+        platform == :ios
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/actions/prepare_git_repository.rb

@@ -0,0 +1,59 @@
+module Fastlane
+  module Actions
+    module SharedValues
+    end
+
+    class PrepareGitRepositoryAction < Action
+      def self.run(params)
+        git_branch = params[:branch]
+        remote = params[:remote]
+        sh("git checkout #{git_branch}")
+        sh("git remote set-branches --add #{remote} #{git_branch}")
+        sh("git branch --set-upstream-to=refs/remotes/#{remote}/#{git_branch} #{git_branch}")
+        other_action.git_pull
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        "Prepares repo for fastlane to work"
+      end
+
+      def self.details
+        # Optional:
+        # this is your chance to provide a more detailed description of this action
+        "You can use this action to do cool things..."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :branch,
+                                       env_name: "FL_PREPARE_GIT_REPOSITORY_BRANCH",
+                                       description: "Git branch to checkout and track for rest of fastlane",
+                                       default_value: "master",
+                                       verify_block: proc do |value|
+                                         UI.user_error!("No branch for PrepareGitRepositoryAction given, pass using `branch: 'branch'`") unless value and !value.empty?
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :remote,
+                                       env_name: "FL_PREPARE_GIT_REPOSITORY_REMOTE",
+                                       description: "Git remote name to checkout and track for rest of fastlane",
+                                       default_value: "origin",
+                                       verify_block: proc do |value|
+                                         UI.user_error!("No git remote for PrepareGitRepositoryAction given, pass using `remote: 'origin'`") unless value and !value.empty?
+                                       end)
+        ]
+      end
+
+      def self.authors
+        # So no one will ever forget your contribution to fastlane :) You are awesome btw!
+        ["SemenovAlexander"]
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/actions/prepare_snapfiles.rb

@@ -0,0 +1,129 @@
+module Fastlane
+  module Actions
+    module SharedValues
+      PREPARE_SNAPFILES_FILES_PATHS = :PREPARE_SNAPFILES_FILES_PATHS
+    end
+
+    # To share this integration with the other fastlane users:
+    # - Fork https://github.com/KrauseFx/fastlane
+    # - Clone the forked repository
+    # - Move this integration into lib/fastlane/actions
+    # - Commit, push and submit the pull request
+
+    class PrepareSnapfilesAction < Action
+      def self.run(params)
+        require 'fileutils'
+        Dir.chdir(FastlaneCore::FastlaneFolder.path) do
+          if params[:snapfile_template_path].to_s != ''
+            snapfile_template_path = params[:snapfile_template_path]
+          else
+            lib_path = File.join(Helper.gem_path('fastlane-plugin-mobile_common'), "lib")
+            snapfile_template_path = File.join(lib_path, "assets/Snapfile-template")
+          end
+
+          template = File.read(snapfile_template_path)
+
+          devices = params[:devices]
+          langs = params[:languages]
+          base_path = params[:screenshots_path]
+          result_paths = []
+          ios_version = params[:ios_version]
+          langs.each do |item|
+            language = item
+            devices.each do |device|
+              path = base_path + '/' + language + '/' + device
+              path += " (#{ios_version})" unless ios_version.empty?
+              FileUtils.mkdir_p path
+              File.open(path + '/Snapfile', 'w') do |fo|
+                fo.puts template
+                fo.puts "\n"
+                fo.puts "output_directory \"fastlane/#{path}\""
+                fo.puts "\n"
+                fo.puts "devices([\"#{device}\"])"
+                fo.puts "\n"
+                fo.puts "languages([\"#{language}\"])"
+                fo.puts "\n"
+                fo.puts "ios_version '#{ios_version}'" unless ios_version.empty?
+              end
+              result_paths << path
+            end
+          end
+          Actions.lane_context[SharedValues::PREPARE_SNAPFILES_FILES_PATHS] = result_paths
+          return result_paths
+        end
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        'Generates snapfile from template in each language/device folder combination'
+      end
+
+      def self.details
+        # Optional:
+        # this is your change to provide a more detailed description of this action
+        'You can use this action to generate individual snapshot report for each language/device combination. Just run snapshot for each path, returned in PREPARE_SNAPFILES_FILES_PATHS shared value'
+      end
+
+      def self.available_options
+        # Define all options your action supports.
+
+        # Below a few examples
+        [
+          FastlaneCore::ConfigItem.new(key: :devices,
+                                       env_name: 'FL_PREPARE_SNAPFILES_DEVICES', # The name of the environment variable
+                                       description: 'Array with names of simulator devices to use', # a short description of this parameter
+                                       is_string: false,
+                                       verify_block: proc do |value|
+                                         UI.user_error!("No Devices for PrepareSnapfilesAction given, pass using `devices: ['iPhone 4s', 'iPhone 6',...]`") unless value && !value.empty?
+                                         # UI.user_error!("Invalid devices passed: #{value}. Please, pass array of devices!") unless value.kind_of?(Array)
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :languages,
+                                       env_name: 'FL_PREPARE_SNAPFILES_LANGUAGES', # The name of the environment variable
+                                       description: 'Array with names of langugages to use', # a short description of this parameter
+                                       is_string: false,
+                                       verify_block: proc do |value|
+                                         UI.user_error!("No languages for PrepareSnapfilesAction given, pass using `languages: ['en-US', 'ru-RU']`") unless value && !value.empty?
+                                         # UI.user_error!("Invalid languages passed: #{value}. Please, pass array of languages!") unless value.kind_of?(Array)
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :snapfile_template_path,
+                                       env_name: 'FL_PREPARE_SNAPFILES_TEMPLATE_PATH', # The name of the environment variable
+                                       description: 'path for template snapfile, to which info will be added', # a short description of this parameter
+                                       optional: true),
+          FastlaneCore::ConfigItem.new(key: :screenshots_path,
+                                       env_name: 'FL_PREPARE_SNAPFILES_SCREENSHOTS_PATH', # The name of the environment variable
+                                       description: 'Base directory for screenshots, from where action will separate snapfiles through language dirs', # a short description of this parameter
+                                       default_value: 'screenshots-ui-test'),
+          FastlaneCore::ConfigItem.new(key: :ios_version,
+                                       env_name: 'FL_PREPARE_SNAPFILES_IOS_VERSION', # The name of the environment variable
+                                       description: 'Optional ios version to be added in generated snapfile as param', # a short description of this parameter
+                                       default_value: '')
+
+        ]
+      end
+
+      def self.output
+        # Define the shared values you are going to provide
+        # Example
+        [
+          ['PREPARE_SNAPFILES_FILES_PATHS', 'Array with paths to generated Snapfiles']
+        ]
+      end
+
+      def self.return_value
+        'Returns array of paths to generated Snapfiles'
+      end
+
+      def self.authors
+        # So no one will ever forget your contribution to fastlane :) You are awesome btw!
+        ['SemenovAlexander']
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include? platform
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/actions/push_version_changes.rb

@@ -0,0 +1,66 @@
+module Fastlane
+  module Actions
+    module SharedValues
+    end
+
+    class PushVersionChangesAction < Action
+      def self.run(params)
+        git_branch = params[:git_branch]
+
+        # remove all files from index
+        sh("git reset")
+
+        other_action.commit_version_bump(
+          force: true,
+          message: params[:commit_message],
+          xcodeproj: params[:xcodeproj]
+        )
+        other_action.push_to_git_remote(
+          local_branch: git_branch
+        )
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        "Commits target version changes to repository and pushes created commit"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :commit_message,
+                                       env_name: "FL_PUSH_VERSION_CHANGES_COMMIT_MESSAGE",
+                                       description: "Commit message for version bump",
+                                       verify_block: proc do |value|
+                                         UI.user_error!("No CommitMessage for PushVersionChangesAction given, pass using `commit_message: 'message'`") unless value and !value.empty?
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :git_branch,
+                                       env_name: "FL_PUSH_VERSION_CHANGES_GIT_BRANCH",
+                                       description: "Branch to push changes",
+                                       verify_block: proc do |value|
+                                         UI.user_error!("No Git branch for PushVersionChangesAction given, pass using `git_branch: 'branch'`") unless value and !value.empty?
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :xcodeproj,
+                                       env_name: "FL_PUSH_VERSION_CHANGES_XCODEPROJ",
+                                       description: "If you have multiple Xcode project files, you must specify your main project here",
+                                       optional: true,
+                                       verify_block: proc do |value|
+                                         UI.user_error!("Please pass the path to the project, not the workspace") if value.end_with? ".xcworkspace"
+                                         UI.user_error!("Could not find Xcode project at path '#{File.expand_path(value)}'") unless File.exist?(value)
+                                       end)
+        ]
+      end
+
+      def self.authors
+        # So no one will ever forget your contribution to fastlane :) You are awesome btw!
+        ["SemenovAlexander"]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/actions/update_changelog.rb

@@ -0,0 +1,105 @@
+module Fastlane
+  module Actions
+    module SharedValues
+      UPDATE_CHANGELOG_CURRENT = :UPDATE_CHANGELOG_CURRENT
+    end
+
+    # To share this integration with the other fastlane users:
+    # - Fork https://github.com/KrauseFx/fastlane
+    # - Clone the forked repository
+    # - Move this integration into lib/fastlane/actions
+    # - Commit, push and submit the pull request
+
+    class UpdateChangelogAction < Action
+      CHANGELOG_TEMPLATE_LEGACY = "### Fixed\n*\n\n### Added\n*\n\n### Removed\n*".freeze
+      CHANGELOG_TEMPLATE = '* Put your changes here one by one, you can use markdown syntax'.freeze
+
+      def self.run(params)
+        changelog_filename = params[:log_filename]
+        current_changelog_filename = params[:current_log_filename]
+
+        version = params[:version]
+
+        current_changelog = File.read(current_changelog_filename).to_s.strip
+        changelog_error_message = params[:current_log_error_message]
+        raise changelog_error_message unless CHANGELOG_TEMPLATE.to_s != current_changelog.to_s
+        raise changelog_error_message unless CHANGELOG_TEMPLATE_LEGACY.to_s != current_changelog.to_s
+        global_changelog = File.read(changelog_filename)
+        #       prepending contents of current changelog to existing file
+        File.open(changelog_filename, 'w') do |fo|
+          current_date = Time.now.strftime('%Y-%m-%d')
+          fo.puts "## #{version} - #{current_date}"
+          fo.puts current_changelog
+          fo.puts "\n"
+          fo.puts global_changelog
+        end
+        #        deleting current changelog file to make it clean for next releases
+        File.open(current_changelog_filename, 'w') do |fo|
+          fo.puts CHANGELOG_TEMPLATE
+        end
+
+        Actions.lane_context[SharedValues::UPDATE_CHANGELOG_CURRENT] = current_changelog
+        current_changelog
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        'Reads current changelog and appends it to global one'
+      end
+
+      def self.details
+        # Optional:
+        # this is your change to provide a more detailed description of this action
+        'You can use this action to provide change log for olg version and update global one with it. You must have CHANGELOG_CURRENT.md file with changes for current version. You can use standard markdown. It then be moved to CHANGELOG.md as changes for current version and cleaned'
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :version,
+                                       env_name: 'FL_UPDATE_CHANGELOG_VERSION', # The name of the environment variable
+                                       description: 'Complete version string, which will be added as current version to changelog', # a short description of this parameter
+                                       verify_block: proc do |value|
+                                         raise "No new app version for UpdateChangeLog given, pass using `version: 'token'`, e.g. `version: '1.2 (258)'`".red unless value && !value.empty?
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :log_filename,
+                                       env_name: 'FL_CHANGELOG_FILE_NAME', # The name of the environment variable
+                                       description: 'Optional file name of general changelog', # a short description of this parameter
+                                       default_value: 'CHANGELOG.md'),
+          FastlaneCore::ConfigItem.new(key: :current_log_filename,
+                                       env_name: 'FL_CURRENT_CHANGELOG_FILE_NAME', # The name of the environment variable
+                                       description: 'Optional file name of current changelog', # a short description of this parameter
+                                       default_value: 'CHANGELOG_CURRENT.md'),
+          FastlaneCore::ConfigItem.new(key: :current_log_error_message,
+                                       env_name: 'FL_CUSTOM_ERROR_MESSAGE', # The name of the environment variable
+                                       description: 'Optional custom message to be shown if current changelog is not valid', # a short description of this parameter
+                                       default_value: 'You have not provided changelog for build. Please, fill in file CHANGELOG_CURRENT.md')
+        ]
+        # Define all options your action supports.
+      end
+
+      def self.output
+        # Define the shared values you are going to provide
+        # Example
+        [
+          ['UPDATE_CHANGELOG_CURRENT', 'Current version changelog string representation, you can send it to slack, for instance']
+        ]
+      end
+
+      def self.return_value
+        'Returns value of UPDATE_CHANGELOG_CURRENT shared value'
+      end
+
+      def self.authors
+        # So no one will ever forget your contribution to fastlane :) You are awesome btw!
+        ['SemenovAlexander']
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac, :android].include? platform
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/helper/mobile_common_helper.rb

@@ -0,0 +1,12 @@
+module Fastlane
+  module Helper
+    class MobileCommonHelper
+      # class methods that you define here become available in your action
+      # as `Helper::MobileCommonHelper.your_method`
+      #
+
+      def self.prepare_repository(options)
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/helper/other_action_hotfix.rb

@@ -0,0 +1,29 @@
+module Fastlane
+  # This class is used to call other actions from within actions
+  # We use a separate class so that we can easily identify when
+  # we have dependencies between actions
+  class OtherAction
+    # Allows the user to call an action from an action
+    def method_missing(method_sym, *arguments, &_block)
+      # We have to go inside the fastlane directory
+      # since in the fastlane runner.rb we do the following
+      #   custom_dir = ".."
+      #   Dir.chdir(custom_dir) do
+      # this goes one folder up, since we're inside the "fastlane"
+      # folder at that point
+      # Since we call an action from an action we need to go inside
+      # the fastlane folder too
+
+      # FIXME: because of changes in fastlane runner - we can't just pass fastlane folder - action will be called in fastlane folder
+      # for now this is a workaround - pass current folder, so fastlane will switch nowhere
+      # FIXME: create an issue in official fastlane repo
+      # Now fastlane runner switches to upper level folder only if nil was passed:
+      # custom_dir ||= ".."
+
+      self.runner.trigger_action_by_name(method_sym,
+                                         '.',
+                                         true,
+                                         *arguments)
+    end
+  end
+end

data/lib/fastlane/plugin/mobile_common/version.rb

@@ -0,0 +1,5 @@
+module Fastlane
+  module MobileCommon
+    VERSION = "0.4.4"
+  end
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-mobile_common
+version: !ruby/object:Gem::Version
+  version: 0.4.4
+platform: ruby
+authors:
+- Alexander Semenov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-11-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fastlane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.38.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.38.1
+- !ruby/object:Gem::Dependency
+  name: fastlane-plugin-versioning
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fastlane-plugin-get_product_bundle_id
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: alexs@2kgroup.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/assets/Snapfile-template
+- lib/fastlane/plugin/mobile_common.rb
+- lib/fastlane/plugin/mobile_common/actions/commit_changelog.rb
+- lib/fastlane/plugin/mobile_common/actions/ios_publish_beta.rb
+- lib/fastlane/plugin/mobile_common/actions/prepare_git_repository.rb
+- lib/fastlane/plugin/mobile_common/actions/prepare_snapfiles.rb
+- lib/fastlane/plugin/mobile_common/actions/push_version_changes.rb
+- lib/fastlane/plugin/mobile_common/actions/update_changelog.rb
+- lib/fastlane/plugin/mobile_common/helper/mobile_common_helper.rb
+- lib/fastlane/plugin/mobile_common/helper/other_action_hotfix.rb
+- lib/fastlane/plugin/mobile_common/version.rb
+homepage: 
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: Collection of common CI actions for Android, iOS and MacOSX projects - like
+  unit tests, app publishing, version increment, screenshots, etc.
+test_files: []