Introduction

A Mendix native mobile application does not include the runtime itself, which hosts all the application’s logic, data, and microflows. Instead, the application functions as a client that must connect to a running Mendix server. The runtime URL specifies the exact address of this server, allowing the application to fetch data, execute logic, and authenticate users. Without it, the application would not know where to connect and would not be able to function.

When building a native mobile application locally, the application needs the runtime URL to know which server to connect to for interacting with the runtime. During the build process, the runtime URL is set to the computer’s IP address along with the port used by Studio Pro.

Example: http://172.20.10.2:8080/

<computer-ip> = IP address of the machine on the local network

<port> = the port used by Mendix Studio Pro

Environment

Native Mobile

Instructions/Procedure

If the Wi-Fi connection changes, the <computer-ip> will also be changed, causing the build to include an incorrect runtime URL. Since the runtime URL is placed into the config files in your-native-template-root/android/app/src/main/res/raw/runtime_url or your-native-template-root/ios/Config/config.xcconfig, the runtime URL can be updated manually in the config files instead of reconfiguring the build folder.

Outcome

After updating the runtime URL file, rebuild the app, reinstall it on the device or emulator, and verify it connects to the new runtime URL.

Additional information

Mendix documentation:

• Build a Mendix Native App Locally
• Bundling Your Mendix App