Skip to main content

Creating white label app versions

Abstract

You can create different versions of your white label project and build all or just one version by chaining Workflows and setting differences in Environment Variables.

This guide explains how to create different versions of your white label project and build all or just one version by chaining Workflows and setting differences in Environment Variables.

In this article, we’re building three individual versions (red, green, white) of our white label project.

What you’ll need for this setup:

Prepping Workflows of a white label app

  1. Add your project to Bitrise in the usual way.

  2. Select your project on the Bitrise CI page and click Workflows.

    getting-to-workflows.png

  3. Open the dropdown menu of available Workflows and click Create Workflow to create your main Workflow.

    create-workflow.png

  4. Add a new Workflow based on an Empty Workflow.

    In this example, our main Workflow is called allcolor. This Workflow will start running your version-specific Workflows in the chain.

  5. Click + again to create your version-specific Workflow.

    Keep adding as many Workflows as many different versions you wish to create.

  6. Select Env Vars on the left navigation menu and add your version-specific parameters to each Workflow you’ve just created.

    In this example we’re adding Workflow Environment Variables to our green, red and white Workflows but leaving allcolor intact.

    Creating white label app versions

  7. Go back to Workflows and create a utility Workflow.

    Make sure you give a name that starts with an underscore, for example, _runner, otherwise Bitrise CLI will not treat it as a utility Workflow.

  8. Add Steps to your utility Workflow.

    In this example, we’re adding a Script Step which will inherit the Environment Variable from the Workflows and print out the value in the build log.

    Creating white label app versions

Chaining Workflows for a white label app

Now that we have a bunch of Workflows ready, it’s time to chain them together in the right order.

  1. Select your main Workflow (allcolor in this example). This is the Workflow that should be triggered by your build triggers.

  2. Click the vertical ellipsis next to the Workflow's name and select Chain Workflows. Select a version Workflow (for example, white) and click Add after.

  3. Add each version-specific Workflow the same way (such as white, green, and red in our example) and add your utility Workflow after each of them, as seen in this image:

    Creating white label app versions

  4. Go back to your Build’s page and click Start build.

  5. In the Build configuration dialog, select your main Workflow under Workflow. This will kickstart your chained Workflows and build the app versions of your white label app.

In this section:

A Workflow is a collection of Steps, Environment Variables, and other configurations. When Bitrise starts a build, it runs one or more Workflows according to the configuration defined in the bitrise.yml file.

The Bitrise Workflow Editor allows you to edit your Workflows, configure Steps, upload files (including code signing files) and manage your app's triggers and stacks on a graphical user interface. It is available both online and offline.