fastlane-plugin-airwatch_workspaceone 1.0.2 → 2.3.1

data/lib/fastlane/plugin/airwatch_workspaceone/actions/delete_specific_version_action.rb

@@ -0,0 +1,206 @@
+require 'fastlane/action'
+require_relative '../helper/airwatch_workspaceone_helper'
+
+module Fastlane
+  module Actions
+    class DeleteSpecificVersionAction < Action
+      
+      APP_VERSIONS_LIST_SUFFIX    = "/API/mam/apps/search?applicationtype=Internal&bundleid=%s"
+      INTERNAL_APP_DELETE_SUFFIX  = "/API/mam/apps/internal/%d"
+      
+      $is_debug = false
+
+      def self.run(params)
+        UI.message("The airwatch_workspaceone plugin is working!")
+
+        # check if debug is enabled
+        $is_debug = params[:debug]
+
+        if debug
+          UI.message("---------------------------------------------")
+          UI.message("DeleteSpecificVersionAction debug information")
+          UI.message("---------------------------------------------")
+          UI.message(" host_url: #{params[:host_url]}")
+          UI.message(" aw_tenant_code: #{params[:aw_tenant_code]}")
+          UI.message(" b64_encoded_auth: #{params[:b64_encoded_auth]}")
+          UI.message(" app_identifier: #{params[:app_identifier]}")
+          UI.message(" version_number: #{params[:version_number]}")
+        end
+
+        $host_url         = params[:host_url]
+        $aw_tenant_code   = params[:aw_tenant_code]
+        $b64_encoded_auth = params[:b64_encoded_auth]
+        app_identifier    = params[:app_identifier]
+        version_number    = params[:version_number]
+
+        # step 1: find app
+        UI.message("-----------------------")
+        UI.message("1. Finding app versions")
+        UI.message("-----------------------")
+
+        app_versions = find_app(app_identifier)
+        app_version_numbers = app_versions.map {|app_version| app_version.values[1]}
+        UI.success("Found %d app version(s)" % [app_versions.count])
+        UI.success("Version number(s): %s" % [app_version_numbers])
+
+        # step 2: delete specific version
+        UI.message("--------------------------------")
+        UI.message("2. Deleting specific app version")
+        UI.message("--------------------------------")
+
+        if app_version_numbers.include? version_number
+          version_index = app_version_numbers.index(version_number)
+          app_version_to_delete = app_versions[version_index]
+          delete_app(app_version_to_delete)
+        else
+          UI.user_error!("A version with the given version number: %s does not exist on the console for this application or is already deleted." % [version_number])
+        end
+
+        UI.success("Version %s successfully deleted" % [version_number])
+      end
+
+      def self.find_app(app_identifier)
+        # get the list of apps 
+        data = list_app_versions(app_identifier)
+        app_versions = Array.new
+
+        data['Application'].each do |app|
+          app_version = Hash.new
+          app_version['Id'] = app['Id']['Value']
+          app_version['Version'] = app['AppVersion']
+          app_versions << app_version
+        end
+
+        app_versions.sort_by! { |app_version| app_version["Id"] }
+        return app_versions
+      end
+
+      def self.list_app_versions(app_identifier)
+        require 'rest-client'
+        require 'json'
+        
+        response = RestClient.get($host_url + APP_VERSIONS_LIST_SUFFIX % [app_identifier], {accept: :json, 'aw-tenant-code': $aw_tenant_code, 'Authorization': "Basic " + $b64_encoded_auth})
+
+        if debug
+          UI.message("Response code: %d" % [response.code])
+          UI.message("Response body:")
+          UI.message(response.body)
+        end
+
+        if response.code != 200
+          UI.user_error!("There was an error in finding app versions. One possible reason is that an app with the bundle identifier given does not exist on Console.")
+          exit
+        end
+
+        json = JSON.parse(response.body)
+        return json
+      end
+
+      def self.delete_app(app_version)
+        require 'rest-client'
+        require 'json'
+
+        UI.message("Starting to delete app version: %s" % [app_version['Version']])
+        response = RestClient.delete($host_url + INTERNAL_APP_DELETE_SUFFIX % [app_version['Id']],  {accept: :json, 'aw-tenant-code': $aw_tenant_code, 'Authorization': "Basic " + $b64_encoded_auth})
+
+        if debug
+          UI.message("Response code: %d" % [response.code])
+        end
+
+        if response.code == 204
+          UI.message("Successfully deleted app version: %s" % [app_version['Version']])
+        else
+          UI.message("Failed to delete app version: %s" % [app_version['Version']])
+        end
+      end
+
+      def self.description
+        "The main purpose of this action is to delete a specific version of an application. This action takes a string parameter where you can specify the version number to delete."
+      end
+
+      def self.authors
+        ["Ram Awadhesh Sharan"]
+      end
+
+      def self.return_value
+        # If your method provides a return value, you can describe here what it does
+      end
+
+      def self.details
+        # Optional:
+        "delete_specific_version - To delete specific version of an application on the AirWatch/Workspace ONE console."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :host_url,
+                                  env_name: "AIRWATCH_HOST_API_URL",
+                               description: "Host API URL of the AirWatch/Workspace ONE instance without /API/ at the end",
+                                  optional: false,
+                                      type: String,
+                              verify_block: proc do |value|
+                                              UI.user_error!("No AirWatch/Workspace ONE Host API URl given, pass using `host_url: 'https://yourhost.com'`") unless value and !value.empty?
+                                            end),
+
+          FastlaneCore::ConfigItem.new(key: :aw_tenant_code,
+                                  env_name: "AIRWATCH_API_KEY",
+                               description: "API key or the tenant code to access AirWatch/Workspace ONE Rest APIs",
+                                  optional: false,
+                                      type: String,
+                              verify_block: proc do |value|
+                                              UI.user_error!("Api tenant code header is missing, pass using `aw_tenant_code: 'yourapikey'`") unless value and !value.empty?
+                                            end),
+
+          FastlaneCore::ConfigItem.new(key: :b64_encoded_auth,
+                                  env_name: "AIRWATCH_BASE64_ENCODED_BASIC_AUTH_STRING",
+                               description: "The base64 encoded Basic Auth string generated by authorizing username and password to the AirWatch/Workspace ONE instance",
+                                  optional: false,
+                                      type: String,
+                              verify_block: proc do |value|
+                                              UI.user_error!("The authorization header is empty or the scheme is not basic, pass using `b64_encoded_auth: 'yourb64encodedauthstring'`") unless value and !value.empty?
+                                            end),
+
+          FastlaneCore::ConfigItem.new(key: :app_identifier,
+                                  env_name: "APP_IDENTIFIER",
+                               description: "Bundle identifier of your app",
+                                  optional: false,
+                                      type: String,
+                              verify_block: proc do |value|
+                                              UI.user_error!("No app identifier given, pass using `app_identifier: 'com.example.app'`") unless value and !value.empty?
+                                            end),
+
+          FastlaneCore::ConfigItem.new(key: :version_number,
+                                  env_name: "AIRWATCH_VERSION_NUMBER",
+                               description: "Version number of the application to delete",
+                                  optional: false,
+                                      type: String,
+                              verify_block: proc do |value|
+                                              UI.user_error!("No version number given, pass using `version_number: '1.0'`") unless value and !value.empty?
+                                            end),
+
+          FastlaneCore::ConfigItem.new(key: :debug,
+                                  env_name: "AIRWATCH_DEBUG",
+                               description: "Debug flag, set to true to show extended output. default: false",
+                                  optional: true,
+                                 is_string: false,
+                             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)
+        true
+      end
+
+      # helpers
+      
+      def self.debug
+        $is_debug
+      end
+
+    end
+  end
+end

