From 657df53f5e306a25b28f4e9a698d481f8f32bac4 Mon Sep 17 00:00:00 2001 From: John Torjo Date: Mon, 20 May 2024 10:00:10 +0300 Subject: [PATCH] Create development-setup --- documentation/general/development-setup | 87 +++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 documentation/general/development-setup diff --git a/documentation/general/development-setup b/documentation/general/development-setup new file mode 100644 index 00000000..451cc487 --- /dev/null +++ b/documentation/general/development-setup @@ -0,0 +1,87 @@ +# Installation Guide for OpenSilver Development Environment + +Below, you'll find a detailed document about how to set up your Development Environment when using OpenSilver. + +## Contents +1. Install the Latest Version of Visual Studio 2022 +2. Install the OpenSilver Plugin for Visual Studio +3. Download .NET 7 +4. Install WebAssembly Tools for .NET 7 +5. Download and Install the IIS URL Rewrite Module + +## 1. Install the Latest Version of Visual Studio 2022 + +### Step-by-Step Instructions: +1. **Navigate to the Visual Studio Website:** + - Open your web browser and go to the official Visual Studio site: [Visual Studio Official Site](https://visualstudio.microsoft.com/vs/). + +2. **Download the Installer:** + - Click on the "Download" button for Visual Studio 2022 Community Edition, which is free for individual developers, open-source projects, academic research, education, and small professional teams. + +3. **Run the Installer:** + - Once the download is complete, run the installer file from your Downloads folder. + +4. **Install Visual Studio 2022:** + - When prompted, select the workloads you wish to install. For general development, choose “.NET desktop development” and “ASP.NET and web development”. + - Click "Install" and wait for the installation to complete. + +5. **Complete the Setup:** + - After installation, launch Visual Studio and sign in with your Microsoft account (optional but recommended for syncing settings). + +## 2. Install the OpenSilver Plugin for Visual Studio + +### Step-by-Step Instructions: +1. **Open Visual Studio 2022:** + - Launch Visual Studio 2022. + +2. **Access the Extensions Menu:** + - Navigate to “Extensions” on the menu bar, then select “Manage Extensions”. + +3. **Search for OpenSilver:** + - In the search bar of the Manage Extensions window, type “OpenSilver” and press enter. + +4. **Install OpenSilver:** + - Find the OpenSilver extension in the list and click “Download”. After downloading, you may need to close Visual Studio to initiate the installation. + +5. **Restart Visual Studio:** + - Restart Visual Studio to complete the installation of the OpenSilver plugin. + +## 3. Download .NET 7 + +### Step-by-Step Instructions: +1. **Go to the .NET Download Page:** + - Access the .NET 7 official download page at [Download .NET 7](https://dotnet.microsoft.com/en-us/download/dotnet/7.0). + +2. **Select the Appropriate SDK:** + - Choose the SDK according to your operating system (Windows, macOS, Linux). + +3. **Download and Install the SDK:** + - Click the download link and run the installer after the download completes. + +## 4. Install WebAssembly Tools for .NET 7 + +### Step-by-Step Instructions: +1. **Open a Command Prompt or Terminal:** + - On Windows, you can search for “cmd” or “Command Prompt” in the Start menu. + +2. **Install the WebAssembly Tools:** + - Type the following command and press Enter: + ```bash + dotnet workload install wasm-tools + ``` + +## 5. Download and Install the IIS URL Rewrite Module + +### Step-by-Step Instructions: +1. **Visit the IIS URL Rewrite Module Download Page:** + - Navigate to the official Microsoft IIS page to download the URL Rewrite Module: [IIS URL Rewrite Module Official Page](https://www.iis.net/downloads/microsoft/url-rewrite). + +2. **Download the Module:** + - Select the version appropriate for your system and click the download link. + +3. **Install the Module:** + - Run the downloaded installer and follow the on-screen instructions to install the module. + +4. **Verify Installation:** + - Open the IIS Manager from the Control Panel or by searching in the Start menu to ensure that the URL Rewrite module is installed. +