All Products
Search
Document Center

Object Storage Service:Installation (C# SDK V1)

Last Updated:Nov 29, 2025

You can use the OSS C# SDK to manage OSS buckets, upload and download files, manage data, and perform image processing. This topic describes how to install the OSS C# SDK.

Prerequisites

  • Windows

    • .NET 2.0 or later is required.

    • Visual Studio 2010 or later is required.

  • Linux/Mac

    Mono 3.12 or later is required.

Download the SDK

Install the SDK

  • Installing on Windows

    • Install using NuGet

      1. If NuGet is not installed for your Visual Studio, install NuGet first. For more information, see Install NuGet client tools.

      2. After you install NuGet, create a project or open an existing project in Visual Studio. Then, choose Tools > NuGet Package Manager > Manage NuGet Packages for Solution.

      3. Enter aliyun.oss.sdk in the search box and click Search. Find Aliyun.OSS.SDK (applicable to .NET Framework) or Aliyun.OSS.SDK.NetCore (applicable to .Net Core) in the search results. Select the latest version and click Install.

    • Install using a DLL file

      1. You can download and unzip the .NET SDK package.

      2. Compile the aliyun-oss-sdk project in Release mode to generate a Dynamic Link Library (DLL) file.

      3. In Visual Studio, go to Solution Explorer and find your project. Right-click the project name and choose Reference > Add Reference. In the dialog box that appears, select Browse.

      4. Find the bin directory generated by the DLL file and select the Aliyun.OSS.dll file in the bin directory. Then, click OK.

    • Install by importing a project

      If you download the SDK installation package or download the source code from GitHub and use the source code to install the SDK, perform the following steps:

      1. In Visual Studio, right-click Solution and select a solution. Then, choose Add > Existing projects.

      2. In the dialog box that appears, select the aliyun-oss-sdk.csproj file. Click Open.

      3. Right-click the name of your project and choose Reference > Add Reference. In the dialog box that appears, click the Projects tab, select the aliyun-oss-sdk project, and then click OK.

  • Installation on Unix and Mac

    Perform the following operations to install the SDK using NuGet:

    1. In Xamarin, create a project or open an existing project. Select Add NuGet.

    2. Search for Aliyun.OSS.SDK or Aliyun.OSS.SDK.NetCore. Select the latest version and click Add Package to add the package to the project application.