mirror of
https://github.com/VSCodium/vscodium.git
synced 2026-04-25 04:10:15 +10:00
- rename env variables
- update doc
This commit is contained in:
37
DOCS.md
37
DOCS.md
@@ -41,16 +41,39 @@ The `product.json` file is set up to use [open-vsx.org](https://open-vsx.org/) a
|
|||||||
* Ask the extension maintainers to publish to [open-vsx.org](https://open-vsx.org/) in addition to the VS Code Marketplace. The publishing process is documented in the [Open VSX Wiki](https://github.com/eclipse/openvsx/wiki/Publishing-Extensions).
|
* Ask the extension maintainers to publish to [open-vsx.org](https://open-vsx.org/) in addition to the VS Code Marketplace. The publishing process is documented in the [Open VSX Wiki](https://github.com/eclipse/openvsx/wiki/Publishing-Extensions).
|
||||||
* Create a pull request to [this repository](https://github.com/open-vsx/publish-extensions) to have the [@open-vsx](https://github.com/open-vsx) service account publish the extensions for you.
|
* Create a pull request to [this repository](https://github.com/open-vsx/publish-extensions) to have the [@open-vsx](https://github.com/open-vsx) service account publish the extensions for you.
|
||||||
* Download and [install the vsix files](https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix).
|
* Download and [install the vsix files](https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix).
|
||||||
* Modify the `extensionsGallery` section of the `product.json` file in your VSCodium installation to use the VS Code Marketplace as shown below. However, note that [it is not clear whether this is legal](https://github.com/microsoft/vscode/issues/31168).
|
|
||||||
```json
|
|
||||||
"extensionsGallery": {
|
|
||||||
"serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery",
|
|
||||||
"itemUrl": "https://marketplace.visualstudio.com/items"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
See [this article](https://www.gitpod.io/blog/open-vsx/) for more information on the motivation behind Open VSX.
|
See [this article](https://www.gitpod.io/blog/open-vsx/) for more information on the motivation behind Open VSX.
|
||||||
|
|
||||||
|
### How to use the VS Code Marketplace
|
||||||
|
|
||||||
|
You can switch and use the VS Code marketplace by using the following solutions. However, note that [it is not clear whether this is legal](https://github.com/microsoft/vscode/issues/31168).
|
||||||
|
|
||||||
|
With the following environment variables:
|
||||||
|
- `VSCODE_GALLERY_SERVICE_URL='https://marketplace.visualstudio.com/_apis/public/gallery'`
|
||||||
|
- `VSCODE_GALLERY_CACHE_URL='https://vscode.blob.core.windows.net/gallery/index'`
|
||||||
|
- `VSCODE_GALLERY_ITEM_URL='https://marketplace.visualstudio.com/items'`
|
||||||
|
- `VSCODE_GALLERY_CONTROL_URL=''`
|
||||||
|
- `VSCODE_GALLERY_RECOMMENDATIONS_URL=''`
|
||||||
|
|
||||||
|
Or by creating a custom `product.json` at the following location:
|
||||||
|
- Windows: `%USER%\AppData\Roaming\VSCodium`
|
||||||
|
- macOS: `~/Library/Application Support/VSCodium`
|
||||||
|
- Linux: `~/.config/VSCodium`
|
||||||
|
|
||||||
|
with the content:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"extensionsGallery": {
|
||||||
|
"serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery",
|
||||||
|
"cacheUrl": "https://vscode.blob.core.windows.net/gallery/index",
|
||||||
|
"itemUrl": "https://marketplace.visualstudio.com/items",
|
||||||
|
"controlUrl": "",
|
||||||
|
"recommendationsUrl": ""
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
### Proprietary Debugging Tools
|
### Proprietary Debugging Tools
|
||||||
|
|
||||||
The debugger provided with Microsoft's [C# extension](https://github.com/OmniSharp/omnisharp-vscode) as well as the (Windows) debugger provided with their [C++ extension](https://github.com/Microsoft/vscode-cpptools) are very restrictively licensed to only work with the offical Visual Studio Code build. See [this comment in the C# extension repo](https://github.com/OmniSharp/omnisharp-vscode/issues/2491#issuecomment-418811364) and [this comment in the C++ extension repo](https://github.com/Microsoft/vscode-cpptools/issues/21#issuecomment-248349017).
|
The debugger provided with Microsoft's [C# extension](https://github.com/OmniSharp/omnisharp-vscode) as well as the (Windows) debugger provided with their [C++ extension](https://github.com/Microsoft/vscode-cpptools) are very restrictively licensed to only work with the offical Visual Studio Code build. See [this comment in the C# extension repo](https://github.com/OmniSharp/omnisharp-vscode/issues/2491#issuecomment-418811364) and [this comment in the C++ extension repo](https://github.com/Microsoft/vscode-cpptools/issues/21#issuecomment-248349017).
|
||||||
|
|||||||
@@ -49,11 +49,11 @@ index 2730ee7..4d46c23 100644
|
|||||||
+
|
+
|
||||||
+ Object.assign(product, {
|
+ Object.assign(product, {
|
||||||
+ extensionsGallery: {
|
+ extensionsGallery: {
|
||||||
+ serviceUrl: env['VSCODIUM_GALLERY_SERVICE_URL'] || serviceUrl,
|
+ serviceUrl: env['VSCODE_GALLERY_SERVICE_URL'] || serviceUrl,
|
||||||
+ cacheUrl: env['VSCODIUM_GALLERY_CACHE_URL'] || cacheUrl,
|
+ cacheUrl: env['VSCODE_GALLERY_CACHE_URL'] || cacheUrl,
|
||||||
+ itemUrl: env['VSCODIUM_GALLERY_ITEM_URL'] || itemUrl,
|
+ itemUrl: env['VSCODE_GALLERY_ITEM_URL'] || itemUrl,
|
||||||
+ controlUrl: env['VSCODIUM_GALLERY_CONTROL_URL'] || controlUrl,
|
+ controlUrl: env['VSCODE_GALLERY_CONTROL_URL'] || controlUrl,
|
||||||
+ recommendationsUrl: env['VSCODIUM_GALLERY_RECOMMENDATIONS_URL'] || recommendationsUrl
|
+ recommendationsUrl: env['VSCODE_GALLERY_RECOMMENDATIONS_URL'] || recommendationsUrl
|
||||||
+ }
|
+ }
|
||||||
+ })
|
+ })
|
||||||
+
|
+
|
||||||
|
|||||||
Reference in New Issue
Block a user