الأسئلة المتكررة
التراخيص والمصدر المفتوح
ما الرخصة التي يستخدمها Aspose.Cells FOSS للغة Rust؟
الحزمة موزعة تحت رخصة MIT. النص الكامل موجود في المستودع كـ LICENSE.txt.
هل يمكنني استخدامها في المنتجات التجارية؟
نعم. رخصة MIT تسمح بالاستخدام التجاري، والتعديل، وإعادة التوزيع. الشرط الوحيد هو الحفاظ على إشعار حقوق النشر والرخصة في النسخ أو الأجزاء الجوهرية من البرنامج.
التثبيت والمتطلبات
كيف أقوم بتثبيت الحزمة؟
أضف aspose-cells-foss-rust إلى Cargo.toml كاعتماد git:
# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }انظر دليل التثبيت للحصول على شرح خطوة بخطوة.
ما إصدارات Rust المدعومة؟
الحزمة تستهدف إصدار Rust 2021.
هل يتطلب Microsoft Office أو مكتبات أصلية؟
لا. المكتبة تقرأ وتكتب تنسيق حزمة XLSX مباشرة — لا يتطلب تثبيت Microsoft Office ولا أتمتة COM ولا أي بيئة تشغيل خارجية.
دعم الصيغ
ما الصيغ التي يمكن قراءتها وكتابتها؟
XLSX هو الصيغة المدعومة في الإصدار الحالي: قراءة وكتابة كاملة ذهابًا وإيابًا. يتم التحميل عبر Workbook::load_xlsx (التعداد LoadFormat يغطي Auto وXlsx)، ويتم الحفظ عبر save أو save_xlsx أو save_with_format باستخدام تعداد SaveFormat.
هل يمكنه إصلاح ملفات XLSX التالفة؟
LoadOptions يكشف عن أعلام try_repair_package وtry_repair_xml، وLoadDiagnostics يبلّغ عن المشكلات التي تم مواجهتها أثناء التحميل:
let options = LoadOptions {
try_repair_package: true,
try_repair_xml: true,
..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&path, &options)?;API Usage
ما هو النمط المعتاد لإنشاء دفتر عمل؟
أنشئ Workbook، حدّد نطاق القروض القابلة للتغيير، اكتب القيم، ثم احفظ:
let mut workbook = Workbook::new();
{
let mut worksheets = workbook.get_worksheets_mut();
let sheet = worksheets.get(0)?;
let mut cells = sheet.get_cells_mut();
cells.get("A1")?.put_value_string("Hello")?;
}
workbook.save("hello.xlsx")?;كيف يمكنني كتابة أنواع قيم مختلفة في الخلايا؟
استخدم المحددات المكتوبة على خلية قابلة للتغيير: put_value_string, put_value_i32, put_value_bool, put_value_decimal, وput_value_date_time.
كيف أكتب معادلة؟
استخدم put_formula_with_cached_value، مع توفير القيمة التي يجب أن يعرضها Excel قبل أول إعادة حساب له:
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;كيف أقوم بقراءة القيم مرة أخرى من مصنف تم تحميله؟
احصل على الورقة باستخدام worksheet (أو مجموعة أوراق العمل)، ثم اقرأ الخلايا عبر get_cells؛ display_string_value تُعيد النص المعروض وvalue_type تُبلغ عن النوع المخزن.
القيود المعروفة
هل الـcrate موجود على crates.io؟
ليس بعد — ثبّته كاعتماد git لـCargo من مستودع GitHub. يسجل Cargo الالتزام الدقيق في Cargo.lock، لذا تظل عمليات البناء قابلة لإعادة الإنتاج.
هل يتم دعم صيغ غير XLSX؟
لا. يركز الإصدار الحالي على جولة XLSX؛ لا يتم قراءة أو كتابة صيغ جداول البيانات الأخرى.