عیب‌یابی نصب Aspose.Slides برای Node.js از طریق Java

مقدمه

هنگامی‌که با استفاده از npm نصب aspose.slides.via.java انجام می‌شود، مواردی وجود دارد که در زمان کامپایل ماژول‌های java و node-gyp خطا رخ می‌دهد. ما این خطاها را به‑صورت جامع‌تری بررسی کردیم و نیازمندی‌های خاصی برای نسخه‌های برنامه‌ها و بسته‌های نصب‌شده شناسایی کردیم.

نیازمندی‌های نسخه

1. برای Node.js 12 و نسخه‌های پیشین:

   • Python با نسخه بالاتر از 3.10 نیست.
   • برای ویندوز، توصیه می‌شود Visual Studio Build Tools را که جدیدتر از 2017 نیست نصب کنید.
   • نسخه بسته npm java: 0.12.1.

2. برای Node.js 13:

   • همان نیازمندی‌های Node.js 12.

3. برای Node.js 14:

   • Python 3.10.
   • نسخه بسته npm java: 0.14.0.

4. برای Node.js 15:

   • Python 3.12.
   • نسخه بسته npm java: 0.14.0.

5. برای Node.js 16 و جدیدتر:

   • Python 3.12.
   • نسخه بسته npm java: 0.14.0.

دستورالعمل‌های زیر را برای نصب برنامه‌های مورد نیاز دنبال کنید.

نصب بر روی یونیکس

• نصب Node.js.
• نصب Python.
• نصب Java (JDK 1.8).
• نصب ابزار زنجیره کامپایلر C/C++ مناسب، مانند GCC.

نصب بر روی macOS

• نصب Node.js.
• نصب Python.
• نصب Java (JDK 1.8) و بخش JVMCapabilities را در مسیر /Library/Java/JavaVirtualMachines/jdk1.8.x_xxx.jdk/Contents/Info.plist با دسترسی ریشه ویرایش کنید. jdk1.8.x_xxx.jdk به نسخه JDK شما بستگی دارد. آن را به شکل زیر تنظیم کنید:

<key>JavaVM</key>
    <dict>
        <key>JVMCapabilities</key>
        <array>
                <string>JNI</string>
                <string>BundledApp</string>
                <string>CommandLine</string>
        </array>

• نصب ابزارهای خط فرمان Xcode به‌صورت مستقل با اجرای xcode-select --install. – OR – به‌جای آن، اگر قبلاً Xcode کامل نصب شده دارید، می‌توانید ابزارهای خط فرمان را از منوی Xcode -> Open Developer Tool -> More Developer Tools... نصب کنید.

نصب بر روی ویندوز

• نصب Node.js.
• نصب Python از Microsoft Store.
• نصب Java (JDK 1.8).
• نصب Visual C++ Build Environment (در صورتی که نسخه‌ای قدیمی‌تر از VS2019 استفاده می‌کنید، «Visual C++ build tools» را انتخاب کنید؛ در غیر این صورت از workload «Desktop development with C++» یا Visual Studio Community با workload «Desktop development with C++» استفاده کنید).

اطمینان حاصل کنید که Node.js، Python و Java به متغیر PATH اضافه شده‌اند.

نصب Aspose.Slides برای Node.js از طریق Java در نسخه 14 و بالاتر Node.js

به سادگی از فرمان زیر استفاده کنید:

npm i aspose.slides.via.java

نصب Aspose.Slides برای Node.js از طریق Java در نسخه 12 یا 13 Node.js

Aspose.Slides برای Node.js از طریق Java باید به‌صورت دستی نصب شود. از فرمان زیر استفاده کنید:

• برای Node.js 12:

npm i java@0.12.1

• برای Node.js 13:

npm i java@0.13.0

سپس aspose.slides.via.java را دانلود کنید و آن را در پوشه node_modules/aspose.slides.via.java استخراج نمایید.

اعتبارسنجی نصب

برای اعتبارسنجی نصب، یک فایل index.js در ریشهٔ پروژهٔ خود ایجاد کنید که محتوای زیر را داشته باشد:

var aspose = aspose || {};
var java = require('java');
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.Presentation();
var slide = presentation.getSlides().get_Item(0);
slide.getShapes().addAutoShape(aspose.slides.ShapeType.Line, 50, 150, 300, 0);
presentation.save("lineShape.pptx", aspose.slides.SaveFormat.Pptx);

این فایل را با اجرای فرمان node index.js اجرا کنید.

اطلاعات تکمیلی

امکان پوشش تمام مشکلات ممکن در چارچوب این مقاله وجود ندارد. از آنجا که مشکلات به‌دلیل کامپایل ماژول‌های java و node-gyp پیش می‌آیند، لینک‌های زیر نیز مفید خواهند بود:

• نصب java
• نصب node-gyp