All pages
Powered by GitBook
1 of 3

Loading...

Loading...

Loading...

Download Your App

Overview

Downloading your app to test it before release is a critical phase in the app development process. It's an essential step in delivering a high-quality product to end-users and maintaining the app's integrity throughout its lifecycle.

The number and type of monthly downloads you are allowed varies per Thunkable plan. This number resets when your next billing cycle begins.

You can download your app for the following platforms:

Download Your App on iOS
Download Your App on Android

Download Your App on iOS

Overview

Downloading your app to an iOS device requires an Apple Developer account. The process involves actions in your Thunkable project and your Apple Developer account. We recommend having each open in a separate browser tab so you can easily navigate between them.

Please note that while the images and instructions from the Apple Developer account are accurate at the time of this doc’s publishing, they may change slightly over time.

Register Your App with Apple

To avoid download errors, we recommend to your project before downloading.

  1. Within your Thunkable project, click the Publish and Download icon.

  2. Select Download iOS.

    The number of monthly downloads you are allowed varies per . This number resets when your next billing cycle begins

Register Devices

You must specify registered devices in your Apple Developer account to create a provisioning profile for app testing and ad hoc distribution. This process is necessary because iOS devices have security mechanisms in place to ensure that only authorized apps are installed and run on them.

Removing a registered device from your account will continue to count against your device limit. At the start of your new membership year, Account Holders and Admins can remove listed devices and restore the available device count.

Register a Single Device

To register a single device to your Apple Developer account:

  1. Open your.

  2. Under the Certificates, IDs & Profiles heading, select Devices.

  3. Click the blue + icon to add a new device to your account.

Register Multiple Devices

To register multiple devices to your Apple Developer account:

  1. Open your.

  2. Under the Certificates, IDs & Profiles heading, select Devices.

  3. Click the blue + icon to add a new device to your account.

Locating Your Device’s UDID

Every iPhone, iPod touch and iPad has a unique identifier number associated with it, known as a UDID (Unique Device ID). This is either a 40-character alphanumeric ID on older devices or a 24-character ID (excluding hyphen) on newer devices, consisting of eight digits, a hyphen, and 16 alphanumeric characters.

Please see here for instructions on locating your device’s UDID: .

Create an iOS Distribution Certificate

Follow these instructions to create a distribution certificate: .

Create an Ad Hoc Provisioning Profile

Apple requires a provisioning profile to install an app on a device. You need to create and download an Ad Hoc provisioning profile in your Apple Developer account and then return to Thunkable to upload this file.

  1. Open your.

  2. Under the Certificates, IDs & Profiles heading, select Profiles.

  3. Click the blue + icon to add a new certificate to your account.

Review App Information

  1. Review your app’s information in the modal provided. Detailed instructions are available here: .

  2. Click Submit.

  3. Congratulations! You will receive an email from Thunkable when your iOS app is available to download. This may take up to an hour.

Download iOS App

When you receive the email with the download link:

  1. Open the email on your iPhone or iPad.

  2. Click the Download App Project button.

  3. Select your preferred browser.

  4. Click Download.

If there are issues with your app build, you will receive an email outlining what you need to fix.

Troubleshooting

App Cannot be Built

If you receive an email saying that your app cannot be built, it may be the result of one of the following:

  • Ensure your app icon image:

    • does not have the same name as another project asset

    • is an image file

    • does not contain transparent pixels. Apple does not allow icons with transparent colors.


Have feedback on this doc? Please take a moment to share your feedback here: . Your valuable insights will help us improve and better serve you in the future.

