Skip to content

Conversation

per1234
Copy link

@per1234 per1234 commented Jul 10, 2018

A popular library installation technique is to download the library via GitHub's Clone or download > Download ZIP and then use the Arduino IDE's Sketch > Include Library > Add .ZIP Library on the downloaded file. This requires the library to be in the root of the repository, not in a subfolder. If the library is not in the root of the repository this installation technique fails:

Specified folder/zip file does not contain a valid library

This is the standard repository structure used in all official Arduino libraries:
https://github.com/arduino-libraries

This move is also required if you wanted to add your library to the Arduino Library Manager index, which provides an even easier installation option.

A popular library installation technique is to download the library via GitHub's Clone or download > Download ZIP and then use the Arduino IDE's Sketch > Include Library > Add .ZIP Library on the downloaded file. This requires the library to be in the root of the repository, not in a subfolder. If the library is not in the root of the repository this installation technique fails:

Specified folder/zip file does not contain a valid library

This is the standard repository structure used in all official Arduino libraries:
https://github.com/arduino-libraries

This move is also required if you wanted to add your library to the Arduino Library Manager index, which provides an even easier installation option.
@ajlapp
Copy link
Member

ajlapp commented Jul 10, 2018

I'll look into this. I don't recall if there was some other reason that we originally used a sub-folder structure...possibly carry-over from old development.

@per1234
Copy link
Author

per1234 commented Jul 10, 2018

Arduino IDE 1.0.5 and older did not allow library folders to use the - character. Those IDE versions are pretty outdated now so I'm not sure there is much value in going that far with backwards compatibility. Any users who might still be on an ancient IDE version could always just rename the library folder.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants