Skip to main content

Common Workflow Steps

The steps listed below are common across all build profiles regardless of the target OS and platform.

You can find the full list of available workflow steps in our workflow marketplace and under each workflow step in this document, you can find the related repository URL, which also includes the documentation for the related step.

Component Downloader

This is a built-in step present within the build agent and executed before every step in the workflow. It is responsible for downloading the sources of the next step/component in the workflow.

Activate SSH Key

This step sets up your SSH key in the build machine if you used one to connect your repository. This allows the build machine to connect to your private repository using your SSH key.

GitHub - appcircleio/appcircle-activate-ssh-key-component
Contribute to appcircleio/appcircle-activate-ssh-key-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-activate-ssh-key-component favicon https://github.com/appcircleio/appcircle-activate-ssh-key-component
GitHub - appcircleio/appcircle-activate-ssh-key-component

Custom Scripts

You can use custom scripts for additional functionalities in your builds. Appcircle will run the commands in your custom scripts and perform the specified actions. These scripts will be run on the build agent and you can use any functionality of the virtual machine as you need.

GitHub - appcircleio/appcircle-custom-script-component
Contribute to appcircleio/appcircle-custom-script-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-custom-script-component favicon https://github.com/appcircleio/appcircle-custom-script-component/
GitHub - appcircleio/appcircle-custom-script-component

Git Clone

Clones the Git repository to the build agent with the given arguments.

GitHub - appcircleio/appcircle-git-clone-component
Contribute to appcircleio/appcircle-git-clone-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-git-clone-component favicon https://github.com/appcircleio/appcircle-git-clone-component
GitHub - appcircleio/appcircle-git-clone-component

Export Build Artifacts

Exports the specified build artifacts from the build agent to the Appcircle dashboard. The exported files will be available for download from the artifacts section of the completed build.

GitHub - appcircleio/appcircle-export-build-artifacts: Exports the specified build artifacts for download from the completed builds list
Exports the specified build artifacts for download from the completed builds list - appcircleio/appcircle-export-build-artifacts
GitHub - appcircleio/appcircle-export-build-artifacts: Exports the specified build artifacts for download from the completed builds list favicon https://github.com/appcircleio/appcircle-export-build-artifacts
GitHub - appcircleio/appcircle-export-build-artifacts: Exports the specified build artifacts for download from the completed builds list

Cache Push

Every single build at Appcircle runs in clean state. It means that all files and folders, that are not versioned in git repository, are lost when build pipeline is completed. For example, installed dependencies or build artifacts. If you need to keep those files and folders, you can use Appcircle cache push and pull components.

With cache you can persist any resource that are ignored from Git. So you can transfer files and folders between build pipelines. Sometimes it may speed up your build or it may help if you have reliability issues with the original download location for dependencies. But keep in mind that the cache is uploaded to or downloaded from remote location. It may help you in some cases, but it's not a guaranteed way of speeding up builds. You should try and see the actual results for your project.

info

Using Cache Pull/Push steps, particularly when employing repository management software like Sonatype Nexus Repository, may not always yield the desired efficiency in reducing build time.

The cache is stored as a single archive file. Cache push and pull components work in coordination on the same cache file defined with a label. With custom labelling you can have different chunks of caches and you can share some caches between branches. Cache labelling helps you organize your caches.

When you drag and drop cache push component to your workflow, it comes with pre-defined values according to your project type. For example, for android projects it comes with pre-defined gradle cache paths which should be useful for most Android apps.

If you need more paths to cache or need to change paths according to your project, you can customize included and excluded paths as you wish. All path updates will be reflected to archived cache file on your next build.

Cache push uses a pattern in order to select files and folders. Although the pattern is not a regexp, it's closer to a shell glob. For example, ~/Library/Caches/CocoaPods will select "Cocoapods" folder from home as a whole. Or for an android project you can cache home ".gradle" folder with ~/.gradle include path and exclude all ".lock" files from there with ~/.gradle/**/*.lock exclude path. Patterns, that can be used in included and excluded paths, is explained in detail here.

danger

Keep in mind that included paths and cache push step's workflow order are closely related with each other. For example, if you include a path from repository and you place cache push step before git clone step, cache push won't find that path since it's not git cloned yet. Although that's not a fatal error for cache push, it will inform you about unreachable paths on build logs. You can review and resolve those kinds of issues from build logs.

You can not reach the cache archive file directly by yourself. But you can see cache file updates and track changes to cache at the end of build pipeline from "Download Artifacts > ac_cache.zip". Also build logs have some useful information about cache mechanism with how included and excluded paths are processed. You can see produced cache file size from build logs. (Size of cache file affects upload and download durations.)

