Build Actions

A series of Fastlane utilities to make building apps within Bottle Rocket simpler.

How it Works

This project contains three custom Fastlane actions:

• build_setup: Sets up everything needed to run a build. This includes creating a new temporary Keychain, copying the right provisioning profiles into ~/Library/MobileDevice/Provisioning Profiles, and importing the correct certificates into the newly created Keychain.
• build_cleanup: Cleans up everything that build_setup does - including deleting the provisioning profiles and the temporary keychain.
• generate_veracode_bca: Converts a given .xcarchive into a .bca file suitable for upload to Veracode.

Usage

You can link this project with your existing Fastfile using the import_from_git action. You don't need to clone this repo or install it anywhere in your project. An example usage inside a Fastfile is below. There are two main ways to properly utilize these actions and account for build failures - and both examples are below. The exception handling is not explicitly required, but it should be present so cleanup can be done even in the case of a build failure.

Import BuildActions at the top of the Fastfile:

default_platform(:ios)
import_from_git(url: "git@github.com:BottleRocketStudios/iOS-BuildActions.git")

Option 1 - Use begin - rescue:

platform :ios do

  lane :buildExample do
    begin
      build_setup(
        certificate_names: ["Certificate1.p12"],
        provisioning_profile_names: ["Profile1.mobileprovision", "Profile2.mobileprovision"],
        should_log: true
      )
      # `gym` command not shown
      build_cleanup

    rescue => exception
      build_cleanup
      raise exception
    end    
  end
end

Option 2 - Use an error lane:

platform :ios do

  lane :buildExample2 do
    build_setup(
      certificate_names: ["Certificate1.p12"],
      provisioning_profile_names: ["Profile1.mobileprovision", "Profile2.mobileprovision"],
      should_log: true
    )
    # `gym` command not shown
    build_cleanup
  end

  error do |lane, exception|
   UI.error("Lane [#{lane}] Threw Exception: #{exception}")
   cleanup_build # Keep in mind if you have other lanes, they may not need cleanup!
  end
end