The same VSIX can be installed from the VS Code command`Extensions: Install from VSIX...`.
Этот же VSIX можно установить через команду VS Code`Extensions: Install from VSIX...`.
## Actions
## Действия
-`Run app on systems`: asks for an app and target systems.
-`Run app on systems parallel`: asks for an app, then lets you choose a preset or type target systems manually, and passes`--parallel`.
-`Run app preset`: asks for an app and `main`, `russian`, or`all`.
-`Run exec command`: asks for a shell command and target systems or preset.
-`./bin/epm play <app>`: runs a local play command outside Docker.
-`./bin/epm play --latest <app>`: runs a local latest play command outside Docker.
-`Rerun last command`: repeats the last generated command.
-`Open log folder`: opens `${XDG_STATE_HOME:-$HOME/.local/state}/epm-docker-test` or the configured log root.
-`Run app on systems`: спрашивает приложение и целевые системы.
-`Run app on systems parallel`: спрашивает приложение, затем даёт выбрать пресет или вручную ввести системы, и передаёт`--parallel`.
-`Run app preset`: спрашивает приложение и пресет `main`, `russian` или`all`.
-`Run exec command`: спрашивает shell-команду и целевые системы или пресет.
-`./bin/epm play <app>`: запускает локальный `epm play` вне Docker.
-`./bin/epm play --latest <app>`: запускает локальный `epm play --latest` вне Docker.
-`Rerun last command`: повторяет последнюю сгенерированную команду.
-`Open log folder`: открывает `${XDG_STATE_HOME:-$HOME/.local/state}/epm-docker-test` или настроенный каталог логов.
When an app name is requested, it is inferred from the active editor if the file is in `play.d`, `pack.d`, or `repack.d`. The extension first checks simple shell variables such as `PRODUCT=rstudio` or `PKGNAME=rstudio`, then falls back to the file name without extension. If an app is inferred, the extension shows clickable `OK` and `Cancel` choices; the app name can be edited in the picker input before pressing`OK`.
Когда расширение спрашивает имя приложения, оно пытается определить его по активному файлу, если файл находится в `play.d`, `pack.d` или `repack.d`. Сначала проверяются простые shell-переменные вроде `PRODUCT=rstudio` или `PKGNAME=rstudio`; если они не найдены, используется имя файла без расширения. Если приложение найдено, расширение показывает кликабельные варианты `OK` и `Cancel`; имя приложения можно поправить в поле выбора перед нажатием`OK`.
## Favorites
## Избранное
Pinned commands can be added to workspace settings:
Закреплённые команды можно добавить в настройки рабочей области:
```json
{
...
...
@@ -67,18 +67,18 @@ Pinned commands can be added to workspace settings:
}
```
## Settings
## Настройки
Important settings:
Основные настройки:
-`epmDockerTest.scriptPath`: path to `epm-docker-test.sh`; empty means auto-detect.
-`epmDockerTest.workingDirectory`: command working directory.
-`epmDockerTest.defaultSystems`: default systems for app/exec runs.
-`epmDockerTest.defaultPreset`: default preset for preset runs.
-`epmDockerTest.parallelJobs`: pass `-j N` when greater than`1`.
-`epmDockerTest.localEpmRoot`: local eepm tree for outside-container `./bin/epm play` commands.
-`epmDockerTest.eepmDir`, `epmDockerTest.eepmSource`, `epmDockerTest.remoteHost`, `epmDockerTest.remoteUser`, `epmDockerTest.builderUser`, `epmDockerTest.builderPath`, `epmDockerTest.logRoot`: map to the same script options.
-`epmDockerTest.scriptPath`: путь к `epm-docker-test.sh`; пустое значение означает автоопределение.
-`epmDockerTest.workingDirectory`: рабочий каталог команды.
-`epmDockerTest.defaultSystems`: системы по умолчанию для запусков app/exec.
-`epmDockerTest.defaultPreset`: пресет по умолчанию для запусков по пресету.
For Docker test commands, auto-detection prefers the nearest parent directory of the active editor that contains both `bin/epm` and `epm-docker-test.sh`. That directory is used as the command working directory, and its `epm-docker-test.sh` is used as the runner.
Для Docker-тестов автоопределение предпочитает ближайший родительский каталог активного файла, в котором есть и `bin/epm`, и `epm-docker-test.sh`. Этот каталог используется как рабочий каталог команды, а его `epm-docker-test.sh` используется как запускаемый скрипт.
