fastlane-plugin-appcircle_enterprise_app_store

Appcircle Enterprise App Store

Appcircle Enterprise Mobile App Store is your own mobile app store for providing access to in-house apps with a customizable mobile storefront.

• Customizable Storefront: Distribute your in-house apps with a fully customizable mobile storefront.
• Secure Distribution: Everything you need for secure, streamlined distribution of your in-house apps.
• No MDM Required: Allows distribution of B2B and B2E applications without the need for an MDM solution and enrollment.

Learn more about Appcircle Enterprise App Store.

What Sets Apart Appcircle Enterprise Mobile App Store

• Direct File Sharing:
  • Skip Traditional Stores: Share .IPA, APK, or AAB files directly, avoiding the need to wait for Apple App Store or Google Play approvals.
• Flexible Sharing Options:
  • Beta and Live Modes: Share your app in ‘beta’ mode for testing new features or identifying bugs, or in ‘live’ mode for stable versions. This flexibility helps maintain the development lifecycle without interruptions.
• Enhanced Security:
  • Secure Authentication: Access the Enterprise Mobile App Store with extra secure authentication using Enterprise Authentication Methods.
  • Controlled Access: Ensure that only authorized users can access the app store and its contents.
• Customizable Mobile Storefront:
  • Tailored Experience: Provide a customizable mobile storefront for your in-house apps, ensuring a tailored experience that aligns with your brand and user needs.
• No MDM Requirement:
  • Simplified Distribution: Distribute B2B and B2E applications without the need for a Mobile Device Management (MDM) solution or enrollment, reducing complexity and costs.
• Streamlined Workflow:
  • Seamless Integration: Integrates smoothly with your existing workflow, making it easy to manage and distribute apps within your organization.
  • Efficient Management: Track and manage applications, versions, testers, and teams effectively, ensuring a smooth distribution process.

These features make the Appcircle Enterprise Mobile App Store a powerful tool for securely and efficiently distributing in-house applications, offering flexibility, enhanced security, and a streamlined workflow.

System Requirements

Compatible Agents:

• macOS 14.2, 14.5

Supported Version:

• Fastlane 2.222.0
• Ruby 3.2.2

Note: We currently support Appcircle Cloud, with self-hosted support planned in our roadmap.

Generating/Managing the Personal API Tokens

To generate a Personal API Token:

• Go to the My Organization screen (second option at the bottom left).
• Find the Personal API Token section in the top right corner.
• Press the "Generate Token" button to generate your first token.

Getting Started

This project is a fastlane plugin. To get started with appcircle_enterprise_app_store, add it to your project by running:

fastlane add_plugin appcircle_enterprise_app_store

After adding the plugin to your project, configure your Fastfile as follows:

  lane :distribute_app_store do
    appcircle_enterprise_app_store(
      personalAPIToken: "$(AC_PERSONAL_API_TOKEN)",
      appPath: "$(APP_PATH)",
      summary: "$(SUMMARY)",
      releaseNotes: "$(RELEASE_NOTE)",
      publishType: "$(PUBLISH_TYPE)" # Assign the appropriate number based on the status: None (0), Beta (1), Live (2)
    )
  end

• 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 that will be uploaded to Appcircle Testing Distribution Profile.
• releaseNote: 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.

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

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.

Leveraging Environment Variables

Utilize environment variables seamlessly by substituting the parameters with $(VARIABLE_NAME) in your task inputs. The extension automatically retrieves values from the specified environment variables within your pipeline.

If you would like to learn more about this extension and how to utilize it in your projects, please contact us

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.

Troubleshooting

If you have trouble using plugins, check out the Plugins Troubleshooting guide.

Reference

For more detailed instructions and support, visit the Appcircle Enterprise App Store documentation.