خلية FOSS
C++
Getting Started
التثبيت

التثبيت

التثبيت

تظهر هذه الدورة كيفية إعداد Aspose.Cells FOSS لـ C++ على آلة التطوير الخاصة بك ، وبناء المكتبة ، وتحقق من الإعداد باستخدام برنامج إنشاء ورقة بيانات ضئيل.

المعايير

متطلباتالتفاصيل
C++ مترجممترجم متوافق مع C++17 (GCC 9+، Clang 10+ أو MSVC 2019+)
صناعة المنتجاتالإصدار 3.15 أو أعلى
إذهبأي نسخة حديثة
نظام التشغيللينكس، ماكوس أو ويندوز

الخطوة 1 استنساخ المستودع

استنساخ Aspose.Cells FOSS لمستودع مصدر C++:

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

الخطوة 2 بناء العينات

استخدم تكوين 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 لتمكين التحسينات.
  • احتفظ بالدليل النموذجي كجذر مكتبتك؛ لا تنسخ الرؤوس الفردية نسبي تشمل المسارات في رأس المكتبة تعتمد على تخطيط الدليل الأصلي.

القضايا المشتركة

القضيةالسببإصلاح
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryإدراج مسار غير مُصمّمتأمين target_include_directories يشير إلى المكتبة include/ المجلد
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()مكتبة غير مرتبطةإضافة target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) في CMakeLists.txt
خطأ في الإصدار CMakeCMake < 3.15قم بتحديث CMake إلى 3.15+ أو ضبط المقياس. cmake_minimum_required النسخة
فشل البناء في وضع C++14القياس قديم جداًإضافة set(CMAKE_CXX_STANDARD 17) قبل أن يبدأ التشغيل add_executable دعوة

الخطوات التالية

انظر أيضا

 العربية