fastlane-plugin-ionic_integration 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8c414a201f1622f34e4079486d368830415d5bb5
+  data.tar.gz: cf73d0b573a4179d599dd01e0781f2ba9e9f1667
+SHA512:
+  metadata.gz: a29bf584846dec83895e0357c0bdc86bb7b1120a98611581cdf08c30e28fa2d90aece302dc6ffaf18978b3d7413dc0b101a522bf28c30a73a9bc60441333df61
+  data.tar.gz: 41d86718e4ac1d28f462649b6007e6c099de8f9ae9925784536eb0c9747c817bc9f5c988fa1dfc8af0f24860354eef62517c8fced702edbb28877d232c258ae4

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Adrian Regan <adrian@littlevista.net>
+
+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,143 @@
+# ionic_integration plugin
+
+[![fastlane Plugin Badge](https://rawcdn.githack.com/fastlane/fastlane/master/fastlane/assets/plugin-badge.svg)](https://rubygems.org/gems/fastlane-plugin-ionic_integration)
+
+## Getting Started
+
+**NOTE** This is hot off the press and I am still testing it locally, so hang tight
+
+This project is a [_fastlane_](https://github.com/fastlane/fastlane) plugin. To get started with `fastlane-plugin-ionic_integration`, add it to your project by running:
+
+```bash
+fastlane add_plugin ionic_integration
+```
+
+## About ionic_integration
+
+Integrating Fastlane with Ionic Generated Projects
+
+Fastlane is an awesome application. However the assumption is that you are in control of the iOS or Android projects while using it. When developing in Ionic 
+(or Cordova), the relevant platform projects are created for you by Ionic. For example **ionic platform add ios**
+
+This poses a problem when attempting to automate the build process. We do not want to put the generated projects under source control, however we would like to 
+be able to link it into fastlane??
+
+This plugin will let you generate a sample UI Test group for generating snapshots the [fastlane way](https://tisunov.github.io/2015/11/06/automating-app-store-screenshots-generation-with-fastlane-snapshot-and-sketch.html). But it stores the UI Unit tests in your fastlane folder so that you can
+commit only these to version control. The plugin, will then retrofit these tests into the Ionic/Cordova generated projects.
+
+There are two actions (so far)
+**ionic_ios_config_snapshot** get's you started with a sample UI Test configuration (and saves it to fastlane/ionic/config/ios/ui-tests). The UI Unit Tests
+are linked into any existing XCode project generated by Ionic.
+
+**ionic_ios_snapshot** Scans the fastlane/ionic/config/ios/ui-tests folder for sub folders that represent UI Test Schemes (each folder is a scheme). It retrofits 
+each UI Test scheme into the XCode projects generated by Ionic.
+
+NOTE: At the moment this works for Xcode 8+. If anyone out there is interested in contributing, it would be great to support XCode 7 and (ideally) be able to do a 
+similar thing for Android generated projects.
+
+## Example
+
+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`.
+
+To create a sample test you can add a lane like so:
+
+```ruby
+lane :setup_tests do
+    ionic_ios_config_snapshot(
+      ionic_scheme_name: "blah-blah"
+    )
+end
+```
+
+This will create a folder **fastlane/ionic/config/ios/ui-tests/blah-blah**
+
+In this folder will be the standard test files that you would expect for a UI Unit Test, Info.plist, Fastlane SWIFT file and a sample Unit Test ui-snapshots.swift
+
+**ionic_ios_config_snapshot** also executes the *ionic_config_snapshot* action to retrofit this unit test configuration into any existing XCode Project
+
+When this is done. The sample will be linked into your generated project. In the above example, a UI Test scheme will be created in **fastlane/ionic/config/ios/ui-tests/blah-blah**. The files in this folder are linked absolutely into Xcode, that is Xcode refers directly to these files (they are not copied over to Xcode)
+
+If you open up Xcode and open the file 'blah-blah/ui-snapshots.swift' you will see something like this:
+
+```
+    func testSnapshots() {
+
+        //
+        // Place your own tests here. This is a starter example to get you going..
+        //
+        snapshot("app-launch")
+        
+        // XCUIApplication().buttons["Your Button Name"].tap()
+        
+        // snapshot("after-button-pressed")
+                
+    }
+```
+In the XCode UI, select the scheme 'blah-blah' and click into the method 'testSnapshots()' (after the first snapshot). Then Run the scheme. 
+This will open the simulator and you can click around in your application. XCode will record, each interaction within the 
+testSnapshots() method.
+
+When you are done, you can save everthing and it will save those interactions into the fastlane/ionic/config/ios/ui-tests/ui-snapshots.swift.
+
+You can now add fastlane ```snapshot("decription")``` where you like.
+
+This whole operation only needs to be done once (or if you want to add more screenshots later). The UI Test files can be added to your source control and they will be retrofitted into any future generated Ionic projects. Nice.
+
+Your fully automated Fastlane file can now look like this:
+
+```ruby
+platform :ios do
+
+  before_all do
+    #
+    # This will retrofit any existing schemes in fastlane/ionic/config/ios/ui-tests/
+    #
+    ionic_ios_snapshot(
+    	team_id: "[YOUR TEAM ID]"
+    	bundle_id: "[YOUR APP BUNDLE ID]"
+    )
+  end
+
+  lane :release do
+  	# This will run the retrofitted UI Tests for you and create snapshots... :-)
+  	snapshot(
+      output_simulator_logs: true,
+      reinstall_app: false,
+      erase_simulator: true,
+      scheme: "[Name of folder in fastlane/ionic/config/ios/ui-tests/, i.e. blah-blah]"
+    )
+  end
+end
+```
+
+You can now use this to fully automate the build process between ionic and fastlane, including snapshots.
+
+## 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/ionic_integration.rb

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

data/lib/fastlane/plugin/ionic_integration/actions/ionic_ios_config_snapshot_action.rb

@@ -0,0 +1,85 @@
+require 'xcodeproj'
+require 'fastlane/plugin/ionic_integration/constants'
+
+module Fastlane
+  module Actions
+    #
+    # Used to bootstrap the UI Unit Testing Process for iOS generated Xcode Projects.
+    #
+    # It copies over a sample UI test to our fastlane config folder and runs the IonicSnapShotAction
+    #
+    class IonicIosConfigSnapshotAction < Action
+      #
+      # Default location for Ionic/Cordova Project generation, ionic plaform add ios
+      #
+      default_scheme_name = IonicIntegration::IONIC_DEFAULT_UNIT_TEST_NAME
+
+      def self.run(params)
+        workspace_path = params[:ionic_ios_xcode_path]
+        target_os = params[:ionic_min_target_ios]
+        scheme_name = params[:ionic_scheme_name]
+
+        UI.message("Creating New UI Unit Tests for Snapshots, with Scheme #{scheme_name} in #{IonicIntegration::IONIC_IOS_CONFIG_UITESTS_PATH}")
+        Fastlane::Helper::IonicIntegrationHelper.copy_ios_sample_tests(scheme_name)
+
+        #
+        # Just call our main ios snapshot action, if there is a workspace
+        #
+        if Dir.exist?(workspace_path)
+          Actions::IonicIosSnapshotAction.run(
+            ionic_ios_xcode_path: workspace_path,
+            ionic_min_target_ios: target_os
+          )
+          UI.success("Created UI Test Configuration")
+        elsif
+          UI.success("Created UI Test Configuration. No Workspace exists or was specified yet. When ionic generates the workspace you'll need to call ionic_ios_snapshot action.")
+        end
+      end
+
+      def self.description
+        'Create a Sample iOS UI Unit Test to get started with in a generated Ionic/Cordova project'
+      end
+
+      def self.authors
+        ['Adrian Regan']
+      end
+
+      def self.return_value
+        # If your method provides a return value, you can describe here what it does
+      end
+
+      def self.details
+        # Optional:
+        "Creates a set of UI Unit Tests in #{IonicIntegration::IONIC_IOS_CONFIG_UITESTS_PATH} and configures an existing Ionic/Cordova Generated Xcode projec to use them"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :ionic_ios_xcode_path,
+                                       env_name: 'IONIC_IOS_XCODE_PATH',
+                                       description: 'Path to XCode Project Generated by Ionic',
+                                       default_value: Fastlane::Helper::IonicIntegrationHelper.find_default_ios_xcode_workspace,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :ionic_min_target_ios,
+                                       env_name: 'IONIC_MIN_TARGET_IOS',
+                                       description: 'Minimal iOS Version to Target',
+                                       default_value: IonicIntegration::DEFAULT_IOS_VERSION,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :ionic_scheme_name,
+                                       env_name: 'IONIC_IOS_TEST_SCHEME',
+                                       description: 'Scheme Name of the UI Unit Tests',
+                                       default_value: IonicIntegration::IONIC_DEFAULT_UNIT_TEST_NAME,
+                                       optional: 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://github.com/fastlane/fastlane/blob/master/fastlane/docs/Platforms.md
+        #
+        # [:ios, :mac, :android].include?(platform)
+        [:ios].include?(platform)
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/ionic_integration/actions/ionic_ios_snapshot_action.rb

@@ -0,0 +1,212 @@
+require 'xcodeproj'
+
+module Fastlane
+  module Actions
+    class IonicIosSnapshotAction < Action
+      def self.run(params)
+        UI.message "Configuring Xcode with UI Tests Located in #{IonicIntegration::IONIC_IOS_CONFIG_UITESTS_PATH}/**"
+
+        (!params.nil? && !params[:ionic_ios_xcode_path].nil?) || UI.user_error!("Mandatory parameter :ionic_ios_xcode_path not specified")
+
+        #
+        # Deduce the name of the xcode project we are looking for...
+        #
+        xcode_project = params[:ionic_ios_xcode_path]
+        target_os = params[:ionic_min_target_ios]
+        team_id = params[:team_id]
+        bundle_id = params[:bundle_id]
+
+        File.exist?(xcode_project) || UI.user_error!("Xcode Project #{xcode_project} does not exist!")
+        #
+        # Find all preconfigured UI Unit Tests
+        #
+        schemes = Dir.glob("#{IonicIntegration::IONIC_IOS_CONFIG_UITESTS_PATH}/*/").reject do |d|
+          d =~ /^\.{1,2}$/
+        end
+
+        UI.message "Found #{schemes}..."
+        schemes.each do |scheme_path|
+          # UI.message("Processing Test Scheme #{scheme_path}")
+          generate_xcode_unit_test(scheme_path, xcode_project, team_id, bundle_id, target_os)
+        end
+      end
+
+      def self.generate_xcode_unit_test(config_folder, xcode_project_path, team_id, bundle_id, target_os)
+        scheme_name = File.basename(config_folder)
+        xcode_folder = File.dirname(xcode_project_path)
+        project_name = File.basename(xcode_project_path, ".xcodeproj")
+
+        UI.message("Setting up #{scheme_name} as UI Unit Test folder and Scheme in #{xcode_folder} for Xcode Project #{project_name}")
+
+        proj = Xcodeproj::Project.open(xcode_project_path) || UI.user_error!("Unable to Open Xcode Project #{xcode_project_path}")
+
+        UI.message("Xcode Project is Version #{proj.root_object.compatibility_version} Compatible")
+        #
+        # Find existing Target and remove it
+        #
+        target = nil
+        proj.targets.each do |t|
+          next unless t.name == scheme_name
+          UI.important "Found existing Target #{t.name}. Will be replaced."
+          target = t
+          break
+        end
+
+        #
+        # Find existing code group or unit tests and remove if needed.
+        #
+        snapGrp = nil
+        proj.groups.each do |g|
+          next unless g.name == scheme_name
+          g.clear
+          snapGrp = g
+          UI.important "Found existing Code Group #{g.name}. Will be replaced."
+          break
+        end
+
+        #
+        # Remove existing targets and groups if required.
+        #
+        target.nil? || target.remove_from_project
+        snapGrp.nil? || snapGrp.remove_from_project
+
+        target = nil
+        snapGrp = nil
+
+        #
+        # Ok, let's rock and roll
+        #
+        UI.message "Creating UI Test Group #{scheme_name} for snapshots testing"
+        snapGrp = proj.new_group(scheme_name.to_s)
+
+        UI.message "Finding Main Target (of the Project)..."
+        main_target = nil
+        proj.root_object.targets.each do |t|
+          if t.name == project_name
+            UI.message "Found main target as #{t.name}"
+            main_target = t
+          end
+        end
+
+        main_target || UI.user_error!("Unable to locate Main Target for Ionic App in #{project_name}")
+
+        # Create a product for our ui unit test
+        product_ref = proj.products_group.new_reference(scheme_name + '.xctest', :built_products)
+
+        target = Xcodeproj::Project::ProjectHelper.new_target(proj, :ui_test_bundle,
+                                                              scheme_name, :ios, target_os, proj.products_group, :swift)
+
+        target.product_reference = product_ref
+
+        UI.message "Adding Main Target Dependency: " + main_target.to_s
+        target.add_dependency(main_target)
+
+        # We need to save here for some reason... xcodeproj?
+        proj.save
+
+        UI.message "Adding Pre-Configured UI Unit Tests (*.plist and *.swift) to Test Group #{scheme_name}"
+        files = []
+
+        # Link our fastlane configured UI Unit Tests into the project
+        Dir["#{config_folder}/*.plist", "#{config_folder}/*.swift"].each do |file|
+          UI.message "Adding UI Test Source #{file}"
+          files << snapGrp.new_reference(File.absolute_path(file))
+        end
+
+        target.add_file_references(files)
+
+        UI.message "Configuring Project Metadata..."
+
+        # We may need to switch here on compatibility versions, this is for Xcode 8.0
+        # Fasten your seatbelts, it gets bumpy from here on in..
+        target_config = {
+            CreatedOnToolsVersion: "8.2",
+                  DevelopmentTeam: team_id,
+                  ProvisioningStyle: "Automatic",
+                  TestTargetID: main_target.uuid
+        }
+
+        if proj.root_object.attributes['TargetAttributes']
+          proj.root_object.attributes['TargetAttributes'].store(target.uuid, target_config)
+        elsif
+          proj.root_object.attributes.store('TargetAttributes', { target.uuid => target_config })
+        end
+
+        target.build_configuration_list.set_setting('INFOPLIST_FILE', "#{scheme_name}/Info.plist")
+        target.build_configuration_list.set_setting('SWIFT_VERSION', '3.0')
+        target.build_configuration_list.set_setting('PRODUCT_NAME', "$(TARGET_NAME)")
+        target.build_configuration_list.set_setting('TEST_TARGET_NAME', project_name)
+        target.build_configuration_list.set_setting('PRODUCT_BUNDLE_IDENTIFIER', "#{bundle_id}.#{scheme_name}")
+        target.build_configuration_list.set_setting('CODE_SIGN_IDENTITY[sdk=iphoneos*]', "iPhone Developer")
+        target.build_configuration_list.set_setting('LD_RUNPATH_SEARCH_PATHS', "$(inherited) @executable_path/Frameworks @loader_path/Frameworks")
+        target.build_configuration_list.set_setting('DEVELOPMENT_TEAM', team_id)
+
+        # Create a shared scheme for the UI tests
+        existingScheme = Xcodeproj::XCScheme.shared_data_dir(xcode_project_path) + "/#{scheme_name}.xcscheme"
+
+        UI.message "Generating XCode Scheme #{scheme_name} to run UI Snapshot Tests"
+        scheme = File.exist?(existingScheme) ? Xcodeproj::XCScheme.new(existingScheme) : Xcodeproj::XCScheme.new
+
+        scheme.add_test_target(target)
+
+        scheme.add_build_target(main_target)
+        scheme.set_launch_target(main_target)
+
+        scheme.save_as(xcode_project_path, scheme_name)
+
+        UI.success "Completed Retrofit of #{scheme_name} in Ionic Generated XCode Project #{project_name} OK... SAVING"
+
+        proj.save
+      end
+
+      def self.description
+        'Bridge between Ionic/Cordova Projects and Fastlane for Automated Snapshot Generation for iOS Projects'
+      end
+
+      def self.authors
+        ['Adrian Regan']
+      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 allows the developer to specify UI Unit Tests and store them in the fastlane configuration. The plugin will copy over these unit tests to the generated Xcode (and hopefully Android) projects, create the required targets/schemes to run the snapshots and integrate into fastlane. It allows for greater automation of the build for ionic/cordova projects that wish to use fastlane'
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :ionic_ios_xcode_path,
+                                       env_name: 'IONIC_IOS_XCODE_PATH',
+                                       description: 'Path to XCode Project Generated by Ionic',
+                                       default_value: Fastlane::Helper::IonicIntegrationHelper.find_default_ios_xcode_workspace,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :ionic_min_target_ios,
+                                       env_name: 'IONIC_MIN_TARGET_IOS',
+                                       description: 'Minimal iOS Version to Target',
+                                       default_value: IonicIntegration::DEFAULT_IOS_VERSION,
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :team_id,
+                                       env_name: 'IONIC_TEAM_ID_IOS',
+                                       description: 'Team Id in iTunesConnect or Apple Developer',
+                                       optional: false),
+          FastlaneCore::ConfigItem.new(key: :bundle_id,
+                                       env_name: 'IONIC_BUNDLE_ID_IOS',
+                                       description: 'The Bundle Id of the iOS App, eg: ie.littlevista.whateverapp',
+                                       optional: 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://github.com/fastlane/fastlane/blob/master/fastlane/docs/Platforms.md
+        #
+        # [:ios, :mac, :android].include?(platform)
+        [:ios].include?(platform)
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/ionic_integration/constants.rb

@@ -0,0 +1,12 @@
+module Fastlane
+  module IonicIntegration
+    IONIC_IOS_BUILD_PATH = "platforms/ios"
+    DEFAULT_IOS_VERSION = "9.0"
+
+    IONIC_CONFIG_PATH = "fastlane/ionic/config"
+    IONIC_IOS_CONFIG_PATH = IONIC_CONFIG_PATH + "/ios"
+    IONIC_IOS_CONFIG_UITESTS_PATH = IONIC_IOS_CONFIG_PATH + "/ui-tests"
+
+    IONIC_DEFAULT_UNIT_TEST_NAME = "ui-snapshots"
+  end
+end

data/lib/fastlane/plugin/ionic_integration/helper/ionic_integration_helper.rb

@@ -0,0 +1,38 @@
+require 'fastlane/plugin/ionic_integration/constants'
+
+module Fastlane
+  module Helper
+    class IonicIntegrationHelper
+      HELPER_PATH = File.expand_path(File.dirname(__FILE__))
+
+      IOS_RESOURCES_PATH = File.expand_path("#{HELPER_PATH}/../resources/ios")
+
+      #
+      # Copy over to the xcode project our pre-configured UI Test Code
+      #
+      def self.copy_ios_ui_test_code(src_folder, project_folder)
+        if src_folder && Dir.exist?(src_folder)
+          dest_folder = project_folder.to_s
+          UI.message "Copying iOS UI Tests from #{src_folder} to #{dest_folder}"
+          Dir.exist?(dest_folder) || FileUtils.mkdir_p(dest_folder)
+          FileUtils.cp_r(src_folder + "/.", dest_folder)
+        elsif
+          UI.user_error! "Copying iOS UI Test Files: #{src_folder} does not exist."
+        end
+      end
+
+      def self.copy_ios_sample_tests(scheme_name)
+        source_folder = "#{IOS_RESOURCES_PATH}/#{IonicIntegration::IONIC_DEFAULT_UNIT_TEST_NAME}"
+        dest_folder = "#{IonicIntegration::IONIC_IOS_CONFIG_UITESTS_PATH}/#{scheme_name}"
+        copy_ios_ui_test_code(source_folder, dest_folder)
+      end
+
+      #
+      # Find any existing Xcode Workspace generated by Ionic/Cordova
+      #
+      def self.find_default_ios_xcode_workspace
+        Dir["#{IonicIntegration::IONIC_IOS_BUILD_PATH}/*.xcodeproj"].last || nil
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/ionic_integration/resources/ios/ui-snapshots/Info.plist

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+</dict>
+</plist>

data/lib/fastlane/plugin/ionic_integration/resources/ios/ui-snapshots/SnapshotHelper.swift

@@ -0,0 +1,163 @@
+//
+//  SnapshotHelper.swift
+//  Example
+//
+//  Created by Felix Krause on 10/8/15.
+//  Copyright © 2015 Felix Krause. All rights reserved.
+//
+import Foundation
+import XCTest
+
+var deviceLanguage = ""
+var locale = ""
+
+@available(*, deprecated, message: "use setupSnapshot: instead")
+func setLanguage(_ app: XCUIApplication) {
+    setupSnapshot(app)
+}
+
+func setupSnapshot(_ app: XCUIApplication) {
+    Snapshot.setupSnapshot(app)
+}
+
+func snapshot(_ name: String, waitForLoadingIndicator: Bool = true) {
+    Snapshot.snapshot(name, waitForLoadingIndicator: waitForLoadingIndicator)
+}
+
+open class Snapshot: NSObject {
+
+    open class func setupSnapshot(_ app: XCUIApplication) {
+        setLanguage(app)
+        setLocale(app)
+        setLaunchArguments(app)
+    }
+
+    class func setLanguage(_ app: XCUIApplication) {
+        guard let prefix = pathPrefix() else {
+            return
+        }
+
+        let path = prefix.appendingPathComponent("language.txt")
+
+        do {
+            let trimCharacterSet = CharacterSet.whitespacesAndNewlines
+            deviceLanguage = try String(contentsOf: path, encoding: .utf8).trimmingCharacters(in: trimCharacterSet)
+            app.launchArguments += ["-AppleLanguages", "(\(deviceLanguage))"]
+        } catch {
+            print("Couldn't detect/set language...")
+        }
+    }
+
+    class func setLocale(_ app: XCUIApplication) {
+        guard let prefix = pathPrefix() else {
+            return
+        }
+
+        let path = prefix.appendingPathComponent("locale.txt")
+
+        do {
+            let trimCharacterSet = CharacterSet.whitespacesAndNewlines
+            locale = try String(contentsOf: path, encoding: .utf8).trimmingCharacters(in: trimCharacterSet)
+        } catch {
+            print("Couldn't detect/set locale...")
+        }
+        if locale.isEmpty {
+            locale = Locale(identifier: deviceLanguage).identifier
+        }
+        app.launchArguments += ["-AppleLocale", "\"\(locale)\""]
+    }
+
+    class func setLaunchArguments(_ app: XCUIApplication) {
+        guard let prefix = pathPrefix() else {
+            return
+        }
+
+        let path = prefix.appendingPathComponent("snapshot-launch_arguments.txt")
+        app.launchArguments += ["-FASTLANE_SNAPSHOT", "YES", "-ui_testing"]
+
+        do {
+            let launchArguments = try String(contentsOf: path, encoding: String.Encoding.utf8)
+            let regex = try NSRegularExpression(pattern: "(\\\".+?\\\"|\\S+)", options: [])
+            let matches = regex.matches(in: launchArguments, options: [], range: NSRange(location:0, length:launchArguments.characters.count))
+            let results = matches.map { result -> String in
+                (launchArguments as NSString).substring(with: result.range)
+            }
+            app.launchArguments += results
+        } catch {
+            print("Couldn't detect/set launch_arguments...")
+        }
+    }
+
+    open class func snapshot(_ name: String, waitForLoadingIndicator: Bool = true) {
+        if waitForLoadingIndicator {
+            waitForLoadingIndicatorToDisappear()
+        }
+
+        print("snapshot: \(name)") // more information about this, check out https://github.com/fastlane/fastlane/tree/master/snapshot#how-does-it-work
+        sleep(1) // Waiting for the animation to be finished (kind of)
+        #if os(tvOS)
+            XCUIApplication().childrenMatchingType(.Browser).count
+        #elseif os(OSX)
+            XCUIApplication().typeKey(XCUIKeyboardKeySecondaryFn, modifierFlags: [])
+        #else
+            XCUIDevice.shared().orientation = .unknown
+        #endif
+    }
+
+    class func waitForLoadingIndicatorToDisappear() {
+        #if os(tvOS)
+            return
+        #endif
+
+        let query = XCUIApplication().statusBars.children(matching: .other).element(boundBy: 1).children(matching: .other)
+
+        while (0..<query.count).map({ query.element(boundBy: $0) }).contains(where: { $0.isLoadingIndicator }) {
+            sleep(1)
+            print("Waiting for loading indicator to disappear...")
+        }
+    }
+
+    class func pathPrefix() -> URL? {
+        let homeDir: URL
+        //on OSX config is stored in /Users/<username>/Library
+        //and on iOS/tvOS/WatchOS it's in simulator's home dir
+        #if os(OSX)
+            guard let user = ProcessInfo().environment["USER"] else {
+                print("Couldn't find Snapshot configuration files - can't detect current user ")
+                return nil
+            }
+
+            guard let usersDir =  FileManager.default.urls(for: .userDirectory, in: .localDomainMask).first else {
+                print("Couldn't find Snapshot configuration files - can't detect `Users` dir")
+                return nil
+            }
+
+            homeDir = usersDir.appendingPathComponent(user)
+        #else
+            guard let simulatorHostHome = ProcessInfo().environment["SIMULATOR_HOST_HOME"] else {
+                print("Couldn't find simulator home location. Please, check SIMULATOR_HOST_HOME env variable.")
+                return nil
+            }
+            guard let homeDirUrl = URL(string: simulatorHostHome) else {
+                print("Can't prepare environment. Simulator home location is inaccessible. Does \(simulatorHostHome) exist?")
+                return nil
+            }
+            homeDir = homeDirUrl
+        #endif
+        return homeDir.appendingPathComponent("Library/Caches/tools.fastlane")
+    }
+}
+
+extension XCUIElement {
+    var isLoadingIndicator: Bool {
+        let whiteListedLoaders = ["GeofenceLocationTrackingOn", "StandardLocationTrackingOn"]
+        if whiteListedLoaders.contains(self.identifier) {
+            return false
+        }
+        return self.frame.size == CGSize(width: 10, height: 20)
+    }
+}
+
+// Please don't remove the lines below
+// They are used to detect outdated configuration files
+// SnapshotHelperVersion [1.3]

data/lib/fastlane/plugin/ionic_integration/resources/ios/ui-snapshots/ui-snapshots.swift

@@ -0,0 +1,41 @@
+//
+//  ui_snapshots.swift
+//  ui-snapshots
+//
+//  Created by Adrian Regan on 07/04/2017.
+//
+//
+
+import XCTest
+
+class ui_snapshots: XCTestCase {
+        
+    override func setUp() {
+        super.setUp()
+        
+        let app = XCUIApplication()
+               
+        setupSnapshot(app)
+
+        app.launch()
+ 
+    }
+    
+    override func tearDown() {
+        super.tearDown()
+    }
+    
+    func testSnapshots() {
+
+        //
+        // Place your own tests here. This is a starter example to get you going..
+        //
+        snapshot("app-launch")
+        
+        // XCUIApplication().buttons["Your Button Name"].tap()
+        
+        // snapshot("after-button-pressed")
+                
+    }
+    
+}

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

@@ -0,0 +1,5 @@
+module Fastlane
+  module IonicIntegration
+    VERSION = "0.1.0"
+  end
+end

metadata

@@ -0,0 +1,152 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-ionic_integration
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Adrian Regan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-04-14 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: 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'
+  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.26.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.26.1
+- !ruby/object:Gem::Dependency
+  name: fakefs
+  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'
+description: 
+email: adrian.regan@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/ionic_integration.rb
+- lib/fastlane/plugin/ionic_integration/actions/ionic_ios_config_snapshot_action.rb
+- lib/fastlane/plugin/ionic_integration/actions/ionic_ios_snapshot_action.rb
+- lib/fastlane/plugin/ionic_integration/constants.rb
+- lib/fastlane/plugin/ionic_integration/helper/ionic_integration_helper.rb
+- lib/fastlane/plugin/ionic_integration/resources/ios/ui-snapshots/Info.plist
+- lib/fastlane/plugin/ionic_integration/resources/ios/ui-snapshots/SnapshotHelper.swift
+- lib/fastlane/plugin/ionic_integration/resources/ios/ui-snapshots/ui-snapshots.swift
+- lib/fastlane/plugin/ionic_integration/version.rb
+homepage: https://github.com/knocknarea/fastlane-plugin-ionic_integration
+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: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Integrating Fastlane with Ionic Generated Projects
+test_files: []