Deployment Manager

From RAD Studio
Jump to: navigation, search

Go Up to Using the Deployment Manager
Go Up to Project Menu


Project > Deployment

The Deployment Manager lets you deploy multi-device applications for any of the supported target platforms.

For Windows, Mac OS X, and iOS, the Deployment Manager works with the Platform Assistant, so the application being deployed must use the Platform Assistant server and a connection profile. For Android, you only need to add an Android SDK to RAD Studio to deploy your applications locally.

The Deployment Manager allows you to enable, view, add, delete, or edit the files that are being deployed. You can also use the Deployment Manager to add other necessary "featured files" to the deployment, such as database drivers for the target platform.

Tip: The Deployment Manager is not needed for every project that is to be deployed to a remote system. In most of the cases when you create a project, everything works flawlessly when the project is deployed to the remote machine without the Deployment Manager. But projects differ, and the Deployment Manager gives you control over these special cases.

With the Deployment Manager, you can:

  • Enable or disable the files that are to be deployed to the target machine (check or uncheck Chekbox.png).
  • Add featured files from a generated list of ready-to-deploy files (click DMgrAddFeatFiles.png).
    Important: For multi-device database applications, you must use the Deployment Manager to enable the necessary database drivers for your specific target machine. You enable the database drivers using the Add Featured Files dialog box. When you actually run, debug, or deploy your application, the IDE copies the files currently enabled in the deployment list into the deployed application.
  • For all applications, add other files to your deployment list (click DMgrAddFiles.png).
  • Edit properties of the files that are to be deployed (Platforms, Remote Path, and Remote Name).
  • Delete files from the deployment list (click DMgrDeleteFiles.png).
  • Select those files that you do not want overwritten during deployment (Overwrite).

If you add or remove a file to or from a project using the Project Manager, RAD Studio adds or removes this file to or from the Deployment Manager automatically.

Deployment Manager Window

The Deployment Manager employs a toolbar with command buttons and a build configuration and target platform combo box, and a files list that uses eight fields (columns), all of which are sortable:

32-bit Windows Win32DeploymentManager.png
64-bit Windows Win64DeploymentManager.png
Mac OS X DMgrWindow.png
Android AndroidDeploymentManager.png
iOS IOSDeploymentManager.png

Deployment Manager Toolbar

Button and Icon Description

Enable check box

Chekbox.png

Enables files to be included in the deployment.

Click an Enable check box to toggle it, or use the Check All Items (CheckAllItems.png), Uncheck All Items (UncheckAllItems.png), Check Selected Items (CheckSelectedItems.png), and Uncheck Selected Items (UncheckSelectedItems.png) command buttons to enable or disable more than one check box at a time.

Reconcile command button

DMgrReconcile.png

Reloads all the information from the project. This command is very similar to a refresh command.

Add Files command button

DMgrAddFiles.png

Allows you to add files that are not part of the project to the deployment list. A common example would be adding data files or configuration files that your Application makes use of. Read more on this help topic: Adding Files.

Delete Selected Files command button

DMgrDeleteFiles.png

Allows you to delete files that were previously added through the Add Files command button. Note that you cannot delete files that the IDE automatically adds. When selecting these files, the Delete Files button will be disabled (grayed). Read more on this help topic: Deleting Files.

Add Featured Files command button

DMgrAddFeatFiles.png

Displays a dialog box that contains a list of files that you can select to add to your project. This command is mainly used for database-related applications. Read more on this help topic: Adding Featured Files.

Deploy command button

DMgrDeploy.png

Deploys the files to the remote machine. This command uses the currently selected configuration to deploy the files. This command is not required in order to start deploying the files. The files in the list are also automatically deployed by running the project in the IDE.

Connect command button

DMgrConnect.png

