Installation

Installation

این راهنمای نشان می دهد که چگونه برای تنظیم Aspose.Cells FOSS برای C++ در دستگاه توسعه خود، ساخت کتابخانه و بررسی تنظیمات با یک برنامه ایجاد صفحه پخش حداقل.


Prerequisites

RequirementDetail
C++ کامپیوتریکپیگر سازگار با C++17 (GCC 9+، Clang 10+ یا MSVC 2019+)
CMAKنسخه 3.15 یا بالاتر
GITهر نسخه جدیدی
سیستم عاملمک، لینوکس یا ویندوز

مرحله اول: کلون کردن رستوران ها

Clone the Aspose.Cells FOSS for C++ منبع ذخیره سازی:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-Cpp

مرحله دوم: نمونه ها را بسازید

از تنظیمات CMake بسته بندی شده برای ساخت پروژه نمونه استفاده کنید که همچنین کتابخانه را جمع آوری می کند:

cd samples
mkdir build
cd build
cmake ..
cmake --build .

ساختن محصول، دوگانه های جمع آوری شده را در build/ کارگردانی.


مرحله 3 - شامل کتابخانه در پروژه خود را

اضافه کردن کتابخانه عنوان ها و درخت منبع به خود CMakeLists.txt از طریق FetchContent یا یک مسیر محلی شامل:

cmake_minimum_required(VERSION 3.15)
project(MyProject CXX)

set(CMAKE_CXX_STANDARD 17)

# Option A: local path
add_subdirectory(path/to/Aspose.Cells-FOSS-for-Cpp)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE Aspose.Cells.Foss.Cpp)

مرحله 4 - نصب را بررسی کنید.

ایجاد یک حداقل main.cpp که یک فایل XLSX ایجاد و ذخیره می کند:

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/WorksheetCollection.h"
#include "aspose/cells_foss/Worksheet.h"
#include "aspose/cells_foss/Cell.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Hello");
    sheet.GetCells()["A1"].PutValue("Hello, Aspose.Cells FOSS!");
    workbook.Save("hello.xlsx");
    return 0;
}

ساخت و اجرا کنید اگر hello.xlsx در دایرکتوری کار ایجاد شده است، نصب موفقیت آمیز است.


راهنمایی ها و بهترین شیوه ها

  • همیشه از آن استفاده کنید. Aspose::Cells_FOSS نام فضای برای جلوگیری از درگیری های نمادین با کتابخانه های دیگر.
  • این بخش شامل نقطه ورود برای اکثر عملیات ها می باشد. aspose/cells_foss/Workbook.h;شامل سایر شاخص ها مانند Worksheet.h و Cell.h به عنوان لازم است.
  • از CMake 3.15 یا بالاتر استفاده کنید؛ نسخه های قدیمی تر ممکن است تنظیم هدف بسته را پشتیبانی نکنند.
  • برای ساخت و ساز، عبور -DCMAKE_BUILD_TYPE=Release به cmake بهینه سازی امکان پذیر است.
  • دایرکتوری کلون را به عنوان ریشه کتابخانه خود نگه دارید؛ سرنوشت های فردی را کپی نکنید – نسبتا شامل مسیرها در سرنکتورهای کتابچه بستگی به طرح اصلی درایو دارد.

مسائل مشترک

IssueCauseاصلاحی
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryمسیرهای غیر تنظیم شده را شامل می شود.Ensure target_include_directories نکته ای که در کتابخانه به آن اشاره می شود include/ پوشه ها
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()کتابخانه بدون ارتباطاضافه کردن target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) در CMakeLists.txt
خطای نسخه CMakeفایر 3.15CMake را به 3.15+ ارتقا دهید یا تنظیم کنید. cmake_minimum_required نسخه
ساخت شکست در حالت C++14استاندارد قدیمی استاضافه کردن set(CMAKE_CXX_STANDARD 17) قبل از آن که add_executable تماس تلفنی

قدم های بعدی

  • License – بررسی شرایط مجوز MIT برای Aspose.Cells FOSS برای C++.
  • Features – مرور تمام قابلیت های صفحه پخش پشتیبانی شده.
  • مدیریت Spreadsheet Management - یادگیری کارگاه ها و کارگزاران.

See Also

 فارسی