danger

You can not delete specific cache file from UI but if you have a problem with cache file and need a fresh one, you can change your cache label to a new one to go on with clean cache.

info

System automatically cleans unreachable and obsolete cache files periodically. For this reason, it's not guaranteed to reach a previously used cache file by using previous cache label in build. Also it’s a good idea to build your workflow in a way that your build won’t fail if the cache can’t be accessed.

GitHub - appcircleio/appcircle-cache-push-component
Contribute to appcircleio/appcircle-cache-push-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-cache-push-component favicon https://github.com/appcircleio/appcircle-cache-push-component
GitHub - appcircleio/appcircle-cache-push-component

Cache Pull

Cache push uploads cache archive file to remote location as we explained in detail above. On the other hand cache pull downloads and extracts that archive file in build pipeline. All files and folders are extracted to original locations that came from.

danger

Cache push and pull components should work in coordination on the same cache file. For this reason in order to download the pushed cache, cache pull must have the same cache label used in cache push.

info

In the event that you need to utilize the cached folder in an alternate branch or a separate project, you have the capability to modify the values of $AC_GIT_BRANCH or $AC_BUILD_PROFILE_ID.

These variables can be adjusted within the Cache Label field, as indicated by the red highlight in the accompanying image. Simply replace them with the branch or project ID that corresponds to your intended usage.

Also you can have more than one push and pull pairs in the same build pipeline according to your needs.

GitHub - appcircleio/appcircle-cache-pull-component
Contribute to appcircleio/appcircle-cache-pull-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-cache-pull-component favicon https://github.com/appcircleio/appcircle-cache-pull-component
GitHub - appcircleio/appcircle-cache-pull-component

Release Notes

You can use Release Notes component to create release notes during your workflow.

GitHub - appcircleio/appcircle-release-notes-component
Contribute to appcircleio/appcircle-release-notes-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-release-notes-component favicon https://github.com/appcircleio/appcircle-release-notes-component
GitHub - appcircleio/appcircle-release-notes-component

SonarQube

You can use SonarQube component to check your code quality.

GitHub - appcircleio/appcircle-sonarqube-component: Appcircle SonarQube Component
Appcircle SonarQube Component. Contribute to appcircleio/appcircle-sonarqube-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-sonarqube-component: Appcircle SonarQube Component favicon https://github.com/appcircleio/appcircle-sonarqube-component
GitHub - appcircleio/appcircle-sonarqube-component: Appcircle SonarQube Component

Appium Server

This step installs Appium Server and starts it.

GitHub - appcircleio/appcircle-appium-component: Appcircle Appium Server Component
Appcircle Appium Server Component. Contribute to appcircleio/appcircle-appium-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-appium-component: Appcircle Appium Server Component favicon https://github.com/appcircleio/appcircle-appium-component
GitHub - appcircleio/appcircle-appium-component: Appcircle Appium Server Component

Firebase App Distribution

Send your apps to be distributed via Firebase App Distribution

GitHub - appcircleio/appcircle-firebase-distribution-component: Firebase Distribution Component
Firebase Distribution Component. Contribute to appcircleio/appcircle-firebase-distribution-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-firebase-distribution-component: Firebase Distribution Component favicon https://github.com/appcircleio/appcircle-firebase-distribution-component
GitHub - appcircleio/appcircle-firebase-distribution-component: Firebase Distribution Component

Firebase Deployment

Deploy your web applications to Firebase Hosting

GitHub - appcircleio/appcircle-firebase-deploy-component
Contribute to appcircleio/appcircle-firebase-deploy-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-firebase-deploy-component favicon https://github.com/appcircleio/appcircle-firebase-deploy-component
GitHub - appcircleio/appcircle-firebase-deploy-component

Firebase Upload dSYM

Upload your debug symbols to Firebase Crashlytics

GitHub - appcircleio/appcircle-firebase-dsym-upload-component
Contribute to appcircleio/appcircle-firebase-dsym-upload-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-firebase-dsym-upload-component favicon https://github.com/appcircleio/appcircle-firebase-dsym-upload-component
GitHub - appcircleio/appcircle-firebase-dsym-upload-component

Fortify On Demand

This step installs Fortify on Demand and submits a Fortify on Demand Mobile Assessment

GitHub - appcircleio/appcircle-fod-mobile-assessment
Contribute to appcircleio/appcircle-fod-mobile-assessment development by creating an account on GitHub.
GitHub - appcircleio/appcircle-fod-mobile-assessment favicon https://github.com/appcircleio/appcircle-fod-mobile-assessment
GitHub - appcircleio/appcircle-fod-mobile-assessment

