الصفحة الرئيسية>المتعلقة بالبرمجة>جافا كود المصدر
تنزيل

إعدادات JavaCPP المسبقة


إنشاء الحالة لجميع الأنظمة الأساسية (Android وiOS وLinux وMac OS X وWindows):
الدعم التجاري والخدمات المدفوعة للإعدادات المسبقة المخصصة:

مقدمة

تحتوي وحدات إعدادات JavaCPP المسبقة على تكوينات Java وفئات الواجهة لمكتبات C/C++ المستخدمة على نطاق واسع. يتم استخدام ملفات التكوين الموجودة في حزم org.bytedeco.<moduleName>.presets بواسطة Parser لإنشاء ملفات واجهة Java من ملفات رأس C/C++ التي تستهدف حزم org.bytedeco.<moduleName> ، والتي يتم استخدامها بدورها بواسطة Generator ومترجم C++ الأصلي لإنتاج مكتبات JNI المطلوبة. علاوة على ذلك، تعمل الفئات المساعدة على تسهيل استخدام وظائفها على منصة Java، بما في ذلك Android.

لأغراض التوجيه، يمكن اعتبار توثيق هذا المستودع مقسمًا إلى مستويين:

  1. الدليل الذي يوجد به مستند README.md الأصلي ينتمي إلى المستوى الأعلى، ووحدة javacpp-presets نفسها، و
  2. الدلائل الفرعية الموجودة فيه هي الوحدات الفرعية الفعلية، مع ملفات README.md الخاصة بها، والإعدادات المسبقة، والحزم، باعتبارها المستوى الأدنى.

يحتوي ملف README.md الأصلي هذا على معلومات عامة تنطبق على جميع الوحدات النمطية لحل المشكلات المتعلقة بالتنزيلات والمتطلبات العامة وإجراءات التثبيت وتعليمات البناء. تحتوي ملفات README.md المعنية في كل دليل فرعي على معلومات إضافية، وروابط، وملاحظات تتعلق بوثائق واجهة برمجة التطبيقات (API)، ومتطلبات محددة، وتبعيات ملفات pom.xml ، ونموذج كود الاستخدام، للإعدادات المسبقة والحزم الخاصة بكل وحدة. يرجى العلم أنه ليست كل الإعدادات المسبقة لها نفس مستوى النضج، وقد يختلف النمط والتخطيط أيضًا من واحد إلى آخر نظرًا لأنهما يعتمدان على واجهات برمجة التطبيقات الخاصة بمكتبات الطرف الثالث.

يرجى الرجوع إلى صفحة wiki للحصول على مزيد من المعلومات حول كيفية إنشاء إعدادات مسبقة جديدة. نظرًا لعدم وجود وثائق إضافية حاليًا، فلا تتردد أيضًا في طرح الأسئلة على القائمة البريدية أو منتدى المناقشة.

التنزيلات

يمكن الحصول على ملفات JAR التي تحتوي على ثنائيات لجميع الوحدات النمطية الفرعية والإصدارات لجميع الأنظمة الأساسية المدعومة (Android وiOS وLinux وMac OS X وWindows) من مستودع Maven المركزي. الأرشيفات التي تحتوي على ملفات JAR هذه متاحة أيضًا كإصدارات.

لتثبيت ملفات JAR يدويًا، اتبع الإرشادات الموجودة في قسم التثبيت اليدوي أدناه.

يمكننا أيضًا تنزيل كل شيء وتثبيته تلقائيًا باستخدام:

  • Maven (داخل ملف pom.xml ) 
  < dependency >
    < groupId >org.bytedeco</ groupId >
    < artifactId >${moduleName}-platform</ artifactId >
    < version >${moduleVersion}-1.5.11</ version >
  </ dependency >
  • Gradle (داخل ملف build.gradle.kts أو ملف build.gradle ) 
  dependencies {
    implementation( " org.bytedeco: $m oduleName -platform: $m oduleVersion -1.5.11 " )
  }
  • لينينجن (داخل ملف project.clj ) 
  :dependencies [
    [~( symbol ( str " org.bytedeco/ " moduleName " -platform " )) ~( str moduleVersion " -1.5.11 " )]
  ]
  • sbt (داخل ملف build.sbt ) 
  libraryDependencies += " org.bytedeco " % moduleName + " -platform " % moduleVersion + " -1.5.11 "

