Guides

☁️ Uploading your app to Waldo

Once you have exported your app 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.

Suggest Edits

📘

In case you are not ready yet: we provide sample apps

Uploading an app is not necessary to test Waldo: ever account comes with a sample iOS or Android app (Wikipedia app) to let you experiment with Waldo before committing to upload your own app.

Once you are ready to test on your own app, Waldo offers 2 ways to upload your buildfile:

  • Web upload : low friction way to get started
  • CLI upload: install the CLI, get a seamless and headless upload flow in exchange !

Web upload

iOS File Requirements

  • Your .app should be built for arm64 simulator
  • Your .app size must be compressed into a .zip file
  • Your .zip size must be less than 1 GB

❗️

.ipa files won't work

For iOS, if you attempt to upload a .ipa file, your upload will fail. You must use the .app file in Waldo.

🚧

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.

Android File Requirements

  • Your .apk must support arm64-v8a ABI
  • Your file size must be less than 1 GB

If your upload fails, the webapp will provide an error code you can use to 👨‍⚕️ Diagnose upload failures.

CLI upload

From your local environment

The Waldo CLI provides a command waldo upload to upload a build directly from your terminal, or in your CI/CD scripts.

Documentation for this option can be found here.

From your CI

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

iOS CI integrations

Android CI integrations

📘

Missing provider?

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

Updated 2 months ago

What’s Next