Circular Dependencies Detector

Presentation:

Demo Video : https://youtu.be/8ZBd1RLFG3M

Marketplace link : https://www.unrealengine.com/marketplace/en-US/slug/circular-dependencies-detector

With the Circular Dependencies Detector plugin, you can quickly detect in your project all circular dependencies, dependencies in both ways. The detection is done in compile and save time. You can place the Editor Widget wherever you want.

Send by mail any suggestion for the plugin. It will always be considered.
Please report any unexpected behaviours. It will be fixed as soon as possible.

Support e-mail : bstt.ue4@gmail.com

Sources

You can get the lastest source code of the plugin on this link.

You can freely get the plugin via the Unreal Engine marketplace in order to automatically get the updates.

Documentation:

Table of contents

1. Use Circular Dependencies Detector

1.1. Run the Editor Widget

1.2. Display

1.3. Refresh all button

1.4. Refresh already detected button

1.5. Open asset

1.6. Exclude button

1.7. Contextual menu

1.8. Show plugins

2. Configuration

2.1. Show On Startup

2.2. Max Detection Count

2.3. Max Dependency Depth

2.4. Automatic Refresh Delay

3. Solve circular dependencies

3.1. Use interfaces

3.2. Use Event Dispatcher

3.3. Split Blueprint Function Library

3.4. Redo the design

4. Contact me

1. Use Circular Dependencies Detector

Circular Dependencies Detector is a tool that only detect all circular dependencies in a project. You need to manually solve these circular dependencies. Some ways to fix them are explained in the section : Solve circular dependencies.

1.1. Run the Editor Widget

<details> <summary>Show steps in case of Editor Widget not automatically opened</summary>

• In Content Browser, enable Show Plugin Content,
• Enable Show Engine Content (It is recommanded to disable Show C++ Classes)
• Go to the Circular Dependencies Detector plugin folder,
• Right click on the CircularDependencies_EWBP (do not double-click),
• Select Run Editor Utility Widget.

</details>

If you opened and closed the EWBP, you can re-open it by going to the Edit Menu -> Editor Widget -> Run EWBP.

Table of contents

1.2. Display

Displayed by the plugin :

• number of excluded assets
• all excluded assets
• number of circular dependencies
• search bar
• all assets involved in circular dependencies grouped by block.

The current display means this :

(A -> B means A depends on B)

If an asset is displayed in 2 blocks it means that it is involved in 2 different circular dependencies.

All diplayed circular dependencies don't contain the excluded assets.

Table of contents

1.3. Refresh all button

This button start the detection of circular dependencies on all files.

On compile and save, Unreal Engine compute the dependencies. Sometimes it is not immediately computed. After a short amount of time (30 seconds maximum), you can press the button refresh to check if the dependencies are still present. Sometimes it is wrongly computed especially when dependencies were contained in a node group. Close and open again the blueprint to fix the computation of dependencies.

You can check the current dependencies by opening the Reference viewer (Right click on the asset -> Reference viewer).

The plugin is using only hard referencies.

Table of contents

1.4. Refresh already detected button

This button only refresh the circular dependencies already detected.

By default the automatic refresh is only done on the files involved in circular dependencies already detected. If there is none, this is done on all files.

1.5. Open asset

Press the button of a displayed asset in order to open it. The next asset in the circular dependency is automatically search. You just need to manually make the search result empty in order to break the circular dependency.

A specific search is done for Blueprint Function Library.

Table of contents

1.6. Exclude button

For each asset involved in a circular dependencies, you can press the Exclude button in order to exclude the asset from the search of all circular dependencies.
For each excluded asset, you can press the Include button in order to include the asset in the search of all circular dependencies.

Table of contents

1.7. Contextual menu

In content browser, you can right-click on an asset or a folder and select Circular Dependencies Detector -> Detect For selected in order to detect circular dependencies for the selected assets.
The search bar is automatically filled with the selected assets.

Table of contents

1.8. Show plugins

By default, the plugin is only searching circular dependencies in the project. You can click on the Show plugins button and select the plugins you want to include in the search.

Table of contents

2. Configuration

You can change CDD option in Editor Preferences/Plugins/Circular Dependencies Detector.

2.1. Show On Startup

Enable this option to spawn the CDD Editor Widget on startup.

2.2. Max Detection Count

This is the number of circular dependencies detected from which detection is interrupted.

2.3. Max Dependency Depth

This is the length of depenency path from which dependencies are ignored.

2.4. Automatic Refresh Delay

This is the delay in seconds before an automatic refresh, put a negative value to disable the automatic refresh.

3. Solve circular dependencies

In Unreal Engine, it is really simple to generate circular dependencies with Blueprint since all blueprints are in the same scope. In C++, you must use forward declaration to have circular dependencies, it means that if you have ones, it's intentional.

Circular dependencies are considered as an anti-pattern because of their negative effects : tight coupling, memory leaks...
They can be avoid by using desing patterns.

Problem :
You have 2 classes A and B, you are forced to make B depends on A and your class A call some functions funcB1 and funcB2 from class B (and then A depends on B).

Current dependencies :

(A -> B means A depends on B)

Table of contents

3.1. Use interfaces

Dependency inversion principle is a simple way to resolve dependencies problem.

Solution :
Move the functions funcB1 and funcB2 in an interface B_Interface and call the functions from the interface instead of the class B.

New dependencies :

Warning : You must not directely put a reference of class B or any type that depends on class B. You'll need to put a reference of type B_interface or of a type that depends on B_interface.

Table of contents

3.2. Use Event Dispatcher

Observer design pattern is another simple way to resolve dependencies problem.

Solution :
Declare 2 events dispatcher within the class A, one of type funcB1, one of type funcB2, subscribe the class B to these dispatcher and call the dispatcher in your class A.

If you need a return value for your 2 functions, you need to create 2 other functions return_funcB1, return_funcB2 within the class A and call them in class B instead of returning values.

![Class B usin