fastlane-plugin-flutter_version 0.1.7 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 445078ef94413aa065dbbd9b3a6fb3d1c486b1c32a9a743ed68be6b935dc3b73
-  data.tar.gz: 2548b3d07141f63f797bbf35bc1529c96dce2ae76751034fcc1a66e9e040024a
+  metadata.gz: 898a0c032e445d7c6cd206e7390331c3626d5c67bd42b8e6333ceddb12098670
+  data.tar.gz: ecc9f689ab65e73e8b01076abd79ebadf3704b75a7c0e5306f0231daa434e69f
 SHA512:
-  metadata.gz: 7c54234649873f8208cc9d95a1c2f381d18f986218c30ad222f339c525e28378a99474c8fbb9a8ecb60e306779304b1097b844261249bdb8e46259d14c7410b8
-  data.tar.gz: 416883e194008876bbd5c27e69343ad8d93644a8d09bbe9ca3af0da1c619e5496373690820da95cdbe914ae7a89f7cb2fa9c41480cedea1b958fa486ef835ec5
+  metadata.gz: 9b57ed28418567ae153861bdd896ececf0a67140b546c13ded3dc368dc517b547782d97b7721196398dd8ba8cfe6123e843f1630e4cd343707355d467a4ecc65
+  data.tar.gz: d57b106d02279bb17cf7e782fc0e5744105dd01d959e65c8f286f748b50ecff65493e6cb4fe9011e5f3604e9af94939524afdbd7f9bde9a54b8314c445fd210b

data/README.md