data/lib/fastlane/plugin/airwatch_workspaceone/actions/deploy_build_action.rb

@@ -5,12 +5,12 @@ module Fastlane
   module Actions
     class DeployBuildAction < Action
 
-      UPLOAD_BLOB_SUFFIX = "/API/mam/blobs/uploadblob?fileName=%s&organizationGroupId=%s"
-      BEGIN_INSTALL_SUFFIX = "/API/mam/apps/internal/begininstall"
+      UPLOAD_BLOB_SUFFIX    = "/API/mam/blobs/uploadblob?fileName=%s&organizationGroupId=%s"
+      BEGIN_INSTALL_SUFFIX  = "/API/mam/apps/internal/begininstall"
 
-      $is_debug = false
-      $device_type = "Apple"
-      $supported_device_models = Hash.new
+      $is_debug                 = false
+      $device_type              = "Apple"
+      $supported_device_models  = Hash.new
 
       def self.run(params)
         UI.message("The airwatch_workspaceone plugin is working!")
@@ -19,27 +19,28 @@ module Fastlane
         $is_debug = params[:debug]
 
         if debug
-          UI.message("---------------------------------")
-          UI.message("AirWatch plugin debug information")
-          UI.message("---------------------------------")
+          UI.message("-----------------------------------")
+          UI.message("DeployBuildAction debug information")
+          UI.message("-----------------------------------")
           UI.message(" host_url: #{params[:host_url]}")
           UI.message(" aw_tenant_code: #{params[:aw_tenant_code]}")
           UI.message(" b64_encoded_auth: #{params[:b64_encoded_auth]}")
