Appcircle is a mobile CI/CD platform that provides a fully automated environment to manage mobile app lifecycle end-to-end, transforming DevOps to NoOps with the best practices. Appcircle supports the full lifecycle of Native iOS apps for all CI/CD needs. In this article, we will be building and deploying a Native iOS app with Appcircle with no need for a Mac or any third-party tools.
The first step is getting started with Appcircle. Just go to <a href="https://my.appcircle.io/" target="_blank" rel="noopener">https://my.appcircle.io/</a> and register. (Regardless of the login provider you select, you can connect any other provider for the repository connections.)
<h2>Creating a Build Profile for a Native iOS Project</h2>
In Appcircle, a build profile contains the build workflows and the configuration of a Native iOS app target.
To create your first build profile, click on the orange “Add New” button on the middle of the screen.
<img class="aligncenter wp-image-6253 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile.png" alt="build profiles" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/buildProfile-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
&nbsp;
Enter a name for your build profile and select the target operating system (iOS) and the target platform as Objective-C/Swift.
<img class="aligncenter wp-image-6254 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform.png" alt="add new profile" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/targetPlatform-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
You will see your build profile once it has been created. Click on the build profile to connect to a repository that contains a valid Native iOS app.
You can connect GitHub, Bitbucket, Azure, 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, Azure, and other compatible Git providers.
You can authorize Appcircle to connect to your cloud repository provider account. This will allow you to use auto-build your project with hooks. If you authorize Appcircle to access your repositories, you can select the repository that you want to connect. If you use a private repository using an SSH Key, you need to have an SSH key pair ready and enter your private key to Appcircle so Appcircle can access your repository.
Appcircle will then pull your branches, commits, and other information from your repository.
To test drive the Appcircle platform for Native iOS app builds, you can also use our sample iOS App by forking it or adding it as a public repository: <a href="https://github.com/appcircleio/appcircle-sample-ios" target="_blank" rel="noopener">https://github.com/appcircleio/appcircle-sample-ios</a>
<img class="aligncenter wp-image-6255 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/connection.png" alt="repository selection in appcircle" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/connection.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/connection-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/connection-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/connection-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/connection-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/connection-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/connection-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
&nbsp;
<h2>Native iOS Application Build Configuration</h2>
The build configuration has different flows for iOS and Android and the projects are configured on a branch basis. You can have different configurations for different branches and you can build any of your commits (assuming that they are compatible with the current configuration).
<h3>iOS Build Configuration</h3>
Click on the gear icon on the top middle to access the build configuration. The first step will be entering the project details. You can enter these details manually or click on the Autofill button to retrieve them from your project to detect the correct path for the Xcode project automatically. 
Your iOS project needs to have an Xcode project or an Xcode workspace and a shared scheme to complete the build configuration successfully. Appcircle can fetch these workspaces and shared schemes from your branch automatically.
You can also select a specific Xcode version if you have certain dependencies or if you want to test your build on a specific version.
&nbsp;
<img class="aligncenter wp-image-6256 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/config.png" alt="appcircle build configuration" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/config.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/config-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/config-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/config-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/config-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/config-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/config-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
<h3>Build Triggers for Auto Builds</h3>
The next section, Triggers, is common for iOS.
Appcircle allows you to trigger builds manually or automatically using build triggers.
<ul>
<li>On Every Push: Whenever code is pushed to a configured branch, the build is triggered.</li>
<li>On Merge/Pull Request: When a PR is opened, the last commit of the PR is automatically triggered.</li>
<li>On Tag Push: Whenever a tagged commit is pushed, the build is triggered for that commit. Commits without any tags are ignored.</li>
</ul>
<img class="aligncenter wp-image-6257 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/trigger.png" alt="appcircle build triggers" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/trigger.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/trigger-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/trigger-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/trigger-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/trigger-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/trigger-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/trigger-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
<h3>Signing Configuration</h3>
Appcircle allows you to sign your app for deployment.
Appcircle is unique that it doesn’t require you to generate signing identities with a third-party tool. You can simply create your iOS certificates/profiles within the platform and use them in any project in a centralized manner.
If you have readily available signing identities, you can also upload them once to the Appcircle Signing Identities module and use them centrally in any project. (No need for separate uploads of the same certificate for separate projects.)
<ul>
<li>For more information on iOS certificate and provisioning profile management, please refer to the following document: <a href="https://docs.appcircle.io/signing-identities/ios-certificates-and-provisioning-profiles" target="_blank" rel="noopener noreferrer">https://docs.appcircle.io/signing-identities/ios-certificates-and-provisioning-profiles</a></li>
</ul>
For signing Native iOS app, press add, select the bundle ID from the first dropdown and then select a compatible provisioning profile (added from the signing identities module) from the second dropdown.
&nbsp;
<img class="aligncenter wp-image-6258 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/sign.png" alt="apple single build sign" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/sign.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/sign-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/sign-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/sign-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/sign-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/sign-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/sign-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
&nbsp;
<h3>Distribution (Deployment) Configuration</h3>
Appcircle is an end-to-end mobile CI/CD tool enables you to build and deploy your apps to mobile devices with full automation.
Distribution is a critical step when it comes to testing 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.
For more information on how to set up testing groups and deploy your app after the build, please refer to the following document: <a href="https://docs.appcircle.io/distribute/create-or-select-a-distribution-profile" target="_blank" rel="noopener noreferrer">https://docs.appcircle.io/distribute/create-or-select-a-distribution-profile</a>.
You can select a previously created distribution profiles. Use the toggle that you want to distribute your own app automatically, and select the related distribution profile. You can enable other distribution methods such as <a href="/publish-module/" target="_blank" rel="noopener">Publish Module</a> or <a href="/enterprise-appstore/" target="_blank" rel="noopener">Enterprise App Store</a>.
If the target profile has auto-send configured, your testers will receive the latest version automatically.
&nbsp;
<img class="aligncenter wp-image-6259 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/dist.png" alt="appcircle build distribution" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/dist.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/dist-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/dist-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/dist-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/dist-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/dist-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/dist-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
&nbsp;
<h3>Environment Variables Configuration</h3>
The final tab is to add environment variables to the build. For advanced use cases, 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.
&nbsp;
<h2>Workflows for Advanced Build Configuration</h2>
Appcircle is a simple, but flexible platform. You can make basic changes in a simple user interface with the build configuration and use the workflows for advanced use cases. A workflow is a ladder of steps taken to build your applications. Each step has a different purpose and the workflow can be customized by modifying step parameters and inputs, running custom scripts, or re-ordering steps. Workflows allow you to have complete control on your build process and enhance it with third-party services and features.
Also, note that the workflows are set up by default, so you don’t need to set them up for builds.
For more information on the workflows, you can refer to the following document: <a href="https://docs.appcircle.io/workflows/why-to-use-workflows" target="_blank" rel="noopener">https://docs.appcircle.io/workflows/why-to-use-workflows</a>
You have a wide variety of options with workflows. For instance, if you want to run a specific command before or after the build, you can add a custom script step at any point in the workflow. If you want to deploy your app with a third-party service instead of Appcircle, you can configure it with the workflows.
&nbsp;
<img class="aligncenter wp-image-6260 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/workflow.png" alt="push workflow editing" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/workflow.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/workflow-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/workflow-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/workflow-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/workflow-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/workflow-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/workflow-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
&nbsp;
<h2>Starting a Build and After a Build</h2>
To start your first build, just press the start build button – the play button above the actions columns (or push some code to your repo if auto-build is configured.)
You will see the build progress and the log in real-time.
&nbsp;
<img class="aligncenter wp-image-6261 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/log.png" alt="build logs" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/log.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/log-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/log-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/log-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/log-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/log-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/log-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
Once your build is complete, you can now download the binary file or deploy it to distribute module manually (if autodistribute is enabled, it will be sent automatically after a successful build).
You can also view or download your build logs anytime.
&nbsp;
<img class="aligncenter wp-image-6262 size-full" src="https://ac.appcircle.io/wp-content/uploads/2024/03/download.png" alt="app build list" width="1680" height="929" srcset="https://ac.appcircle.io/wp-content/uploads/2024/03/download.png 1680w, https://ac.appcircle.io/wp-content/uploads/2024/03/download-300x166.png 300w, https://ac.appcircle.io/wp-content/uploads/2024/03/download-1030x570.png 1030w, https://ac.appcircle.io/wp-content/uploads/2024/03/download-768x425.png 768w, https://ac.appcircle.io/wp-content/uploads/2024/03/download-1536x849.png 1536w, https://ac.appcircle.io/wp-content/uploads/2024/03/download-1500x829.png 1500w, https://ac.appcircle.io/wp-content/uploads/2024/03/download-705x390.png 705w" sizes="(max-width: 1680px) 100vw, 1680px" />
&nbsp;
<div class="Post_postContent__gQhDD">
<h2>Testing the Native iOS App</h2>
With Appcircle, you can use the standard unit testing workflows by adding the related iOS test steps or by running custom scripts.
</div>

Streamline the CI/CD of your Native iOS apps now!

Guide to Automated Mobile CI/CD for Native iOS with Appcircle

Related Posts

iOS Code Review Practices for Efficient Pull Requests

Transforming Appcircle’s Enterprise App Store into Alternative App Marketplaces with Apple Sideloading

How to Build and Deploy Apps to Google Play Console Testing and Apple TestFlight

Automatic Code Signing for iOS

Guide to Automated Mobile CI/CD for Native iOS with Appcircle

Related Posts

iOS Code Review Practices for Efficient Pull Requests

Transforming Appcircle’s Enterprise App Store into Alternative App Marketplaces with Apple Sideloading

How to Build and Deploy Apps to Google Play Console Testing and Apple TestFlight

Automatic Code Signing for iOS

Subscribe to Appcircle Circle