The PR has no duplicates (please search among thePull Requests
before creating one)
The PR follows
our contributing guidelines
Tests for the changes have been added (for bug fixes / features)
Docs have been added / updated (for bug fixes / features)
UPGRADING.md has been updated with a migration guide (for breaking changes)
configuration.schema.json updated if new parameters are added.

What kind of change does this PR introduce?

This PR changes the way libraries are imported when using sketch profiles.

What is the current behavior?

The libraries specified on profiles are "loaded" in the global state. Still, they are imported and compiled only if referenced by the sketch (or indirectly by a library imported from the sketch) after the so-called "library discovery".

What is the new behavior?

The libraries specified on profiles are always imported and compiled, even if not referenced directly or indirectly by the sketch.
This reduces the number of "library discovery" passes and slightly improves compilation times. Still, the main part of the library discovery phase remains.

Does this PR introduce a breaking change, and istitled accordingly?

It might introduce a breaking change. For example, if a library is listed in a sketch profile but not used in the sketch, after this update, the library will still be compiled, leading to a compilation failure.

Other information

cmaglie added13 commits

July 7, 2025 23:12

Moved Result structure into his own package

d25a7e9

This change is preparatory for next refactorings

Moving sourceFile object in his own file

c72f35b

Moved uniqueSourceFileQueue in his own file

53d45ca

Moved includeCache in his own file and made it a field of detector

134bb28

Fixed comment

d8a9623

Renamed variable (typo)

8b6c1be

Simplified handling of de-duplication of cache hit messages

c571095

This equivalent change moves the 'first' variable closer to his definition and use.

Implemented a better include-cache

f43262c

Remove the old, no longer used, includeCache

208bbf9

Refactored function

862a9fc

it will be useful in the next commits.

Always add to the build the libraries requested in the active sketch …

c17c018

…profile.This will improve sketch compile time.

Fixed result conversion.

c70560a

Ensure stable ordering when libraries are auto-included

07d9452

This avoid cache invalidation if recompiled.

cmaglie self-assigned this

Jul 11, 2025

cmaglie added type: enhancement

Proposed improvement

topic: build-processRelated to the sketch build process labels

Jul 11, 2025

per1234 added the topic: codeRelated to content of the project itself label

Jul 11, 2025

Copy link

codecovbot commentedJul 11, 2025•
edited
Loading

Codecov Report

Attention: Patch coverage is69.44444% with66 lines in your changes missing coverage. Please review.

Project coverage is 67.99%. Comparing base(3db4ad8) to head(07d9452).
Report is 3 commits behind head on master.

Files with missing lines	Patch %	Lines
...nternal/arduino/builder/internal/detector/cache.go	70.31%	14 Missing and 5 partials⚠️
...lder/internal/preprocessor/arduino_preprocessor.go	0.00%	16 Missing⚠️
...rnal/arduino/builder/internal/detector/detector.go	83.63%	5 Missing and 4 partials⚠️
...nal/arduino/builder/internal/preprocessor/ctags.go	45.45%	6 Missing⚠️
...l/arduino/builder/internal/detector/source_file.go	88.63%	3 Missing and 2 partials⚠️
internal/arduino/libraries/libraries_location.go	44.44%	5 Missing⚠️
...ernal/arduino/builder/internal/preprocessor/gcc.go	33.33%	4 Missing⚠️
commands/service_compile.go	50.00%	1 Missing and 1 partial⚠️

Additional details and impacted files

@@            Coverage Diff             @@##           master    #2951      +/-   ##==========================================- Coverage   68.01%   67.99%   -0.03%==========================================  Files         238      239       +1       Lines       22567    22589      +22     ==========================================+ Hits        15350    15360      +10- Misses       6015     6025      +10- Partials     1202     1204       +2