id: test
title: Testing EnvayaSMS
---

<p>
<img src='/media/avd.png' width='242' height='227' style='float:right;padding-left:10px;' />
If you don't yet have an Android phone, you can test EnvayaSMS in an emulated phone on your computer. 
</p>
<p>
With this method, you can test EnvayaSMS for free
and figure out if EnvayaSMS will work for your project
without needing to get an actual phone or subscribe to mobile service.
</p>
<p>
The following steps explain how to set up EnvayaSMS on an Android Virtual Device:
</p>
<ol>
   <li>Install the <a href='http://developer.android.com/sdk/'>Android SDK</a> on your computer</li>
   <li>Create a new Android Virtual Device with a target of Android 1.6 or higher. Specify a size for the SD card (necessary to download EnvayaSMS via the browser)</li>
   <li>Start the virtual device</li>
   <li>Open the Browser app and go to <a href='/install/'>sms.envaya.org/install</a></li>
   <li>Click on the EnvayaSMS-release.apk link to download EnvayaSMS.<br />
   <small>Note: Android Market does not work in the emulator.</small></li>
   <li>Install EnvayaSMS</li>
   <li>Configure EnvayaSMS with the settings of your development server. <br />
   <small>Note: Use <code>10.0.2.2</code> as the host in the Server URL. Do not enter <code>localhost</code>, since this would refer to the AVD itself).</small>
   </li>
    <li>        
    To simulate incoming SMS on the emulator:
        <ul>
        <li>
        <img src='/media/telnet.png' width='226' height='95' style='float:right;padding-left:10px' />
        using a telnet client (on your computer), connect to <code>localhost:5554</code><br />
        <small>Note: on Windows, you can install <a href='http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html'>puttytel</a>.</small>
        </li>
        <li>type <code>sms send [phonenumber] [text message]</code> to send messages to the emulator.<br/>
        <small>Note: the emulator cannot receive MMS messages.</small>
        </li>
        </ul>
    </li>    
</ol>

<h3>EnvayaSMS Request Simulator</h3>
<p>
The <a href='https://raw.github.com/youngj/EnvayaSMS/master/server/php/example/www/test.html'>EnvayaSMS Request Simulator</a>
is a standalone HTML file that allows you to simulate EnvayaSMS's HTTP requests entirely in your browser via JavaScript.
</p>
<p>
This may be helpful when developing and testing your server implementation. For example, you could write automated
tests in Selenium that use EnvayaSMS Request Simulator to make sure that your server implementation works correctly.
</p>
<p>
To use EnvayaSMS Request Simulator, just copy the HTML file somewhere on your site, and open it in a web browser. 
The URL of the EnvayaSMS Request Simulator must be on the same domain as the Server URL.
</p>

<h3>Using a Real Phone with a Development Server</h3>
<p>
Of course, you can also test EnvayaSMS by connecting a real Android phone to your development web server.
For more information, see the <a href='/faq/#q_tunnel'>FAQ</a>.
</p>