Could not find backup file when restoring RadStudio project

Question

Could not find backup file when restoring RadStudio project
The goal is to determine whether the automatic backup created by RadStudio’s Project Options captures the full project state, including all source files, or merely the project metadata. When a user attempts to restore a project via File ► Restore Project, the IDE displays the error message "Could not find backup file" if the corresponding .dproj.bak file is missing or corrupted. This situation raises uncertainty about the completeness of the backup and the reliability of the restore operation.
Key constraints include:

The documented backup process only copies .dproj, .dpk, and .dproj.local files.
Unit source files (.pas, .dfm) are not part of the backup.
Restoration recreates project files but does not automatically recover deleted or modified source files.

Unresolved decision: Should future releases extend the backup to include all source files, providing a true snapshot of the project?
To address this, consider the following questions:

Does the current .dproj.bak contain only metadata, or are any source files included?
If the backup is incomplete, what manual steps are required to recover lost or altered source files after a restore?
What verification steps can ensure that a restored project reflects the exact state of the original at backup time?

Tasadduq Burney · Answer

The Cause of the Restore Error
The error "Could not find backup file" occurs when the RAD Studio IDE cannot locate the .dproj.bak (or .dpk.bak) file associated with your project. This typically happens if the backup file was manually deleted, renamed, or if the project was moved to a directory where the backup was not mirrored.

Backup Scope: Metadata vs. Source
It is critical to understand that File ► Restore Project is not a full system snapshot. It is designed to recover project configuration, not your actual code.

What is backed up: The .dproj.bak file contains XML metadata, including project options, build configurations, search paths, and the list of units included in the project.
What is NOT backed up: Unit source files (.pas), form files (.dfm), and resource files (.res) are never included in the .dproj.bak.

If your source files were deleted from the disk, restoring the project file will only recreate the "blueprint" of the project; it will not resurrect the missing .pas or .dfm files.

Recovery Steps
Depending on what was lost, follow these steps to recover your project state:

Scenario A: Project metadata is lost, but source files exist

Check the project folder for any .dproj.bak files. If found, ensure they are named correctly for the IDE to recognize them.
If the backup is missing, create a new project and manually add the existing .pas and .dfm files via the Project Manager.
Reconfigure the Search Paths and Conditional Defines in Project ► Options.

Scenario B: Source files are missing

Version Control: Use git checkout or your SVN/Perforce equivalent to revert to the last known good commit.
OS Backups: Check Windows "Previous Versions" or cloud backup snapshots (OneDrive/Dropbox).
IDE Local History: If the files were deleted within the IDE, check if your specific version of RAD Studio has local history snapshots available for those files.

Verification of Restoration
To ensure the project is in a stable state after a restore, perform these checks:

Full Build: Run a Build All (not just Compile) to surface missing units or unresolved references.
Reference Audit: Verify that all forms (.dfm) load correctly without "Class not found" errors.
Path Validation: Confirm that library and include paths in Project Options point to the correct directories on the current machine.

Diagnostic Detail Needed: Are you attempting to recover from a disk failure, or was the project file corrupted during a crash? (Recovery methods differ significantly between the two.)

Could not find backup file when restoring RadStudio project