Enter the Apple ID associated with your Apple Developer account. Don't yet have an Apple Developer account? You can learn more and sign up for one here: Create Your Apple ID.

  • Click Next.

  • Copy the project’s auto-populated Bundle ID. You’ll need this in the next step.

  • Follow these instructions to register your app in your Apple Developer account: Register Your App with Apple.

  • Copy the App ID Prefix (Team ID) in your Apple Developer account.

  • Return to your Thunkable project and paste the App ID Prefix (Team ID) into the provided field.

  • Click Next.

  • Ensure the iOS platform is selected.
  • Give your device a name.

  • Provide the device’s UDID. See here for instructions for locating your device's UDID: Locating Your Device’s UDID.

  • Click Continue.

  • Under Register Multiple Devices, click Download sample files.
  • Create your file containing the devices you wish to register. A maximum of 100 devices can be included in your file, and it may take a few minutes to process.

  • Click Choose File.

  • From your computer, select the file you created in step five above.

  • Click Open.

  • Click Continue.

  • Under the Distribution heading, select Ad Hoc.
  • Click Continue.

  • Select the App ID for the app you want to publish.

  • Click Continue.

  • Select the certificate you wish to include in this provisioning profile.

  • Click Continue.

  • Select the device(s) you wish to include in this provisioning profile.

  • Click Continue

  • Name your provisioning profile.

  • Click Generate.

  • Click Download to save the provisioning profile to your computer.

  • Return to Thunkable.

  • Click Upload Ad Hoc Provisioning Profile.

  • From your computer, select the .mobileprovision file you just downloaded.

  • Click Next.

  • In the pop-up prompt, click Install.

  • Open your iOS device's Settings.

  • Navigate to Privacy & Security.

  • Click Developer Mode.

  • Toggle the Developer Mode switch to true.

  • Click Restart.

  • Once your device has restarted, click Turn On to enable Developer Mode.

  • Enter your device’s passcode.

  • Click on your app's icon to test the app.

  • Ensure your App (Bundle) ID adheres to the following:

    • It is a series of short strings of text separated by periods (e.g. com.thunkable.creator.app).

    • It is all lowercase.

    • It begins with a letter.

  • Ensure your asset names only contain Roman alphabet characters (with no accents) and numbers.

    • Examples of asset names that could cause errors: image(1).jpg, imãge.jpg

    • Examples of asset names that won't cause errors: image1.jpg, image.jpg

  • We are having trouble with our build servers. Please try again in 30 minutes.

  • adding an App Icon and Name
    Thunkable plan
    Apple Developer account page
    Apple Developer account page
    bjango: Finding your iPhone, iPod touch or iPad unique ID (UDID)
    Create an iOS Distribution Certificate
    Apple Developer account page
    Publish iOS: App Info
    Thunkable Docs Feedback

    Download Your App on Android

    Overview

    All Android apps built with Thunkable are built with Android API 35 and target Android 15.

    Initiate an Android App Download

    To avoid download errors, we recommend to your project before downloading.

    To download your app to an Android device:

    1. Click the Publish and Download icon.

    2. Select Download Android.

    You will be sent an email with a link to download your app.

    For some , the number of monthly downloads varies per download type.

    We offer two types of downloads for Android:

    a. Testing downloads (expire after 72 hours)

    b. Distribution downloads (these do not expire).

    Download Android App

    When you receive the email with the download link:

    1. Open the email on your Android device.

    2. Click the DOWNLOAD YOUR APK button.

      Google Chrome's browser settings may prevent you from downloading the APK file. If you have an issue, open the email in Firefox or Safari and download your APK file.

    Trust Thunkable

    To install the app on your Android device, you must indicate that you trust Thunkable. To do that:

    1. Open your Android device's Settings menu.

    2. Navigate to Lock Screen and Security.

    3. Set the Unknown Sources option to true.

    In addition, you may be alerted that Play Protect has blocked an unsafe app. This is because you are downloading the app outside of the Play Store. If that is the case:

    1. Select the APK file you downloaded to your device.

    2. Click Install.

    3. Click More details.

    4. Click Install anyway.

    Anyone installing your app directly, instead of from the Play Store, will need to change the setting on their phone to allow installation of apps from Unknown Sources.

    General Download Limits

    The number of monthly downloads you are allowed varies per . This number resets when your next billing cycle begins.

    Troubleshooting

    App Cannot be Built

    If you receive an email saying that your app cannot be built, it may be the result of one of the following:

    • Ensure your app icon image:

      • does not have the same name as another project asset

      • is an image file

      • does not contain transparent pixels. Apple does not allow icons with transparent colors.

    Cannot connect to storage.googleapis.com

    If you cannot install your app and get the message "Cannot connect to storage.googleapis.com," it is likely the result of the following:

    • Ensure you do not have special characters such as "&" in your .

    There was a problem parsing the Package

    If you install your app on an Android device and see the message "There was a problem parsing the Package," it is likely the result of the following:

    • Ensure your App (Bundle) ID adheres to the following:

      • It is a series of short strings of text separated by periods (e.g. com.thunkable.creator.app).

      • It is all lowercase.


    Have feedback on this doc? Please take a moment to share your feedback here: . Your valuable insights will help us improve and better serve you in the future.

    The number of monthly downloads you are allowed varies per Thunkable plan. This number resets when your next billing cycle begins
  • Enter your email address in the provided field

  • Click Send.

  • Select your preferred browser.

  • Click Download.

  • Click Open.

  • Ensure your App (Bundle) ID adheres to the following:

    • It is a series of short strings of text separated by periods (e.g. com.thunkable.creator.app).

    • It is all lowercase.

    • It begins with a letter.

  • Ensure your asset names only contain Roman alphabet characters (with no accents) and numbers.

    • Examples of asset names that could cause errors: image(1).jpg, imãge.jpg

    • Examples of asset names that won't cause errors: image1.jpg, image.jpg

  • We are having trouble with our build servers. Please try again in 30 minutes.

  • It begins with a letter.

    adding an App Icon and Name
    Thunkable plans
    Thunkable plan
    App Name
    Thunkable Docs Feedback