This is a two-state (sticky) button. The Connect button will remain down while the machines are connected. When the connection fails or succeeds, the button will remain pressed. If the connect operation completes with success, the Remote Status fields are updated. Otherwise, an error message is displayed. The Connect button is disabled when All Configurations is selected, because you can only connect to one machine at a time.

Revert to Default command button

DMgrRevert.png

Reverts all changes that you have ever made in the Deployment Manager to the current project. The project is reverted to the state that it was in when you first opened it in the Deployment Manager.

The option Keep added files allows you to keep the files that you manually added to your project. The option is selected by default.

Check All Items command button

CheckAllItems.png

Enables all files to be included in the deployment.

Uncheck All Items command button

UncheckAllItems.png

Disables all files from being included in the deployment.

Check Selected Items command button

CheckSelectedItems.png

Enables selected files to be included in the deployment.

Uncheck Selected Items command button

UncheckSelectedItems.png

Disables selected files from being included in the deployment.

Change Remote Path for Selected Items command button

ChangeRemotePathForSelectedItems.png

Opens a dialog box where you can set a remote path for the selected items.

Change Overwrite value for selected items command button

ChangeOverwriteValueforSelectedItems.png

Allows you to select those files that you do not want to deploy in order to avoid overwriting them in the target device.

Configuration Selector combo box

Selection.png

Selects the build configuration and target platform for which you are deploying. Any of the fields of the files list might change if the configuration changes. This combo-box is the same as the Target field in Target Options on the Project Options dialog box.

Deployment Manager Fields

The Deployment Manager has eight columns or fields that are described below. Only four of the fields are editable: Platforms, Remote Path, Remote Name, and Overwrite.

Field Editable Description

Local Path

No

The path of the corresponding file on the local machine. Note that these paths are relative to the project and can contain macros, such as $(BDS).

Local Name

No

The name of the local file.

Type

No

The class that the file belongs to. Classes are used to group files with the same deployment rules. Some of these rules might be used to specify that this file is only available for a given platform.

Platforms

Yes

Each file will be deployed for a given list of platforms.

It is possible for files to be deployed to only one platform at a time. For example:

Other files, such as .exe files, might be deployed only for 32-bit Windows or 64-bit Windows.

You can deploy files to all platforms or any combination of platforms. You can edit the platform where you want the files to be deployed. If you select a wrong combination of platforms, the project might not work at all.

Remote Path

Yes

The destination for the file. This field is initialized with "./" (dot-slash), which indicates a relative path name. If you do not fully qualify the remote path for the deployed files, then the path is relative to either:

  • The scratch directory of the Platform Assistant server, by default inside C:\Users\<user>\Documents\Embarcadero\Studio\Profiles (32-bit Windows and 64-bit Windows target platforms).
  • The application bundle (Mac OS X and iOS target platforms) or package (Android target platform).

When you deploy custom files for iOS or Android, you must be especially careful where you deploy your files. Applications for these platforms can only access files located in certain folders within the application bundle or package. For more information, see:

Remote Name

Yes

The remote file name.

Remote Status

No

If the Connect button is pressed, then the Remote Status columns will show the status of the file comparing the remote file to the local file. The remote status can be:

  • Not Connected: The Connect button is not pressed down, so no remote data is found.
  • Unknown: There was an error getting information from the local file.
  • Newer: The remote file is newer than the local file.
  • Older: The remote file is older than the local file.
  • Same: The local and remote files have the same time date stamps.
  • Not Found: The remote file was not found.

Overwrite

Yes

The Overwrite option is set to Always by default, which means that if the local file is newer than the remote file, then the file is overwritten in the target device.

You may want to exclude some files from being deployed and overwritten. For this purpose you can change the Overwrite value to Never.

The overwrite status can be:

  • Always: Deploy the local file if it is newer than the remote file, overwriting the remote file.
  • Never: Select this option for a file if you want to exclude it from being deployed.

Read the next topics for further information about configuring the Deployment Manager and how to deploy a project.

Deployment Manager Topics

See Also