Merge pull request #8 from devdotnetorg/dev

Dev => Master

Author: devdotnetorg

.vscodeignore

@@ -12,14 +12,13 @@ src/**
 
 #add
 #folders
+archive/**
 assets/source/**
 bashscript/_old_*.sh
 bashscript/_test*.sh
 docs/**
 packages/**
 samples/**
-vscodetemplates/**
-windows/**
 
 #files
 .gitattributes

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## v0.3.2 (24-03-2023)
+
+- Added output of diagnostic information when connecting via ssh protocol.
+- Added stdErr and codeErr output at the end of ssh script execution.
+- Fixed the problem of long execution of scripts when adding a device.
+- Added parameter `fastiot.template.loadonstart`, you can disable the loading of templates at the start of the extension.
+- Added parameter `fastiot.template.updateinterval`, time interval between template updates.
+- Added parameter `fastiot.template.isupdate`, disables template updates.
+- Added `Restore/upgrade system templates` command to restore system templates.
+- Variables added for project templates: `%{extension.apps.builtin.aswindows}`, `%{os.userinfo.username}`.
+- Compliance with UX Guidelines is done.
+- Improved UI.
+- Changed the description of the settings.
+- Added Crlf normalization for bash scripts.
+- Fixed bugs.
+
 ## v0.3.1 (27-02-2023)
 
 - Bugs fixed.

CHANGELOG_ru.md

@@ -1,4 +1,20 @@
-# Changelog
+# Список изменений
+
+## v0.3.2 (24-03-2023)
+
+- Добавлен вывод диагностической информации при подключении по ssh-протоколу.
+- По окончанию выполнения ssh-скриптов добавлен вывод stdErr и codeErr.
+- Решена проблема долгого выполнения скриптов при добавлении устройства.
+- Добавлен параметр `fastiot.template.loadonstart`, можно отключить загрузку шаблонов при старте расширения.
+- Добавлен параметр `fastiot.template.updateinterval`, интервал времени между обновлениями шаблонов.
+- Добавлен параметр `fastiot.template.isupdate`, отключает обновление шаблонов.
+- Добавлена команда `Restore/upgrade system templates` для восстановления системных шаблонов.
+- Для шаблонов проектов добавлены переменные: `%{extension.apps.builtin.aswindows}`, `%{os.userinfo.username}`.
+- Выполнено соответствие с UX Guidelines.
+- Улучшен UI.
+- Изменено описание настроек.
+- Добавлена Crlf нормализация для bash-скриптов.
+- Исправлены ошибки.
 
 ## v0.3.1 (27-02-2023)
 

Create-extension.md

@@ -5,3 +5,8 @@
 2. npm install -g yo generator-code
 
 3. Create App: yo code
+
+Links:
+
+- Topic - [Your First Extension](https://code.visualstudio.com/api/get-started/your-first-extension);
+- [Creating Extensions for Visual Studio Code A Complete Guide - Syncfusion Blogs](https://www.syncfusion.com/blogs/post/creating-extensions-for-visual-studio-code-a-complete-guide.aspx/amp).

ISSUES.md

@@ -1,9 +1,7 @@
 # Known Issues
 
-1. The user interface of the extension does not follow the [UX Guidelines](https://code.visualstudio.com/api/ux-guidelines/overview).
+1. The user interface of the extension does not partially comply with the [UX Guidelines](https://code.visualstudio.com/api/ux-guidelines/overview).
 
-2. It takes a long time to create a device profile.
+2. Commands are executed slowly.
 
-3. Commands are executed slowly.
-
-4. Low speed of execution of bash scripts.
+3. Low speed of execution of bash scripts.

ISSUES_ru.md

@@ -1,9 +1,7 @@
 # Известные проблемы
 
-1. Пользовательский интерфейс расширения не соответствует [UX Guidelines](https://code.visualstudio.com/api/ux-guidelines/overview).
+1. Пользовательский интерфейс расширения частично не соответствует [UX Guidelines](https://code.visualstudio.com/api/ux-guidelines/overview).
 
-2. Долго создается профиль устройства.
+2. Медленно выполняются команды.
 
-3. Медленно выполняются команды.
-
-4. Низкая скорость выполнения bash скриптов.
+3. Низкая скорость выполнения bash-скриптов.

README.md

@@ -36,7 +36,7 @@ Additional extensions required for developing .NET applications:
 
 Recommended additional extensions that improve the development process and interaction with the remote device:
 
-- [NuGet Package Manager](https://marketplace.visualstudio.com/items?itemName=jmrog.vscode-nuget-package-manager "NuGet Package Manager") - adding Nuget packages (later the Nuget package manager will be built into extension);
+- [NuGet Package Manager GUI](https://marketplace.visualstudio.com/items?itemName=aliasadidev.nugetpackagemanagergui "NuGet Package Manager GUI") - adding Nuget packages (later the Nuget package manager will be built into the extension);
 - [DeviceTree](https://marketplace.visualstudio.com/items?itemName=plorefice.devicetree "DeviceTree") - Syntax support for Device Tree (DT) files. Used to edit `*.dts` files. For example, it will be necessary if it becomes necessary to adapt the [SPI LCD ILI9341 display](https://devdotnet.org/post/rabota-s-gpio-v-linux-na-primere-banana-pi-bpi-m64-chast-4-device-tree-overlays-podkluchenie-displey-spi-lcd-ili9341/ "SPI LCD ILI9341 display") for your SBC;
 - [Output Colorizer](https://marketplace.visualstudio.com/items?itemName=IBM.output-colorizer "Output Colorizer") - adds color to the test messages in the OUTPUT window, makes it easier to perceive the information provided by the extension.
 
@@ -93,6 +93,6 @@ See [ISSUES](ISSUES.md "ISSUES") and [Issues on GitHub](https://github.com/devdo
 
 Testing was performed on single-board computers:
 
-- [Cubieboard](https://github.com/devdotnetorg/Cubieboard "Cubieboard")
-- [Cubietruck](https://devdotnet.org/post/otladochnaya-plata-cubietruck/ "Cubietruck")
-- [Banana Pi BPI-M64](https://devdotnet.org/post/otladochnaya-plata-banana-pi-bpi-m64/ "Banana Pi BPI-M64")
+- [Cubieboard](https://github.com/devdotnetorg/Cubieboard "Cubieboard"). Armbian distribution.
+- [Cubietruck](https://devdotnet.org/post/otladochnaya-plata-cubietruck/ "Cubietruck"). Armbian distribution.
+- [Banana Pi BPI-M64](https://devdotnet.org/post/otladochnaya-plata-banana-pi-bpi-m64/ "Banana Pi BPI-M64"). Armbian distribution.

README_ru.md

@@ -36,7 +36,7 @@
 
 Рекомендуемые дополнительные расширения, улучшающие процесс разработки и взаимодействия с удаленным устройством:
 
-- [NuGet Package Manager](https://marketplace.visualstudio.com/items?itemName=jmrog.vscode-nuget-package-manager "NuGet Package Manager") — добавление Nuget-пакетов (позже менеджер Nuget-пакетов будет встроен в расширение);
+- [NuGet Package Manager GUI](https://marketplace.visualstudio.com/items?itemName=aliasadidev.nugetpackagemanagergui "NuGet Package Manager GUI") — добавление Nuget-пакетов (позже менеджер Nuget-пакетов будет встроен в расширение);
 - [DeviceTree](https://marketplace.visualstudio.com/items?itemName=plorefice.devicetree "DeviceTree") — поддержка синтаксиса для файлов дерева устройств (Device Tree, DT). Используется для редактирования файлов `*.dts`. Например, потребуется если возникнет необходимость адаптации [дисплея SPI LCD ILI9341](https://devdotnet.org/post/rabota-s-gpio-v-linux-na-primere-banana-pi-bpi-m64-chast-4-device-tree-overlays-podkluchenie-displey-spi-lcd-ili9341/ "дисплея SPI LCD ILI9341") для вашего одноплатного компьютера;
 - [Output Colorizer](https://marketplace.visualstudio.com/items?itemName=IBM.output-colorizer "Output Colorizer") — добавляет цвет к тестовым сообщениям в окне OUTPUT, облегчает восприятие информации выдаваемой расширением.
 
@@ -91,8 +91,8 @@
 
 ## Тестирование
 
-Тестирование выполнялось на одноплатных компьютерах:
+Тестирование выполняется на следующих одноплатных компьютерах:
 
-- [Cubieboard](https://github.com/devdotnetorg/Cubieboard "Cubieboard")
-- [Cubietruck](https://devdotnet.org/post/otladochnaya-plata-cubietruck/ "Cubietruck")
-- [Banana Pi BPI-M64](https://devdotnet.org/post/otladochnaya-plata-banana-pi-bpi-m64/ "Banana Pi BPI-M64")
+- [Cubieboard](https://github.com/devdotnetorg/Cubieboard "Cubieboard"). Дистрибутив Armbian.
+- [Cubietruck](https://devdotnet.org/post/otladochnaya-plata-cubietruck/ "Cubietruck"). Дистрибутив Armbian.
+- [Banana Pi BPI-M64](https://devdotnet.org/post/otladochnaya-plata-banana-pi-bpi-m64/ "Banana Pi BPI-M64"). Дистрибутив Armbian.

SCHEDULE.md

@@ -3,7 +3,7 @@
 - Compliance with UX Guidelines.
 - Adding a WebView to select a project template.
 - Custom installation packages.
-- Custom BASH scripts to run on device and PC.
+- Custom bash-scripts to run on device and PC.
 - GPIO: read chips, view gpio line, control I/O.
 - Support for Python projects.
 - Ensuring work in Linux.

SCHEDULE_ru.md

@@ -3,10 +3,10 @@
 - Соответствие UX Guidelines.
 - Добавление WebView для выбора шаблона проекта.
 - Пользовательские пакеты установки.
-- Пользовательские скрипты BASH для запуска на устройстве и ПК.
+- Пользовательские bash-скрипты для запуска на устройстве и ПК.
 - GPIO: чтение chips, просмотр линии gpio, управление I/O.
 - Поддержка Python проектов.
-- Обеспечение работы в Linux.
+- Обеспечение работы расширения в Linux.
 - Отображение доступных устройств: `/dev/*` и sysfs.
 - Сканер устройств I2C.
 - Добавление менеджера Nuget-пакетов.

windows/apps/cwrsync.zip renamed to archive/cwrsync.zip

@@ -9,10 +9,18 @@ set -e #Exit immediately if a comman returns a non-zero status
 
 echo "Run: pregetinformation.sh"
 
+#
+PACKAGELIST="lsb-release rsync jq sudo curl wget"
+#
+
 export DEBIAN_FRONTEND="noninteractive"
 
+echo "System update and package installation: $PACKAGELIST"
+
 apt-get update
-apt-get install -y lsb-release rsync jq sudo curl wget
+apt-get install -y $PACKAGELIST
+
+echo "System update and package installation completed successfully"
 
 echo "Successfully"
 

vscodetemplates/20-gpio-fastiot.rules renamed to archive/vscodetemplates/20-gpio-fastiot.rules

@@ -10,6 +10,6 @@ echo "Run: testpackagedocker.sh"
 sudo systemctl status docker
 docker --version
 docker version
-docker info
+sudo docker info
 
 echo "Successfully"

vscodetemplates/insert_configuration.json renamed to archive/vscodetemplates/insert_configuration.json

@@ -13,3 +13,7 @@ Settings:
 - **Fastiot › Device > ssh > Key: Bits** - key length in bits. Default value: `256`.
 - **Fastiot › Device > ssh > Key: Type** - The name of the algorithm used to generate the key. For more information about key algorithms, see [How To Set Up SSH Keys](https://goteleport.com/blog/how-to-set-up-ssh-keys/). Default value: `ed25519`. If you choose the `rsa` algorithm, then you will need to add the line `PubkeyAcceptedAlgorithms=+ssh-rsa` to the `/etc/ssh/sshd_config` file.
 - **Fastiot › Launch: Templatetitle** - template for forming the name of Launch. Variable values can be viewed at [link](Launch-title-template.md "Template for forming the name Launch"). Default value: `Launch on %{device.label} (%{project.name}, %{device.board.name}, %{device.user.debug})`.
+- **Fastiot › Template: Isupdate** - enable/disable updating templates from Internet resources.
+- **Fastiot › Template: Lastupdate** - last update time. Technical parameter.
+- **Fastiot › Template: Loadonstart** - loading templates at extension start. If this option is disabled, templates will only be loaded the first time they are accessed.
+- **Fastiot › Template: Updateinterval** - template update interval in hours.

vscodetemplates/insert_task_build_linux.json renamed to archive/vscodetemplates/insert_task_build_linux.json

@@ -13,3 +13,7 @@
 - **Fastiot › Device > ssh > Key: Bits** - длина ключа в битах. Значение по умолчанию: `256`.
 - **Fastiot › Device > ssh > Key: Type** - Название используемого алгоритма для генерации ключа. Более подробно об алгоритмах для ключей в публикации [How To Set Up SSH Keys](https://goteleport.com/blog/how-to-set-up-ssh-keys/). Значение по умолчанию: `ed25519`. Если выберете алгоритм `rsa`, то вам потребуется в файл `/etc/ssh/sshd_config` внести строку `PubkeyAcceptedAlgorithms=+ssh-rsa`.
 - **Fastiot › Launch: Templatetitle** - шаблон для формирования названия Launch. Значения переменных можно посмотреть по [ссылке](Launch-title-template_ru.md "Template for forming the name Launch"). Значение по умолчанию: `Launch on %{device.label} (%{project.name}, %{device.board.name}, %{device.user.debug})`.
+- **Fastiot › Template: Isupdate** - вкл/выкл обновление шаблонов с ресурсов сети Интернет.
+- **Fastiot › Template: Lastupdate** - время последнего обновления. Технически параметр.
+- **Fastiot › Template: Loadonstart** - загрузка шаблонов при старте расширения. При отключенном параметре шаблоны загрузятся только при первом обращение к ним.
+- **Fastiot › Template: Updateinterval** - интервал обновления шаблонов в часах.

vscodetemplates/insert_task_copy_app_to_device.json renamed to archive/vscodetemplates/insert_task_copy_app_to_device.json

@@ -16,8 +16,6 @@ apt-get install -y sudo
 ```bash
 sudo apt-get update
 sudo apt-get install -y openssh-server mc
-sudo systemctl reload ssh
-sudo systemctl status ssh
 sudo mcedit /etc/ssh/sshd_config
 ```
 
@@ -118,6 +116,8 @@ To run a .NET IoT application and perform remote debugging, you need to install:
 
 Sample projects with added configuration Launch (`/.vscode/launch.json`) and Tasks (`/.vscode/tasks.json`) are located in the [samples](/samples/) folder.
 
+The `template.fastiot.yaml` file will be placed in the project folder. This file is required to determine the template ID when adding Launch. If it is removed, then there will be no exact definition of the template from which the project was formed. From the `template.fastiot.yaml` file, only the template identifier string `id: dotnet-console` is taken.
+
 ## Rebuild Launch
 
 Launch (`/.vscode/launch.json`) and Tasks (`/.vscode/tasks.json`) configurations contain absolute paths to binary files that are loaded on the device, for example `/cygdrive/d/Anton/Projects/Tests /DotnetConsoleAppRuntimeInfo/bin/Debug/net5.0/linux-arm/`. In this regard, if you change the path to the `Applicationdatafolder` folder in the settings or rename / move the project folder, then the paths become non-existent. In this case, you need to rebuild (Rebuild) Launch. Select the required Launch and then call the context menu, click on the `Rebuild` menu item.

vscodetemplates/insert_task_create_folder.json renamed to archive/vscodetemplates/insert_task_create_folder.json

@@ -16,8 +16,6 @@ apt-get install -y sudo
 ```bash
 sudo apt-get update
 sudo apt-get install -y openssh-server mc
-sudo systemctl reload ssh
-sudo systemctl status ssh
 sudo mcedit /etc/ssh/sshd_config
 ```
 
@@ -61,7 +59,7 @@ sudo systemctl status ssh
 
 ### Шаг 3 — Установка пакетов
 
-Для запуска .NET IoT приложения и выполнения удаленной отладки необходимо установить:
+Для запуска .NET IoT приложении и выполнения удаленной отладки необходимо установить:
 
 - Среду исполнения - .NET Runtime;
 - Удаленный отладчик - .NET Debugger (vsdbg).
@@ -118,6 +116,8 @@ sudo systemctl status ssh
 
 Примеры проектов с добавленной конфигурацией Launch (`/.vscode/launch.json`) и Tasks (`/.vscode/tasks.json`) располагаются в папке [samples](/samples/).
 
+В папке с проектом будет размещен файл `template.fastiot.yaml`. Этот файл необходим для определения идентификатора шаблона при добавлении Launch. Если его удалить, то не будет точного определения шаблона из которого был сформирован проект. Из файла `template.fastiot.yaml` берется только строка идентификатор шаблона `id: dotnet-console`.
+
 ## Перестройка (Rebuild) Launch
 
 Конфигурации Launch (`/.vscode/launch.json`) и Tasks (`/.vscode/tasks.json`) содержат абсолютные пути к бинарным файлам, которые загружаются на устройство, например `/cygdrive/d/Anton/Projects/Tests/DotnetConsoleAppRuntimeInfo/bin/Debug/net5.0/linux-arm/`. В связи с этим, если вы изменяете путь к папке `Applicationdatafolder` в настройках или переименовываете/перемещаете папку с проектом, то пути становятся несуществующими. В этом случае необходимо перестроить (Rebuild) Launch. Выбрать необходимый Launch и затем вызвать контекстное меню, нажать на пункт меню `Rebuild`.

vscodetemplates/launch.json renamed to archive/vscodetemplates/launch.json

@@ -4,6 +4,6 @@ Default value: `Launch on %{device.label} (%{project.name}, %{device.board.name}
 
 Merging example: `Launch on cubieboard (DotnetConsoleBlinkLEDApplication, Cubieboard, debugvscode)`.
 
-Variables for creating the name of the Launch configuration and their values can be viewed on the [Project Templates](Project-templates.md "Project Templates") page.
+See the [Project Templates](Project-templates.md "Project Templates") page for the variables to create the Launch configuration name and their values.
 
 If you need additional variables, please create an [ISSUE](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues "ISSUE").

vscodetemplates/source/launch.json renamed to archive/vscodetemplates/source/launch.json

@@ -4,6 +4,6 @@
 
 Пример слияния: `Launch on cubieboard (DotnetConsoleBlinkLEDApplication, Cubieboard, debugvscode)`.
 
-Переменные для создания названия конфигурации Launch и их значения можете посмотреть на странице [Project Templates](Project-templates_ru.md "Project Templates").
+Переменные для создания названия конфигурации Launch и их значения смотрите на странице [Project Templates](Project-templates_ru.md "Project Templates").
 
 Если вам нужны дополнительные переменные, создайте [ISSUE](https://github.com/devdotnetorg/vscode-extension-dotnet-fastiot/issues "ISSUE").