Installation
Installation
این راهنمای نشان می دهد که چگونه برای تنظیم Aspose.Cells FOSS برای C++ در دستگاه توسعه خود، ساخت کتابخانه و بررسی تنظیمات با یک برنامه ایجاد صفحه پخش حداقل.
Prerequisites
| Requirement | Detail |
|---|---|
| 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بهینه سازی امکان پذیر است. - دایرکتوری کلون را به عنوان ریشه کتابخانه خود نگه دارید؛ سرنوشت های فردی را کپی نکنید – نسبتا شامل مسیرها در سرنکتورهای کتابچه بستگی به طرح اصلی درایو دارد.
مسائل مشترک
| Issue | Cause | اصلاحی |
|---|---|---|
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.15 | CMake را به 3.15+ ارتقا دهید یا تنظیم کنید. cmake_minimum_required نسخه |
| ساخت شکست در حالت C++14 | استاندارد قدیمی است | اضافه کردن set(CMAKE_CXX_STANDARD 17) قبل از آن که add_executable تماس تلفنی |
قدم های بعدی
- License – بررسی شرایط مجوز MIT برای Aspose.Cells FOSS برای C++.
- Features – مرور تمام قابلیت های صفحه پخش پشتیبانی شده.
- مدیریت Spreadsheet Management - یادگیری کارگاه ها و کارگزاران.