Skip to content

Commit 7d1e83b

Browse files
authored
Use optimal bundled library names (#183)
When multiple libraries contain files matching an #include directive in the program, the Arduino build system must pick one to use for compilation. Multiple factors are used in order to make an intelligent determination of which library is best. In order to enhance this determination, the closeness of match between the library.properties name value and the filename in the #include directive is being added as one of those factors. This new factor is referred to as "Library Name Priority". Unfortunately, this change can result in platform bundled libraries which had previously been correctly correctly chosen no longer being given priority over their equivalent standalone libraries, which may be incompatible or not optimized for the platform's boards. This priority inversion only occurs when all the following conditions are true: - There is a standalone library installed which provides a header filename collision. - The platform bundled library is architecture optimized (e.g., architectures=esp32). - The standalone library is architecture compatible (architectures=*). - The standalone library has equal "Folder Name Priority". - The standalone library has better "Library Name Priority" (e.g., name=SD vs name=SD(ESP32) for a library with primary header file SD.h. The fix is to simply give the platform bundled library a perfect "Library Name Priority". Some platform bundled libraries were given a modified name as a workaround to a bug in the Arduino IDE's Library Manager which caused Library Manager to always show the library as updatable under specific circumstances. That bug was fixed in Arduino IDE 1.8.6, ~3 years ago.
1 parent fd685aa commit 7d1e83b

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

libraries/SD/library.properties

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name=SD(rp2040)
1+
name=SD
22
version=2.0.0
33
author=Earle F. Philhower, III <earlephilhower@yahoo.com>
44
maintainer=Earle F. Philhower, III <earlephilhower@yahoo.com>

0 commit comments

Comments
 (0)