Skip to main content

How to Share Files Between Build Profiles

With the build cache structure provided by Appcircle, cache files can be shared between different Build Profiles. This sharing of files enables the faster generation of packages in different Build Profiles, reducing build time. Below is a simple, step-by-step example of how you can achieve this.


This simple example will use our CocoaPods files in different build profiles. If you intend to use a cache other than dependencies, please refer to the documentation for the Cache Push component.


To share cache between Build Profiles, the Cache Pull component must be added to the related pipeline.


As an example, master and development branches were used, but you can apply the same operations to different branches.


Please note that the organizational structure of Appcircle is designed in such a way as to prevent any security vulnerabilities. Consequently, exchanging files between organizations or sub-organizations is not permitted.

You can find detailed information about the Appcircle organizational structure in the documentation here.

  1. Firstly, the caching of CocoaPods files is initiated in the Appcircle Team build profile. These files will subsequently be utilized in the Appcircle Team 2 build profile. To accomplish this, the Cache Push step should be incorporated into the workflow after the CocoaPods Install step in the initial build profile.
  1. After the successful completion of the build in the Appcircle Team build profile, the cached CocoaPods files are now available for use in the Appcircle Team 2 build profile.
  1. For the Appcircle Team 2 build profile, the workflow steps need to be adjusted accordingly. To do this, the Cache Pull step should be added to the workflow before the CocoaPods Install step for the relevant branch.
  1. When the Cache Pull step is entered, the cache label parameter is encountered, which is set as $AC_BUILD_PROFILE_ID/$AC_GIT_BRANCH/cache by default. Here, the value of $AC_BUILD_PROFILE_ID needs to be updated because a different profile is being used. To accomplish this, the build profile ID of the Appcircle Team where the files were cached will be used. This ID can be found directly at the Appcircle URL. For example, in the URL, edc136b9-85fc-4e0a-aa7c-602375a84f64 represents the build profile ID. After setting the profile ID, the $AC_GIT_BRANCH value that was cached in the previous profile, Appcircle Team, is specified, which is set to the development branch. Consequently, the cache label parameter will appear as edc136b9-85fc-4e0a-aa7c-602375a84f64/development/cache.

  2. After this parameter change, the CocoaPods dependencies that were cached in the development branch of the Appcircle Team build profile will be automatically pulled to the master branch of Appcircle Team 2 and used directly in the pipeline.


When sharing cache files between Build Profiles, please make sure that you spell your build profile ID and branch names correctly and use the Cache Push and Cache Pull steps correctly in each profile.