Skip to main content

Build Profile Configuration Overview

Configuring a build profile has some basic steps that need to be completed before starting a build.

Creating a configuration

You may create Distribution configuration to send your app to public stores or create Testing configuration to send your app to testers. Configurations allow you to set different certificates, distribution channels that can be used with different workflows.

  • Click on Configurations to create configurations for different scenarios.

  • Click on New button to create your first configuration.

  • You may change the name of the configuration or delete the ones you don't need.

Project details configuration

Every build profile needs to know project details regardless of the project being iOS or Android project. Project details can be entered manually or can be fetched from your project automatically by Appcircle if you click on Autofill button.

You can also select your self-hosted runner from the SELECT A POOL dropdown.

File IconSelf-Hosted Runners

Signing configuration

Both iOS and Android applications need to be digitally signed by their developers in order to be able to be installed on real devices or submitted to app stores.

iOS certificates and Android keystores can be generated within Appcircle or pre-obtained certificates can be uploaded. iOS provisioning profiles need to be obtained from Apple Developer account and uploaded to Appcircle.

Distribution configuration

Distribution is a critical step when it comes to test your application on real devices. You may need multiple testers and test groups to download, install and test your application and make sure it works on different devices and operating system versions.

Distribution configuration allows you to set up which testing groups will receive your application after the build is complete. You can manually send your binary file to testers or Appcircle can do this for you.

You can select a previously created distribution profile or create a new one on this window. Use the top input box to enter a name for the new distribution profile you want to create. Press enter or click on the green + icon on the right to create the distribution profile.

Finally, check Auto Distribute if you want your build to be deployed to the Testing Distribution automatically and Auto Deployment if you want the build to be deployed to Store Submission automatically.

Environment variables configuration

You can define variables and secrets to be incorporated during the build in the Environment Variables submodule so that you don't need to store certain keys and configurations within the repository.

Versioning configuration

You can set custom rules to manage the versioning of your app. You can increase both the build number and version number according to the rules you set.

Workflows and Triggers

For advanced configuration, you can utilize workflows and for automatic builds, you can utilize triggers.

These options are available at the profile level in the profile context menu.

Need help?

Get help from Appcircle's support team, or see how others are using Appcircle by joining our Slack Channel.

Slack favicon