fastlane-plugin-unity_exporter 1.0.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53984aaa0c3d1121abe876780db89b6921543cc1128314feb8e8b519418a8027
-  data.tar.gz: d581d86006135f3b1d10dcd52d9beceb58463ea6c7702e7d800f7caf299a778e
+  metadata.gz: 5f871c4202b1c52b9d5d719312834f66f9374a6a16319925a6e39d5d3f87f258
+  data.tar.gz: 6c74a627ee70148c1b27d52421f5bf275d5ce2405c60588db6abeee04dcded2e
 SHA512:
-  metadata.gz: dde31fb51816bc84aca04166bf1cdb7c53e6092b94104eb046b7663e30f0b319d32d1cb54fdbe6a3480f04b7a3bc552c6a13235245aa44af68cfd594161b89a1
-  data.tar.gz: dfbf63a88dd528cd0cfc258e2d3e6d0dcbf302e111273990c57814c78a85eafd690b8dcab40fc404922c24a085f181965aa3f9a276f467ab8b6c5dd79d26234d
+  metadata.gz: e62253ae48ffaa41ee6a62ce09e91b0d10dcc610e05216ddec73414ea2f1d295263c95117289fd9ca33c0622036f98e9e7d44cddb3fedf360e4245378a569aa9
+  data.tar.gz: 3ce7dc870812337f11e80c9de94910697b47278dc98b31d51dbffe7b5006516bbb7b07342693269ee624d818000a931c4d31c9e4fecb4d4a9e63d6ae8e916482

data/README.md

@@ -88,8 +88,21 @@ unity_export(build_target: "...", new_version_code: "42")
 # increments the existing version code (Android) and build number (iOS)
 unity_export(build_target: "...", new_version_code: "increment")
 
-# combined usage of 'new_version' and 'new_version_code'
-unity_export(build_target: "...", new_version: "2.3.4", new_version_code: "0")
+# the expected default path is in accordance with the "getting started" section of this readme
+# if a custom path to the Unity project is required, it's specified this way
+# note that the starting point for relative paths is the directory that contains the 'fastlane' folder
+unity_export(build_target: "...", project_path: "path/some-example-unity-projects-directory")
+
+# exports the Unity project to the specified path
+# if no export path is specified, a default path will be used
+# note that the starting point for relative paths is the root of the Unity project
+unity_export(build_target: "...", export_path: "path/some-example-builds-directory")
+
+# combined usage of 'new_version', 'new_version_code', 'project_path' and 'export_path'
+unity_export(
+  build_target: "...", 
+  new_version: "2.3.4", new_version_code: "0", 
+  project_path: "path/Unity-project", export_path: "path/Builds")
 ```
 
 ### Using `unity_commit_version_bump`
@@ -104,10 +117,27 @@ unity_export(build_target: "...", new_version: "3.4.5", new_version_code: "0")
 unity_commit_version_bump
 ```
 
+### Using `unity_get_version_number`
 
-## Compatibility
+```ruby
+# you must first use the unity export action
+unity_export(...)
 
-Both this _fastlane plugin_ and the [_Unity Build Exporter_](https://github.com/ar-met/unity-build-exporter) were developed with _Unity 2020.3.13f1_. We haven't tested the plugin with any earlier versions, but we don't expect there to be any issues. If you run into trouble, regarding compatibility or anything else, [please open an issue](https://github.com/ar-met/unity-build-exporter/issues). For pull requests [see here](#pull-requests).
+# afterwards you can get the version number like so
+# note that an error code will be returned if something fails
+version_number = unity_get_version_number
+```
+
+### Using `unity_get_build_number`
+
+```ruby
+# you must first use the unity export action
+unity_export(...)
+
+# afterwards you can get the build number like so
+# note that an error code will be returned if something fails
+build_number = unity_get_build_number
+```
 
 
 ## Example
