Skip to content

Commit

Permalink
Address CR feedback
Browse files Browse the repository at this point in the history
 * Add note about possible need to add `.local` or `.home` suffix or use
   IP address instead of hostname.
 * Use title case for heading.
  • Loading branch information
robertknight committed Apr 3, 2017
1 parent a2de17d commit 3951aa2
Showing 1 changed file with 8 additions and 3 deletions.
11 changes: 8 additions & 3 deletions docs/developers/mobile.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,17 @@
# Mobile Development

## Testing the client on a mobile device
## Testing the Client on a Mobile Device

If you have made changes to the client that could affect the mobile experience, it is a good idea to test them on a real device. Such changes should ideally be tested with at least current versions of iOS Safari and Chrome for Android.

1. Make sure your development system and mobile device are on the same local network.
1. Get the IP address or host name of your development system (`$HOSTNAME` in the steps below). You can do this using the `hostname` terminal command on Mac/Linux.
1. Configure the "h" service to allow incoming connections from other systems by editing `conf/development-app.ini` and changing the `host` setting from `localhost` to `0.0.0.0`.
1. Get the IP address or host name of your development system (`$HOSTNAME` in the steps below). You can do this using the `hostname` terminal command on Mac/Linux.

**Tip:** _If the output of `hostname` does not include a `.home` or `.local`
suffix, you may need to append `.local` to get a host name that is accessible from
other devices on the network. If you have problems using the host name, try
using the IP address instead._
1. Configure the "h" service to load the client from this host and start the dev
server:
```sh
Expand All @@ -30,5 +35,5 @@ If you have made changes to the client that could affect the mobile experience,

gulp watch
```
When `gulp watch` runs, it will print out the URLs used for the "h" service and client assets. These should include `$HOSTNAME` instead of `localhost`.
**Tip:** _When `gulp watch` runs, it will print out the URLs used for the "h" service and client assets. These should include `$HOSTNAME` instead of `localhost`._
1. On your mobile device, go to a page which has the client embedded such as `http://$HOSTNAME:3000` or `http://$HOSTNAME:5000/docs/help`.

0 comments on commit 3951aa2

Please sign in to comment.