حيث تتوافق متغيرات moduleName و moduleVersion مع الوحدة المطلوبة. يؤدي هذا إلى تنزيل الثنائيات لجميع الأنظمة الأساسية، ولكن للحصول على ثنائيات لمنصة واحدة فقط، يمكننا تعيين خاصية النظام javacpp.platform (عبر خيار سطر الأوامر -D ) إلى شيء مثل android-arm ، linux-x86_64 ، macosx-x86_64 ، windows-x86_64 وما إلى ذلك. يمكننا أيضًا تحديد أكثر من منصة واحدة، راجع الأمثلة في تقليل عدد التبعيات. هناك خيار آخر متاح لمستخدمي Gradle وهو Gradle JavaCPP، وبالمثل لمستخدمي Scala هناك SBT-JavaCPP.

البرامج المطلوبة

لاستخدام إعدادات JavaCPP المسبقة، ستحتاج إلى تنزيل البرنامج التالي وتثبيته:

  • تطبيق Java SE 7 أو الأحدث:
    • OpenJDK http://openjdk.java.net/install/ أو
    • أوراكل JDK http://www.Oracle.com/technetwork/Java/javase/downloads/ أو
    • آي بي إم JDK http://www.ibm.com/developerworks/java/jdk/

علاوة على ذلك، في حالة Android، تعتمد إعدادات JavaCPP المسبقة أيضًا على:

  • Android SDK API 24 أو الأحدث http://developer.android.com/sdk/

التثبيت اليدوي

ما عليك سوى وضع جميع ملفات JAR المطلوبة ( opencv*.jar ، ffmpeg*.jar ، وما إلى ذلك)، بالإضافة إلى javacpp.jar ، في مكان ما في مسار الفصل الدراسي الخاص بك. ملفات JAR المتوفرة كعناصر معدة مسبقًا مخصصة للاستخدام مع JavaCPP. تم إنشاء ثنائيات Linux باستخدام Ubuntu، لذا يجب أن تعمل على معظم التوزيعات المستخدمة حاليًا. فيما يلي بعض التعليمات الأكثر تحديدًا للحالات الشائعة:

NetBeans (Java SE 7 أو الأحدث):

  1. في نافذة المشاريع، انقر بزر الماوس الأيمن فوق عقدة المكتبات الخاصة بمشروعك، ثم حدد "إضافة JAR/Folder...".
  2. حدد موقع ملفات JAR، وحددها، ثم انقر فوق "موافق".

Eclipse (Java SE 7 أو أحدث):

  1. انتقل إلى المشروع > الخصائص > Java Build Path > المكتبات وانقر على "إضافة JARs خارجية...".
  2. حدد موقع ملفات JAR، وحددها، ثم انقر فوق "موافق".

كود Visual Studio (Java SE 7 أو الأحدث):

  1. انتقل إلى Java Projects > Reference Libraries، وانقر فوق + .
  2. حدد موقع ملفات JAR، وحددها، ثم انقر فوق "موافق".

IntelliJ IDEA (Android 7.0 أو الأحدث):

  1. اتبع الإرشادات الموجودة على هذه الصفحة: http://developer.android.com/training/basics/firstapp/
  2. انسخ جميع ملفات JAR إلى الدليل الفرعي app/libs .
  3. انتقل إلى ملف > هيكل المشروع > التطبيق > التبعيات، وانقر فوق + ، وحدد "2 تبعيات الملف".
  4. حدد كافة ملفات JAR من الدليل الفرعي libs .

بعد ذلك، يمكننا الوصول بشفافية تقريبًا إلى واجهات برمجة تطبيقات C/C++ المقابلة من خلال فئات الواجهة الموجودة في حزم org.bytedeco.<moduleName> . في الواقع، يقوم Parser بترجمة تعليقات التعليمات البرمجية من ملفات رأس C/C++ إلى ملفات واجهة Java، الجاهزة (تقريبًا) للاستهلاك بواسطة Javadoc. ومع ذلك، نظرًا لأن ترجمتها لا تزال غير مرغوب فيها، فقد يرغب المرء في الرجوع إلى صفحات الوثائق الأصلية. على سبيل المثال، يمكن العثور على تلك الخاصة بـ OpenCV وFFmpeg عبر الإنترنت على:

  • وثائق OpenCV
  • وثائق إف إف إم بي إي جي

تعليمات البناء

