Connection Profile Manager
Go Up to Environment Options
Tools > Options > Environment Options > Connection Profile Manager
Project Manager | right-click a platform in Target Platforms | Edit Connection
Displays the existing connection profiles and enables you to create and manage connection profiles.
A connection profile is a named set of properties that define a connection to an instance of the Platform Assistant server running on a remote machine.
On this page, for each platform that has an associated connection profile, one profile is the default profile, which appears in bold type. Windows platforms do not have a default profile.
To create a connection profile, use this dialog box.
To associate a connection profile to a target platform on a project, use the Platform Properties dialog box. To open Platform Properties, right-click the target platform node on the Project Manager and choose Properties.
Contents
When You Must Use a Connection Profile
Connection profiles are required for the following instances in application development:
- You need a connection profile to run or debug applications remotely. This allows you to run and debug applications that target 64-bit Windows (when on a 32-bit Windows development PC), OS X or iOS.
- You do not need a connection profile to run or debug Android applications.
- You need a connection profile to use the Deployment Manager to deploy applications that target 64-bit Windows (when on a 32-bit Windows development PC), OS X or iOS.
- You do not need a connection profile to use the Deployment Manager to deploy applications for Android. RAD Studio deploys Android applications locally.
- You can deploy applications without a connection profile if you do not use the Deployment Manager.
- Note: To connect to a target platform, you must install and run the Platform Assistant server on the target platform, or on an intermediate platform that supports the target platform. That is, to connect to an iOS device (the target platform), you need the Platform Assistant server running on a Mac (the intermediate platform).
Filenames and File Extension for Connection Profiles
Profile names have few restrictions other than that they must be valid filenames, as determined by System.IOUtils.TPath.HasValidFileNameChars. Duplicated profile names result in an error (from the attempted Add, Copy, Rename, or Import).
The profile file extension is .profile, which is added automatically when the profile is saved as a file.
Examples of names for a connection profile:
- MyFirstOSXApp
- Gr8daZ!
Each profile you have defined is saved as a .profile file in your Application Data folder (as returned by DesignIntf.IDesigner170.GetAppDataDirectory), such as the following folder on Windows 7:
C:\Users\<username>\AppData\Roaming\Embarcadero\BDS19円.0
Connection Profile Manager Panel
| Item | Description |
|---|---|
|
Profiles |
Lists the connection profiles that have been defined, along with their associated platform. Boldface indicates the default profile for a platform.
Clicking one of the profiles enables the buttons for managing a profile (Copy, Rename, Delete, and Export). |
|
Profile Properties |
Displays the current settings in the selected connection profile. Platform Displays the designated platform for the selected connection profile. The designated platform is the platform where the target instance of the Platform Assistant server is running. If you change the platform on this page, the position of the profile in the list of profiles might change accordingly. If you need a connection profile for either the iOS Device - 32 bit, iOS Device - 64 bit or the iOS Simulator target platforms, select the OS X platform here. OS X is an intermediate platform which allows you to build, run, debug, and deploy not only OS X applications, but iOS applications as well. Host name Either the hostname (name of the machine as known on the network using standard DNS lookup) or the IP address of the target machine. To determine the IP address of the target machine, use the following commands as appropriate:
Port number Port number used when connecting to the Platform Assistant server on the target machine. Password Password that was set for the instance of the Platform Assistant server to which this profile will connect.
Test Connection Attempts to establish a connection to the target machine, using the specified Host name and Port number. Displays a message indicating success or failure. The connection succeeds only if the Platform Assistant server is running on the target machine first. Add Launches the Create a Connection Profile wizard so that you can create a connection profile to connect to the target machine and specify the properties of the connection profile. The keyboard equivalent is pressing the Copy Prompts you for a new profile name and copies the currently selected settings of the profile to the new profile. Rename Prompts you for a new profile name and renames the currently selected profile to the new name. Any projects using the existing profile are updated to the new profile name. Delete Prompts you for confirmation and, if accepted, deletes the currently selected profile. You can also delete a profile by pressing the Export Prompts you for a filename and saves the profile to that location (the default file name is "<ProfileName>.profile"). Import Prompts you for a .profile filename and imports the contained profile into the IDE. |