Improve the Build Process of your Apps

First of all, let's understand what this tool is:

What is Fastlane?

It's an open-source tool that will help you improve the development process and the distribution of your android and ios applications. With this tool you can automate processes such as:

Automatically generate screenshots for use in stores
Distribute beta versions to testers
Sign your own code
Upload a new version to testflight

It is possible to use external plugins to implement new flows; these plugins are developed by the open-source community.

How to configure on android?

access your project and enter the android folder

cd myApp/android

Initialize fastlane

Fastlane init

Now! you have to do configurations:

In the terminal you will be asked to enter the package name found in the path NameOfApp/android/app/build.gradle and in the namespace field.
As we are working with android at the moment, we need to make some settings in google. We'll have to generate the json file with some settings.

Google Configuration

Open the google console
Activate the api of the project you are working on, if you don't have a project created, create it here.
Open the google service accounts and select the project you are working on.

Create google services

Fill in the details and click done
Copy the email address provided by the service and save it as we will need it later

Create the keys, click on the 3 dots under actions
Manage keys

Create new key -> JSON -> Create
We will place this json inside our project, place this file inside the android/fastlane folder and define a name for it
We need to give permission for our service to work

User permissions

Open the google console and go to users and permissions
Invite user -> enter the email address of the service
Set permissions to admin

Configuring the AppFile

json_key_file("android/fastlane/keys.json") # Path to the json secret

# find this data inside android/build.gradle, we use this to identify the app we are working on
package_name("com.nameofapp")

Installing an automatic version change plugin

access the path yourProject/android/fastlane
run this command

gem 'fastlane-plugin-increment_version_code'

Configuring FastFile

This file is where we'll have our fastlane action flow

fastlane_require 'dotenv'

default_platform(:android)

# esta linha faz a leitura do arquivo gradle.properties para
# pegar algumas informações de config
def getGradleProperty(property_name)
  gradle_properties_content = File.read('../gradle.properties')
  property_regex = /^#{property_name}=(.+)/
  match = gradle_properties_content.match(property_regex)
  match[1] if match
end

platform :android do
  desc "Deploy to test internal to Google Play"

  lane :deployBeta do
    pathKeyJson = "android/fastlane/keys.json"

    # aumentar versão do build
    previous_build_number = google_play_track_version_codes(
      package_name: "com.nameofapp",
      json_key: pathKeyJson,
      track: "internal",
    )[0]

    current_build_number = previous_build_number + 1

    increment_version_code(
      gradle_file_path: "./app/build.gradle",
      version_code: current_build_number
    )

    gradle(task: 'clean')
    gradle(
      task: 'bundleRelease',
      properties: {
        "storeFile" => "../app/release.keystore",
        "android.injected.signing.store.password" => getGradleProperty('MYAPP_UPLOAD_STORE_PASSWORD'),
        "android.injected.signing.key.alias" => getGradleProperty('MYAPP_UPLOAD_KEY_ALIAS'),
        "android.injected.signing.key.password" => getGradleProperty('MYAPP_UPLOAD_KEY_PASSWORD'),
      }
    )

    supply(
      json_key: pathKeyJson,
      package_name: "com.nameofapp",
      track: 'internal',
      skip_upload_metadata: true,
      skip_upload_images: true,
      skip_upload_screenshots: true,
      skip_upload_apk: true,
      skip_upload_aab: false
    )
  end
end

Create script package.json

"fastlane:android": "cd android/Fastlane && Fastlane deployBeta"

How to configure on ios?

access your project and enter the android folder

cd myApp/android

Initialize fastlane

Fastlane init

Tools we will use:

app_store_connect_api_key: Tool that allows authentication with App Store Connect, this improves security and simplifies the implementation process.
build_app: Used to generate an ipa file of our application.
upload_to_testflight: Upload the ipa file to testflight

Generate api key

Select user and access, select tab api keys
Generate api key
Choose a name
Select the type of access -> generate the key
Paste the key file into the path myApp/ios/fastlane

Configuring AppFile

# enter your app identifier
app_identifier("your app_identifier")

# enter your apple_id
apple_id("your apple_id")

Configuring FastFile

default_platform(:ios)

platform :ios do
  desc "Deploy App to Testflight"
  lane :upload_testflight_beta do
    build_app(
      workspace: "myApp.xcworkspace", 
      scheme: "myApp",
      silent: true,
      clean: true,
    )

    api_key = app_store_connect_api_key(
      key_id: "your key id",
      issuer_id: "your issuer id",
      key_filepath: "path to file auth key",
      duration: 1200,
      in_house: false
    )

    upload_to_testflight(
      api_key: api_key,
      skip_submission: true,
      ipa: "myApp.ipa",
      skip_waiting_for_build_processing: true,
    )
  end
end

Create script package.json

"fastlane:ios": "cd iod/Fastlane && Fastlane upload_testflight_beta"

Blog

Improve the Build Process of your Apps

Luiz Gabriel

What is Fastlane?

How to configure on android?

Google Configuration

Create google services

User permissions

Configuring the AppFile

Installing an automatic version change plugin

Configuring FastFile

Create script package.json

How to configure on ios?

Generate api key

Configuring AppFile

Configuring FastFile

Create script package.json

Join Our Newsletter. No Spam, Only the good stuff.

Related