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
{{ message }}
Repository navigation
Commit b1c992a
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -141,7 +141,7 @@ for (auto loader : factory.plugins("org.example.Renderer")) {
141
141
142
142
Discovery has the following extension and lifetime rules:
143
143
144
-
-`BundlePluginFactory` provides the common external-metadata layout: every immediate child directory is a bundle, its root `name` selects the platform library name, and its constructor can replace `plugin.json` with another metadata file name.
144
+
-`BundlePluginFactory` provides the common external-metadata layout: every immediate child directory is a bundle, its root `name` selects the platform library name, and its constructor can replace `plugin.json` with another relative metadata path such as `metadata/plugin.json`.
145
145
- Subclasses can override `scanPluginPaths()` and `resolvePluginPath()` to implement another directory layout or external metadata policy.
146
146
- Replacing search paths discards previously discovered filesystem loaders that are not loaded.
147
147
- Loaded plugins are not unloaded when search paths change.
@@ -243,7 +243,7 @@ A plugin with compatibility version `C` and current version `V` satisfies a requ
243
243
244
244
-`Flat` is the default. It puts plugin libraries directly below each search path and reads their embedded metadata.
245
245
-`Bundle` gives every plugin a child directory containing its library and a sidecar `plugin.json`. The metadata must contain a root `name` without a platform library prefix or suffix. For example, `"name": "editor"` can resolve to `editor.dll`, `libeditor.dll`, `libeditor.so`, or `libeditor.dylib`.
246
-
-`CustomLayout` is reported when the constructor receives a user-provided `PluginFactory`. Its `scanPluginPaths()` and `resolvePluginPath()` overrides can implement recursive packages, another metadata file name, or a separate library subdirectory. `PluginSystem` accepts only filesystem plugins returned by this factory.
246
+
-`CustomLayout` is reported when the constructor receives a user-provided `PluginFactory`. Its `scanPluginPaths()` and `resolvePluginPath()` overrides can implement recursive packages, another metadata path, or a separate library subdirectory. `PluginSystem` accepts only filesystem plugins returned by this factory.
247
247
248
248
In Bundle layout, `name` belongs to `BundlePluginFactory`, while `displayName` belongs to `PluginSystem`. They happen to coexist in the same root metadata object and do not describe the same thing.
0 commit comments