Skip to content

Commit

Permalink
Create development-setup
Browse files Browse the repository at this point in the history
  • Loading branch information
jtorjo authored May 20, 2024
1 parent eae8ae0 commit 657df53
Showing 1 changed file with 87 additions and 0 deletions.
87 changes: 87 additions & 0 deletions documentation/general/development-setup
Original file line number Diff line number Diff line change
@@ -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.

0 comments on commit 657df53

Please sign in to comment.