ionic-fastlane-plugin

fastlane plugin for Ionic 4+.

• Getting started
• Actions

Install the ionic-fastlane plugin

fastlane add_plugin fastlane-plugin-fivethree_ionic

This will add gem 'fastlane-plugin-fivethree_ionic' in the fastlane/Pluginfile.

This Fastfile contains example of the following actions.

Generate an Android keystore file or validate keystore exists

Build your Ionic app for iOS:

outputpath =
  fiv_ionic(
    platform: 'ios', release: 'true', prod: 'true', team_id: 'YOUR_TEAM_ID'
  )

Build your Ionic app for Android:

outputpath = fiv_ionic(platform: 'android', release: 'true', prod: 'true')

Add fiv_select_client to your lane to select a client for copying client specific resources before your app build.

For example you have the following app clients:

• clients
  • companyA
    • resources
    • ...
  • companyB
  • companyZ

fiv_select_client() lets you select one client and returns the client name.

client = fiv_select_client

# copy client resources e.g. "cp ../clients/#{client}/resources ../"
# build app

Client selection can also be passed as an option for a non interactive environment. Add the option client to before_all and assign it to an environment variable CLIENT.

before_all { |lane, options| ENV['CLIENT'] = options[:client] }

fastlane example_lane client:companyA

Add fiv_select_clients to your lane to select all, many or one client for copying client specific resources before your app build in a loop.

For example you have the following app clients:

• clients
  • companyA
    • resources
    • ...
  • companyB
  • companyZ

fiv_select_clients() lets you select all, many or one client and returns an array of client names.

clients = fiv_select_clients

clients.each { |client| }

Clients selection can also be passed as an option for a non interactive environment. Add the option clients to before_all and assign it to an environment variable CLIENTS.

before_all { |lane, options| ENV['CLIENTS'] = options[:clients] }

Seperate clients by ,:

fastlane example_lane clients:companyA,companyB

Add fiv_select_env to your lane to select an environment of a client for copying specific resources for this environment before your app build. e.g the resources or app icon and splash screen might differ for each environment.

For example you have the following app clients with different environments:

• clients
  • companyA
    • resources
    • environment
      • prod
        • resources
      • qa
        • resources
      • test
        • resorces
  • companyB
  • companyZ

fiv_select_env() lets you select one client and returns the client name.

client = fiv_select_client
env = fiv_select_env(client: client)

# copy client resources from environment e.g. "cp ../clients/#{client}/enviroment/#{env}/resources ../"
# build app

Environment selection can also be passed as an option for a non interactive environment. Add the option env to before_all and assign it to an environment variable ENV.

before_all do |lane, options|
  ENV['CLIENT'] = options[:client]
  ENV['ENV'] = options[:env]
end

fastlane example_lane client:companyA env:prod

Zipaligns, signs v2 and verifys an apk with a keystore. If the keystore does not exists it uses fiv_android_keystore to create a new keystore.

# run before signing: ionic cordova build android --prod --release

apk_path =
  fiv_sign_android(
    keystore_name: 'pizza',
    key_alias: 'pizza',
    app_version: '1.0.1',
    app_build_no: '2020',
    apk_output_dir: './apk',
    silent: true
  )