@@ -117,6 +147,24 @@ Check out the [example `Fastfile`](fastlane/Fastfile) to see how to use this plu
 Also check out the example [_Unity3d_ project](https://github.com/ar-met/fastlane-plugin-unity-exporter-example-project) to see how this plugin works. See the repositories readme for more details.
 
 
+## Compatibility
+
+Both this _fastlane plugin_ and the [_Unity Build Exporter_](https://github.com/ar-met/unity-build-exporter) were developed with _Unity 2020.3.13f1_. We haven't tested the plugin with any earlier versions, but we don't expect there to be any issues. If you run into trouble, regarding compatibility or anything else, [please open an issue](https://github.com/ar-met/unity-build-exporter/issues). For pull requests [see here](#pull-requests).
+
+
+## Ruby
+
+Note that this plugin requires `Ruby 2.7.4`. 
+
+### Ruby on Mac
+
+Installing ruby -- even different versions of it -- on Mac and _fastlane_ is well documented.
+
+### Ruby on Windows
+
+To install ruby on Windows you, e.g., can use [_RubyInstaller_](https://rubyinstaller.org/downloads/). Be sure to get `Ruby 2.7.4`. After that you can use `gem` commands with Windows' command prompt and rely on _fastlane_'s documentation to get you going.
+
+
 ## Pull requests
 
 We are happy to accept [pull requests](https://github.com/ar-met/unity-build-exporter/pulls). For easier development of this plugin, we suggest you use the provided [_Unity3d_ project](https://github.com/ar-met/fastlane-plugin-unity-exporter-dev-project).

data/lib/fastlane/plugin/unity_exporter/actions/unity_commit_version_bump.rb

@@ -1,5 +1,6 @@
 require 'fastlane/action'
 require_relative '../helper/unity_editor_helper'
+require_relative '../helper/generic_helper'
 
 module Fastlane
   module Actions
@@ -8,11 +9,11 @@ module Fastlane
         # TODO: improve the commit command: currently it simply commits the ProjectSettings file
         #      what if there are other changes in the file and you don't want these changes to be part of the commit
 
-        log_file = "unity-export-logs/#{DateTime.now.strftime('%Y-%m-%d_%H-%M-%S-%L')}_git.log"
+        log_file = Helper::GenericHelper.instance_variable_get(:@git_log_path)
 
         # Thank you: https://linuxize.com/post/bash-redirect-stderr-stdout/#redirecting-stderr-to-stdout
         sh("echo 'UnityCommitVersionBumpAction: created file' > #{log_file} 2>&1")
-        sh("git add '#{Helper::UnityEditorHelper.unity_project_path_relative_to_fastfile}ProjectSettings/ProjectSettings.asset' >> #{log_file} 2>&1")
+        sh("git add '#{Helper::UnityEditorHelper.unity_project_path}ProjectSettings/ProjectSettings.asset' >> #{log_file} 2>&1")
         sh("git commit -m 'Version Bump' >> #{log_file} 2>&1")
       end
 

data/lib/fastlane/plugin/unity_exporter/actions/unity_export.rb

@@ -17,11 +17,15 @@ module Fastlane
           end
 
         elsif params[:build_target]
+          if params[:project_path]
+            Helper::UnityEditorHelper.instance_variable_set(:@project_path, params[:project_path])
+          end
+
           # following are arguments as defined in the docs: https://docs.unity3d.com/Manual/CommandLineArguments.html
           headless_args = "-buildTarget #{params[:build_target]}"
           headless_args << " -batchmode -nographics -quit" # some arguments that are required when running Unity in headless-mode
           headless_args << " -accept-apiupdate -releaseCodeOptimization"
-          headless_args << " -projectPath #{Helper::UnityEditorHelper.unity_project_path_relative_to_fastfile}"
+          headless_args << " -projectPath #{Helper::UnityEditorHelper.unity_project_path}"
           headless_args << " -logFile unity-export-logs/#{DateTime.now.strftime('%Y-%m-%d_%H-%M-%S-%L')}_#{params[:build_target]}_build.log" # logging; not specifying a path will print the log to the console
 
           # following are custom arguments defined in 'UnityExporter.BuildUtility'
@@ -29,7 +33,12 @@ module Fastlane
           headless_args << " -executeMethod armet.BuildExporter.BuildUtility.CreateBuild"
           headless_args << " -newVersion #{params[:new_version]}" if params[:new_version]
           headless_args << " -newVersionCode #{params[:new_version_code]}" if params[:new_version_code]
-          headless_args << " -exportPath fastlane-build-exporter/#{params[:build_target]}/unity-export"
+
+          if params[:export_path]
+            headless_args << " -exportPath #{params[:export_path]}"
+          else
+            headless_args << " -exportPath fastlane-build-exporter/#{params[:build_target]}/unity-export"
+          end
 
           # NOTE: the different relative paths used in 'projectPath' and 'exportPath'
           # while 'projectPath' is relative to the 'fastfile',
@@ -62,7 +71,7 @@ module Fastlane
           return
         end
 
-        UI.message("Open 'logFile', if you want to know whats going on with your build.")
+        UI.message("Open 'logFile', if you want to know whats going on with your build. Look for its path in the invocation of the next line.")
         invocation = unity_path.to_s
         invocation << " #{params[:arguments]}"
         sh(invocation) # 'sh' will print what's passed to it
@@ -159,7 +168,21 @@ module Fastlane
                                              UI.user_error!("Please pass a valid version code. For options see 'fastlane action unity_exporter'")
                                            end
                                          end
-                                       end)
+                                       end),
+
+          FastlaneCore::ConfigItem.new(key: :project_path,
+                                       env_name: "FL_UNITY_PROJECT_PATH",
+                                       description: "The path to the Unity project. The starting point for relative paths is the directory that contains the 'fastlane' folder",
+                                       optional: true,
+                                       type: String,
+                                       conflicting_options: [:arguments]),
+
+          FastlaneCore::ConfigItem.new(key: :export_path,
+                                       env_name: "FL_UNITY_EXPORT_PATH",
+                                       description: "The path to the exported Unity project. The starting point for relative paths is the root of the Unity project",
+                                       optional: true,
+                                       type: String,
+                                       conflicting_options: [:arguments])
         ]
       end
 

data/lib/fastlane/plugin/unity_exporter/actions/unity_get_build_number.rb

@@ -0,0 +1,44 @@
+require 'fastlane/action'
+require_relative '../helper/unity_editor_helper'
+require_relative '../helper/generic_helper'
+
+module Fastlane
+  module Actions
+    class UnityGetBuildNumberAction < Action
+      def self.run(params)
+        build_number = Helper::GenericHelper.build_exporter_build_number
+        if build_number == ""
+          return "unity_exporter_error_occurred"
+        end
+
+        return build_number
+      end
+
+      def self.description
+        "Will get the build number that was used for the latest Unity export action. Therefore make sure to call the Unity export action before you use this action."
+      end
+
+      def self.authors
+        ["steft"]
+      end
+
+      def self.return_value
+        "Returns the build number that was used for the latest Unity export action. In case of error will return 'unity_exporter_error_occurred'."
+      end
+
+      def self.details
+        # Optional:
+      end
+
+      def self.available_options
+      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)
+        true
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/unity_exporter/actions/unity_get_version_number.rb

