Before you choose to use AJAX on any MPage of your application, you should consider these facts:
- The page will be unusable on devices without a working internet connection.
- The page will be unusable if the server hosting your web application is unreachable, be it because the server itself is down, a DNS issue, etc.
- The page will freeze, with a loading message box, while it retrieves each new status from the server. Depending on your user’s internet connection, that can make the application feel slow or unresponsive.
In order to use AJAX with mobile application, you will need a web server you can deploy to.
To use AJAX on an MPage:
- Set MPage’s UseAjax property to
- Point MPage’s UseAjaxUri property to the URL of the twin page on the web server where you will deploy the server-side version of your application. For example: http://example.com/unit6.php.
That will enable PHP events on the target MPage.
Run on a Web Browser
When testing a mobile application with MPage containers using AJAX, you should empty their UseAjaxUri property. When empty, UseAjaxUri points to your local web server, that way your mobile and web twin applications will be the same.
If UseAjaxUri is already pointing to the location where the web twin will be hosted, whenever you run your application on a web browser to test it, your mobile twin running in your web browser will try to synchronize with whatever UseAjaxUri is pointing to, probably a previous version of your web application, or maybe an empty location. Anyway, it will probably cause your MPage containers using AJAX to misbehave.
It is once you are about to deploy your application that you have to set the final values of those UseAjaxUri properties.
On mobile applications, when you use AJAX, you will have to deploy two twin applications:
- A web application, which will have the whole source code of your application.
Those two applications will then work in synchronization whenever your users perform an action requiring PHP code:
- Your mobile application will send its state to its web twin on your web server. Each mobile page’s UseAjaxUri property must point to the URL of its twin page in the server.
- Your web application will retrieve the data, perform any needed operation, and send back a new state to your mobile application.
- Your mobile application will retrieve and render that new state.
You can generate your mobile application with the Wizard for PhoneGap, the steps will depend on the platform you target: Android, iOS or BlackBerry. You can deploy your mobile application to as many supported platforms as you like, though.
Note: Do not forget to set UseAjaxUri to the right value if you changed it for testing purposes.