Code Reviews with Danger

Danger runs during your CI process and gives teams the chance to automate common code review chores. This provides another logical step in your build, through this Danger can help lint your rote tasks in daily code review. You can use Danger to codify your team’s norms. Leaving humans to think about harder problems.

GitHub - appcircleio/appcircle-danger-component
Contribute to appcircleio/appcircle-danger-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-danger-component favicon https://github.com/appcircleio/appcircle-danger-component
GitHub - appcircleio/appcircle-danger-component
Danger in CI: Automate Your Mobile Code Reviews - Appcircle Blog
Did you know that you can set rules for your code reviews and make sure they are checked before submitted? You can with running Danger in CI.
Danger in CI: Automate Your Mobile Code Reviews - Appcircle Blog favicon https://blog.appcircle.io/article/danger-in-ci-automate-your-mobile-code-reviews
Danger in CI: Automate Your Mobile Code Reviews - Appcircle Blog

Authenticate with netrc

The .netrc file contains login and initialization information used by the auto-login process. You can use this component to add credentials for hosts such as your repositories or external hosts. Git automatically recognizes the .netrc file. However, if you want to use the .netrc file with curl, you need to append the -n command line parameter. You may also use the --netrc-optional parameter if you don't always use the .netrc file with curl.

GitHub - appcircleio/appcircle-netrc-component
Contribute to appcircleio/appcircle-netrc-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-netrc-component favicon https://github.com/appcircleio/appcircle-netrc-component
GitHub - appcircleio/appcircle-netrc-component

File size check

This component checks the file size and either warn or fail the workflow.

GitHub - appcircleio/appcircle-filesize-component
Contribute to appcircleio/appcircle-filesize-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-filesize-component favicon https://github.com/appcircleio/appcircle-filesize-component
GitHub - appcircleio/appcircle-filesize-component

FTP Upload

This component uploads file or folders to given FTP server.

GitHub - appcircleio/appcircle-ftp-upload-component
Contribute to appcircleio/appcircle-ftp-upload-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-ftp-upload-component favicon https://github.com/appcircleio/appcircle-ftp-upload-component
GitHub - appcircleio/appcircle-ftp-upload-component

Testinium

This component runs your test plans with Testinium.

GitHub - appcircleio/appcircle-testinium-component
Contribute to appcircleio/appcircle-testinium-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-testinium-component favicon https://github.com/appcircleio/appcircle-testinium-component
GitHub - appcircleio/appcircle-testinium-component

Maestro Cloud Upload

This component uploasd both your app binary and flows to Maestro Cloud.

GitHub - appcircleio/appcircle-maestro-cloud-upload-component
Contribute to appcircleio/appcircle-maestro-cloud-upload-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-maestro-cloud-upload-component favicon https://github.com/appcircleio/appcircle-maestro-cloud-upload-component
GitHub - appcircleio/appcircle-maestro-cloud-upload-component

Data Theorem Mobile Secure

This component scans your app using Mobile Secure

GitHub - appcircleio/appcircle-datatheorem-component
Contribute to appcircleio/appcircle-datatheorem-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-datatheorem-component favicon https://github.com/appcircleio/appcircle-datatheorem-component
GitHub - appcircleio/appcircle-datatheorem-component

Repeato Mobile Test Automation

This component creates and automates UI tests for iOS and Android.

GitHub - appcircleio/appcircle-repeato-component: Repeato Test Runner Component
Repeato Test Runner Component. Contribute to appcircleio/appcircle-repeato-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-repeato-component: Repeato Test Runner Component favicon https://github.com/appcircleio/appcircle-repeato-component
GitHub - appcircleio/appcircle-repeato-component: Repeato Test Runner Component

Snyk Scan Security

By utilizing this step, you will be able to test your project dependencies for vulnerabilities during builds and use Snyk to monitor your projects.

GitHub - appcircleio/appcircle-snyk-scan-secure-component: Appcircle Snyk Scan Security Component
Appcircle Snyk Scan Security Component. Contribute to appcircleio/appcircle-snyk-scan-secure-component development by creating an account on GitHub.
GitHub - appcircleio/appcircle-snyk-scan-secure-component: Appcircle Snyk Scan Security Component favicon https://github.com/appcircleio/appcircle-snyk-scan-secure-component
GitHub - appcircleio/appcircle-snyk-scan-secure-component: Appcircle Snyk Scan Security Component