Upload a build for Sessions

The first step to using the Waldo platform is uploading a build of your app to interact with.

As soon as you verify your free account and complete your profile, you will be directed to upload a build so that you are able to start engaging with Sessions as soon as account setup is complete.

You will have three options to complete the build upload step:

1. Manually upload a build file that meets the Waldo file requirements

iOS File Requirements

  • Your .app should be built for simulator (arm64 recommended)
  • Your .app size must be compressed into a .zip file

Android File Requirements

  • Your .apk must support x86_64 ABI
  • Your .apk size must be compressed into a .zip file

Further guidance for exporting simulator + emulator builds can be found linked below in "next steps", or by searching exporting your build in our documentation.


Builds supported

To ensure your app is displayed correctly on the iPad version, check that your build supports the iPad destination, which can be viewed in the builds page.

PLEASE NOTE: Waldo supports builds that have both iPhone and iPad destinations, but not builds that have an iPad-only destination.

You can check your build destinations in the general tab of your project settings in Xcode.

2. Use Waldo CLI to upload the build file

This will allow you to automatically upload a build from your CI/CD solution. Documentation for this option can be found by clicking here.

3. Select a demo app provided by Waldo to begin testing without your own build file
Waldo provides demo app files that meet all the above requirements, so that you can start using your account quickly without worrying about uploading your own build.


Why do I have to upload a build before exploring the platform?

In order to experience + interact with features in Waldo, you have to have a build on the platform. Accessing our Sessions feature, the Test Builder, building rules, viewing network calls, etc. all require a build to test.

If you don't have a build that meets the requirements, or you are not ready to upload one, Waldo provides several demo apps that you can select for trial purposes.


Uploading builds in Waldo

You will also be able to automate the upload of new commits via CI/CD integration. These uploads can even serve as triggers for your tests with Waldo Automate!