+          UI.message(" organization_group_id: #{params[:org_group_id]}")
           UI.message(" app_name: #{params[:app_name]}")
+          UI.message(" app_version: #{params[:app_version]}")
           UI.message(" file_name: #{params[:file_name]}")
           UI.message(" path_to_file: #{params[:path_to_file]}")
-          UI.message(" organization_group_id: #{params[:org_group_id]}")
           UI.message(" push_mode: #{params[:push_mode]}")
-          UI.message("---------------------------------")
         end
 
-        host_url          = params[:host_url]
-        aw_tenant_code    = params[:aw_tenant_code]
-        b64_encoded_auth  = params[:b64_encoded_auth]
+        $host_url         = params[:host_url]
+        $aw_tenant_code   = params[:aw_tenant_code]
+        $b64_encoded_auth = params[:b64_encoded_auth]
+        $org_group_id     = params[:org_group_id]
         app_name          = params[:app_name]
+        app_version       = params[:app_version]
         file_name         = params[:file_name]
         path_to_file      = params[:path_to_file]
-        org_group_id      = params[:org_group_id]
         push_mode         = params[:push_mode]
 
         # step 1: determining device type
@@ -54,7 +55,7 @@ module Fastlane
         UI.message("2. Setting supported device models")
         UI.message("----------------------------------")
         $supported_device_models = find_supported_device_models(path_to_file)
-        UI.success("Supported Device Models are: %s" % [$supported_device_models.to_json])
+        UI.success("Supported Device Model(s): %s" % [$supported_device_models.to_json])
 
         # step 3: uploading app blob file
         UI.message("---------------------")
@@ -64,7 +65,7 @@ module Fastlane
           UI.message("3. Uploading IPA file")
         end
         UI.message("---------------------")
-        blobID = upload_blob(host_url, aw_tenant_code, b64_encoded_auth, file_name, path_to_file, org_group_id)
+        blobID = upload_blob(file_name, path_to_file)
 
         if $device_type == "Android"
           UI.success("Successfully uploaded apk blob")
@@ -77,10 +78,10 @@ module Fastlane
         end
 
         # step 4: deploying app version
-        UI.message("------------------------------------")
+        UI.message("-----------------------------------")
         UI.message("4. Deploying app version on console")
-        UI.message("------------------------------------")
-        deploy_app(host_url, aw_tenant_code, b64_encoded_auth, blobID, app_name, push_mode, org_group_id)
+        UI.message("-----------------------------------")
+        deploy_app(blobID, app_name, app_version, push_mode)
         UI.success("Successfully deployed the app version")
       end
 
@@ -134,21 +135,21 @@ module Fastlane
         return model_hash
       end
 
