Gradle Runner

Runs a specified Gradle task.

Description

The Step runs the specified Gradle task and copies the generated APK and AAB files into the Bitrise Deploy Directory ($BITRISE_DEPLOY_DIR). It is capable of doing everything that you can do with Gradle on your own machine.

Configuring the Step

To use this Step, you need at least two things:

• Gradle Wrapper.
• A Gradle task that is correctly configured in your Gradle project.

The Step can run the specified task with the Gradle Wrapper. For the basic configuration:

1. Open the Config input group.
2. In the Gradle task to run input, add the task you want to run. Without an existing, valid task, the Step will fail.
3. Set the gradlew file path: this is the path where the Gradle Wrapper lives in your project. The path should be relative to the project's root.
4. Optionally, you can set a build.gradle file for the Step in the Optional path to the gradle build file to use input.

To configure exporting an APK or AAB file generated by the Step:

1. Open the Export config input group.
2. Filter the files you want the Step to export. You can filter:
   • APK and AAB files.
   • Test APK files.
   • Mapping files. Both exclude and include filters can be used. Each filter option can take multiple patterns, with each pattern on its own line in the input field.

Troubleshooting

If the Step keeps failing because it can't download the dependencies, check the repositories section in your build.gradle file. It's possible that one or more of the services listed there are down so we Bitrise can't connect to them to download the dependencies you need.

If you use a build.gradle file and get the error Issue with input: GradleFile does not exist, check the Optional path to the gradle build file to use input. Remember, the path must be relative to the root of the repository.

Useful links

• Gradle Wrapper
• Caching Gradle

Related Steps

• Generate Gradle Wrapper
• Gradle Unit Test
• Android Build

🧩 Get started

Add this step directly to your workflow in the Bitrise Workflow Editor.

You can also run this step directly with Bitrise CLI.

Examples

This configuration builds all variant's aab:

- gradle-runner@2:
    inputs:
    - gradlew_path: "./gradlew"
    - gradle_task: bundleRelease

You can also set up file path filters to avoid exporting unwanted archives or mapping files:

- gradle-runner@2:
    inputs:
    - gradlew_path: "./gradlew"
    - gradle_task: bundleRelease
    - app_file_include_filter: "*release.aab"
    - app_file_exclude_filter: "*/temporary/*"
    - test_apk_file_include_filter: "*Test*.apk"
    - test_apk_file_exclude_filter: "*/immediate/*"
    - mapping_file_include_filter: "*/mapping.txt"
    - mapping_file_exclude_filter: "*/tmp/*"

⚙️ Configuration

Inputs

