You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: FAQ.md
+15-11Lines changed: 15 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,11 @@
2
2
3
3
### What is the Arduino Library Manager?
4
4
5
-
The Arduino Library Manager is a feature of the Arduino IDE (**Sketch > Include Library > Manage Libraries...**) which makes it easy for users to find, install, and update both official and 3rd party libraries. When your library is added to the library list, every release/tag version of the library in your repository will automatically be made available for installation via Library Manager. The users can set their preferences to display an update notification when a new version of any installed library on the list is available and easily update to the new version with just a couple clicks. More information: <br />
5
+
Library Manager is a feature of the Arduino IDE (**Sketch > Include Library > Manage Libraries...**) which makes it easy for users to find, install, and update both official and 3rd party libraries.
6
+
7
+
When a library is [added to the library list](README.md#adding-a-library-to-library-manager), every release of the library will automatically be made available for installation via Library Manager. The users can set their preferences to display an update notification when a new version of any installed library on the list is available and easily update to the new version with just a couple clicks.
8
+
9
+
More information: <br />
6
10
https://www.arduino.cc/en/Guide/Libraries#toc3
7
11
8
12
### What are the requirements for a library to be added to Library Manager?
@@ -42,13 +46,13 @@ Every hour, the automated Library Manager indexer system:
42
46
43
47
### How can I add my library to Library Manager?
44
48
45
-
Follow the submission instructions [here](README.md#adding-a-library-to-library-manager).
49
+
Follow the instructions [here](README.md#adding-a-library-to-library-manager).
46
50
47
51
### How can I publish a new release once my library is in the list?
48
52
49
53
1. Make sure the library is compliant with [all requirements](#update-requirements).
50
-
1. Update the `version` in your `library.properties`.
51
-
1. Tag your library once more and push the new tag (or create a release if your web hosting offers a way to do it, for example with GitHub "releases").
54
+
1. Update the `version` in your [`library.properties`](https://arduino.github.io/arduino-cli/latest/library-specification/#library-metadata)).
55
+
1. Tag your library once more and push the new tag (or create a release if your Git-hosting site offers a way to do it, for example with [GitHub "releases"](https://help.github.com/articles/creating-releases/)).
52
56
53
57
[Our indexer](#how-is-the-library-manager-index-generated) checks for new releases every hour and will eventually fetch and publish your new release.
54
58
@@ -60,7 +64,7 @@ Follow the submission instructions [here](README.md#adding-a-library-to-library-
60
64
-[ ] The `name` property in library.properties must not have changed from the value it had when the library was submitted. If you must change the library name, see [this](#how-can-i-change-my-librarys-name).
61
65
-[ ] The `version` property in library.properties must not be the same as it was in a tag previously added to the Library Manager index.
62
66
63
-
### Sorry, I did something wrong! How can I change or unpublish an already published library?
67
+
### I did something wrong! How can I change or unpublish an already published library?
64
68
65
69
In order to change contents of an already published library version, you can recreate its related tag.
66
70
@@ -79,20 +83,20 @@ For the sake of continuity, libraries in the Library Manager list are locked to
79
83
If you wish to change the name it will need to be done manually by request:
80
84
81
85
1. Change the `name` value in your [library.properties file](https://arduino.github.io/arduino-cli/latest/library-specification/#libraryproperties-file-format) and update the `version`.
82
-
1. Create a release or tag that matches the updated `version` value in library.properties.
83
-
1. Submit an [issue report](https://github.com/arduino/library-registry/issues) requesting the name be changed and the URL of your library's repository.
86
+
1. Create a release or tag.
87
+
1. Submit an [issue report](https://github.com/arduino/library-registry/issues) requesting the name be changed and stating the URL of your library's repository.
84
88
85
-
### How can I delete a library?
89
+
### How can I remove a library I installed via Library Manager?
86
90
87
-
Open your sketchbook's `libraries` folder with your OS file explorer (Windows: Explorer, Mac: Finder, Linux: Nautilus, kfiles...) and delete the folder containing your library.
91
+
Open your sketchbook's `libraries` folder with your operating system's file explorer (Windows: Explorer, Mac: Finder, Linux: Nautilus, kfiles...) and delete the folder containing the library.
88
92
89
93
##### Rationale
90
94
91
-
No, we don't have a delete button. Libraries managed by the Library Manager are mixed with those you've manually installed, maybe libraries you've written: making a mistake and deleting the wrong library is too easy. That's why trash bins exist. Since the IDE has no knowledge of your trash bin, we didn't implement a "delete" button.
95
+
No, we don't have a delete button. Libraries managed by the Library Manager are mixed with those you've manually installed, maybe libraries you've written: making a mistake and deleting the wrong library is too easy. That's why Trash bins exist. Since the IDE has no knowledge of your Trash bin, we didn't implement a "delete" button.
92
96
93
97
## Limitations
94
98
95
-
### Is my Git repo OK?
99
+
### Is my Git repository OK?
96
100
97
101
Your repo is OK if it meets all [the requirements listed here](#submission-requirements).
0 commit comments