الفرق بين المراجعتين لصفحة: «ReactNative/symbolication»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 7: | سطر 7: | ||
07-15 10:58:25.820 18979 18998 E AndroidRuntime: f@1:131854 | 07-15 10:58:25.820 18979 18998 E AndroidRuntime: f@1:131854 | ||
07-15 10:58:25.820 18979 18998 E AndroidRuntime: anonymous@1:131119 | 07-15 10:58:25.820 18979 18998 E AndroidRuntime: anonymous@1:131119 | ||
</syntaxhighlight>الأقسام كالقسم <code>p@1:132161</code> هي أسماء دوال مصغَّرة وإزاحات شيفرة | </syntaxhighlight>الأقسام كالقسم <code>p@1:132161</code> هي أسماء دوال مصغَّرة وإزاحات شيفرة ثنائية، لذلك قد ترغب بدلًا من ذلك في ترجمتها إلى ملف وسطر واسم دالة مثل: <code>AwesomeProject/App.js:54:initializeMap</code>. تُعرف هذه العملية باسم '''symbolication'''، إذ يمكنك ترجمة أسماء الدوال المصغرة والشيفرة الثنائية كالواردة أعلاه عن طريق تمرير حزمة <code>metro-symbolicate</code> وخارطة الشيفرة البرمجية المحوّلة source map المُنشَأة وتعقّب المكدس stack trace.<blockquote>تُثبَّت حزمة <code>metro-symbolicate</code> افتراضيًا في قالب مشروع React Native من خلال [[ReactNative/environment setup|إعداد بيئة التطوير الخاصة بك]].</blockquote>من ملف يحتوي على تعقّب المكدس:<syntaxhighlight lang="bash"> | ||
npx metro-symbolicate android/app/build/generated/sourcemaps/react/release/index.android.bundle.map < stacktrace.txt | npx metro-symbolicate android/app/build/generated/sourcemaps/react/release/index.android.bundle.map < stacktrace.txt | ||
</syntaxhighlight>من مجلد <code>adb logcat</code>:<syntaxhighlight lang="bash"> | </syntaxhighlight>من مجلد <code>adb logcat</code>:<syntaxhighlight lang="bash"> | ||
مراجعة 00:14، 11 يوليو 2021
ترجمة عناوين Symbolicating تعقّب المكدس
إن رفع تطبيق React Native اعتراضًا exception ليس معالَجًا في إصدار البناء، فقد يكون الخرج غامضًا ويصعب قراءته كما يلي:
07-15 10:58:25.820 18979 18998 E AndroidRuntime: FATAL EXCEPTION: mqt_native_modules
07-15 10:58:25.820 18979 18998 E AndroidRuntime: Process: com.awesomeproject, PID: 18979 07-15 10:58:25.820 18979 18998 E AndroidRuntime: com.facebook.react.common.JavascriptException: Failed, js engine: hermes, stack:
07-15 10:58:25.820 18979 18998 E AndroidRuntime: p@1:132161
07-15 10:58:25.820 18979 18998 E AndroidRuntime: p@1:132084
07-15 10:58:25.820 18979 18998 E AndroidRuntime: f@1:131854
07-15 10:58:25.820 18979 18998 E AndroidRuntime: anonymous@1:131119
الأقسام كالقسم p@1:132161 هي أسماء دوال مصغَّرة وإزاحات شيفرة ثنائية، لذلك قد ترغب بدلًا من ذلك في ترجمتها إلى ملف وسطر واسم دالة مثل: AwesomeProject/App.js:54:initializeMap. تُعرف هذه العملية باسم symbolication، إذ يمكنك ترجمة أسماء الدوال المصغرة والشيفرة الثنائية كالواردة أعلاه عن طريق تمرير حزمة metro-symbolicate وخارطة الشيفرة البرمجية المحوّلة source map المُنشَأة وتعقّب المكدس stack trace.
تُثبَّت حزمة
metro-symbolicateافتراضيًا في قالب مشروع React Native من خلال إعداد بيئة التطوير الخاصة بك.
من ملف يحتوي على تعقّب المكدس:
npx metro-symbolicate android/app/build/generated/sourcemaps/react/release/index.android.bundle.map < stacktrace.txt
من مجلد adb logcat:
adb logcat -d | npx metro-symbolicate android/app/build/generated/sourcemaps/react/release/index.android.bundle.map
سيؤدي ذلك إلى تحويل كل اسم دالة مصغَّر مع إزاحة مثل p@1:132161 إلى اسم الملف الفعلي مع دالة AwesomeProject/App.js:54:initializeMap.
ملاحظات حول خرائط الشيفرة البرمجية المحوّلة Sourcemaps
- يمكن إنشاء خرائط شيفرة برمجية محوّلة متعددة من خلال عملية البناء، لذلك تأكد من استخدام خارطة شيفرة برمجية محوّلة في الموقع الموضّح في الأمثلة السابقة.
- تأكد من أن خارطة الشيفرة البرمجية المحوّلة التي تستخدمها تتوافق مع الالتزام الدقيق للتطبيق المعطَّل، فالتغييرات الصغيرة في الشيفرة المصدرية يمكن أن تسبب اختلافات كبيرة في الإزاحات.
- إذا نجح تنفيذ
metro-symbolicateمباشرةً، فتأكد من أن الدخل يأتي من أنبوب pipe أو من إعادة توجيه وليس من طرفية.