Go Up to Main Page
This topic describes how to install, upgrade or remove RAD Studio.
- 1 Installing RAD Studio
- 2 Adding or Removing Features After the Installation
- 3 Removing RAD Studio
- 4 Upgrading RAD Studio Tokyo
- 5 See Also
Installing RAD Studio
Before You Install RAD Studio
The Installation Notes page describes the RAD Studio system requirements and other information that you must know before you decide to install RAD Studio.
You can install RAD Studio Tokyo on a system where previous versions of RAD Studio are installed. Note, however, that each version of RAD Studio extends your
PATH environment variable, which cannot be longer than 1830 characters before you install RAD Studio Tokyo.
Choosing an Installer
To install RAD Studio, you can either use the Installer or use the Offline Installer.
The Installer is the best choice for most use cases, as it provides:
- A much lower installation time, as well as a much lower time to modify installed features after the initial installation.
- A higher flexibility to choose features:
- You are not forced to install support for the 32-bit Windows target platform.
- You can choose specific combinations of target platforms and programming languages, instead of choosing programming languages and target platforms separately.
- You can remove support for any programming language after the installation.
- A much lower installer size: 0.2 GB. Anything else is downloaded on demand based on the features that you choose to install. Also, you do not need to keep the Installer around after the initial installation, you use the IDE to modify installed features.
- A better user experience. The installation steps are more straightforward.
However, use the Offline Installer if:
- The machine where you want to install RAD Studio does not have a working internet connection.
- The drive where you want to install RAD Studio does not have enough space if cache files are installed on the same drive. The Offline Installer allows you to customize the temporary storage folder.
- Note: If you use the Offline Installer, the Feature Manager (Tools > Manage Platforms) is not available in your RAD Studio installation.
Running the Chosen Installer
After You Install RAD Studio
The following sections describe some steps that you may need to take after you install RAD Studio Tokyo.
Importing Settings from Previous Version
If you have a previous version of RAD Studio installed in your system, use the Settings Migration Tool to migrate your old settings to your RAD Studio Tokyo installation.
Installing the New Platform Assistant
If you plan to deploy applications for OS X or iOS, or if you plan to deploy applications for 64-bit Windows using a remote system, you must install on your Mac or on your remote 64-bit Windows system the Platform Assistant provided with RAD Studio Tokyo. You cannot reuse the Platform Assistant from a previous version of RAD Studio.
- Tip: You can run different versions of the Platform Assistant simultaneously on the same system as long as you use a different port number for each instance.
Updating Template Files
Projects for OS X, iOS, or Android include template files that allow you to customize certain aspects of your application for those platforms. When you migrate a project from a previous version of RAD Studio to RAD Studio Tokyo, you must:
- Create a backup of any customized template file, so that you can check your custom changes later.
- Remove all template files from your project folder.
- Build (Android) or deploy (OS X, iOS) your application for each target platform so that RAD Studio Tokyo automatically generates an up-to-date version of each template file.
- Edit the new template files to apply your custom changes, if any.
For more information, see:
- Re-creating the AndroidManifest.template.xml File
- Re-creating the info.plist Template Files (
- Customizing Your Entitlement List for iOS or OS X (
Adding or Removing Features After the Installation
During the installation of RAD Studio, you can enable or disable several features: support for programming languages, support for target platforms, language packs, and so on. You can add or remove any of these features after the installation.
If you installed RAD Studio using the Installer, follow the instructions in Adding or Removing Features Using the Feature Manager.
If you installed RAD Studio using the Offline Installer, follow the instructions in Adding or Removing Features Using the Offline Installer.
Removing RAD Studio
The user with Administrator privileges who initially installed RAD Studio can remove RAD Studio following the steps described in the Windows documentation:
- Windows 10: Repair or remove programs
- Windows 8 and 8.1: Uninstall, change, or repair a program
- Windows 7: Uninstall or change a program
Removing RAD Studio Instances that Use Network Licenses
After you remove RAD Studio, each user who is not the Administrator must remove user-specific data from the Windows registry:
- Log in to the user account.
- Make a backup of the registry.
- Launch Regedit or another registry editing tool.
- Delete the following registry key:
Removing Configuration Files
After you remove RAD Studio, user-specific data such as default project settings might remain in configuration files. You should manually remove these folders:
All Users\Application Data\Embarcadero\BDS\19.0
All Users\Shared Documents\Embarcadero\BDS\19.0
Upgrading RAD Studio Tokyo
- Warning: You do not need to follow these steps to install a different version of RAD Studio. Different versions of RAD Studio can coexist on the same system.
Moving from Delphi or C++ Builder Tokyo Starter edition to RAD Studio Tokyo Trial edition
When the Installer detects an installation of Delphi or C++Builder 10.2 Tokyo Starter Edition on your system that matches the version of the RAD Studio Trial you are trying to install (i.e. RAD Studio Tokyo), the installer allows you to automatically uninstall the Starter edition before proceeding with the Trial installation. Additionally, you can choose to preserve or discard the registry settings. The Starter key and installation will be removed from your system as part of that process.
- Note: This procedure is only available when using the GetIt Installer.