Adding a Build Profile & Connecting a Repository
New to Appcircle Build module? Follow our quick start guide to build your iOS and Android apps in the cloud.
The Build Module allows you to streamline and automate your mobile app build flows.
The Build Module is the first step to automate your CI/CD processes via Appcircle.
Create a build profile (app)
A build profile is an app that you can build in a target OS and framework.
To create your first build profile, click on the orange "Add New" button on the top left of the screen.
Enter a name for your build profile and select the target operating system (iOS or Android) and target platform.
Connect your repository
You can connect GitHub through a GitHub app or Bitbucket and GitLab repositories to your build profile through OAuth apps. Alternatively, You can connect private repositories through SSH and public repositories directly on GitHub, Bitbucket, GitLab, and other compatible git providers such as Azure DevOps and AWS CodeCommit. (Please refer here for more information on AWS CodeCommit connections.)
You can also connect to your Self Hosted Bitbucket and GitLab account directly within Appcircle.
If you authorize Appcircle to connect to your Github, BitBucket, or GitLab account, you can auto-build your project with hooks, get build statuses and the full list of commits. If you connect to a repository through SSH or through a public URL, you need to set up webhooks manually.
To test drive Appcircle, you can find various sample projects in the Appcircle GitHub page or you can just press on the Quick start using the sample repository button to populate the repository URL field with a compatible project based on the selected framework.
When the "Autofill" toggle is activated on the Select Repository popup, Appcircle will try to create a default configuration using the selected repository and fill in the necessary fields.
When you have exceeded the build limit of your plan, Appcircle will not be able to Autofill your build profile, although you activated the toggle.
Refer to the relative documents under this page about the connections and differences between connection types:
- Connect to GitHub
- Connect to Bitbucket
- Connect to GitLab
- Connect to Private Repository via SSH Key
- Connect to Public Repository
View the newly created build profile
You will see your build profile once it has been created. Click on the build profile to connect a repository and fetch your code to Appcircle.
Appcircle will then pull your branches, commits, and other information from your repository.
Delete a Build Profile
In order to delete a build, simply click on the Three Dot and click delete.
After the prompt, the profile will be deleted.
In order to free up storage in your organization, you should also remove the other references pointing to the artifact. In example, if you have the same artifact on the testing distribution, you should also delete those artifacts as well.
FAQ
Repository Connection Issues
Please note that currently only Git repositories are supported. Any third party version control repositories need to be transferred to a proper Git repository on either Github or Bitbucket.
How to change your connected GitHub, Bitbucket, or GitLab account?
You will need to go to your Github, Bitbucket, or GitLab account and revoke access to Appcircle and then reconnect your account from Appcircle.
Unable to see the repositories in the connected repository provider
Please check if you have owner/admin access in the specific organization from which the repositories will be connected. Appcircle does not allow connections to the repositories with a member-level access.
Error accessing the repository. Please check if the repository exists or if you have the required privileges.
- Only members who have admin role on repository or are owner of the organization can install the Github App in an organization that owns that repository.
- Only members who have admin role on a repository or are owner of the organization can connect a repository to a profile.
If you still can't solve your issues, ask on our Slack page. Our community and our support engineers will help you whenever they're available:
Need help?
Get help from Appcircle's support team, or see how others are using Appcircle by joining our Slack Channel.
