Evothings Studio 1.2

Evothings Studio 1.2 is the first generation of Evothings Studio. Is is now being replaced by Evothings Studio version 2.0.

This page provides information for users of Evothings Studio 1.2. Full documentation for version 1.2 is available in the Evothings Studio 1.2 download package.

Evothings Studio 1.2 consists of:

  • Evothings Workbench - Desktop application that supports fast turn around development and live editing of apps running on mobile devices.
  • Evothings Client - Mobile application for running IoT apps written in HTML/JavaScript.
  • Universal Editor/IDE support - Use any text editor or programming IDE to code with instant-reload-on-save. Also works with graphics editors. Just press save to reload changes on connected mobile devices.

Differences between version 1.2 and 2.0

The following are the main differences between Evothings Studio 1.2 and 2.0:

  • Evothings Viewer is used in place of Evothings Client in version 2.0.
  • An important difference is the method used to connect from mobile devices to Evothings Workbench.
  • Version 1.2 uses a local WiFi network to connect from Evothings Client to Evothings Workbench.
  • Version 2.0 uses a hosted service (Evothings Cloud Server) to connect from Evothings Viewer to Evothings Workbench.
  • In version 2.0, Evothings Workbench and connected mobile devices no longer need to be on the same local WiFi network.
  • Evothings Workbench version 2.0 has more features and an improved user interface.
  • Evothings Studio 2.0 is the basis for future versions of Evothings Studio.

Apps developed with Evothings Studio 1.2 are fully compatible with Evothings Studio 2.0.

Getting started

Very quick version:

  • Ensure your computer and mobile device are connected to the same WiFi network.
  • Download and run the Evothings Workbench application on your computer.
  • Install and run the Evothings Client app on your mobile device.
  • AP/Client Isolation may exist on some routers, please ensure the setting is disabled.
  • Connect from Evothings Client to the Workbench.
  • Click the "Run" button of the "Hello World" example.

Slightly longer version:

  • Download and run the Evothings Workbench application on your computer. Make sure to extract the files to your Desktop or other User folder if using Windows.
  • Download and install the Evothings Client app on your mobile device.
  • Connect both your computer running Evothings Workbench and your mobile devices running Evothings Client to the same WiFi network.
  • Launch the app and select "Scan". Select your computer running Evothings Workbench from the list.
  • If your computer does not appear in the list, please check the Troubleshooting section.
  • Alternatively, enter the URL shown in the bottom panel of the Workbench and click "Connect".
  • The app should now connect to Evothings Workbench and display the message "Connected".
  • Click the "Run" button of one of the apps in Evothings Workbench. Does the mobile display the app you selected? If so, you are up and running!
  • You can connect any number of mobile devices, and instantly see the result on all of them!
  • To create your own project, just drag and drop an HTML file into the Workbench project list. When you press RUN that file and all included files will be launched on connected mobile devices. Sort the project list using drag and drop.
  • Mobile devices must be on the same local WiFi network as the computer running the Workbench to be able connect using the "Scan" method, and network client isolation must be turned off.

Learn more about Evothings Workbench and Evothings Client.

Troubleshooting

If Evothings Client can't find or connect to the Workbench:

  • Make sure that your mobile device and computer are on the same WiFi network.
  • Configure any firewalls on the computer to allow Evothings Workbench to handle inbound and outbound connections.
  • Make sure that network client isolation is turned off. It is off by default on most home routers, but some public or enterprise WiFi networks have it on. Please check your router settings or ask your network administrator. In the case where client isolation is enabled, Evothings Studio will not work by using the WiFi network for direct communication between Evothings Client and the Workbench.
  • If client isolation is in effect, the easiest solution is usually to use your own WiFi router or a mobile phone with WiFi sharing. On iOS, this is called "Personal Hotspot". On Android, it is usually called "Portable hotspot" or "Internet sharing".
  • Alternatively, you can:
    • use a Virtual Private Network (VPN), or
    • use a Reverse SSH tunnel, or
    • run Evothings Workbench on a computer with a public IP address. In that case you can use that address to connect from anywhere on the Internet.
    The details of how to set these up is beyond the scope of this document.

Upgrading to Evothings Studio 2.0

Apps developed with Evothings Studio 1.2 are fully compatible with Evothings Studio 2.0. Just download the new version and you are up and running.

Here is how to upgrade:

  • It is very easy to upgrade to Evothings Studio 2.0. Just download the new version from the download page.
  • Install Evothings Viewer on your mobile devices. This app is used in place of Evothings Client. Download from Apple App Store and Google Play Store.
  • Follow the on-screen instructions provided in Evothings Workbench to get started.
  • Tutorials and guides on the Evothings web site will be updated for version 2.0. Meanwhile, most things work the same, and existing tutorials are applicable also to version 2.0. The main difference is that Evothings Viewer is used in place of Evothings Client.