الفرق بين المراجعتين ل"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> هي أسماء دوال مصغَّرة وإزاحات شيفرة ثنائية، لذلك قد ترغب بدلًا من ذلك في ترجمتها إلى ملف وسطر واسم دالة مثل: <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"> | + | </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>تطبيق عملية symbolication من ملف يحتوي على تعقّب المكدس:<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>تطبيق عملية symbolication من مجلد <code>adb logcat</code>:<syntaxhighlight lang="bash"> |
adb logcat -d | npx metro-symbolicate android/app/build/generated/sourcemaps/react/release/index.android.bundle.map | adb logcat -d | npx metro-symbolicate android/app/build/generated/sourcemaps/react/release/index.android.bundle.map | ||
</syntaxhighlight>سيؤدي ذلك إلى تحويل كل اسم دالة مصغَّر مع إزاحة مثل <code>p@1:132161</code> إلى اسم الملف الفعلي مع دالة <code>AwesomeProject/App.js:54:initializeMap</code>. | </syntaxhighlight>سيؤدي ذلك إلى تحويل كل اسم دالة مصغَّر مع إزاحة مثل <code>p@1:132161</code> إلى اسم الملف الفعلي مع دالة <code>AwesomeProject/App.js:54:initializeMap</code>. | ||
مراجعة 00:19، 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 من خلال إعداد بيئة التطوير الخاصة بك.
تطبيق عملية symbolication من ملف يحتوي على تعقّب المكدس:
npx metro-symbolicate android/app/build/generated/sourcemaps/react/release/index.android.bundle.map < stacktrace.txt
تطبيق عملية symbolication من مجلد 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 أو من إعادة توجيه وليس من طرفية.