Added unlock_keychain action

docs/Actions.md

@@ -230,6 +230,27 @@ create_keychain(
 )
 ```
 
+### `unlock_keychain`
+
+Unlock existing keychain and add it to the keychain search list.
+
+```ruby
+unlock_keychain(
+  path: "/path/to/KeychainName.keychain",
+  password: "mysecret"
+)
+```
+
+If the keychain file is located in the standard location `~/Library/Keychains`, then it is sufficient to provide the keychain file name, or file name with suffix.
+
+```ruby
+unlock_keychain(
+  path: "KeychainName",
+  password: "mysecret"
+)
+```
+
+
 ### `delete_keychain`
 
 Delete a keychain, can be used after creating one with `create_keychain`.

lib/fastlane/actions/unlock_keychain.rb

@@ -0,0 +1,97 @@
+module Fastlane
+  module Actions
+    class UnlockKeychainAction < Action
+      def self.run(params)
+        keychain_path = self.expand_keychain_path(params[:path])
+        add_to_search_list = params[:add_to_search_list]
+
+        if keychain_path.empty?
+          raise "Could not find the keychain file: #{keychain_path}".red
+        end
+
+        # add to search list if not already added
+        if add_to_search_list
+          add_keychain_to_search_list(keychain_path)
+        end
+
+        escaped_path = keychain_path.shellescape
+        escaped_password = params[:password].shellescape
+
+        commands = []
+        # unlock given keychain and disable lock and timeout
+        commands << Fastlane::Actions.sh("security unlock-keychain -p #{escaped_password} #{escaped_path}", log: false)
+        commands << Fastlane::Actions.sh("security set-keychain-settings #{escaped_path}", log: false)
+        commands
+      end
+
+      def self.add_keychain_to_search_list(keychain_path)
+        escaped_path = keychain_path.shellescape
+
+        result = Fastlane::Actions.sh("security list-keychains", log: false)
+
+        # add the keychain to the keychains list
+        # the basic strategy is to open the keychain file with Keychain Access
+        unless result.include?(keychain_path)
+          commands = []
+          commands << Fastlane::Actions.sh("open #{escaped_path}")
+          commands
+        end
+      end
+
+      def self.expand_keychain_path(keychain_path)
+        possible_locations = []
+        possible_locations << keychain_path
+        possible_locations << "~/Library/Keychains/#{keychain_path}"
+        possible_locations << "~/Library/Keychains/#{keychain_path}.keychain"
+
+        possible_locations.each do |location|
+          expanded_location = File.expand_path(location)
+          if File.exist?(expanded_location)
+            return expanded_location
+          end
+        end
+
+        return ""
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        "Unlock a keychain"
+      end
+
+      def self.details
+        "Unlocks the give keychain file and adds it to the keychain search list."
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :path,
+                                       env_name: "FL_UNLOCK_KEYCHAIN_PATH",
+                                       description: "Path to the Keychain file",
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :password,
+                                       env_name: "FL_UNLOCK_KEYCHAIN_PASSWORD",
+                                       description: "Keychain password",
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :add_to_search_list,
+                                       env_name: "FL_UNLOCK_KEYCHAIN_ADD_TO_SEARCH_LIST",
+                                       description: "Add to keychain search list",
+                                       is_string: false,
+                                       default_value: true)
+
+        ]
+      end
+
+      def self.authors
+        ["xfreebird"]
+      end
+
+      def self.is_supported?(platform)
+        platform == :ios
+      end
+    end
+  end
+end

spec/actions_specs/unlock_keychain_spec.rb

@@ -0,0 +1,21 @@
+describe Fastlane do
+  describe Fastlane::FastFile do
+    describe "Unlock keychain Integration" do
+
+      it "works with path and password and existing keychain" do
+        keychain_path = Tempfile.new('foo').path
+
+        result = Fastlane::FastFile.new.parse("lane :test do
+          unlock_keychain ({
+            path: '#{keychain_path}',
+            password: 'testpassword',
+          })
+        end").runner.execute(:test)
+
+        expect(result.size).to eq 2
+        expect(result[0]).to eq "security unlock-keychain -p testpassword #{keychain_path}"
+        expect(result[1]).to eq "security set-keychain-settings #{keychain_path}"
+      end
+    end
+  end
+end