Fastlane
Appcircle supports Fastlane for build automation as a supplementary feature to Appcircle's own build automation.
With Appcircle, you can automate your build and signing processes with the flexible workflow structure, and you can also use Fastlane as a workflow step within the build workflows.
Prerequisites
The workflow steps that need to be executed before running the Fastlane workflow step, along with their respective reasons, are listed in the table below.
| Prerequisite Workflow Step | Description |
|---|---|
| Git Clone | The repo needs to be cloned in order to start the Fastlane process. After the clone, Fastlane will be installed. After this step works, the variable AC_REPOSITORY_DIR will be created. |
Fastlane needs project files to work. If there is no Git Clone step in your workflow, it will give an error because it cannot find the relevant files of the project.
Input Variables
You can find all the parameters required for this step in the table below, with their descriptions in detail.
| Variable Name | Description | Status |
|---|---|---|
$AC_FASTLANE_DIR | This path is Fastlane's path in the project. By default, it is AC_REPOSITORY_DIR. If your Fastlane file is in a different location in the repo, please change it. | Required |
$AC_FASTLANE_LANE | Fastlane lane. For example: android deploy or ios release | Required |
To access the source code of this component, please use the following link:
Fastlane FAQ
How to run a Fastlane plug-in directly?
With Appcircle's Fastlane integration, you can easily run the lane you want with the Fastfile in your project. But you can also run a Fastlane plugins directly in the pipeline without any Fastlane integration.
You can easily add the Fastlane plugins you want to run, which are not included in your Fastfile and are available on the Fastlane plugins, to the pipeline via a Custom Script and run them easily. For all available plugins, please visit the Fastlane plugins documentation.
The example Bash script below shows how to run the Fastlane plugin with a gem file. In this example, fastlane-plugin-json is used as a Fastlane plugin. Add a Custom Script step to your Workflows to run the following script.
cd $AC_REPOSITORY_DIR
gem install fastlane-plugin-json
echo "gem 'fastlane-plugin-json'" >> Gemfile
fastlane run read_json json_path:./example.json
The same command sequence should be used to run different Fastlane plugins. Once the plugin is installed, it is run with the fastlane run command. The necessary actions must be completed for the plugin to work correctly. The command used to run Fastlane plugin is as follows:
fastlane run [action] parameter:value
Action: The plugin will be run.Parameter: Input parameter expected by the plugin.Value: Input value to be entered.
If the plugin you are using contains more than one parameter, you can use the parameters side by side as below.
fastlane run [action] parameter1:value1 parameter2:value2
For plugin details and the actions they contain, visit the repository of the Fastlane plugins.