fastlane-plugin-altoolalt 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ce6c8c68423d1ba9017e5436c69fa012acf28cece7ac7553656bc49fbfcee8c0
+  data.tar.gz: b841d6b1d472a044ed2c76ca827bba773fa9e7d151f7648d46856d70b9d70743
+SHA512:
+  metadata.gz: eb1fa24f8b367aab99595e47485cc29465c5d6dedb52426c46f367f50002fd4327e88e4c12f3efff1becb8d119a46ee052d752c391872f317912e6f350b2b26f
+  data.tar.gz: 5189d9630f9ba82dbcddf31be0d40d71adb28d1239609d1c31d87734124d1ada5b2bb6c64bea66b3956ec67047e7a667a6c46011e68707bc080196344fa5d0eb

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Shashikant Jagtap <shashikant.jagtap@icloud.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,102 @@
+# altool plugin
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-altool)
+
+<a href="https://travis-ci.org/Shashikant86/fastlane-plugin-altool/"><img src="https://img.shields.io/travis/Shashikant86/fastlane-plugin-altool.svg" /></a>
+
+## Getting Started
+
+This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-altool`, add it to your project by running:
+
+```bash
+fastlane add_plugin altool
+```
+
+## Pre-requisite
+
+This plugin has configurable Apple ID and password but you probably don't want to hardcode that. You need to have Fastlane setup with `FASTLANE_USER` and `FASTLANE_PASSWORD` environmenal varibales setup. Fastlane will ask it when you run `fastlane init` but if not you have to set these variables.
+
+You can set that easily for bash shell
+
+```
+$ export FASTLANE_USER="your_apple_id@yourcompany.com";
+$ export FASTLANE_PASSWORD="your_super_xecret_password";
+```
+
+You can do the same for your choice of shell if you aren't using bash.
+
+
+## About altool
+
+This plugin can be used to upload IPA to iTunes Connect using altool.
+
+Currently Fastlane deliver uses iTMSTransporter to upload an ipa files to iTunes Connect but there is slick way to do this using `altool`
+
+This plugin can be used for uploading generated `ipa` file using Gym to iTunes Connect.
+
+This plugin assume that, you already have that Fastlane setup and your details are configured as ENV variables in `FASTLANE_USER` and `FASTLANE_PASSWORD` by default.
+
+
+## Usage
+
+You can configure this plugin using
+
+```ruby
+    altool(
+        username: ENV["FASTLANE_USER"],
+        password: ENV["FASTLANE_PASSWORD"],
+        app_type: "ios",
+        ipa_path: "./build/Your-ipa.ipa",
+        output_format: "xml",
+    )
+
+```
+
+OR
+
+```ruby
+    altool(
+        api_key_id: "<YOUR_API_KEY_ID>",
+        api_issuer: "<YOUR_API_ISSUER>",
+        app_type: "ios",
+        ipa_path: "./build/Your-ipa.ipa",
+        output_format: "xml",
+    )
+
+```
+Security Note:  
+
+This might print the username and password to build console in the commands, pipe the output to ` /dev/null` or use similar approach so that fastlane don't print command to console.
+
+## Example Project Repo
+
+This is a example project [Altool-Demo](https://github.com/Shashikant86/Altool-Demo) available on GitHub which has its own README.
+
+## 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/altoolalt/actions/altoolalt_action.rb

@@ -0,0 +1,149 @@
+require 'fastlane/action'
+require_relative '../helper/altoolalt_helper'
+
+module Fastlane
+  module Actions
+    class AltoolaltAction < Action
+      def self.run(params)
+        altool = `xcrun -f altool`.chomp
+        UI.message("altool binary doesn't exist at path: #{altool}") unless File.exist?(altool)
+
+        UI.message(" ----altool binary exists on your machine----- ")
+
+        app_type = params[:app_type]
+        ipa_path = "\"#{params[:ipa_path]}\""
+        output_format = params[:output_format]
+
+        UI.message("========Validating and Uploading your IPA file to iTunes Connect=========")
+        command = [
+          altool,
+          '--upload-app',
+          '-t',
+          app_type,
+          '-f',
+          ipa_path,
+          output_format
+        ]
+
+        api_key_id = params[:api_key_id]
+        api_issuer = params[:api_issuer]
+        if !api_key_id.to_s.empty? && !api_issuer.to_s.empty?
+          command += ['--apiKey', api_key_id, '--apiIssuer', api_issuer]
+        else
+          username = params[:username]
+          ENV["ALTOOL_PASSWORD"] = params[:password]
+          password = "@env:ALTOOL_PASSWORD"
+          if username.to_s.empty? || password.to_s.empty?
+            UI.user_error!("You must provide either api_key and api_issuer or username and password")
+          end
+          command += ['--username', username, '--password', password]
+        end
+
+        Actions.sh(command.join(' '))
+        UI.message("========It might take long time to fully upload your IPA file=========")
+      end
+
+      def self.description
+        "Upload IPA to iTunes Connect using altool"
+      end
+
+      def self.authors
+        ["Shashikant Jagtap", "Anand Biligiri", "Maksym Grebenets"]
+      end
+
+      def self.return_value
+        # If your method provides a return value, you can describe here what it does
+      end
+
+      def self.details
+        # Optional:
+        "This plugin can be used for uploading ipa files to iTunes Connect using altool rather than using ITMSTransporter.. Currently Fastlane deliver upload an ipa file using iTMSTransporter tool. There is another slick command line too called altool that can be used to upload ipa files as well"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :app_type,
+                                    env_name: "ALTOOL_APP_TYPE",
+                                    description: "Type or platform of application e.g osx, ios, appletvos ",
+                                    default_value: "ios",
+                                    is_string: true,
+                                    optional: true),
+
+          FastlaneCore::ConfigItem.new(key: :ipa_path,
+                                    env_name: "ALTOOL_IPA_PATH",
+                                    description: "Path to IPA file ",
+                                    is_string: true,
+                                    default_value: Dir["*.ipa"].sort_by { |x| File.mtime(x) }.last,
+                                    optional: false,
+                                    verify_block: proc do |value|
+                                      value = File.expand_path(value)
+                                      UI.user_error!("Could not find ipa file at path '#{value}'") unless File.exist?(value)
+                                      UI.user_error!("'#{value}' doesn't seem to be an ipa file") unless value.end_with?(".ipa")
+                                    end),
+
+          FastlaneCore::ConfigItem.new(key: :username,
+                                    env_name: "ALTOOL_USERNAME",
+                                    description: "Your Apple ID for iTunes Connects. This usually FASTLANE_USER environmental variable",
+                                    is_string: true,
+                                    default_value: ENV["FASTLANE_USER"],
+                                    optional: true),
+
+          FastlaneCore::ConfigItem.new(key: :password,
+                                    env_name: "ALTOOL_PASSWORD",
+                                    description: "Your Apple ID Password for iTunes Connects. This usually FASTLANE_PASSWORD environmental variable",
+                                    is_string: true,
+                                    default_value: ENV["FASTLANE_PASSWORD"],
+                                    optional: true),
+          
+          FastlaneCore::ConfigItem.new(key: :api_key_id,
+                                    env_name: "ALTOOL_API_KEY_ID",
+                                    description: "Only specify the Key ID without the AuthKey_ and .p8. Place the file in ~/private_keys/ or ~/.private_keys/ or ~/.appstoreconnect/private_keys/ or private_keys/ in directory where altool is excuted",
+                                    is_string: true,
+                                    default_value: ENV["ALTOOL_API_KEY"],
+                                    optional: true),
+
+          FastlaneCore::ConfigItem.new(key: :api_issuer,
+                                    env_name: "ALTOOL_API_ISSUER",
+                                    description: "API Issuer ID for App Store Connect API",
+                                    is_string: true,
+                                    optional: true),
+
+          FastlaneCore::ConfigItem.new(key: :output_format,
+                                    env_name: "ALTOOL_OUTPUT_FORMAT",
+                                    description: "Output formal xml or normal ",
+                                    default_value: "normal",
+                                    is_string: true,
+                                    optional: true)
+
+        ]
+      end
+
+      def self.example_code
+        ['   altool_alt(
+            username: ENV["FASTLANE_USER"],
+            password: ENV["FASTLANE_PASSWORD"],
+            app_type: "ios",
+            ipa_path: "./build/Your-ipa.ipa",
+            output_format: "xml",
+        )
+       ',
+         '   altool_alt(
+            api_key: "<YOUR_API_KEY_ID>",
+            api_issuer: "<YOUR_API_ISSUER>",
+            app_type: "ios",
+            ipa_path: "./build/Your-ipa.ipa",
+            output_format: "xml",
+        )'
+        ]
+      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, :mac, :android].include?(platform)
+        true
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/altoolalt/helper/altoolalt_helper.rb

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

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

@@ -0,0 +1,5 @@
+module Fastlane
+  module Altoolalt
+    VERSION = "1.2.0"
+  end
+end

data/lib/fastlane/plugin/altoolalt.rb

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

metadata

@@ -0,0 +1,174 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-altoolalt
+version: !ruby/object:Gem::Version
+  version: 1.2.0
+platform: ruby
+authors:
+- Anand Biligiri
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-07-21 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: 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.75.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.75.1
+description:
+email: abiligiri@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/altoolalt.rb
+- lib/fastlane/plugin/altoolalt/actions/altoolalt_action.rb
+- lib/fastlane/plugin/altoolalt/helper/altoolalt_helper.rb
+- lib/fastlane/plugin/altoolalt/version.rb
+homepage: https://github.com/abiligiri/fastlane-plugin-altool
+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: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Upload IPA to iTunes Connect using altool
+test_files: []