๐Ÿ‘จโ€โš•๏ธ Diagnosing your upload failure

When Waldo rejects your upload

During onboarding, you are presented with a screen inviting you to upload a build of your app for the first time.

2090

When you attempt to upload your first build to Waldo, Waldo performs a series of validation checks to ensure that your build is correctly constructed.

It canโ€™t catch everything in advance (yet), but it does detect many common mistakes.

Here is the list of the common issues:

๐Ÿšซ not_built_for_simulator

Not built for simulator Waldo

Waldo is designed to work exclusively with simulator builds of your app.
This means that you must have a version of your app that has been specifically exported to run on the simulator in order to use Waldo.
For iOS, your zipped file must include a valid .app file, which is the format for a simulator build.

Please note that Waldo does not support .IPA files, as these are intended for real devices only.
Therefore, make sure to provide a valid .app file when using Waldo

Remediation:

Follow these instructions to export a valid simulator build. (.app file)


๐Ÿšซ does_not_contain_app

Does not contain app waldo

This error occurs when the file you upload does not contain a valid app file.

For iOS app, make sure you upload a valid .app file (simulator build) compressed into a .zip file.

Remediation:
Follow these instructions to export a valid simulator build. (.app file)

For Android, Waldo required a .apk file.

Remediation:
Follow these instructions to export a valid Android build (.apk file)

โ—What you SHOULD NOT upload:

  • Don't upload your source code or multiple files; Waldo requires only one file, a .app for iOS or .apk for Android.
  • Don't rename .ipa into .app, it's not going to work.
  • Don't upload a zipped .ipa; Waldo needs a valid simulator build (.app file).
  • Don't upload a .xcodeproj; Waldo needs a build, not a project file.

๐Ÿšซ abis

ABI error Android

Your Android build must be compatible X86_64 ABI
To learn more about this requirement, please read the Google documentation for ABIs.

Remediation:
Make sure your build support X86_64 ABI before uploading it on Waldo.


๐Ÿšซ min_os_version

minimum os version mobile app

This error occurs when your build is incompatible with Waldo's default device configuration.
Please note that you can change the default configuration later on the App Configurations page.

Remediation:
On Android, your build MUST support Android 9 (SDK 28.0)
On iOS, your build MUST support iOS 16.0


๐Ÿšซ no_valid_manifest

no valid manifest apk

This error occurs when your Android app has not been built correctly.

Remediation
Follow these instructions to export a valid Android build (.apk file)


๐Ÿšซ does_not_contain_plist

Your app must contain plist

This error occurs when your iOS app has not been built correctly.
For iOS app, make sure you upload a valid .app file (simulator build) compressed into a .zip file.

โ—What you SHOULD NOT upload:

  • Don't upload your source code or multiple files; Waldo requires only one file, a .app for iOS or .apk for Android.
  • Don't rename .ipa into .app, it's not going to work.
  • Don't upload a zipped .ipa; Waldo needs a valid simulator build (.app file).
  • Don't upload a .xcodeproj; Waldo needs a build, not a project file.

Remediation:
Follow these instructions to export a valid simulator build. (.app file)

๐Ÿšซ does_not_support_iphone

error build does not support iPhone

This error occurs when your iOS build only supports the iPad destination but not the iPhone.
Waldo required a build that support at least iPhone. If you want to use Sessions on iPad, make sure your build support iPad AND iPhone.

Here is a valid Xcode configuration to support Waldo on iPad and iPhone

Here is a valid Xcode configuration to support Waldo on iPad and iPhone


๐Ÿšซ does_not_support_iphone

The error message is a generic error, which indicates that Waldo was unable to recognize your app file and provide a more specific explanation. This typically occurs when the file you uploaded does not match the expected format. In most cases, this happens when you try to upload an app that has not been built correctly.

โ—What you SHOULD NOT upload:

  • Don't upload your source code or multiple files; Waldo requires only one file, a .app for iOS or .apk for Android.
  • Don't rename .ipa into .app, it's not going to work.
  • For iOS, don't upload a zipped .ipa; Waldo needs a valid simulator build (.app file).
  • Don't upload a .xcodeproj or .gradle; Waldo needs a Simulator or Emulator build, not a project file.

Remediation:
Follow these instructions to export a valid build.


๐Ÿ’ฌ

If you're having issue uploading your app, feel free to contact us through the get help button in the header of the upload app page.

๐Ÿ”

Waldo does not access your source code since it only used a build of your app.


Whatโ€™s Next