MY ACCOUNT / MY ORGANIZATON
Troubleshooting
BEST PRACTICES

Send Apps to App Store Connect and TestFlight

Appcircle supports sending IPA binaries to App Store Connect and TestFlight through the Store Submission module.

Both App Store Connect and TestFlight use the same binary pool, so once you send a binary to any of the destinations, it can be used across App Store Connect for testing and app releases.

Prerequisites

Before uploading a binary to the store, please make sure that an application listing is created in App Store Connect. Otherwise, the store upload process will fail.

You also need to provide either:

or

Adding an App Store Connect API Key (Recommended Method)

To send apps from Appcircle, you need to provide an App Store Connect API key. To add a key, go to My Organization and press the "Add New" button (or the "Manage" button first if you have saved keys) next to the "App Store Connect API Keys" item under the Connections section. The add key screen will be displayed.

Create an API key in App Store Connect and upload it here for API authentication. Please keep this file as it is the only copy and it will be required during every store submission for security purposes.

With the next option, enter the key ID and the issuer ID that can be obtained from the keys section in App Store Connect.

Then enter a user-friendly name to identify the key in the lists and press save. You can use this key in multiple apps without the need for key uploads at every upload process.

Adding an Apple Developer ID

To send apps from Appcircle, you can alternatively provide an Apple Developer ID. To add a new Apple ID, go to My Organization and press the "Add New" button (or the "Manage" button first if you have saved keys) next to the "Apple Developer IDs" item under the Connections section. The add key screen will be displayed.

Create an app-specific password on the Apple ID account page and enter it here along with the Apple ID email for authentication.

With the next option, enter the application Apple ID that can be obtained from the App Information section in App Store Connect.

Then enter a user-friendly name to identify the credentials in the lists and press save. You can use this Apple ID in multiple apps without the need for reentering the credentials at every upload process.

Deploying the Binary from the Distribute Module

You can deploy the binaries to the Store Submit module from the Distribute Module. Both directly uploaded apps and built apps deployed from the build module are supported as long as they are valid for App Store (signed with an App Store Distribution certificate).

Select a binary in the list and press "Send to Store Submit Module" from the top left menu. The bundle ID of the binary will be matched automatically if there is an existing store submission profile. If not, a new store submission profile will be created automatically.

Store Submit Profile Details

Once deployed, the binary will be available in the related store submission profile. Note that the profile name and icon is automatically fetched from the latest binary.

There are three actions available for each version in the version list. The first action displays a screen where you can initiate the store upload to the specified destination. The second action allows you to view the logs of the latest upload of that binary and the third action allows you to delete that version.

Sending Apps to App Store Connect (and TestFlight)

Both App Store Connect and TestFlight use the same binary pool, so once you send a binary to any of the destinations, it can be used across App Store Connect for testing and app releases.

When you press the "Upload to App Store Connect" button, you will be prompted to select an authentication method: with an App Store Connect API Key or with an Apple Developer ID using an app-specific password.

When you select an option, if you don't have a previously saved API key or Apple ID, you will be prompted to add one. If you have saved keys or IDs, you can select them from the list.

When you press the "Send App" button, the binary will be uploaded to App Store Connect.

Viewing the Binary Upload Status

The upload status of the binary can be tracked on the same screen.

Once process in complete, you can click on the status or click on the "View Logs" button to see the logs. If the upload is successful, the app will be visible under the builds section in the TestFlight tab as well as in the builds list in the Add Build dialog in the App Store tab.