mirror of
https://github.com/cwinfo/envayasms.git
synced 2024-11-15 04:40:26 +00:00
63 lines
3.0 KiB
Twig
Executable File
63 lines
3.0 KiB
Twig
Executable File
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: Do not enter <code>localhost</code> as the Server URL (since this would refer to the AVD itself). Instead, use your computer's IP address on the local network, as shown by the <code>ipconfig</code>
|
|
or <code>ifconfig</code> utilities.</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>
|