Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated doc per TIDOC-3117

Table of Contents

Overview

Studio requires an Internet internet connection to authenticate the user to the Appcelerator cloud on first launch, although the credentials are cached for subsequent use. In addition, the web internet access is used for news, documentation, and code updates. This guide explains how to configure it for use behind a proxy.  For For Windows systems, use the system proxy settings (see the Windows System Settingssystem settings section below for details).  

Startup

...

splash screen

If no user credentials are available to for Studio on launch, a the Studio splash screen will be displayed allowing ask you to enter your user name and password. At the bottom of this dialog, click the Proxy Setup... link to open the following dialog:

Image Removed

The proxy schema (HTTP, HTTPS and SOCKS are all supported), server name or IP address, service port number and authentication details can be configured. After clicking OK, then Login to start, all Internet internet traffic will be directed via this proxy.

Preferences

...

window

To configure your proxy settings once Studio has started, open the Preferences window and navigate to Network Connections:

  1. From the menu bar, 
    1. Windows: select Windows
    Preferences on Windows, or
    1. Preferences.
    2. Mac OS: select Titanium Studio > Preferences or Appcelerator Studio > 
    Preferences on Mac OS X
    1. Preferences.
  2. Navigate to General > Network Connections.
  3. Select the Proxy entry that you would like to edit, for example, HTTP, and click Edit...
  4. In the Host and Port fields, specify the name or IP address and port number of your proxy server.
  5. If you have authentication enabled, check the Requires Authentication box and type in your proxy User and Password.
  6. Click OK to apply your settings.
  7. Restart Studio. All Internet internet traffic will be directed via this proxy.

Windows

...

system settings

For Windows systems, Studio should use the system's proxy settings.  You You may need to enter the proxy settings when the Splash Screen splash screen appears to get to the Preferences window to change the settings.

  1. From the menu bar, select Windows Preferences.
  2. Navigate to General Network Connections.
  3. Change the Active Provider drop-down to Native.
  4. Click OK to apply your settings.
  5. Restart Studio. All Internet internet traffic will be directed via the Windows system proxy setttingssettings.

Whitelisting URLs

It's possible you may need to whitelist several URLs in some network environments. Below are the set of URLs to whitelist. If possible, it is easiest to whitelist *.appcelerator.com.

...

For the local web server that Studio creates, the range of the port Studio looks for is controlled by the preference defined in Preferences > Studio > Web Servers > Built-in. By default the range is 8020-8079.

Network connections

This section describes the preferences available on the General > Network Connections preference page.

OptionDescriptionDefault
Active ProviderSpecifies the settings profile to be used when opening connections. Choosing the Direct provider causes all the connections to be opened without the use of a proxy server. Selecting Manual causes settings defined in Eclipse to be used. On some platforms there is also a Native provider available, selecting this one causes settings that were discovered in the OS to be used.Native (if present)
Manual (otherwise)
Proxy entriesThe table displays entries that are available for all providers. Checkboxes in the first column of the table indicate entries to be used for the currently selected provider. 
Proxy bypassUse this table to specify, either by name or pattern, which hosts should not use any proxy. A direct connection will always be used for matching hosts. Checkboxes in the first column of the table indicate entries to be used for the currently selected provider. 

Proxy entries

When using Manual proxy provider there are three predefined schemas to set settings for: HTTP, HTTPS and SOCKS. Configuration for each schema is displayed in the Proxy entries table. To edit settings for a particular schema double-click the entry or select the entry and click Edit... button. If Port field is left blank default port number will be used. Following table lists default port numbers for each of the predefined schemas.

SchemaDefault Port
HTTP80
SSL443
SOCKS1080

This section was adapted from Eclipse's Network Connections document.