@@ -0,0 +1,44 @@
+require 'fastlane/action'
+require_relative '../helper/unity_editor_helper'
+require_relative '../helper/generic_helper'
+
+module Fastlane
+  module Actions
+    class UnityGetVersionNumberAction < Action
+      def self.run(params)
+        version_number = Helper::GenericHelper.build_exporter_version_number
+        if version_number == ""
+          return "unity_exporter_error_occurred"
+        end
+
+        return version_number
+      end
+
+      def self.description
+        "Will get the version number that was used for the latest Unity export action. Therefore make sure to call the Unity export action before you use this action."
+      end
+
+      def self.authors
+        ["steft"]
+      end
+
+      def self.return_value
+        "Returns the version number that was used for the latest Unity export action. In case of error will return 'unity_exporter_error_occurred'."
+      end
+
+      def self.details
+        # Optional:
+      end
+
+      def self.available_options
+      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)
+        true
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/unity_exporter/helper/generic_helper.rb

@@ -1,11 +1,46 @@
 require 'fastlane_core/ui/ui'
 require 'shellwords'
+require_relative './unity_editor_helper'
 
 module Fastlane
   UI = FastlaneCore::UI unless Fastlane.const_defined?("UI")
 
   module Helper
     class GenericHelper
+      @git_log_path = "fastlane-unity-exporter/logs/#{DateTime.now.strftime('%Y-%m-%d_%H-%M-%S-%L')}_git.log"
+
+      def self.build_exporter_versions
+        # this is created and updated whenever you create a build via the build exporter
+        build_exporter_versions_file = "#{Helper::UnityEditorHelper.unity_project_path}/BuildExporter/latest-build-version.txt"
+
+        if File.file?(build_exporter_versions_file)
+          return File.readlines(build_exporter_versions_file, chomp: true)
+        else
+          UI.user_error!("Versions file does not exist yet. You must execute the Unity export action beforehand.")
+          return []
+        end
+      end
+
+      def self.build_exporter_version_number
+        versions = build_exporter_versions
+
+        if versions.count > 0
+          return versions[0]
+        else
+          return ""
+        end
+      end
+
+      def self.build_exporter_build_number
+        versions = build_exporter_versions
+
+        if versions.count > 0
+          return versions[1]
+        else
+          return ""
+        end
+      end
+
       def self.shellify(path)
         if FastlaneCore::Helper.is_mac?
           return Shellwords.escape(path)