-      def self.upload_blob(host_url, aw_tenant_code, b64_encoded_auth, file_name, path_to_file, org_group_id)
+      def self.upload_blob(file_name, path_to_file)
         require 'rest-client'
         require 'json'
 
         response = RestClient::Request.execute(
-          :url => host_url + UPLOAD_BLOB_SUFFIX % [file_name, org_group_id],
-          :method => :post,
-          :headers => {
-            'Authorization' => "Basic " + b64_encoded_auth,
-            'aw-tenant-code' => aw_tenant_code,
-            'Accept' => 'application/json',
-            'Content-Type' => 'application/octet-stream',
-            'Expect' => '100-continue'
+          :url      => $host_url + UPLOAD_BLOB_SUFFIX % [file_name, $org_group_id],
+          :method   => :post,
+          :headers  => {
+            'Authorization'   => "Basic " + $b64_encoded_auth,
+            'aw-tenant-code'  => $aw_tenant_code,
+            'Accept'          => 'application/json',
+            'Content-Type'    => 'application/octet-stream',
+            'Expect'          => '100-continue'
           },
-          :payload => File.open(path_to_file, "rb")
+          :payload  => File.open(path_to_file, "rb")
         )
 
         if debug
@@ -161,17 +162,18 @@ module Fastlane
         return json['Value']
       end
 
-      def self.deploy_app(host_url, aw_tenant_code, b64_encoded_auth, blobID, app_name, push_mode, org_group_id)
+      def self.deploy_app(blobID, app_name, app_version, push_mode)
         require 'rest-client'
         require 'json'
 
         body = {
-          "BlobId" => blobID.to_s,
-          "DeviceType" => $device_type, 
+          "BlobId"          => blobID.to_s,
+          "DeviceType"      => $device_type, 
           "ApplicationName" => app_name,
+          "AppVersion"      => app_version,
           "SupportedModels" => $supported_device_models,
-          "PushMode" => push_mode,
-          "LocationGroupId" => org_group_id
+          "PushMode"        => push_mode,
+          "LocationGroupId" => $org_group_id
         }
 
         if debug
@@ -179,7 +181,14 @@ module Fastlane
           UI.message(body.to_json)
         end
 
-        response = RestClient.post(host_url + BEGIN_INSTALL_SUFFIX, body.to_json, {content_type: :json, accept: :json, 'aw-tenant-code': aw_tenant_code, 'Authorization': "Basic " + b64_encoded_auth})
+        begin
+          response = RestClient.post($host_url + BEGIN_INSTALL_SUFFIX, body.to_json, {content_type: :json, accept: :json, 'aw-tenant-code': $aw_tenant_code, 'Authorization': "Basic " + $b64_encoded_auth})
+        rescue RestClient::ExceptionWithResponse => e
+          UI.message("ERROR! Response code: %d" % [e.response.code])
+          UI.message("Response body:")
+          UI.message(e.response.body)
+          raise
+        end
 
         if debug
           UI.message("Response code: %d" % [response.code])
@@ -192,7 +201,7 @@ module Fastlane
       end
 
       def self.description
-        "The main purpose of this action is to upload an IPA or an APK file to an AirWatch or Workspace ONE enterprise instance/console."
+        "The main purpose of this action is to upload an IPA or an APK file to an AirWatch or Workspace ONE enterprise console."
       end
 
       def self.authors
@@ -205,36 +214,45 @@ module Fastlane
 
       def self.details
         # Optional:
-        "deploy_app - To upload an iOS ipa OR Android APK to AirWatch/WorkspaceOne console."
+        "deploy_build - To upload an iOS ipa OR Android APK to AirWatch/Workspace One console."
       end
 
       def self.available_options
         [
           FastlaneCore::ConfigItem.new(key: :host_url,
                                   env_name: "AIRWATCH_HOST_API_URL",
-                               description: "Host API URL of the AirWatch instance",
+                               description: "Host API URL of the AirWatch/Workspace ONE instance without /API/ at the end",
                                   optional: false,
                                       type: String,
                               verify_block: proc do |value|
-                                              UI.user_error!("No AirWatch Host API URl given.") unless value and !value.empty?
+                                              UI.user_error!("No AirWatch/Workspace ONE Host API URl given, pass using `host_url: 'https://yourhost.com'`") unless value and !value.empty?
                                             end),
 
           FastlaneCore::ConfigItem.new(key: :aw_tenant_code,
                                   env_name: "AIRWATCH_API_KEY",
-                               description: "API key or the tenant code to access AirWatch Rest APIs",
+                               description: "API key or the tenant code to access AirWatch/Workspace ONE Rest APIs",
                                   optional: false,
                                       type: String,
                               verify_block: proc do |value|
-                                              UI.user_error!("Api tenant code header is missing.") unless value and !value.empty?
+                                              UI.user_error!("Api tenant code header is missing, pass using `aw_tenant_code: 'yourapikey'`") unless value and !value.empty?
                                             end),
 
           FastlaneCore::ConfigItem.new(key: :b64_encoded_auth,
                                   env_name: "AIRWATCH_BASE64_ENCODED_BASIC_AUTH_STRING",
-                               description: "The base64 encoded Basic Auth string generated by authorizing username and password to the AirWatch instance",
+                               description: "The base64 encoded Basic Auth string generated by authorizing username and password to the AirWatch/Workspace ONE instance",
+                                  optional: false,
+                                      type: String,
+                              verify_block: proc do |value|
+                                              UI.user_error!("The authorization header is empty or the scheme is not basic, pass using `b64_encoded_auth: 'yourb64encodedauthstring'`") unless value and !value.empty?
+                                            end),
+
+          FastlaneCore::ConfigItem.new(key: :org_group_id,
+                                  env_name: "AIRWATCH_ORGANIZATION_GROUP_ID",
+                               description: "Organization Group ID integer identifying the customer or container",
                                   optional: false,
                                       type: String,
                               verify_block: proc do |value|
-                                              UI.user_error!("The authorization header is empty or the scheme is not basic") unless value and !value.empty?
+                                              UI.user_error!("No Organization Group ID integer given, pass using `org_group_id: 'yourorggrpintid'`") unless value and !value.empty?
                                             end),
 
           FastlaneCore::ConfigItem.new(key: :app_name,
@@ -245,6 +263,13 @@ module Fastlane
                               verify_block: proc do |value|
                                               UI.user_error!("No app name given, pass using `app_name: 'My sample app'`") unless value and !value.empty?
                                             end),
+                                            
+          FastlaneCore::ConfigItem.new(key: :app_version,
+                                  env_name: "AIRWATCH_APPLICATION_VERSION",
+                               description: "Airwatch Internal App Version",
+                                  optional: true,
+                                      type: String,
+                             default_value: nil),                                         
 
           FastlaneCore::ConfigItem.new(key: :file_name,
                                   env_name: "AIRWATCH_FILE_NAME",
@@ -264,22 +289,13 @@ module Fastlane
                                               UI.user_error!("Path to the file not given, pass using `path_to_file: '/path/to/the/file/on/disk'`") unless value and !value.empty?
                                             end),
 
-          FastlaneCore::ConfigItem.new(key: :org_group_id,
-                                  env_name: "AIRWATCH_ORGANIZATION_GROUP_ID",
-                               description: "Organization Group ID integer identifying the customer or container",
-                                  optional: false,
-                                      type: String,
-                              verify_block: proc do |value|
-                                              UI.user_error!("No Organization Group ID integer given, pass using `org_group_id: MyOrgGroupId`") unless value and !value.empty?
-                                            end),
-
           FastlaneCore::ConfigItem.new(key: :push_mode,
                                   env_name: "AIRWATCH_APP_PUSH_MODE",
-                               description: "Push mode for the application",
+                               description: "Push mode for the application. Values are Auto or On demand",
                                   optional: false,
                                       type: String,
                               verify_block: proc do |value|
-                                              UI.user_error!("No push mode given, pass using `push_mode: 'Auto'` or pass using `push_mode: 'On demand'`") unless value and !value.empty?
+                                              UI.user_error!("No push mode given, pass using `push_mode: 'Auto'` or `push_mode: 'On demand'`") unless value and !value.empty?
                                             end),
 
           FastlaneCore::ConfigItem.new(key: :debug,