Qtopia Home · Home · Reference · User Guide · Internals

depends()

Usage

    depends(libraries/qtopia)
    depends(libraries/*,fake)

Description

Register a dependency. Use the same format that PROJECTS uses (ie. paths relative to the project root). Dependencies are searched for in the current project root first, then the Qtopia and Qtopia Sync Agent project roots followed by all other project roots. There is no support for depending on a particular project in a particular project root but such support may appear in the future.

Note: This function must only be called from .pro files or from an implicit_deps.pr[if] file.

You can pass a second argument fake to create a fake dependency. Fake dependencies affect the order of building without changing the actual dependency tree. For example, src/build/extra/extra.pro depends on everything but it's a fake dependency designed only to have it processed last.

Note: In 4.3.1 and later it is a fatal error to depend on a project that is disabled.

A project is considered disabled if it is not listed in PROJECTS after projects.pri has been read. If a tree does not contain a projects.pri but does contain the dependency it is considered to be enabled. Since there may be times when a fatal error is not suitable you can set disabled_deps_are_non_fatal to cause a non-fatal error. For example, the examples tree sets this since many projects depend on libraries that can be disabled.

A non-fatal error causes a warning to be emitted when building the Makefile and the following message to be output when running make. It does not cause the build to be aborted.

    Some of the required modules (contains(PROJECTS,missing/project)) are not available.
    Skipped.

See also Functions (build system), Dependencies, dep(), idep(), PROJECTS, and disabled_deps_are_non_fatal.


Copyright © 2008 Nokia Qtopia Build System Documentation