إذا كانت الملفات الثنائية المتوفرة أعلاه غير كافية لاحتياجاتك، فقد تحتاج إلى إعادة بنائها من التعليمات البرمجية المصدر. ولتحقيق هذه الغاية، تم إنشاء ملفات المشروع على جانب Java كوحدات Maven. افتراضيًا، يقوم إصدار Maven أيضًا بتثبيت المكتبات الأصلية على جانب C/C++ الأصلي باستخدام البرامج النصية cppbuild.sh ، ولكن يمكن أيضًا تثبيتها بوسائل أخرى.

بالإضافة إلى ذلك، يمكن للمرء أن يجد على صفحة wiki معلومات إضافية حول بيئات البناء الموصى بها للمنصات الرئيسية.

وحدات مافن

تعتمد إعدادات JavaCPP المسبقة على Maven، وهو نظام بناء قوي لـ Java، لذا قبل محاولة البناء، تأكد من التثبيت والقراءة:

  • مخضرم 3.x http://maven.apache.org/download.html
  • جافا سي بي بي 1.5.11 https://github.com/bytedeco/javacpp

تعتمد كل وحدة فرعية بدورها بشكل افتراضي على البرامج النصية cppbuild.sh المضمنة، الموضحة أدناه، لتثبيت المكتبات الأصلية المقابلة لها في الدليل الفرعي cppbuild . لاستخدام المكتبات الأصلية المثبتة بالفعل في مكان آخر على النظام، يمكن أيضًا تحديد أدلة تثبيت أخرى غير cppbuild إما في ملفات pom.xml أو في ملفات تكوين .java . الإصدارات التالية مدعومة:

  • OpenCV 4.10.x https://opencv.org/releases/
  • FFmpeg 7.1.x http://ffmpeg.org/download.html
  • FlyCapture 2.13.x https://www.flir.com/products/flycapture-sdk
  • سبيناكر 4.0.x https://www.flir.com/products/spinnaker-sdk
  • libdc1394 2.2.6 http://sourceforge.net/projects/libdc1394/files/
  • ليبفرينيكت 0.5.7 https://github.com/OpenKinect/libfreenect
  • libfreenect2 0.2.0 https://github.com/OpenKinect/libfreenect2
  • librealsense 1.12.x https://github.com/IntelRealSense/librealsense
  • librealsense2 2.53.x https://github.com/IntelRealSense/librealsense
  • إدخال الفيديو 0.200 https://github.com/ofTheo/videoInput/
  • ARToolKitPlus 2.3.1 https://launchpad.net/artoolkitplus
  • شيليتاغز https://github.com/chili-epfl/chilitags
  • فلاندمارك 1.07 https://github.com/uricamic/flandmark
  • السهم 6.0.x https://arrow.apache.org/install/
  • HDF5 1.14.x https://www.hdfgroup.org/downloads/
  • هايبرسكان 5.4.x https://github.com/intel/hyperscan
  • LZ4 1.9.x https://github.com/lz4/lz4
  • MKL 2025.x https://software.intel.com/mkl
  • MKL-DNN 0.21.x https://github.com/oneapi-src/oneDNN
  • DNNL 3.6.x https://github.com/oneapi-src/oneDNN
  • أوبن بلاس 0.3.28 http://www.openblas.net/
  • ARPACK-NG 3.9.x https://github.com/opencollab/arpack-ng
  • كمينباك 1.3.11 https://github.com/devernay/cminpack
  • ففتو 3.3.10 http://www.fftw.org/download.html
  • جي إس إل 2.8 http://www.gnu.org/software/gsl/#downloading
  • سي بايثون 3.13.x https://www.python.org/downloads/
  • NumPy 2.1.x https://github.com/numpy/numpy
  • SciPy 1.14.x https://github.com/scipy/scipy
  • جيم 0.26.x https://github.com/openai/gym
  • LLVM 19.1.x http://llvm.org/releases/download.html
  • libffi 3.4.x https://github.com/libffi/libffi
  • libpostal 1.1 https://github.com/openvenues/libpostal
  • ليب راو 0.21.x https://www.libraw.org/download
  • ليبتونيكا 1.85.x http://www.leptonica.org/download.html
  • تسراكت 5.5.x https://github.com/tesseract-ocr/tesseract
  • كافيه 1.0 https://github.com/BVLC/caffe
  • OpenPose 1.7.0 https://github.com/CMU-Perceptual-Computing-Lab/openpose
  • كودا 12.6.x https://developer.nvidia.com/cuda-downloads
    • cuDNN 9.5.x https://developer.nvidia.com/cudnn
    • NCCL 2.23.x https://developer.nvidia.com/nccl
    • nvCOMP 4.1.x https://developer.nvidia.com/nvcomp
  • NVIDIA Video Codec SDK 12.2.x https://developer.nvidia.com/nvidia-video-codec-sdk
  • OpenCL 3.0.x https://github.com/KhronosGroup/OpenCL-ICD-Loader
  • MXNet 1.9.x https://github.com/apache/incubator-mxnet
  • بايتورتش 2.5.x https://github.com/pytorch/pytorch
  • SentencePiece 0.2.0 https://github.com/google/sentencepiece
  • TensorFlow 1.15.x https://github.com/tensorflow/tensorflow
  • TensorFlow Lite 2.18.x https://github.com/tensorflow/tensorflow
  • TensorRT 10.6.x https://developer.nvidia.com/tensorrt
  • خادم تريتون الاستدلالي 2.51.x https://developer.nvidia.com/nvidia-triton-inference-server
  • بيئة تعلم الأركيد 0.8.x https://github.com/mgbellemare/Arcade-Learning-Environment
  • DepthAI 2.24.x https://github.com/luxonis/عمقai-core
  • ONNX 1.17.x https://github.com/onnx/onnx
  • nGraph 0.26.0 https://github.com/NervanaSystems/ngraph
  • وقت تشغيل ONNX 1.20.x https://github.com/microsoft/onnxruntime
  • TVM 0.18.x https://github.com/apache/tvm
  • رصاصة الفيزياء SDK 3.25 https://pybullet.org
  • LiquidFun http://google.github.io/liquidfun/
  • كيو تي 5.15.x https://download.qt.io/archive/qt/
  • مونو/سكيا 2.88.x https://github.com/mono/skia
  • cpu_features 0.7.0 https://github.com/google/cpu_features
  • ModSecurity 3.0.x https://github.com/SpiderLabs/ModSecurity
  • واجهات برمجة تطبيقات النظام لبيئات البناء:
    • لينكس (glibc) https://www.gnu.org/software/libc/
    • نظام التشغيل Mac OS X (XNU libc) https://opensource.apple.com/
    • ويندوز (Win32) https://developer.microsoft.com/en-us/windows/

