Exporting your build

Before you can upload your build to Waldo, you may have to export the build from an existing simulator or emulator. Below, you will find step by step instructions to export your build.

Exporting an iOS simulator build from Xcode

Before you can upload an iOS simulator build to Waldo, you must first export the ‘.app’ file from Xcode.

  1. Launch Xcode and open the project or workspace for your application.
  2. Choose an appropriate scheme, as well as a simulator, from the drop-down menu on the toolbar. It doesn’t matter which simulator you choose: any simulator will do.
20002000
  1. Choose Product > Build to build your application.
  2. When the build is complete, go to the project navigator and click the disclosure triangle for the Products folder to expand it and reveal available products.
12881288
  1. Control-click the ‘.app’ file for your application, then choose Show in Finder from the popup menu.

❗️

Pay attention to the file type you select

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

  1. A folder containing your ‘.app’ file will be revealed in Finder. You can upload this .app file on Waldo!

Flutter support

For Flutter applications, we highly recommend exporting and uploading a debug build of your application to Waldo. This will allow Waldo to extract a more accurate view hierarchy for your tests. Learn more about debug builds in Flutter documentation.

Troubleshooting

If you encounter issues while uploading a new build of your application to Waldo, you can refer to the following:


Exporting an Android emulator build from Android Studio

Before you can upload an Android Emulator build to Waldo, you must first export a .apk file from Android Studio. Simply follow these steps:

  1. Launch Android Studio and open the project or workspace for your application
  2. Make sure your project is configured to build for emulator X86_64 ABI.
  3. Click on "Build" > "Build Bundle(s) / APK(s)
  4. Once the build is complete, you can click on "Locate" on the bottom right and corner popup.It will show you the APK file that you can upload on Waldo.
10041004

Trusting user certificates

For Waldo to be able to intercept all requests from your application when using Waldo Live, we recommend to trust the user certificates by default in your application.
For that, you should specify the network security configuration by adding the following XML file in the xml folder of the resources: res/xml/network_security_config.xml

<network-security-config>
    <base-config cleartextTrafficPermitted="true">
      <trust-anchors>
        <certificates src="user" />
        <certificates src="system" />
      </trust-anchors>
    </base-config>
  </network-security-config>

and add the property android:networkSecurityConfig="@xml/network_security_config" to your application component in your manifest:

<application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        android:networkSecurityConfig="@xml/network_security_config">

Waldo will always attempt to force this setting when processing your application but might not always be able to do so in some specific cases.

Firebase fingerprint whitelisting

When receiving a new Android build, we attempt to inject a piece of code which allows to have a better view hierarchy and intercept some specific events like analytics. By doing this, we need to resign the build.
For this reason, if your application has setup any fingerprint restrictions for any third-party library, you will need to add Waldo's fingerprint to the whitelisted list. For that, do the following:

  1. Go to your project in Google Cloud Platform: https://console.cloud.google.com/
  2. Click API & Services
860860
  1. Click “Credentials”
860860
  1. Click on the API Key of the service you want to enable
860860
  1. Find “Restrict usage to your Android apps”
860860
  1. Add the Package Name of the app and Waldo's certificate fingerprint
Waldo's Certificate fingerprints:
     SHA1: 52:56:27:DF:92:75:81:9C:EB:CD:47:A9:A9:EB:CB:0F:C0:B5:40:7C
     SHA256: 45:D9:C1:E2:40:36:42:C5:C6:1D:B3:D9:13:E9:77:AA:F0:AE:50:66:CB:64:D3:55:28:04:55:B7:62:26:26:22
860860
  1. Don't forget to save by clicking Done!

Flutter support

For Flutter applications, we highly recommend exporting and uploading a debug build of your application to Waldo. This will allow Waldo to extract a more accurate view hierarchy for your tests. Learn more about debug builds in Flutter documentation.

Troubleshooting

If you encounter issues while uploading a new build of your application to Waldo, you can refer to the following: