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), Mac 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), Mac 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\BDS\17.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.
|