Configure an iOS delivery pipeline for your Kotlin Multiplatform project

Start CI setup from the IDE

1. Commit and push your project changes. If CI has not been configured yet, the Kotlin Multiplatform IDE plugin displays a tooltip prompting you to start CI setup.

2. Click Configure CI.

   

   The plugin generates the files required to build and test your iOS app on a hosted macOS agent. These files are added to your local project but are not committed.

3. If the TeamCity plugin is not installed, the IDE prompts you to install it. Click Install TeamCity plugin, then return to the setup flow.

   

4. When the IDE displays Pipeline is ready, the initial pipeline configuration is complete. Click Continue and, when prompted, allow the IDE to add the generated files to Git. These files remain local until you commit them to your repository.

Create or connect a TeamCity Cloud workspace

TeamCity requires a Cloud workspace to run builds on hosted macOS agents.

1. Review and accept the TeamCity Cloud Terms of Service.

2. Click Create free account to create a TeamCity Cloud account.

3. In the browser, click Authorize JetBrains to authorize the integration.

TeamCity creates or connects to the workspace and prepares the build environment. This usually takes less than 30 seconds.

Create an App Store Connect API key

1. Sign in to App Store Connect.

2. Go to Users and Access and select Keys.

3. Create an API key with the permissions required to upload the app.

4. Download the private key (.p8 file).

5. Note the Issuer ID and Key ID displayed for the key.

You can download the .p8 file only once, so store it securely.

Export an Apple Distribution certificate

1. In Xcode, Go to Settings | Accounts, or open the Apple Developer Portal, and then create or locate your Apple Distribution certificate.

2. On a Mac, open Keychain Access and find the certificate under My Certificates.

3. Right-click the certificate and choose Export to save it as a .p12 file.

4. Set an export password and store it securely; you'll need it later.

Add Apple credentials in the IDE

Return to the IDE and complete the Add Apple signing credentials form. TeamCity stores these values as secure deployment credentials; they are not added to your project source files.

Upload the first build to TestFlight

After you add the credentials, the pipeline includes signing and deployment steps.

1. Click Deploy to TestFlight. TeamCity reruns the pipeline, creates a signed iOS build, and uploads it to App Store Connect.

2. Open App Store Connect or TestFlight and verify that the build appears.

Connect the repository

To automate this process, connect your GitHub repository to TeamCity so that every push triggers a new build.

1. After the first deployment pipeline finishes successfully, click Connect repository in the IDE. TeamCity opens in the browser and confirms that the repository is authorized. It detects your repository and branch automatically and attaches them to the pipeline.

2. Return to the IDE, then commit and push the generated pipeline configuration files.

TeamCity now triggers the pipeline whenever you push changes to the configured branch.

Verify the pipeline

Your iOS delivery pipeline is now ready! Every push to the configured branch triggers TeamCity to:

1. Start a build on a hosted macOS agent.

2. Build the Kotlin Multiplatform project.

3. Run the configured tests.

4. Sign the iOS application.

5. Upload a new build to TestFlight.

Click Done to close the setup flow.

From now on, push your code and TeamCity handles the rest.