fastlane-plugin-react_native_release 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 41c9108af617444663430f462d96375ee2a4856e083553a7f935699cbdf01211
+  data.tar.gz: 8c6c46cb031b6af0204af69c59e5d3526ce04eac969ea4d84d9c414cf00c0b91
+SHA512:
+  metadata.gz: 38c95c3c03ebe145a5e2174910bfc261513c01dc15d9abe372e34b0a0d9cd0a552687a7c4c4acff281d41e143434e42ec02af706765945527ddb5c8e142f8c32
+  data.tar.gz: 2869253f1d4a9e852b1d05e43a401218e439498f0818fa6d13b52000cfb0a2eb8e4e46e5ad12a0ac2a17272594789de9d23becdd4163cfa2cd39587328f8c2d4

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Chris Ball <chris@echobind.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,83 @@
+# React Native Release 
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-react_native_release)
+
+## Getting Started
+
+This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-react_native_release`, add it to your project by running:
+
+```bash
+fastlane add_plugin react_native_release
+```
+
+### Ensure your project confirms to Semantic Versioning
+Projects using React Native Release should use Semantic Versioning. At the very least, you need major, minor, and patch numbers in your version.
+
+**iOS**
+Use `agvtool` to get and set a version across your project. From the `ios` directory, do the following:
+* `agvtool what-marketing-version` to see your current version
+* `agvtool new-marketing-version 0.1.0` to set a new version
+
+**Android**
+* Set `versionName` in `app/build.gradle`. (`versionName "0.1.0"`)
+
+:exclamation: If you don't complete these steps, releases will fail. :exclamation:
+
+## About React Native Release
+
+Simplify releases for React Native apps.
+
+This plugin:
+
+- cuts a new `beta` or `production` release
+- prompts the user for a `major/minor/patch` version bump
+- bumps the version of the iOS and Android app appropriately
+- tags a release based on the iOS and Android version
+- handles hotfix releases
+- handles merging version bumps and hotfixes back to the appropriate branches
+
+The main branch and tagging flow looks like this:
+![Branch / Tag Flow](https://monosnap.com/image/Tn71leeWdCwwjSdwjYKHK4pnyjG1v4.png)
+
+If a hotfix is required the flow looks like this:
+![Hotfix Flow](https://monosnap.com/image/ctwlef0A3TbLbRk1xJrlVroNB8F9ot.png)
+
+Here's what it looks like in action:
+![Releasing a beta](https://api.monosnap.com/image/download?id=IEISpG4vgMeGPl31it8GxPbiTror2i)
+(this example uses `"release": "bundle exec fastlane run react_native_release"` as a yarn script)
+
+## 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`.
+
+**Note to author:** Please set up a sample project to make it easy for users to explore what your plugin does. Provide everything that is necessary to try out the plugin in this project (including a sample Xcode/Android project if necessary)
+
+## 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/fastlane/plugin/react_native_release.rb

@@ -0,0 +1,16 @@
+require 'fastlane/plugin/react_native_release/version'
+
+module Fastlane
+  module ReactNativeRelease
+    # 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::ReactNativeRelease.all_classes.each do |current|
+  require current
+end

data/lib/fastlane/plugin/react_native_release/actions/react_native_release_action.rb