@@ -1,52 +1,154 @@
-# flutter_version plugin
+# flutter_version (Fastlane plugin)
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-8-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 [![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-flutter_version)
 [![Gitpod Ready-to-Code](https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/tianhaoz95/fastlane-plugin-flutter_version) 
+[![codecov](https://codecov.io/gh/tianhaoz95/fastlane-plugin-flutter_version/branch/master/graph/badge.svg)](https://codecov.io/gh/tianhaoz95/fastlane-plugin-flutter_version)
 
 flutter_version is a Fastlane plugin to retrieve version code from Flutter projects which can be used to release changlogs and other metadata to marketplaces.
 
-## Getting Started
+## Installation
 
 This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-flutter_version`, add it to your project by adding the following lines in `Gemfile`:
 
-```Gemfile
-gem "fastlane-plugin-flutter_version", git: "https://github.com/tianhaoz95/fastlane-plugin-flutter-version"
-```
+### From GitHub registry (recommended)
 
-## About flutter_version
+Install from the command line:
+
+```bash
+gem install fastlane-plugin-flutter_version --version "1.0.0" --source "https://rubygems.pkg.github.com/tianhaoz95"
+```
 
-A plugin to retrieve versioning information for Flutter projects.
+Install via Gemfile:
 
-## Example
+```bash
+source "https://rubygems.pkg.github.com/tianhaoz95" do
+  gem "fastlane-plugin-flutter_version", "1.0.0"
+end
+```
 
-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`.
+Check out the instructions in [GitHub Registry](https://github.com/tianhaoz95/fastlane-plugin-flutter_version/packages/143774).
 
-## Run tests for this plugin
+### From RubyGems registry
 
-To run both the tests, and code style validation, run
+Install from the command line:
 
+```bash
+gem install fastlane-plugin-flutter_version
 ```
-rake
+
+Install via Gemfile:
+
+```bash
+gem 'fastlane-plugin-flutter_version', '~> 1.0', '>= 1.0.1'
 ```
 
-To automatically fix many of the styling issues, use
+Check out the instructions [here](https://rubygems.org/gems/fastlane-plugin-flutter_version).
 
+### Directly from Github
+
+```Gemfile
+gem "fastlane-plugin-flutter_version", git: "https://github.com/tianhaoz95/fastlane-plugin-flutter-version"
 ```
-rubocop -a
+
+## Usage
+
+### Android example
+
+The following example releases a Android app to Google Play Store without needing to manually specify the app version:
+
+```ruby
+desc "submit to internal track in Google Play Store"
+lane :internal do
+  Dir.chdir "../.." do sh("flutter", "build", "appbundle", "--release") end # Call Flutter Build
+  gradle(task: 'bundle', build_type: 'Release')
+  upload_to_play_store(
+    track: 'internal',
+    version_code: flutter_version()["version_code"],
+    aab: '../build/app/outputs/bundle/release/app-release.aab',
+    skip_upload_screenshots: true,
+    skip_upload_images: true
+  )
+end
 ```
 
-## Issues and Feedback
+The line `flutter_version()` fetches the version information from the `pubspec.yaml` file from the Flutter project and parses the version information from the file. This is convenient for continuous integration because it saves the effort for developers to keep track of version information in multiple places.
+
+For more details, check out the [example project configuration](https://github.com/tianhaoz95/photochat/blob/master/photochatapp/android/fastlane/Fastfile).
+
+### iOS example
+
+The following example releases an iOS app to TestFlight without needing to manually specify the app version or build number:
+
+```ruby
+desc "submit to TestFlight"
+lane :internal do
+  Dir.chdir "../.." do sh("flutter", "build", "ios", "--release", "--no-codesign") end # Call Flutter Build
+  # https://docs.fastlane.tools/actions/increment_version_number/
+  increment_version_number(
+    xcodeproj: "Runner.xcodeproj",
+    version_number: flutter_version()["version_name"] # Set a specific version number
+  )
+  # https://docs.fastlane.tools/actions/increment_build_number/
+  increment_build_number(
+    xcodeproj: "Runner.xcodeproj",
+    build_number: flutter_version()["version_code"] # Set a specific build number
+  )
+  build_app(workspace: "Runner.xcworkspace", export_method: "app-store")
+  upload_to_testflight
+end
+```
+
+### Available options
+
+| Name | Description | Optional | Type | Default |
+|:---:|:---:|:---:|:---:|:---:|
+| `pubspec_location` | The location of the `pubspec.yaml` file (relative to `Fastfile`). For details, see [here](https://tianhaoz.com/fastlane-plugin-flutter_version/#/options?id=flutter-config-file-location). | :white_check_mark: | `String` | `../pubspec.yaml` |
+| `should_omit_version_code` | If the version code should be omitted for projects that do not use a version code. For details, see [here](https://tianhaoz.com/fastlane-plugin-flutter_version/#/options?id=version-code-omission). | :white_check_mark: | `Boolean` | `false` |
 
-For any other issues and feedback about this plugin, please submit it to this repository.
+## About Fastlane
 
-## Troubleshooting
+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).
+
+### Issues and feedback
+
+For any other issues and feedback about this plugin, please submit it to [this repository](https://github.com/tianhaoz95/fastlane-plugin-flutter_version).
+
+### Troubleshooting
 
 If you have trouble using plugins, check out the [Plugins Troubleshooting](https://docs.fastlane.tools/plugins/plugins-troubleshooting/) guide.
 
-## Using _fastlane_ Plugins
+### 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).
+## Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://www.shunkakinoki.com/"><img src="https://avatars0.githubusercontent.com/u/39187513?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Shun Kakinoki</b></sub></a><br /><a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/commits?author=shunkakinoki" title="Code">💻</a></td>
+    <td align="center"><a href="http://tianhaoz.com"><img src="https://avatars3.githubusercontent.com/u/16887772?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tianhao Zhou</b></sub></a><br /><a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/commits?author=tianhaoz95" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/davidbrenner"><img src="https://avatars3.githubusercontent.com/u/236870?v=4?s=100" width="100px;" alt=""/><br /><sub><b>davidbrenner</b></sub></a><br /><a href="#ideas-davidbrenner" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/commits?author=davidbrenner" title="Documentation">📖</a></td>
+    <td align="center"><a href="http://lahaus.com"><img src="https://avatars2.githubusercontent.com/u/76348?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Daniel Gomez</b></sub></a><br /><a href="#ideas-danielgomezrico" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://github.com/RtypeStudios"><img src="https://avatars3.githubusercontent.com/u/990114?v=4?s=100" width="100px;" alt=""/><br /><sub><b>RtypeStudios</b></sub></a><br /><a href="#question-RtypeStudios" title="Answering Questions">💬</a> <a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/commits?author=RtypeStudios" title="Documentation">📖</a> <a href="#tutorial-RtypeStudios" title="Tutorials">✅</a></td>
+    <td align="center"><a href="https://github.com/M123-dev"><img src="https://avatars.githubusercontent.com/u/39344769?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Marvin M</b></sub></a><br /><a href="#ideas-M123-dev" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://www.upwork.com/o/profiles/users/~015f2268be670e1246/"><img src="https://avatars.githubusercontent.com/u/8264639?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Muhammad Adil</b></sub></a><br /><a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/commits?author=ch-muhammad-adil" title="Documentation">📖</a> <a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/issues?q=author%3Ach-muhammad-adil" title="Bug reports">🐛</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://lesliearkorful.com"><img src="https://avatars.githubusercontent.com/u/4087388?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Leslie Arkorful</b></sub></a><br /><a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/issues?q=author%3Alesliearkorful" title="Bug reports">🐛</a> <a href="https://github.com/tianhaoz95/fastlane-plugin-flutter_version/commits?author=lesliearkorful" title="Documentation">📖</a></td>
+  </tr>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

data/lib/fastlane/plugin/flutter_version.rb

@@ -1,10 +1,13 @@
-require "fastlane/plugin/flutter_version/version"
+# frozen_string_literal: true
+
+require 'fastlane/plugin/flutter_version/version'
 
 module Fastlane
+  # The plugin wrapper
   module FlutterVersion
     # Return all .rb files inside the "actions" and "helper" directory
     def self.all_classes
-      Dir[File.expand_path("**/{actions,helper}/*.rb", File.dirname(__FILE__))]
+      Dir[File.expand_path('**/{actions,helper}/*.rb', File.dirname(__FILE__))]
     end
   end
 end

data/lib/fastlane/plugin/flutter_version/actions/flutter_version_action.rb

@@ -1,63 +1,96 @@
-require "fastlane/action"
-require "yaml"
-require_relative "../helper/flutter_version_helper"
+# frozen_string_literal: true
+
+require 'fastlane/action'
+require 'yaml'
+require_relative '../helper/flutter_version_helper'
 
 module Fastlane
   module Actions
+    # The top-level plugin interface
     class FlutterVersionAction < Action
       def self.run(params)
         pubspec_location = params[:pubspec_location]
-        pubspec = YAML.load_file(pubspec_location)
-        version = pubspec["version"]
-        UI.message("The full version is: ".concat(version))
-        if not version.include? "+"
-          raise "Verson code indicator (+) not found in pubspec.yml"
+        should_omit_version_code = params[:should_omit_version_code]
+        begin
+          pubspec = YAML.load_file(pubspec_location)
+        # rubocop:disable Style/RescueStandardError
+        rescue
+          raise 'Read pubspec.yaml failed'
+        end
+        # rubocop:enable Style/RescueStandardError
+        version = pubspec['version']
+        UI.message('The full version is: '.dup.concat(version))
+        has_version_code_pattern = version.include?('+')
+        if should_omit_version_code && has_version_code_pattern
+          raise 'Version code omitted but verson code indicator (+) found in pubspec.yml'
+        end
+        if !should_omit_version_code && !has_version_code_pattern
+          raise 'Verson code indicator (+) not found in pubspec.yml'
         end
-        version_sections = version.split("+")
+
+        version_sections = if should_omit_version_code
+                             [version, 'NOT_FOUND']
+                           else
+                             version.split('+')
+                           end
         version_name = version_sections[0]
         version_code = version_sections[1]
-        UI.message("The version name: ".concat(version_name))
-        UI.message("The version code: ".concat(version_code))
-        return {
-                 "version_code" => version_code,
-                 "version_name" => version_name,
-               }
+        UI.message('The version name: '.dup.concat(version_name))
+        UI.message('The version code: '.dup.concat(version_code))
+        {
+          'version_code' => version_code,
+          'version_name' => version_name
+        }
       end
 
       def self.description
-        "A plugin to retrieve versioning information for Flutter projects."
+        'A plugin to retrieve versioning information for Flutter projects.'
       end
 
       def self.authors
-        ["tianhaoz95"]
+        ['tianhaoz95']
       end
 
       def self.return_value
         [
-          ["VERSION_CODE", "The version code"],
+          ['VERSION_CODE', 'The version code'],
+          ['VERSION_NAME', 'The verison name']
         ]
       end
 
       def self.details
-        "The plugin reads and parses pubspec.yml of a Flutter project and composes the versioning information into structured data to be consumed by various releasing automations."
+        "The plugin reads and parses pubspec.yml of a Flutter
+        project and composes the versioning information into
+        structured data to be consumed by various releasing
+        automations."
       end
 
       def self.available_options
         [
           FastlaneCore::ConfigItem.new(
             key: :pubspec_location,
-            env_name: "PUBSPEC_LOCATION",
-            description: "The location of pubspec.yml",
+            env_name: 'PUBSPEC_LOCATION',
+            description: 'The location of pubspec.yml',
             optional: true,
             type: String,
-            default_value: "../pubspec.yaml",
+            default_value: '../pubspec.yaml'
           ),
+          FastlaneCore::ConfigItem.new(
+            key: :should_omit_version_code,
+            env_name: 'SHOULD_OMIT_VERSION_CODE',
+            description: 'If the version code should be omitted for projects that do not use a version code',
+            optional: true,
+            type: Boolean,
+            default_value: false
+          )
         ]
       end
 
-      def self.is_supported?(platform)
+      # rubocop:disable Naming/PredicateName
+      def self.is_supported?(_platform)
         true
       end
+      # rubocop:enable Naming/PredicateName
     end
   end
 end

data/lib/fastlane/plugin/flutter_version/helper/flutter_version_helper.rb

@@ -1,15 +1,18 @@
-require "fastlane_core/ui/ui"
+# frozen_string_literal: true
 
+require 'fastlane_core/ui/ui'
+
+# Fastlane namespace
 module Fastlane
-  UI = FastlaneCore::UI unless Fastlane.const_defined?("UI")
+  UI = FastlaneCore::UI unless Fastlane.const_defined?('UI')
 
   module Helper
+    # Generated helper function for the plugin
     class FlutterVersionHelper
       # class methods that you define here become available in your action
       # as `Helper::FlutterVersionHelper.your_method`
-      #
       def self.show_message
-        UI.message("Hello from the flutter_version plugin helper!")
+        UI.message('Hello from the flutter_version plugin helper!')
       end
     end
   end

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

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 module Fastlane
   module FlutterVersion
-    VERSION = "0.1.7"
+    VERSION = '1.1.3'
   end
 end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-flutter_version
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 1.1.3
 platform: ruby
 authors:
 - tianhaoz95
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-29 00:00:00.000000000 Z
+date: 2021-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -25,21 +25,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: fastlane
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.142.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.142.0
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec_junit_formatter
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,21 +81,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rspec_junit_formatter
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.80.1
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.80.1
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-require_tools
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -109,7 +109,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: rubocop-require_tools
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -123,19 +123,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: fastlane
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.142.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.142.0
+        version: '0'
 description: 
 email: tianhaoz@umich.edu
 executables: []
@@ -160,14 +160,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
 summary: A plugin to retrieve versioning information for Flutter projects.