Процесс разработки¶
Для разработки будет выдан шаблонный проект с набором конфигурационных файлов.
Для работы потребуется установить Node.js, используйте последнюю версию линейки Node.js 18.x.
Для разработки используется язык typescript – это надстройка на javascript, добавляющая возможность строгой типизации.
Нужно установить все зависимости из package.json:
npm install
В качестве редактора рекомендуется использовать VS Code.
VS Code¶
Полезные расширения:
-
ESlint– “полиция моды” для javascript и typescript файлов (указывает на неправильное форматирование и стиль кода); -
Prettier- автоматически форматирует код. -
Code Spell Checker- проверяет орфографию в коде.
Расширения ставятся стандартным для VS Code способом: в панели расширения в поисковой строке пишете названия расширений.
Шаблонный проект¶
В состав сборки входит папка WebClient SDK со следующей структурой:
-
dts – папка с описанием API для работы intellisense в typescript;
-
src/default – дефолтные расширения;
-
src/default/examples – примеры расширений;
-
src/solution – дефолтная папка для проектного кода;
-
wwwroot/extensions – тут будут размещаться “скомпилированные” js-расширения;
-
.prettierrc, .eslintrc.js – конфигурационные файлы для указания стиля кода;
-
package.json – описание внешних зависимостей;
-
webpack.config – конфигурация процесса компиляции.
Для сборки расширений нужно в корне папки выполнить команду:
npm run build
Разработка с hot reload¶
Для более быстрой и удобной разработки расширений можно запустить сборку в режиме hot reload. Для этого потребуется запустить сервер локально с переменной среды ASPNETCORE_ENVIRONMENT равной "SdkHot".
Пример:
cd "C:\Tessa\web"
$Env:ASPNETCORE_ENVIRONMENT = "SdkHot"
./Tessa.Web.Server.exe
После этого для сборки расширений следует вызвать команду:
npm run start