Key	Description	Flags	Default
gradle_file	Optional path to the Gradle build file to use. It should be relative to the root of the project.		$GRADLE_BUILD_FILE_PATH
gradle_task	Gradle task to run. You can call gradle tasks or gradle tasks --all in your Gradle project directory to get the list of available tasks.	required	assemble
gradlew_path	Using a Gradle Wrapper (gradlew) is required, as the wrapper ensures that the right Gradle version is installed and used for the build. You can find more information about the Gradle Wrapper (gradlew), and about how you can generate one in the official guide at: https://docs.gradle.org/current/userguide/gradle_wrapper.html. The path should be relative to the repository root. For example, ./gradlew, or if it is in a sub directory, ./sub/dir/gradlew.	required	$GRADLEW_PATH
app_file_include_filter	The Step will copy the generated APK and AAB files that match this filter into the Bitrise deploy directory. Seperate patterns with a newline. Example: Copy every APK and AAB file: *.apk *.aab Copy every APK file with a filename that contains release, like (./app/build/outputs/apk/app-release-unsigned.apk): *release*.apk		*.apk *.aab
app_file_exclude_filter	One filter per line. The Step will NOT copy the generated APK and AAB files that match these filters into the Bitrise deploy directory. You can use this filter to avoid moving unaligned and/or unsigned APK and AAB files. If you specify an empty filter, every APK and AAB file (selected by APK and AAB file include filter) will be copied. Seperate patterns with a newline. Examples: Do not copy APK files with a filename that contains unaligned: *unaligned*.apk Do not copy APK files with a filename that contains unaligned and/or Test: *unaligned*.apk *Test*.apk		*unaligned.apk *Test*.apk */intermediates/*
test_apk_file_include_filter	The Step will copy the generated apk files that match this filter into the Bitrise deploy directory. Example: Copy every APK if its filename contains Test, like (./app/build/outputs/apk/app-debug-androidTest-unaligned.apk): *Test*.apk		*Test*.apk
test_apk_file_exclude_filter	One filter per line. The Step will NOT copy the generated apk files that match this filters into the Bitrise deploy directory. You can use this filter to avoid moving unalinged and/or unsigned apk files. If you specify an empty filter, every APK file (selected by apk_file_include_filter) will be copied. Example: Do not copy the test APK file if its filename contains unaligned: *unaligned*.apk
mapping_file_include_filter	The Step will copy the generated mapping files that match this filter into the Bitrise deploy directory. If you specify an empty filter, no mapping files will be copied. Example: Copy every mapping.txt file: *mapping.txt		*/mapping.txt
mapping_file_exclude_filter	The Step will not copy the generated mapping files that match this filter into the Bitrise deploy directory. You can use this input to avoid moving a beta mapping file, for example. If you specify an empty filter, every mapping file (selected by mapping_file_include_filter) will be copied. Example: Do not copy any mapping.txt file that is in a beta directoy: */beta/mapping.txt		*/tmp/*
cache_level	all - will cache build-cache and dependencies only_deps - will cache dependencies only none - won't cache any of the above	required	only_deps
gradle_options	Options added to the end of the Gradle call. You can use multiple options, separated by a space character. Example: --stacktrace --debug If --debug or -d options are set then only the last 20 lines of the raw gradle output will be visible in the build log. The full raw output will be exported to the $BITRISE_GRADLE_RAW_RESULT_TEXT_PATH variable and will be added as an artifact.		--stacktrace --no-daemon
apk_file_include_filter	This input is DEPRECATED - use the APK and AAB file include filter input instead and set this input to empty value. The step will copy the generated APK files that match this filter into the Bitrise Deploy Directory. If you specify an empty filter, the new input "APK and AAB file include filter" will be used. Example: Copy every APK file: "*.apk" Copy every APK file with a filename that contains release, like (./app/build/outputs/apk/app-release-unsigned.apk): *release*.apk
apk_file_exclude_filter	This input is DEPRECATED - use the APK and AAB file exclude filter input instead and set this input to empty value. One filter per line. The step will not copy the generated APK files that match this filters into the Bitrise Deploy Directory. You can use this filter to avoid moving unalinged and/or unsigned apk files. If you specify an empty filter, the new input "APK and AAB file exclude filter" will be used. Examples: Do not copy APK files with a filename that contains unaligned: *unaligned*.apk Do not copy APK files with a filename that contains unaligned and/or Test: *unaligned*.apk *Test*.apk
collect_metrics	Enable Gradle metrics collection and send data to Bitrise.		no

Outputs

Environment Variable	Description
BITRISE_APK_PATH	This output will include the path of the generated APK file, after filtering based on the filter inputs. If the build generates more than one APK file which fulfills the filter inputs this output will contain the last one's path.
BITRISE_AAB_PATH	This output will include the path of the generated AAB file, after filtering based on the filter inputs. If the build generates more than one AAB file which fulfills the filter inputs this output will contain the last one's path.
BITRISE_TEST_APK_PATH	This output will include the path of the generated test APK file, after filtering based on the filter inputs. If the build generates more than one APK file which fulfills the filter inputs this output will contain the last one's path.
BITRISE_APK_PATH_LIST	This output will include the paths of the generated APK files, after filtering based on the filter inputs. The paths are separated with | character, eg: app-armeabi-v7a-debug.apk|app-mips-debug.apk|app-x86-debug.apk
BITRISE_AAB_PATH_LIST	This output will include the paths of the generated AAB files, after filtering based on the filter inputs. The paths are separated with | character, eg: app.aab|app2.aab
BITRISE_MAPPING_PATH	This output will include the path of the generated mapping.txt. If more than one mapping.txt exist in project this output will contain the last one's path.

🙋 Contributing

We welcome pull requests and issues against this repository.

For pull requests, work on your changes in a forked repository and use the Bitrise CLI to run step tests locally.

Learn more about developing steps:

• Create your own step
• Testing your Step