Publish a Mendix Native App with Appcircle

Last modified: July 2, 2026

Introduction

Once you have built your Mendix native app with Appcircle, you can publish it directly to the App Store or Google Play using Appcircle's built-in Publish to Stores module. This lets you manage the entire release pipeline—from build to store submission—within a single platform.

Prerequisites

Before starting this guide, make sure you have completed the following prerequisites:

Set Up Store Connections

Before creating a publish profile, set up your store credentials under Credentials in the Appcircle organization settings. To access this, do the following:

  1. Click on your organization icon in the bottom-left corner.
  2. Select Security on the left panel.
  3. Go to the Credentials section.
  4. Choose the appropriate integration:
Testing Distribution module in Appcircle

For iOS (App Store Connect):

  1. Click Add under App Store Connect Integrations.
  2. Provide a name for the integration (for example, My App Store Connect).
  3. Upload your App Store Connect API Key (.p8 file).
  4. Enter the Issuer ID and Key ID from your App Store Connect API key details.
  5. Save the integration.
Testing Distribution module in Appcircle

For Android (Google Play Console):

  1. Click Add under Google Play Integrations.
  2. Provide a name for the integration (for example, My Google Play Account).
  3. Upload your Google Play service account JSON key file.
  4. Save the integration.
Testing Distribution module in Appcircle

Once these integrations are configured, you can use them when creating publish profiles.

Create a Publish Profile

To create a publish profile, do the following:

  1. Go to the Publish to Stores module from the left navigation menu.
  2. Choose your platform (iOS or Android).
  3. Click Add New.
Testing Distribution module in Appcircle

For iOS

For iOS, you have two options:

  • Create a profile manually:

    1. Select Create Profile Manually.
    2. Enter a Profile Name (for example, My App - iOS).
    3. Enter the Bundle ID (must exactly match the Bundle ID in your Xcode project and provisioning profile).
    4. Create the profile.

  • Create from App Store Connect:

    1. Select Create from App Store Connect.
    2. Choose the App Store Connect credential you configured in credential integrations.
    3. Select the app from the list of apps in your App Store Connect account.
    4. Appcircle automatically fills in the Bundle ID, app name, and other metadata.
    Testing Distribution module in Appcircle

For Android

For Android, you have two options:

  • Create Profile Manually:

    1. Select Create Profile Manually.
    2. Enter a Profile Name (for example, My App - Android).
    3. Enter the Package Name (must exactly match the Package Name in your Android project).
    4. Create the profile.

  • Create from Google Play Console:

    1. Select Create from Google Play Console.
    2. Choose the Google Play Console credential you configured in credential integrations.
    3. Select the app from the list of apps in your Google Play Console account.
    4. Appcircle automatically fills in the Package Name and other metadata.
Testing Distribution module in Appcircle

To automatically send finished builds to the publish to stores module, do the following:

  1. Open the build profile in the Build module and go to the Build Configuration settings.
  2. Navigate to the Distribution tab.
  3. Enable the Automatically Distribute to Publish toggle.
  4. Select the publish profile you created.
  5. Save the configuration.
Testing Distribution module in Appcircle

After this, completed builds will be sent to the publish profile where you can start the store submission flow.

Publish to the App Store or Google Play

Once a build appears in your publish profile, you can start the store submission process directly from Appcircle. For platform-specific walkthroughs, see the following Appcircle documentation:

Publish Report and Activity Log

The Publish Report provides a detailed overview of all actions performed within the Publish to Stores module. It allows users to monitor, filter, and export publish-related activities across different platforms, trigger types, and stores.

Testing Distribution module in Appcircle

You can also view Publish to Stores module actions such as Publish Flow and Publish Step statutes, along with resign binary operations within the Organizations or Sub-Organizations in the Activity Log section.

Testing Distribution module in Appcircle

Read More