1. Home
  2. Documentation
  3. Using Dropsource
  4. Testing your App

Testing your App

You can test your app in the browser, on a mobile device, or by downloading the source code and importing it into an IDE. To test your app, you will create a build – a build represents your app at a particular point in time. When you create a build, Dropsource writes the source code based on the current state of your project in the editor, then it compiles the code into an executable format that can run on the simulator or a mobile device. You can share your app with others by sending them a link to test in the browser, or a download link to install the app on their own device.

ⓘ Note

You can test in the Web Simulator from any Dropsource project. However, you can only test on a mobile device, download your source code, and publish to an app store from a Premium project. See Dropsource pricing for an overview of the differences between Basic and Premium projects.

Set a test configuration by clicking the right-hand portion of the Test button and choosing either Web Simulator or Mobile Device.

premium configurations

With a config selected, click the Test button to initiate a build. You can cancel a build if necessary, and can continue working on your project while the build is in progress, but the built app will represent the state of the project when you hit the Test button.


ⓘ Note

Each time you make a change to your project and want to test the result, you will need to create a new build by clicking Test again.

If your build fails, you will see a notification and details of the error will appear in My Builds – get in touch if you need support. If your build seems to be stuck, try refreshing the browser – this will not affect any build that is underway, but you should see an updated progress indicator.

Web Simulator

You can test your app in the browser without leaving the Dropsource editor, using the Appetize simulator. With Web Simulator selected in your test configurations, clicking Test will create a build you can run in the browser.

Dropsource will write the source code for your project and compile it to run on the simulator. When your build is complete, you will see a pop-up confirmation message.

build indicator

Any builds you have created will appear in the My Builds list.

build list

From there you can run your app in the browser by choosing Test in Web Simulator.

ⓘ Note

You can share your app build in the simulator via link, email, and social media. Choose an option next to the virtual device to copy the link or share it to a particular platform.

share simulator

Anyone you share your app prototype with can interact with it in the simulator and access its functionality, including any dynamic data you’re using from an API.

Select from the iOS and Android device configurations – you can interact with the app to test its functionality, but certain Actions cannot run on the simulator, such as telephony and location functions. Any Actions that can’t simulate are indicated in the Actions list.

no simulate actions

ⓘ Note

The simulator is a quick way to iteratively check your app’s behavior without leaving the editor, but to test native functionality you’ll need to run it on a mobile device. You may also find that the simulator performance varies since it uses a third-party web service, so your app might run faster on a device.

Mobile Device

You can test your app directly on an Android or iOS mobile device without having to download the source code and compile it yourself. With Mobile Device selected in your test configurations, clicking Test will create a build that will run on a device with the same OS (you can run Android projects on Android devices and iOS projects on iOS devices).

premium configurations

Dropsource will automatically send an email to your account address – this email will contain a test link to install the app. Open the email on your Android or iOS device and click the link. The email will contain instructions on how to install the app on iOS or Android. Note that the link in the email will expire after 7 days.

ⓘ Note

The testing options suit different stages of your app development project:

  • The advantage to testing on a device is that you can access the full range of native functionality such as location and notifications, and see your app in a real world context. There’s no need to handle your source code or deal with the Xcode or Android Studio IDEs, and you can forward the email to coworkers, clients, and other stakeholders so that they can also install the app and try it out.
  • The downside to testing on a device is that you need to have access to hardware that’s compatible or can be configured to work with your Dropsource project, and each time you make a change you will need to install the app again, making the feedback loop a little slower – testing in the simulator is a more convenient option for most small, iterative changes. You can also share any build of your app in the simulator, so you can send it to others on your team who can also test it in the web browser.

After Testing

Once you’re finished testing, you can download or publish your app from any build you have created.

Was this article helpful to you? Yes 1 No

How can we help?