# Upgrade

There are two ways to upgrade our library in your project:

* Using Visual Studio's NuGet package manager
* Manual upgrade

You can choose a way to install a package in a way you prefer.

***

## <mark style="color:$primary;">Visual Studio's NuGet package manager</mark>

If you're using Visual Studio to build your project, it provides you an easy way to install NuGet packages, such as our libraries, into your project.

{% stepper %}
{% step %}

### <mark style="color:$primary;">Open your project</mark>

Open Visual Studio to a project that you want to upgrade our libraries.
{% endstep %}

{% step %}

### <mark style="color:$primary;">Open the NuGet package manager</mark>

Right click on either the project or the `Dependencies` entry beneath the project in the Solution Explorer pane and select `Manage NuGet packages...`

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2FJbpAJqUugu0oxGVxFbcq%2Fimage.png?alt=media&#x26;token=1b21fa3e-a2d4-43dd-a332-50e15787c385" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Search for library updates</mark>

Click on `Updates`. Then, select the desired library you'd like to upgrade, such as Terminaux.

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2FxCWsj2wEapPelfca1mKt%2Fimage.png?alt=media&#x26;token=8f591041-94df-4f17-887a-d08172165fb5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Install a library</mark>

Click on any of the libraries that show up in the search results, and click on `Update`.

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2F4rdEYhbLxxHCHf1Dx2OG%2Fimage.png?alt=media&#x26;token=f2e96002-e6aa-459b-be7b-718b46eb6131" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Accept the license</mark>

If any package asks for your acceptance of the license, read the license contained by clicking on their license names, then click on `I Accept`.

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2F0H5ea4WtmYnBr39lMqr5%2Fimage.png?alt=media&#x26;token=337860af-1946-48b9-b5a5-504d618ab750" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Verify the upgrade</mark>

The package is upgraded! Verify by expanding the `Dependencies` entry beneath the project and expanding the `Packages` entry.

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2Fgc4wtrM8Ymr7aR4pxisy%2Fimage.png?alt=media&#x26;token=a6a5cab4-a69b-4b4e-9b8b-3b54a9b7078a" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## <mark style="color:$primary;">Manual upgrade</mark>

If you'd like to manually upgrade a NuGet package to a project with your favorite editor or if you're unable to use Visual Studio for some reason, you can use this upgrade method. However, this method comes in two ways:

* Visual Studio
* Text editor

### <mark style="color:$primary;">Visual Studio</mark>

If you are using Visual Studio, follow these steps:

{% stepper %}
{% step %}

### <mark style="color:$primary;">Open your project</mark>

Open Visual Studio to a project that you want to upgrade our libraries.
{% endstep %}

{% step %}

### <mark style="color:$primary;">Open the project file</mark>

Double click on the project as shown in the Solution Explorer pane

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2Fmi35R3ZsPFGnhyTQtsEn%2Fimage.png?alt=media&#x26;token=8fcdba71-8e1b-4fd2-a589-2a47a28cd36c" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Update the version in a library reference</mark>

Look for the `PackageReference` property that targets a specific library (for example, Terminaux) and change the `Version` attribute (replace `8.0.14` with the desired version of the library)

```xml
<ItemGroup>
  <PackageReference Include="Terminaux" Version="8.0.14" />
</ItemGroup>
```

{% endstep %}

{% step %}

### <mark style="color:$primary;">Save project and restore packages</mark>

Save the project file. It should automatically upgrade the required packages. If, however, the package restoration didn't automatically start, right-click on the solution and select `Restore NuGet Packages`.

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2Fv6WhNR8a10sDNNCBHieH%2Fimage.png?alt=media&#x26;token=48629cef-24fa-412b-af43-8ca8a6265f0f" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### <mark style="color:$primary;">Text editor</mark>

If you are using your favorite text editor, such as Visual Studio Code or Sublime Text, follow these steps:

{% stepper %}
{% step %}

### <mark style="color:$primary;">Open your project folder</mark>

Open the file explorer and navigate to the target project directory that contains the project file (not the solution `.sln` or `.slnx` file)

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2FFVgHJhYKR5c3c9oE7i9D%2Fimage.png?alt=media&#x26;token=d106992a-136a-44fb-8284-ae03b8e8e9df" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Open your text editor</mark>

Right-click on the project file -> `Open With` -> your favorite text editor

<figure><img src="https://1697756926-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId4bob6wnHvpX4zbVVtI%2Fuploads%2FbH0BURRFGj6ecuqvDEvJ%2Fimage.png?alt=media&#x26;token=6095c91c-505f-4967-8932-8ccb462197ef" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:$primary;">Update the version in a library reference</mark>

Look for the `PackageReference` property that targets a specific library (for example, Terminaux) and change the `Version` attribute (replace `8.0.14` with the desired version of the library)

```xml
<ItemGroup>
  <PackageReference Include="Terminaux" Version="8.0.14" />
</ItemGroup>
```

{% endstep %}

{% step %}

### <mark style="color:$primary;">Save project and restore packages</mark>

Save the project file. Then, open the terminal emulator in your preferred way and execute `dotnet restore`.
{% endstep %}
{% endstepper %}