Uploading your application

Once you have exported your application build, you are ready to upload your app to Waldo! You have a few ways you could do this. Check out the directions below for a step by step guide to upload.


Before you begin...

⚠️ You need to export your application prior to uploading. For instructions, please visit our article on Exporting your build and follow the instructions provided.

Skip To:

  • Uploading your first build
  • Uploading additional iOS Applications
    • Upload from existing simulator build
  • Uploading additional Android Applications
    • Upload from existing simulator build

To upload your first build:

When you log into Waldo after confirming your account for the first time, you will be taken to the screen pictured below. Click "Let's get started".


Waldo will then walk you through uploading your first build to the platform. Step 1 is naming the application and selecting the platform.


After making your selections and clicking "Next", you will be asked if you want to upload your app manually, or directly from an existing CI/CD solution.

If you intend to upload the build manually:

Click on the "Manual" upload option. You will be able to upload your app file and Waldo will perform a few basic checks to ensure the build is compatible.


If you intend to upload a CI/CD build:

You can select your CI/CD provider from the options provided, or follow our custom instructions for a provider that is not listed.



Adding your CI/CD early

Once you integrate with your CI/CD solution, Waldo automatically checks for regressions every time your CI/CD triggers building a new version. Read more about the value of adding your CI/CD to Waldo here.

Custom instructions for iOS can be found here.

Custom instructions for Android can be found here.


In the future...

You can also click on the app icon in the upper left hand corner of your screen (same as you do when uploading your first build) to add a new app to your account in the future. To learn more about the definition of apps vs builds, click here.

You will always be able to upload an app manually, even if you eventually have automatic uploads configured in Waldo.

  1. From your Dashboard, go to “Builds” on the left sidebar
  2. In the top right corner, click on “Upload a new build”
  3. Name your app
  4. Select your app file and it will automatically begin uploading


In the future...

While you will likely be uploading builds to Waldo automatically in the future, you will still maintain the ability to upload manually.


Example of app upload in iOS experience pictured above

Automatically uploading your iOS application from a simulator

Waldo partners with several providers to make it easier to upload your build directly from your existing CI/CD workflow. Below is a list of the approved partners, and their documentation.


File requirements

⚠️ Your .app should be built for simulator arm64
Your .app size must be less than 500 MB


Missing provider?

If you don’t see your CI/CD provider listed above, or you are building outside of a CI/CD solution, we have instructions linked for how to upload your custom workflows here.

Automatically uploading your Android application from an emulator

Waldo also offers several integrations with popular providers to make this as simple as possible.


File requirements

Your .apk must support x86_64 ABI
Your .apk size must be less than500 MB
For more information, please visit developer documentation


Missing provider?

If you don’t see your CI provider listed here, the custom upload instructions will generally set you in the right direction.

To troubleshoot a failed upload of your application, click here.

Validating your build with Waldo Live

Before you go through creating your tests in Waldo, you can verify that your build meets all of Waldo’s requirements by using Waldo Live.

Waldo Live is accessible by clicking the “Live” button from the menu on the left sidebar of your Waldo Dashboard.



A note on Waldo Live

Waldo Live allows you to test the functionality of your build in real time on simulated devices.

If you are able to interact with your app on Waldo Live, you know that your build is stable. You can proceed to building tests with confidence!

If not, please contact Waldo support.

What’s Next