data/lib/fastlane/plugin/unity_exporter/helper/unity_editor_helper.rb

@@ -8,9 +8,14 @@ module Fastlane
 
   module Helper
     class UnityEditorHelper
-      def self.unity_project_path_relative_to_fastfile
-        # project path relative if following hierarchy is given: "root/{unity-project}/fastlane-build-exporter/{platform}-export/."
-        # p File.expand_path("../../")
+      # project path relative if following hierarchy is given: "root/{unity-project}/fastlane-build-exporter/{platform}-export/."
+      # p File.expand_path("../../")
+      @project_path_default = "../../"
+      @project_path = ""
+
+      def self.unity_project_path
+        return @project_path if @project_path != ""
+
         return "../../"
       end
 
@@ -46,6 +51,7 @@ module Fastlane
         # TODO Unity currently does not support commandline arguments for the Package Manager
         exporter_package_namespace = "io.armet.unity.buildexporter"
         included = load_unity_project_package_manifest.include?(exporter_package_namespace)
+        # UI.message("exporter package part of Unity project: '#{included}'")
         unless included
           UI.user_error!("Package 'io.armet.unity.exporter' must be added to the Unity project.")
         end
@@ -57,19 +63,25 @@ module Fastlane
         relative_path = if FastlaneCore::Helper.is_test?
                           "/tmp/fastlane/tests/fixtures/unity_project"
                         else
-                          unity_project_path_relative_to_fastfile
+                          unity_project_path
                         end
 
         package_manifest_path = "#{relative_path}/Packages/manifest.json"
-        package_manifest_json = File.read(package_manifest_path)
-        return package_manifest_json
+
+        # we verify the path to the Unity project by looking for the 'manifest.json' file
+        if File.file?(package_manifest_path)
+          return File.read(package_manifest_path)
+        else
+          UI.user_error!("Cannot find 'manifest.json' at '#{package_manifest_path}'. Make sure that the Unity project path is properly set.")
+          return ""
+        end
       end
 
       def self.load_unity_project_version
         relative_path = if FastlaneCore::Helper.is_test?
                           "/tmp/fastlane/tests/fixtures/unity_project"
                         else
-                          unity_project_path_relative_to_fastfile
+                          unity_project_path
                         end
 
         project_version_txt_path = "#{relative_path}/ProjectSettings/ProjectVersion.txt"

data/lib/fastlane/plugin/unity_exporter/helper/unity_hub_helper.rb

@@ -28,7 +28,7 @@ module Fastlane
 
       def self.verify_default_path
         # verifies that the Unity Hub exists at the default path
-        exists = File.file?(Helper::UnityHubHelper.unity_hub_path(false)) == true
+        exists = File.file?(Helper::UnityHubHelper.unity_hub_path(false))
         unless exists
           UI.error("Unity Hub does not exist at path '#{Helper::UnityHubHelper.unity_hub_path(false)}'")
         end

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

@@ -1,5 +1,5 @@
 module Fastlane
   module UnityExporter
-    VERSION = "1.0.2"
+    VERSION = "1.2.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-unity_exporter
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.2.0
 platform: ruby
 authors:
 - ar:met
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-27 00:00:00.000000000 Z
+date: 2022-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -161,6 +161,8 @@ files:
 - lib/fastlane/plugin/unity_exporter.rb
 - lib/fastlane/plugin/unity_exporter/actions/unity_commit_version_bump.rb
 - lib/fastlane/plugin/unity_exporter/actions/unity_export.rb
+- lib/fastlane/plugin/unity_exporter/actions/unity_get_build_number.rb
+- lib/fastlane/plugin/unity_exporter/actions/unity_get_version_number.rb
 - lib/fastlane/plugin/unity_exporter/helper/generic_helper.rb
 - lib/fastlane/plugin/unity_exporter/helper/unity_editor_helper.rb
 - lib/fastlane/plugin/unity_exporter/helper/unity_hub_helper.rb