Library

From RAD Studio
Jump to: navigation, search

Go Up to Delphi Options


Tools > Options > Language > Delphi Options > Library

Use this page to specify directories, compiler and linker options for all packages.

Item Description

Selected Platform

Specifies the target platform to which the settings on this page are to apply. For example, if you select macOS, the paths and directories apply to the macOS platform.

The fields are preloaded with the specific paths and directories for each supported target platform. You can choose among the platforms that are enabled for the current project.

Library path

Specifies search paths where the compiler can find the required files for the package, such as .dcp and .bpi files.

This is the Delphi global library path. The compiler can find only those files that exist on the Library path. If you try to build your package with a file that is not on the Library path, you receive a compiler error.

Some resource files (such as controls.res) are only available in the Release folder (not the Debug folder), so you should ensure that your project Release directory either is specified in the Library path or will be resolved by at least one variable in the Library path.

Package output directory

Specifies where the compiler should put compiled packages files.

DCP output directory

Specifies where the Delphi-compiled packages are placed.

Browsing path

Specifies the directories where the Code Browsing feature of the Code Editor looks for unit files when it cannot find an identifier on the project search path or source path. The Code Editor searches for unit files used for code browsing in the following order:

  1. The project Search path for Delphi ( Project > Options > Delphi Compiler ) or the Include path for C++ ( Project > Options > Directories and Conditionals).
  2. The global browsing path (this option) for Win32 Delphi language projects; the directories specified with this option are appended to the debug source path for the project. Therefore, the debugger search order for unit files is determined by the following path settings:
    • The Browsing path (this option).
    • The project Source path (the directory in which the project was saved).

Unit scope names

Specifies the prefixes (unit scope names) for dotted namespaces, to allow you create a shorthand version of the namespace in the uses clause in your code.

For example, instead of writing Embarcadero.Vcl.DB, you can specify Embarcadero.Vcl as your namespace prefix. Then in the uses clause, you can simply specify DB;.

Keep in mind that adding namespace prefixes can increase compile time.

Debug DCU path

Specifies the path for the Delphi-compiled unit used for debugging.

HPP output directory

Specifies the directory where user-generated header files are output. This option is similar to the C/C++ .hpp output directory on the Output - C/C++ page that you use to specify whether the Delphi compiler is to output C++ headers when you compile a Pascal unit. However, this option applies to all Delphi projects, while the C/C++ .hpp output directory applies only to the current Delphi project.

The default directory is ($(BDSCOMMONDIR)\hpp, which typically resolves to C:\Users\Public\Documents\Embarcadero\Studio\23.0\hpp (see Environment Variables).

Tip:
  • To list multiple values in an edit box, separate the values with a semicolon. Alternatively, click the ellipsis button next to each edit box to add multiple values through an appropriate dialog box.
  • To specify operating-system environment variables in an edit box, use the following syntax: $(VariableName).
For example, the $(Config) variable resolves to the specific configuration that is set in the Target field on the specific Project Options page where $(Config) is specified. If you specify $(Config) in a path and then build your package with a Debug configuration as the Target, $(Config) includes only the Debug directory, and the build can miss any elements that exist solely in the Release directory.

See Also