@@ -0,0 +1,209 @@
+require 'fastlane/action'
+require_relative '../helper/react_native_release_helper'
+
+module Fastlane
+  module Actions
+    class ReactNativeReleaseAction < Action
+      VALID_TARGETS = %w{beta production}
+
+      def self.run(params)
+        require 'fastlane/plugin/android_versioning'
+        target = UI.select "Select a release type:", VALID_TARGETS
+        is_beta = target.include?('beta')
+        is_hotfix = params[:hotfix] === true
+        ios_version = other_action.get_version_number(xcodeproj: params[:xcodeproj], target: File.basename(params[:xcodeproj], '.*'))
+        android_version = other_action.get_version_name(app_project_dir: params[:android_app_dir])
+        should_prompt_for_version_bump = params[:prompt_for_version_bump] === true || is_beta
+
+        if is_beta
+          tag_prefix = 'betas'
+          base_branch = params[:alpha_branch]
+          target_branch = params[:beta_branch]
+        else
+          tag_prefix = 'releases'
+          base_branch = params[:beta_branch]
+          target_branch = params[:production_branch]
+        end
+
+        # Ensure we're on the right branch and in a good state
+        other_action.ensure_git_branch(branch: base_branch)
+        other_action.ensure_git_status_clean
+        sh "git branch --set-upstream-to=origin/#{base_branch} #{base_branch}"
+        other_action.git_pull
+
+        # Cut a fresh branch unless this is a hotfix
+        if !is_hotfix
+          # delete an existing branch if we have one
+          sh "git show-ref #{target_branch}" do |status|
+            sh "git branch -D #{target_branch}" if status.success?
+          end
+          
+          sh "git checkout -b #{target_branch}"
+        end
+
+        # Tag / Bump version
+        if should_prompt_for_version_bump
+          version = prompt_for_version
+          ios_version = bump_ios_version(version: version, xcodeproj: params[:xcodeproj])
+          android_version = bump_android_version(version: version)
+
+          if ios_version &&  android_version
+            UI.message "Committing iOS v#{ios_version} and Android v#{android_version} to git"
+            other_action.git_commit(
+              path: ["#{Dir.pwd}/ios", "#{Dir.pwd}/android"],
+              message: "Release iOS v#{ios_version} and Android v#{android_version}"
+            )
+          else
+            UI.message "No version bump specified"
+          end
+        end
+
+        # Tag it
+        tag_name = "#{tag_prefix}/ios-#{ios_version}-android-#{android_version}"
+        other_action.add_git_tag(tag: tag_name)
+        other_action.push_to_git_remote(
+          local_branch: target_branch,
+          force: true
+        )
+
+        merge_branch(branch: target_branch, target: base_branch)
+        return if is_beta
+
+        # production releases need an additional merge back to the alpha branch
+        merge_branch(branch: params[:beta_branch], target: params[:alpha_branch])
+      end
+
+      # Handles merging the specified branch into a target.
+      # example: beta -> master
+      def self.merge_branch(options)
+        branch = options[:branch]
+        target = options[:target]
+      
+        sh "git checkout #{target}"
+        sh "git merge origin/#{branch}" do |status|
+          unless status.success?
+            UI.error "Failed to merge #{branch} into #{target}"
+          end
+          
+          other_action.push_to_git_remote(
+            local_branch: target  
+          )
+        end
+      end
+
+      def self.bump_ios_version(options)
+        version_bump = options[:version] || prompt_for_version
+        return if version_bump == "none"
+      
+        UI.message "bumping ios #{options[:xcodeproj]} to #{version_bump}"
+        other_action.increment_version_number(
+          xcodeproj: options[:xcodeproj],
+          bump_type: version_bump
+        )
+      end
+      
+      def self.bump_android_version(options)
+        version_bump = options[:version] || prompt_for_version
+        return if version_bump == "none"
+      
+        UI.message "bumping android to #{version_bump}"
+        other_action.increment_version_name(
+          # TODO: make param
+          app_project_dir: "#{Dir.pwd}/android/app",
+          bump_type: version_bump
+        )
+      end
+      
+      def self.prompt_for_version
+        UI.select("Update Version?: ", ["none", "major", "minor", "patch"])
+      end
+
+      def self.description
+        "Simplify releases for React Native apps"
+      end
+
+      def self.authors
+        ["cball"]
+      end
+
+      def self.return_value
+        # If your method provides a return value, you can describe here what it does
+      end
+
+      def self.details
+        "Creates a release for a React Native app. Handles incrementing versions and tags"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :xcodeproj,
+                                  env_name: "REACT_NATIVE_RELEASE_XCODE_PROJECT",
+                               description: "Path to Xcode project",
+                                  optional: true,
+                                      type: String,
+                             default_value: "#{Dir.pwd}/#{Dir['**/*.xcodeproj'].sort.first}",
+                              verify_block: lambda do |value|
+                                              UI.user_error!("Could not find Xcode project") unless File.exist?(value)
+                                            end),
+          FastlaneCore::ConfigItem.new(key: :android_app_dir,
+                                  env_name: "REACT_NATIVE_RELEASE_ANDROID_APP_DIR",
+                               description: "Path to Android app dir",
+                                  optional: true,
+                                      type: String,
+                             default_value: "#{Dir.pwd}/android/app",
+                              verify_block: lambda do |value|
+                                              UI.user_error!("Could not find specified Android app dir") unless File.exist?(value)
+                                            end),
+          FastlaneCore::ConfigItem.new(key: :alpha_branch,
+                                  env_name: "REACT_NATIVE_RELEASE_ALPHA_BRANCH",
+                               description: "The branch used for alpha releases",
+                                  optional: true,
+                                      type: String,
+                             default_value: 'master'),
+          FastlaneCore::ConfigItem.new(key: :beta_branch,
+                                  env_name: "REACT_NATIVE_RELEASE_BETA_BRANCH",
+                               description: "The branch used for beta releases",
+                                  optional: true,
+                                      type: String,
+                             default_value: 'beta'),
+          FastlaneCore::ConfigItem.new(key: :production_branch,
+                                  env_name: "REACT_NATIVE_RELEASE_PRODUCTION_BRANCH",
+                               description: "The branch used for production releases",
+                                  optional: true,
+                                      type: String,
+                             default_value: 'production'),
+          FastlaneCore::ConfigItem.new(key: :target,
+                                  env_name: "REACT_NATIVE_RELEASE_TARGET",
+                               description: "The release target. Valid targets are #{VALID_TARGETS.join(', ')}",
+                                  optional: true,
+                                      type: String,
+                              verify_block: lambda do |value|
+                                              unless VALID_TARGETS.find{|v| value == v}
+                                                UI.user_error!("Invalid target #{value}. Valid targets are #{VALID_TARGETS.join(', ')}") 
+                                                next
+                                              end
+                                            end), 
+          FastlaneCore::ConfigItem.new(key: :hotfix,
+                                  env_name: "REACT_NATIVE_RELEASE_HOTFIX",
+                               description: "If this is a hotfix. Will only pull the latest branch and tag",
+                                  optional: true,
+                                      type: Boolean,
+                             default_value: false),
+          FastlaneCore::ConfigItem.new(key: :prompt_for_version_bump,
+                                  env_name: "REACT_NATIVE_RELEASE_PROMPT_FOR_VERSION_BUMP",
+                               description: "Force the prompt to bump the app version. Otherwise, only prompts on beta",
+                                  optional: true,
+                                      type: Boolean,
+                             default_value: false),
+        ]
+      end
+
+      def self.is_supported?(platform)
+        # Adjust this if your plugin only works for a particular platform (iOS vs. Android, for example)
+        # See: https://docs.fastlane.tools/advanced/#control-configuration-by-lane-and-by-platform
+        #
+        [:ios, :android].include?(platform)
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/react_native_release/helper/react_native_release_helper.rb

@@ -0,0 +1,16 @@
+require 'fastlane_core/ui/ui'
+
+module Fastlane
+  UI = FastlaneCore::UI unless Fastlane.const_defined?("UI")
+
+  module Helper
+    class ReactNativeReleaseHelper
+      # class methods that you define here become available in your action
+      # as `Helper::ReactNativeReleaseHelper.your_method`
+      #
+      def self.show_message
+        UI.message("Hello from the react_native_release plugin helper!")
+      end
+    end
+  end
+end

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

@@ -0,0 +1,5 @@
+module Fastlane
+  module ReactNativeRelease
+    VERSION = "0.1.0"
+  end
+end

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-react_native_release
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chris Ball
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fastlane-plugin-android_versioning
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+- !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: rspec_junit_formatter
+  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.49.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.49.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-require_tools
+  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: simplecov
+  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.112.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.112.0
+description: 
+email: chris@echobind.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/react_native_release.rb
+- lib/fastlane/plugin/react_native_release/actions/react_native_release_action.rb
+- lib/fastlane/plugin/react_native_release/helper/react_native_release_helper.rb
+- lib/fastlane/plugin/react_native_release/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.7.6
+signing_key: 
+specification_version: 4
+summary: Simplify releases for React Native apps.
+test_files: []