Merge pull request #12 from devdotnetorg/dev-0.4.0

Dev 0.4.0 => Dev

Author: devdotnetorg

.vscode/settings.json

@@ -1,7 +1,8 @@
 // Place your settings in this file to overwrite default and user settings.
 {
     "files.exclude": {
-        "out": false // set this to true to hide the "out" folder with the compiled JS files
+        "out": false, // set this to true to hide the "out" folder with the compiled JS files
+        "samples/**": true
     },
     "search.exclude": {
         "out": true // set this to false to include "out" folder in search results

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v0.4.0 (30-05-2023)
+
+- Added command to discover devices on the local network.
+- Updated npm component packages.
+- Improved UI.
+
 ## v0.3.4 (17-05-2023)
 
 - Bugs fixed.

CHANGELOG_ru.md

@@ -1,5 +1,11 @@
 # Список изменений
 
+## v0.4.0 (30-05-2023)
+
+- Добавлена команда обнаружения устройств в локальной сети.
+- Обновлены npm-пакеты компонентов.
+- Улучшен UI.
+
 ## v0.3.4 (17-05-2023)
 
 - Исправлены ошибки.

Create-extension.md

@@ -1,10 +1,8 @@
 # Create extension
 
-1. npm install -g yo
+1. npm install -g yo generator-code
 
-2. npm install -g yo generator-code
-
-3. Create App: yo code
+2. Create App: yo code
 
 Links:
 

README.md

@@ -26,8 +26,8 @@ Devices supported: Raspberry Pi, Banana Pi, Orange Pi, Radxa, Tinkerboard, Odroi
 
 ## System requirements
 
-- **OS version.** Windows 7-10 (x64). A Linux version will come later. Note: The next version of the extension above v0.3 will not support Windows 7;
-- **Visual Studio Code.** version not lower than [1.70.3](https://code.visualstudio.com/ "1.70.3"). This is the latest version of VSCode with Windows 7 support, more details on this on [support page](https://code.visualstudio.com/docs/supporting/faq#_can-i-run-vs-code-on-windows-7 "Can I run VS Code on Windows 7?");
+- **OS version.** Windows 10 (x64). A Linux version will come later;
+- **Visual Studio Code.** version [1.78.0](https://code.visualstudio.com/ "1.78.0") or higher;
 - **.NET.** Compiling a C# project requires [.NET SDK](https://dotnet.microsoft.com/en-us/download/visual-studio-sdks ".NET SDK") depending on the version of your project you are using (the extension itself is not required to work);
 
 Additional extensions required for developing .NET applications:

README_ru.md

@@ -26,8 +26,8 @@
 
 ## Системные требования
 
-- **Версия ОС.** Windows 7-10 (x64). Версия для Linux появится позже. Примечание: следующая версия расширения выше v0.3 не будет поддерживать Windows 7;
-- **Visual Studio Code.** версия не ниже [1.70.3](https://code.visualstudio.com/ "1.70.3"). Это последняя версия VSCode с поддержкой Windows 7, подробнее об этом на [странице поддержки](https://code.visualstudio.com/docs/supporting/faq#_can-i-run-vs-code-on-windows-7 "Can I run VS Code on Windows 7?");
+- **Версия ОС.** Windows 10 (x64). Версия для Linux появится позже;
+- **Visual Studio Code.** Версия [1.78.0](https://code.visualstudio.com/ "1.78.0") или выше;
 - **.NET.** Для компиляции проекта на C# требуется [.NET SDK](https://dotnet.microsoft.com/en-us/download/visual-studio-sdks ".NET SDK") в зависимости от используемой версии вашего проекта (для работы самого расширения не требуется);
 
 Дополнительные расширения необходимые для разработки .NET приложений:

docs/Troubleshooting.md

@@ -176,6 +176,32 @@ If the problems persist, then you should delete/rename the extension folder wher
 - `C:\RemoteCode\`;
 - `%userprofile%\fastiot`, for example `C:\Users\Anton\fastiot`.
 
+After running the extension, there should be the following folder structure along the path `%userprofile%\fastiot`:
+
+```bash
+.
+└── fastiot
+    ├── settings
+    │   └── keys
+    ├── templates
+    │   ├── community
+    │   ├── system
+    │   │   ├── dotnet-console
+    │   │   │   ├── storage
+    │   │   │   ├── template
+    │   │   │   │   ├── dotnetapp.csproj
+    │   │   │   │   └── Program.cs
+    │   │   │   ├── template.fastiot.png
+    │   │   │   └── template.fastiot.yaml
+    │   │   ├── dotnet-console-runtime-info
+    │   │   │   └── ...
+    │   │   └── dotnet-iot-blink-led
+    │   │       └── ...
+    │   ├── user
+    │   └── webapi
+    └── tmp
+```
+
 If problems persist after restarting the extension, then the problems may be related to granting access rights to the above folders.
 
 The executable extension files are located in the `%USERPROFILE%\.vscode\extensions` folder, for example `C:\Users\Anton\.vscode\extensions`. You can remove the extension from the specified folder and reinstall it.

docs/Troubleshooting_ru.md

@@ -176,6 +176,32 @@ chmod +x vscode-dotnetfastiot.sh
 - `C:\RemoteCode\`;
 - `%userprofile%\fastiot`, например `C:\Users\Anton\fastiot`.
 
+После запуска расширения, должна быть следующая структура папок по пути `%userprofile%\fastiot`:
+
+```bash
+.
+└── fastiot
+    ├── settings
+    │   └── keys
+    ├── templates
+    │   ├── community
+    │   ├── system
+    │   │   ├── dotnet-console
+    │   │   │   ├── storage
+    │   │   │   ├── template
+    │   │   │   │   ├── dotnetapp.csproj
+    │   │   │   │   └── Program.cs
+    │   │   │   ├── template.fastiot.png
+    │   │   │   └── template.fastiot.yaml
+    │   │   ├── dotnet-console-runtime-info
+    │   │   │   └── ...
+    │   │   └── dotnet-iot-blink-led
+    │   │       └── ...
+    │   ├── user
+    │   └── webapi
+    └── tmp
+```
+
 Если после перезапуска расширения проблемы остались, то возможно проблемы связаны с предоставлением прав доступа к выше указанным папкам.
 
 Исполняемые файлы расширения располагаются в папке `%USERPROFILE%\.vscode\extensions`, например `C:\Users\Anton\.vscode\extensions`. Вы можете удалить расширение из указанной папки и заново его установить.

installation.md

@@ -1,24 +1,60 @@
 # Installation
 
-## Prerequisites 
+## for Windows 10
 
-- node (> v14.16)
-- npm 
-- .NET SDK 5.0
+### Prerequisites 
 
-## Install Node.js
+- vscode (v1.78.0)
+- python (v3.11.3) 
+- node (v16.17.1)
+- git
+- npm
+- .NET SDK 7.0
 
-- Download Node.js https://nodejs.org/dist/v14.16.0/
-- Unpack to folder: `{folder_nodejs}`
-- For windows 7 set environment variable: NODE_SKIP_PLATFORM_CHECK=1
-- Add to environment variable Path: `{folder_nodejs}`
-- Execute command: npm config --global set cache "`{folder_nodejs}`\\npm-cache"
-- Execute command: npm config --global set prefix "`{folder_nodejs}`"
-- Execute command: npm config ls -l
+### Software installation
+
+- Download [vscode 1.78.0](https://update.code.visualstudio.com/1.78.0/win32-x64-archive/stable "1.78.0")
+- Unpack to any folder
+- Download [python v3.11.3](https://www.python.org/downloads/release/python-3113/ "3.11.3")
+- Install python
+- Download [node.js v16.17.1](https://nodejs.org/dist/v16.17.1/ "16.17.1")
+- Install node.js with Tools for Native Modules (checkbox during installation)
+- Download [git](https://git-scm.com/download/win/ "git")
+- Install git
 
 ## Install steps
 
 - Clone repository and `cd` into it
 - Execute command: npm install
 - Open in Visual Studio Code (`code .`)
 - Press <kbd>F5</kbd> to debug.
+
+## for Windows 7
+
+Only up to extension version v0.3.4 (17-05-2023).
+
+### Prerequisites 
+
+- vscode (v1.70.3, latest version with Windows 7 support)
+- python (v3.8.0)
+- node (v14.16)
+- git
+- npm
+- .NET SDK 5.0
+
+### Software installation
+
+- Download [vscode 1.70.3](https://az764295.vo.msecnd.net/stable/a21a160d630530476218b85db95b0fd2a8cd1230/VSCodeSetup-x64-1.70.3.exe "1.70.3")
+- Unpack to any folder
+- Download [python v3.8.0](https://www.python.org/downloads/release/python-380/ "3.8.0")
+- Install python
+- Download [node.js v14.16](https://nodejs.org/dist/v14.16.0/ "14.16")
+- Unpack to folder: `{folder_nodejs}`
+- For windows 7 set environment variable: NODE_SKIP_PLATFORM_CHECK=1
+- Add to environment variable Path: `{folder_nodejs}`
+- Execute command: npm config --global set cache "`{folder_nodejs}`\\npm-cache"
+- Execute command: npm config --global set prefix "`{folder_nodejs}`"
+- Execute command: npm config ls -l
+- Execute command: npm install -g --production windows-build-tools
+- Download [git](https://git-scm.com/download/win/ "git")
+- Install git