FAQ — Aspose.PDF FOSS для .NET

Лицензирование и открытый исходный код

Какова модель лицензирования Aspose.PDF FOSS для .NET?

Aspose.PDF FOSS for .NET выпущен под лицензией MIT. Вы можете использовать, копировать, модифицировать и распространять библиотеку бесплатно, в том числе в коммерческих продуктах, без покупки коммерческой лицензии. Исходный код общедоступен на GitHub.

Могу ли я использовать Aspose.PDF FOSS для .NET в коммерческом программном обеспечении?

Да. Лицензия MIT разрешает использование в проприетарных и коммерческих приложениях без каких‑либо сборов за время выполнения. Требуется лишь сохранить уведомление о лицензии в любой распространяемой копии или существенной части библиотеки.

Нужен ли мне лицензионный ключ Aspose или измеряемая лицензия?

Для Aspose.PDF FOSS ключ лицензии не требуется. Свойство Document.IsLicensed отражает внутреннее состояние лицензирования, но шаг активации не нужен — библиотека полностью работает без лицензии и бесплатно.

Установка и требования

Как установить Aspose.PDF FOSS для .NET?

Установите из NuGet с помощью .NET CLI:

dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha

Или добавьте в файл проекта:

<PackageReference Include="Aspose.Pdf.Foss" Version="0.1.0-alpha" />

Какая версия .NET требуется?

Aspose.PDF FOSS нацелен на .NET 8 и более новые версии. Он не поддерживает .NET Framework, .NET Standard или более ранние версии .NET Core. Убедитесь, что ваш проект нацелен на net8.0 или выше в файле .csproj.

Требуются ли какие-либо нативные зависимости или внешние инструменты?

Нет. Aspose.PDF FOSS — полностью управляемая библиотека .NET без неуправляемых нативных бинарных файлов и без зависимости от Adobe Acrobat, Ghostscript или любого другого внешнего инструмента.

Поддержка форматов

Какие форматы поддерживает Aspose.PDF FOSS для .NET?

Библиотека читает и записывает формат PDF. Метод Document.Open принимает массивы байтов, пути к файлам и потоки. Методы Document.Save и Document.ToArray создают вывод в формате PDF. Вывод изображений (для отрисовки страниц) управляется перечислением ImageFormat, которое поддерживает BMP, GIF, JPEG, PNG, TIFF и другие растровые форматы.

Может ли Aspose.PDF FOSS конвертировать страницы PDF в изображения?

Да. Рендеринг страниц в растровые форматы поддерживается через перечисление ImageFormat, которое включает Bmp, Jpeg, Png, Gif, Tiff и Emf. Конкретные классы устройств обрабатывают конвейер рендеринга.

Использование API

Как создать новый PDF‑документ?

Используйте Document.Create() для создания пустого документа, затем добавьте страницы и сохраните:

using var doc = Document.Create();
// add pages, content, annotations
using var ms = new MemoryStream();
doc.Save(ms);
byte[] pdfBytes = ms.ToArray();

Как открыть существующий PDF из пути к файлу или массива байтов?

// From file path
using var doc = Document.Open("input.pdf");
// From byte array
byte[] data = File.ReadAllBytes("input.pdf");
using var doc = Document.Open(data);
// From stream
using var stream = File.OpenRead("input.pdf");
using var doc = Document.Open(stream);

Как объединить несколько PDF-документов?

Используйте Document.Merge для объединения нескольких документов:

var merged = Document.Merge(new[] { doc1, doc2, doc3 });
merged.Save("combined.pdf");

Document.MergeDocuments — это эквивалентная перегрузка, принимающая пути к файлам напрямую.

Известные ограничения

Является ли библиотека полностью функциональной по сравнению с коммерческой редакцией Aspose.PDF?

Нет. Aspose.PDF FOSS — это открытая подсистема. Некоторые продвинутые коммерческие функции — такие как полное рендеринг форм XFA, конвертация PDF/A, цифровые подписи (PKCS7) и некоторые операции линейризации — могут быть частично реализованы или отсутствовать. Проверьте трекер проблем GitHub для текущего статуса конкретных функций.

Полностью ли поддерживаются расширения JavaScript AcroForm?

Классы FieldDateTimeFormatter, FieldNumberCurrencyFormatter и FieldNumberPercentFormatter реализуют эквиваленты функций PDF JavaScript AF_Date_Format, AF_Number_Format и AF_Percent_Format для серверного форматирования полей без движка JavaScript. Они доступны в текущем альфа‑релизе.