Skip to main content

Setting Up Appcircle Enterprise App Store Plugin For Jenkins

Discover Plugin​

You can discover more about this action and install it from:

Appcircle Enterprise App Store
The Enterprise Mobile App Store is your customizable internal mobile app store, enabling seamless enterprise distribution of Android APK/AAB and iOS IPA files
plugins.jenkins.io
Preview of Appcircle Enterprise App Store

Setting Up Appcircle Enterprise App Store Plugin

The Appcircle Enterprise App Store plugin enables users to publish their apps to the Appcircle App Store.

System Requirements​

Compatible Agents:

  • macOS 14 (arm64)

Supported Version:

  • Jenkins 2.440.3
caution

Currently, plugins are only compatible to use with Appcircle Cloud. Self-hosted support will be available in future releases.

Install Appcircle Enterprise App Store Plugin​

Go to your Jenkins dashboard and navigate to Manage Jenkins > Manage Plugins. Then, search for "Appcircle Enterprise App Store" in the available plugins section.

Screenshot

Add Plugin in Build Steps​

Go to your configuration page of the project and add a build step.

Screenshot

Configure Plugin​

After adding the plugin to your build steps, ensure that you provide all required inputs. Additionally, remember to place the plugin after your build steps as you will need to specify the build path later on.

Screenshot

Using Plugin into Your Script​

   stage('Publish') {
      environment {
         AC_PAT = credentials('AC_PAT')
      }
       steps {
          appcircleEnterpriseAppStore personalAPIToken: AC_PAT,
                  appPath: '$APP_PATH',
                  releaseNotes: '$RELEASE_NOTE',
                  summary: '$SUMMARY',
                  publishType: '$PUBLISH_TYPE' // "0": None, "1": Beta, "2": Live
       }
   }
  • personalAPIToken: The Appcircle Personal API token is utilized to authenticate and secure access to Appcircle services, ensuring that only authorized users can perform actions within the platform.
  • appPath: Indicates the file path to the application package that will be uploaded to Appcircle Enterprise App Store Profile.
  • releaseNotes: Contains the details of changes, updates, and improvements made in the current version of the app being published.
  • summary: Used to provide a brief overview of the version of the app that is about to be published.
  • publishType: Specifies the publishing status as either none, beta, or live, and must be assigned the values "0", "1", or "2" accordingly.
Build Steps Order

Ensure that this action is added after build steps have been completed.

caution

If two workflows start simultaneously, the last workflow to reach the publish step will be the up-to-date version on the Enterprise App Store. If these workflows building the same package version, the first publish will be successful, while later deployments with the same version will fail.

References​