mirror of https://github.com/coder/code-server.git
docs: mention Termux extension workarounds (#6227)
This commit is contained in:
parent
0703ef008c
commit
ee024f3f2d
|
@ -8,6 +8,7 @@
|
||||||
- [Upgrade](#upgrade)
|
- [Upgrade](#upgrade)
|
||||||
- [Known Issues](#known-issues)
|
- [Known Issues](#known-issues)
|
||||||
- [Git won't work in `/sdcard`](#git-wont-work-in-sdcard)
|
- [Git won't work in `/sdcard`](#git-wont-work-in-sdcard)
|
||||||
|
- [Many extensions including language packs fail to install](#many-extensions-including-language-packs-fail-to-install)
|
||||||
- [Extra](#extra)
|
- [Extra](#extra)
|
||||||
- [Create a new user](#create-a-new-user)
|
- [Create a new user](#create-a-new-user)
|
||||||
- [Install Go](#install-go)
|
- [Install Go](#install-go)
|
||||||
|
@ -87,6 +88,37 @@ Potential Workaround :
|
||||||
1. Create a soft-link from the debian-fs to your folder in `/sdcard`
|
1. Create a soft-link from the debian-fs to your folder in `/sdcard`
|
||||||
2. Use git from termux (preferred)
|
2. Use git from termux (preferred)
|
||||||
|
|
||||||
|
### Many extensions including language packs fail to install
|
||||||
|
|
||||||
|
Issue: Android is not seen as a Linux environment but as a separate, unsupported platform, so code-server only allows [Web Extensions](https://code.visualstudio.com/api/extension-guides/web-extensions), refusing to download extensions that run on the server.\
|
||||||
|
Fix: None\
|
||||||
|
Potential workarounds :
|
||||||
|
|
||||||
|
Either
|
||||||
|
|
||||||
|
- Manually download extensions as `.vsix` file and install them via `Extensions: Install from VSIX...` in the Command Palette.
|
||||||
|
|
||||||
|
- Use an override to pretend the platform is Linux:
|
||||||
|
|
||||||
|
Create a JS script that patches `process.platform`:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// android-as-linux.js
|
||||||
|
Object.defineProperty(process, "platform", {
|
||||||
|
get() {
|
||||||
|
return "linux"
|
||||||
|
},
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
Then use Node's `--require` option to make sure it is loaded before `code-server` starts:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
NODE_OPTIONS="--require /path/to/android-as-linux.js" code-server
|
||||||
|
```
|
||||||
|
|
||||||
|
⚠️ Note that Android and Linux are not 100% compatible, so use these workarounds at your own risk. Extensions that have native dependencies other than Node or that directly interact with the OS might cause issues.
|
||||||
|
|
||||||
## Extra
|
## Extra
|
||||||
|
|
||||||
### Create a new user
|
### Create a new user
|
||||||
|
|
Loading…
Reference in New Issue