You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
A project can be of type ‘library’. A library project can contain everything a non-library project can, but cannot be executed in the runtime. Other projects (including library projects) can refer to a library project. When a project refers to a library project, the latter’s content becomes available for use by the first.
An internal library project is a library project in development that is only used in your repository. The export of an internal library project is called an external library project.
Create a library project
- Create a new project or edit an existing project that you want to convert to an internal library.
- Open the "Project structure" view.
- Select "Change to library" in the "Properties" tab in the properties panel. Note: converting an existing project to a library project will delete its project configuration such as the entry point module and language.
- Save your changes.
Before exporting a library project you might want to fill out the fields Version and Release notes.
Refer to a library project
In a (library) project you can add references to internal and external library projects. Adding a reference makes the referred library project’s content available for use.
- Create a new project or edit an existing project in which you want to include a library project
- Open the "Project structure" view.
- Select a project from the list or graph in which you want to make an include.
- Select a library project in the "Included projects" input in the detail panel at the top right.
- Save your changes.
Export a library project
Exporting a library project will convert it to a read-only external library project that can be distributed to be used in another repository. A library project can also be packaged (together with other projects). Exporting the package will convert the contained library project to a read-only external library project as well.
To export a library project either:
- Open the context menu () of a project in the navigation panel and choose "Export".
- Or once the library project has already been selected choose "Export library"
Note that a library project export differs from an export of a regular project.
- A library export is used to be distributed to other repositories and cannot be interpreted by the runtime
- An export of a regular project cannot be distributed to another repository (use a package for this) and can be interpreted by the runtime.