Installation

Installation

This page walks through building Aspose.Words FOSS for .NET from source and referencing it in your own .NET project. A NuGet package has not been published yet, so the library must be compiled locally.


Prerequisites

RequirementDetail
.NET SDKAny SDK that can target .NET Standard 2.0 — .NET Framework 4.6.2+, .NET 6, .NET 8, or .NET 10
GitRequired to clone the source repository
OSWindows, Linux, or macOS
DependenciesNone — pure managed C#, no native dependencies

1. Clone and Build from Source

Clone the repository and build the solution in Release configuration:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

2. Reference the Library from Your Project

Add a project reference to Aspose.Words.csproj from your own application, either through your IDE’s Add Reference dialog or with the dotnet CLI:

dotnet add reference path/to/Aspose.Words-FOSS-for-.NET/Aspose.Words/Aspose.Words.csproj

The library targets .NET Standard 2.0, so it runs on .NET Framework 4.6.2+ and .NET 6/8/10, on Windows, Linux, and macOS, with no native dependencies.


3. Verify the Build

Create a minimal console application and build a document with a chart to confirm the reference resolves and the library runs correctly:

using Aspose.Words;
using Aspose.Words.Drawing.Charts;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;

// Delete default generated series.
chart.Series.Clear();

string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });

doc.Save("chart.docx");

If chart.docx is created without errors, the build and reference are working correctly.


Next Steps

See Also