بمجرد تثبيت كل شيء وتكوينه، قم بالتنفيذ ببساطة 

$ mvn install --projects .,opencv,ffmpeg,etc. -Djavacpp.platform.root=/path/to/android-ndk/

داخل الدليل الذي يحتوي على ملف pom.xml الأصل، عن طريق تحديد الوحدات الفرعية المطلوبة فقط في الأمر، ولكن بدون النقطة البادئة "." في قائمة المشاريع المفصولة بفواصل، قد لا يتم تثبيت ملف pom.xml الأصلي نفسه. (الخيار -Djavacpp.platform.root=... مطلوب فقط لإصدارات Android.) حدد أيضًا -Djavacpp.cppbuild.skip كخيار لتخطي تنفيذ البرامج النصية cppbuild.sh . بالإضافة إلى -Djavacpp.platform=... ، يمكن أيضًا إنشاء بعض الإعدادات المسبقة وفقًا لـ CUDA باستخدام -Djavacpp.platform.extension=-gpu أو CPython مع -Djavacpp.platform.extension=-python . يرجى الرجوع إلى التعليقات الموجودة داخل ملف pom.xml لمزيد من التفاصيل. من الدليل الفرعي "النظام الأساسي"، يمكننا أيضًا تثبيت عناصر "النظام الأساسي" باستخدام أمر مماثل: 

$ cd platform
$ mvn install --projects ../opencv/platform,../ffmpeg/platform,etc. -Djavacpp.platform.host

البرامج النصية cppbuild.sh

يتيح لنا تشغيل البرامج النصية تثبيت المكتبات الأصلية بسهولة على منصات متعددة، ولكن يلزم وجود برامج إضافية:

  • إصدار حديث من Linux أو Mac OS X أو Windows مع MSYS وVisual Studio
  • Android NDK r18 أو الأحدث http://developer.android.com/ndk/downloads/ (مطلوب فقط لإصدارات Android)

مع تنفيذ ما سبق، يتم تشغيل البرامج النصية تلقائيًا كجزء من دورة حياة بناء Maven، ولكن يمكننا أيضًا تنفيذها يدويًا 

