oxygenxml / blog

Oxygen XML Editor Blog Posts
4 stars 12 forks source link

Blog post about how to install add-ons when offline #26

Open AlexJitianu opened 3 years ago

AlexJitianu commented 3 years ago

We ahev a lot of plugins packed as addons. If users are offline, they can't access the internet, an administrator needs to download these packages and put them in a proper location for Oxygen to load them.

Something that I wrote to one of our users that faced this challenge:

All these add-ons are represent frameworks and plugins that are unpacked inside a predefined location. In your case this location is:

- For frameworks: C:\Users\{user}\AppData\Roaming\com.oxygenxml\extensions\v22.0\frameworks

- For plugins: C:\Users\{user}\AppData\Roaming\com.oxygenxml\extensions\v22.0\plugins

If you look inside these folders you will notice an additional level of folders, like a namespace, before the actual plugins/frameworks.

Instead of using the add-on mechanism to install them, you can manually download the packages and put them inside one of he locations where Oxygen looks for plugins/frameworks. This location can be the previously mentioned location, assuming you respect the folder structure, or the default one:

- put plugins inside {oxygenInstallDir}/plugins

- put frameworks inside {oxygenInstallDir}/frameworks

The frameworks/plugins packages can be found by opening those update sites into Oxygen, using the Open URL action on the toolbar. An XPath expression like this pinpoints the packages:

/xt:extensions/xt:extension/xt:location/@href

If we are to refer to the ones you enumerated, their corresponding packages are these:

1. Plugins

https://www.oxygenxml.com/maven/com/oxygenxml/oxygen-cgm-plugin/21.1.0.2/oxygen-cgm-plugin-21.1.0.2-plugin.jar

https://github.com/xspec/oXygen-XML-editor-xspec-support/releases/download/1.6.1/xspec.support-1.6.1-plugin.zip

https://www.oxygenxml.com/maven/com/oxygenxml/oxygen-patched-jsonix-schema-compiler/22.1.0.0/oxygen-patched-jsonix-schema-compiler-22.1.0.0-plugin.jar

2. Frameworks:

https://github.com/xspec/oXygen-XML-editor-xspec-support/releases/download/1.6.1/xspec.support-1.6.1-framework.zip