MSDN Documentation

Installation Guide

This guide provides comprehensive instructions on how to install and configure the necessary software and tools to begin developing with our platform.

Prerequisites

Before you begin the installation process, ensure you have the following:

Note: For Windows users, we highly recommend using the Windows Subsystem for Linux (WSL) for an optimal development environment.

Step-by-Step Installation

  1. Download the Installer

    Visit the latest downloads page to get the installer package for your operating system. Choose the appropriate version (e.g., installer-win64.exe, installer-macos.dmg, installer-ubuntu.deb).

  2. Run the Installer

    Execute the downloaded installer file. Follow the on-screen prompts. You will be asked to accept the license agreement and choose an installation directory. It is generally recommended to accept the default location.

    > ./installer-ubuntu.deb
  3. Configure Environment Variables

    After the installation is complete, you may need to add the installation directory to your system's PATH environment variable. This allows you to run our tools from any terminal location.

    For Windows:

    1. Search for "Environment Variables".
    2. Click "Edit the system environment variables".
    3. In the System Properties window, click "Environment Variables...".
    4. Under "System variables" or "User variables", find the "Path" variable, select it, and click "Edit...".
    5. Click "New" and add the path to the `bin` directory within your installation folder.
    6. Click "OK" on all open windows.

    For macOS/Linux:

    Edit your shell configuration file (e.g., ~/.bashrc, ~/.zshrc) and add the following line, replacing /path/to/installation with your actual installation directory:

    export PATH="/path/to/installation/bin:$PATH"

    After saving the file, reload your shell configuration:

    source ~/.bashrc (or source ~/.zshrc)
  4. Verify Installation

    Open a new terminal or command prompt and run the following command to verify that the installation was successful:

    > msdn --version

    This command should output the installed version number.

Post-Installation Steps

Once the core software is installed, you might want to perform the following optional steps:

Tip: We provide official extensions for Visual Studio Code and JetBrains IDEs. Find them in their respective marketplaces.

Troubleshooting

Encountering issues? Check our comprehensive FAQ page or visit the developer forums for assistance.

Warning: Ensure you are installing the correct version for your operating system and architecture. Using an incompatible version can lead to unexpected errors.