$ ANDROID_NDK=/path/to/android-ndk/ bash cppbuild.sh [-platform < name > ] [-extension < name > ] < install | clean > [projects]

حيث تكون أسماء المنصات المحتملة هي:

  • android-arm
  • android-arm64
  • android-x86
  • android-x86_64
  • ios-arm64
  • ios-x86_64
  • linux-armhf
  • linux-arm64
  • linux-ppc64le
  • linux-x86
  • linux-x86_64
  • macosx-arm64
  • macosx-x86_64
  • windows-x86
  • windows-x86_64

يتطلب ملحق -gpu كما تدعمه بعض الإصدارات أيضًا تثبيت CUDA. (متغير ANDROID_NDK مطلوب فقط لإصدارات Android.) يرجى ملاحظة أن البرامج النصية تقوم بتنزيل أرشيفات المصدر من المواقع المناسبة حسب الضرورة.

لتجميع الثنائيات لجهاز Android بدون FPU، تأكد أولاً من أن هذا هو ما تريده. بدون FPU، سيكون أداء OpenCV أو FFmpeg غير مقبول. إذا كنت لا تزال ترغب في الاستمرار في هذا الطريق، فاستبدل "armeabi-v7a" بـ "armeabi" و"-march=armv7-a -mfloat-abi=softfp -mfpu=vfpv3-d16" بـ "-march=armv5te -mtune" =xscale -msoft-float"، داخل ملفات مختلفة.

على الرغم من أن JavaCPP يمكنه التقاط المكتبات الأصلية المثبتة على النظام، إلا أن البرامج النصية موجودة لتسهيل عملية الإنشاء عبر منصات متعددة. كما أنها تسمح لـ JavaCPP بنسخ المكتبات الأصلية وتحميلها في وقت التشغيل من ملفات JAR التي تم إنشاؤها أعلاه بواسطة Maven، وهي ميزة مفيدة للتطبيقات المستقلة أو تطبيقات Java. علاوة على ذلك، تعمل الحيل مثل ما يلي مع JNLP: 

    < resources os = " Linux " arch = " x86 i386 i486 i586 i686 " >
        < jar href = " lib/opencv-linux-x86.jar " />
        < jar href = " lib/ffmpeg-linux-x86.jar " />
    </ resources >
    < resources os = " Linux " arch = " x86_64 amd64 " >
        < jar href = " lib/opencv-linux-x86_64.jar " />
        < jar href = " lib/ffmpeg-linux-x86_64.jar " />
    </ resources >

شكرًا لخوسيه غوميز على اختبار ذلك!

كيف يمكنني المساعدة؟

المساهمات من أي نوع هي موضع ترحيب كبير! في الوقت الحالي، يتمتع Parser بقدرات محدودة، لذا أخطط لتحسينه تدريجيًا إلى الحد الذي يمكنه فيه تحليل ملفات رأس C++ الكبيرة بنجاح والتي تكون أكثر تعقيدًا من تلك الموجودة في OpenCV أو Caffe أو TensorFlow، ولكن يمكن لنظام البناء يمكن تحسينها أيضًا. وبالتالي، فإنني أبحث عن المساعدة خاصة في المهام الخمس التالية، دون ترتيب معين:

  • إعداد التكامل المستمر، ويفضل أن يكون مجانيًا على السحابة (Travis CI؟)
  • تحسين Parser (باستخدام الإعدادات المسبقة لـ LLVM وClang؟)
  • توفير تصميمات لمزيد من المنصات، كما هو الحال مع linux-armhf لـ Raspberry Pi، وما إلى ذلك.
  • استبدال مجموعة البناء Bash/Maven بشيء أسهل في الاستخدام (Gradle؟)
  • إضافة إعدادات مسبقة جديدة كوحدات فرعية لمكتبات C/C++ الأخرى (Caffe2، OpenNI، OpenMesh، PCL، إلخ.)

للمساهمة، يرجى التفرع وإنشاء طلبات السحب، أو نشر اقتراحاتك باعتبارها "مشكلة" جديدة. شكرا جزيلا مقدما على مساهمتك!

قائد المشروع: صامويل أوديت samuel.audet at gmail.com
موقع المطور: https://github.com/bytedeco/javacpp-presets
مجموعة المناقشة: http://groups.google.com/group/javacpp-project

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل