Unify Applications
Logo
Control Build

Control Build

Logo

3 mins READ

Overview

The Control Build action manages your mobile app's build on the device. It can download a new over-the-air (OTA) update, restart the app, or open the in-app debug menu.

control_build.png
control_build.png

Mobile apps only. The action appears in the action picker only for mobile apps. In a web app it does nothing.

Parameters

The action has one field, Build Action. It defaults to Download Update.

Build Action

What it does

Download Update

Downloads the newest published OTA update. The next action in the chain waits until the download finishes. It does not apply the update.

Restart App

Reloads the app, which applies a downloaded update. Anything held only in memory, such as unsaved page variables or a half-filled form, is lost.

Open Debug Menu

Opens the app's built-in debug panel.

Note: The action returns no output. It shows no confirmation or success message, and a network error during a download fails the action. Add your own confirmation before Restart App if users should be able to cancel.

Step-by-Step Usage Guide

  1. Add an "Update app" button: Place a Button on a mobile page, for example on a Settings or About page.

  2. Download the update: In the button's On Click event, click + Add Action → Control Build and set Build Action to Download Update.

  3. Restart to apply it: Add a second Control Build action after the first one and set Build Action to Restart App. It waits for Download Update to finish, then the app reloads on the new version.

Use Cases

Update the App Without an App-Store Release

Let users pull the latest OTA update from inside the app: download it, then restart to apply it.

Give Testers the Debug Menu

Add a hidden or QA-only button that runs Open Debug Menu so testers can reach the debug panel.

Examples

Download the latest update

{ "actionType": "controlBuild", "payload": { "buildControlAction": "downloadUpdate" } }

Restart the app to apply it

{ "actionType": "controlBuild", "payload": { "buildControlAction": "restartApp" } }

Open the debug menu

{ "actionType": "controlBuild", "payload": { "buildControlAction": "openDebugMenu" } }

FAQs

Why does Control Build do nothing on web?

Control Build only appears in the action picker, and only runs, for mobile apps. In a web app it does nothing — there's no blockRef input and no web equivalent.

How do Download Update and Restart App work together?

Download Update fetches the latest OTA update onto the device but doesn't apply it. Run Restart App afterward to apply the downloaded update — add your own confirmation before Restart App if users should be warned first, since the action shows no confirmation of its own.

What does Open Debug Menu do?

It opens the in-app debug menu on the device. Wire it to a hidden or QA-only button so testers can reach it without exposing it to regular users.