A Library is a package which contains multiple reusable components. Libraries are saved as .nupkg files and can be installed as dependencies to workflows using Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

Managing Reusable Component Activities

A reusable component activity represents one or more workflows packaged together as a .nupkg file, and utilized in other processes.

Creating a Library

1. Go to the Studio Backstage View > Start > Library. This opens the New Blank Library window.
2. Fill in the name and pick a location for the library. The default location is C:\Users\<current_user>\Documents\UiPath. Add a description and select Create. The new library is created and saved on your local machine.
   Note: The library name cannot exceed 128 characters, and the description cannot exceed 500 characters.
3. The Project Panel displays the tree view with the Project folder, Dependencies, and the NewActivity.xaml which contains the actual workflow.

📘

Note:

By default, the dependencies available for new libraries are the same as for blank new projects, namely UiPath.Excel.Activities, UiPath.Mail.Activities, UiPath.System.Activities, and UiPath.UIAutomation.Activities, with the Lowest Applicable Version runtime rule.

Add a tooltip and help link to a library by opening the Properties window.

The tooltip is visible in the Activities panel after you've added the new activity. The Help Link opens when you press F1 on the selected activity.

When creating a new library from a template, the Designer panel doesn’t automatically open the .xaml file, unless the library template has a Main.xaml file.

Add an annotation to a used argument in the library to have it displayed later as a tooltip in the activity's Properties panel. Read the Arguments Panel to find out more about adding annotations to arguments.

📘

Notes:

• In the case of libraries, it is recommended to use Nothing to assign a null value to a variable, rather than "". This is done to avoid any inconsistencies when using the packaged library as a dependency to a project.
• The ImplementationVersion property of the System.Activities.ActivityBuilder object is not supported. Setting a value for this property results in arguments not being saved. This object is displayed in the Properties panel when you select the blank area of the Designer panel.

Adjusting Library Settings

To configure the settings of a library project, open the Project Settings window by clicking Settings in the Project panel.

The following options are available in the General tab:

• Name - edit the name of the project.
• Description - edit the description of the project.
• Include Sources - set to Yes to package all .xaml sources within the generated assembly file, including workflows that were previously made private. This is helpful during debugging workflows.
• Compile activities expressions - set to Yes to compile and package all activities expressions with the library. This results in an improved execution time.
• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Publishing a Library

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

Limitations when Publishing Libraries

When publishing libraries, take into account the following limitations:

• Due to NuGet limitations:
  • You cannot publish libraries to locations that contain user-restricted subfolders using Windows environment path variables.
  • Release notes for published libraries are visible only in Orchestrator.
• Libraries with special characters in the names of .xaml files they contain may not be successfully published.
• Libraries containing Invoke Workflow File activities with the Isolated option selected cannot be published. An error message is displayed in the Output panel.
• When using Invoke Workflow File activity, make sure the invoked file is located in the same folder as the library project.
• The Launch Workflow Interactive activity is not supported for libraries.
• Using Invoke Workflow File inside a library to reference the library itself is not supported.

Adding Reusable Components to Automation Projects

1. Open or create a new project.
2. Under the All Packages category, pick the feed under which the library is saved and install the package.
3. Select OK and the package is added to the project definition.
4. The activity is found in the custom category of the Activities panel.

📘

Notes:

• Libraries are forward compatible, which means that they can only be used with projects created with Studio v2018.3 and later. Libraries cannot be published to Orchestrator versions prior to 2018.3.
• Errors may occur when you run a project that contains custom activities from a library that was created in a Studio version prior to 2019.10.1 and published from Studio 2019.10.1 or later. In this scenario, you must recreate and republish the library.

Please note that in a library project, when using Import Workflows to add a workflow that contains a library, the dependencies referenced in the library are not imported.

When importing two versions of the same custom library to a project in Studio, the extra custom activities contained only in the second library are not visible in the Activities panel unless you remove the first imported library.