إصلاح مشكلات طول المسار في CMake عند إنشاء Android React-Native Reanimated

أخطاء طول المسار الشائعة أثناء بناء CMake في React Native

غالبًا ما يواجه المطورون الذين يعملون مع React Native على Windows قيودًا على طول المسار عند إنشاء مشاريع Android. إحدى المشكلات المتكررة تتعلق بـ رد الفعل الأصلي إحياء الحزمة وتكوين CMake الخاص بها، مما قد يؤدي إلى فشل عمليات الإنشاء.

يُشار إلى هذا الخطأ عادةً برسالة تنص على "mkdir: لا يوجد مثل هذا الملف أو الدليل"، في إشارة إلى إنشاء أدلة معينة تتجاوز طول المسار المسموح به على نظام التشغيل Windows. قد يكون هذا محبطًا بشكل خاص عندما يحاول المطورون إنشاء تطبيقاتهم باستخدام CMake و النينجا نظام البناء.

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

إذا كنت تواجه هذه المشكلة أثناء العمل مع رد الفعل الأصلي إحياءإن فهم السبب واستكشاف الحلول البديلة أمر بالغ الأهمية. دعونا نتعمق في المشكلة والحلول المحتملة وطرق تجنب هذا التعقيد في المستقبل.

شرح مفصل لاستراتيجيات الحل

في معالجة مشكلة طول المسار أثناء بناء رد الفعل الأصلي إحياء مكتبة على Android باستخدام CMake، قمنا بتنفيذ العديد من الحلول المستندة إلى البرامج النصية. يتضمن الأسلوب الأول نقل ملفات المشروع إلى مكان أقرب إلى الدليل الجذر. باستخدام برنامج نصي Shell مع أوامر محددة مثل حزب المحافظين -r لنسخ كافة ملفات المشروع و mkdir لإنشاء دليل هدف إذا لم يكن موجودًا، فإننا نهدف إلى تخفيف الخطأ المتعلق بالمسارات الطويلة. يساعد هذا في تقليل مخاطر الوصول إلى الحد الأقصى لطول المسار الافتراضي لنظام Windows وهو 260 حرفًا، وهو أمر شائع في مشاريع React Native المتداخلة.

كان الحل الرئيسي الآخر هو تعديل ملف CMakeLists لاستخدامه المسارات النسبية بدلا من المطلقة. تعالج هذه الطريقة بشكل فعال قيود طول المسار عن طريق منع إنشاء مسارات دليل طويلة ومتداخلة أثناء عملية إنشاء CMake. من خلال تحديد المسارات النسبية باستخدام CMake تعيين الأمر وتوظيف الأوامر مثل add_library و target_include_directories، يتم توجيه نظام البناء لاستخدام مسارات ملفات نسبية أقصر، مما يقلل من فرصة مواجهة الخطأ "لا يوجد مثل هذا الملف أو الدليل".

بالإضافة إلى ذلك، أثبت تمكين دعم المسار الطويل على نظام التشغيل Windows أنه خطوة حاسمة في حل هذه المشكلة. تم تصميم برنامج PowerShell النصي لتعديل مفتاح تسجيل Windows باستخدام Set-ItemProperty. يسمح هذا الأمر لنظام التشغيل Windows بتجاوز حد طول المسار الافتراضي وهو 260 حرفًا عن طريق تمكين خيار "LongPathsEnabled". يضمن البرنامج النصي تعيين مفتاح التسجيل بشكل صحيح، ويستخدم الملف Get-ItemProperty أمر للتحقق من نجاح التعديل. يعد هذا الحل ضروريًا عندما تكون طرق تقليل المسار الأخرى غير كافية لتجنب أخطاء إنشاء الدليل.

وأخيرا، يستخدم البرنامج النصي PowerShell عملية البدء الأمر مع -فعل التشغيل كما علامة لتنفيذ البرنامج النصي بامتيازات إدارية. يعد ذلك ضروريًا لأن تعديل إعدادات التسجيل يتطلب أذونات مرتفعة. من خلال الجمع بين هذه التقنيات — نقل ملفات المشروع، وتعديل تكوينات CMake، وتمكين دعم المسار الطويل — قمنا بإنشاء إستراتيجية شاملة لحل خطأ بناء CMake المتعلق بطول المسار. لا تعمل هذه الحلول على تخفيف الخطأ الحالي فحسب، بل توفر أيضًا إطارًا قابلاً لإعادة الاستخدام لمعالجة المشكلات المماثلة في المشاريع المستقبلية.

# Step 1: Define source and target directories
source_dir="C:/Users/ricar/Documents/Github/StockItUp"
target_dir="C:/StockItUp"

# Step 2: Create target directory if it doesn't exist
if [ ! -d "$target_dir" ]; then
  mkdir "$target_dir"
fi

# Step 3: Copy project files to the target directory
cp -r "$source_dir/"* "$target_dir/"

# Step 4: Confirm completion
echo "Project files moved to $target_dir"

# Set relative paths to reduce absolute path length issues
cmake_minimum_required(VERSION 3.10)

project(reanimated_project)

# Define relative path for source files
set(SOURCE_DIR "src/main/cpp/reanimated")

# Add source files using the relative path
add_library(reanimated STATIC ${SOURCE_DIR}/Common.cpp)

# Specify target properties
target_include_directories(reanimated PRIVATE ${SOURCE_DIR})

# Step 1: Open PowerShell as Administrator
Start-Process powershell -Verb runAs

# Step 2: Set the registry key for long paths
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1

# Step 3: Confirm the setting
Get-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled"

معالجة قيود طول المسار وبناء الاستراتيجيات

هناك جانب رئيسي آخر يجب مراعاته عند حل الخطأ "mkdir: لا يوجد مثل هذا الملف أو الدليل" وهو فهم كيفية تفاعل CMake مع نظام بناء النينجا. يتم اختيار Ninja عادةً لسرعته وكفاءته في تجميع التعليمات البرمجية، ولكن توافقه مع قيود طول المسار على نظام التشغيل Windows يمكن أن يكون أمرًا صعبًا. للتغلب على هذه المشكلة، يحتاج المطورون إلى تكوين CMake وNinja بعناية بطرق تساعد على تجنب أطوال المسارات الزائدة. يتضمن ذلك تخصيص عملية الإنشاء لاستخدام المسارات النسبية والحفاظ على هياكل الدليل بسيطة قدر الإمكان.

أحد الحلول التي يتم تجاهلها غالبًا هو ضبط تكوينات البناء الافتراضية التي يستخدمها CMake أو Ninja لتتناسب بشكل أفضل مع قيود نظام ملفات Windows. على سبيل المثال، يمكن للمرء أن يضيف محددة أعلام أو تحديد أدلة البناء البديلة التي لا تتجاوز الحد الأقصى لطول المسار. بالإضافة إلى ذلك، يمكن للمطورين مراجعة بنية تبعية مشروعهم لتحديد وتقصير المسارات العميقة أو المعقدة بشكل غير ضروري. يضمن هذا الأسلوب تجربة بناء أكثر سلاسة مع تقليل مخاطر الأخطاء المرتبطة بالمسار أثناء التجميع.

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