Skip to main content

Platform Build Guides

Find detailed instructions on building applications for various platforms using Appcircle:

Building iOS Applications

Comprehensive guide for setting up iOS app builds, from provisioning to distribution.

File Icon Building iOS Applications

Building Android Applications

Step-by-step instructions on how to configure and optimize the Android build process.

File Icon Building Android Applications

Building React Native Applications

Tailored guidance for building React Native apps, covering both iOS and Android builds.

File Icon Building React Native Applications

Building Flutter Applications

Everything you need to know to build Flutter applications for multiple platforms.

File Icon Building Flutter Applications

Building Ionic Projects with Custom Scripts

Learn how to use custom scripts to build and customize Ionic projects for any requirements.

File Icon Building Ionic Projects with Custom Scripts


General Build Troubleshooting

There may be a bunch of reasons for a build to fail.

The best way to learn the reason is to check the build logs. See Working With Build Logs section for details on this.

Build logs will display everything that happened in each workflow step in detail and let you examine what went wrong during the build.

If you are unable to determine the exact cause, feel free to get in touch with Appcircle using the in-app messaging for additional support.

Troubleshooting Workflow Steps for Build Failures

Most build failures are related with the following build steps. If you encounter any errors, please remove or edit the following steps and get a build to help isolate the cause of the issue.

  • iOS Sign Errors: If the selected provisioning profile does not match with the selected bundle ID or if the certificate is not valid, you may have an issue in the iOS signing step. In this case, you may try getting an unsigned build
  • Xcode Build for Simulator step: This step builds your target for either x86_64 or arm64 architecture. In some projects, there may be dependencies that are not compatible with given architecture. In this case, please remove this step from the workflow or remove the conflicting dependencies to get a successful build.
  • Android Sign Errors: If you encounter errors while signing your Android app, you can remove this step to get an unsigned build or you can configure the app signing within your project.

The Build is Taking Too Long

With every build, a brand new virtual machine is started to perform your workflow and build your application.

Some applications may have 3rd party dependencies which need to be installed before the build is performed. With every new build, these dependencies need to be re-installed.

One way to speed up the build time may be to manage your dependencies in your project. This will speed up your builds significantly if your application has an excess amount of dependencies to be installed.

If you still think that your build is taking significantly longer than it should, please feel free to get in touch with Appcircle for additional support.