أفضل ميزة في Trailhead هي التتبّع الحيّ: ابدأ رحلة، فيسجّل التطبيق مسارك. يحتاج ذلك إلى موقع الهاتف، والهاتف لن يعطيه دون أن يسأل المستخدم. وهذا الطلب أكثر لحظة هشاشة في التطبيق. اسأل بطريقة سيئة فتخسر الميزة لدى ذلك المستخدم، وأحيانًا إلى الأبد.
\nكل وحدة في Expo تحتاج إلى إذن (الموقع، الكاميرا، مكتبة الوسائط، الإشعارات) تُرجع شكل الاستجابة نفسه:
\n{\n status: 'undetermined' | 'granted' | 'denied',\n granted: boolean,\n canAskAgain: boolean,\n expires: 'never' | number,\n}canAskAgain: true: Android بعد رفض واحد. يمكنك أن تسأل مرة أخرى، ويُفضَّل بعد شرح أفضل.canAskAgain: false: لن يعرض النظام النافذة مرة أخرى. على iOS هذه هي الحالة مباشرة بعد أول رفض؛ وعلى Android بعد أن يرفض المستخدم مرتين. ولا يستطيع تغييرها الآن إلا تطبيق الإعدادات.أسوأ نمط هو الذي تطلقه تطبيقات كثيرة: سلسلة من نوافذ النظام عند أول تشغيل، قبل أن يعرف المستخدم ما يفعله التطبيق. الناس يرفضون ما لا يفهمونه، وعلى iOS يكون ذلك الـ “Don’t Allow” الأول دائمًا ما لم ينقّبوا في الإعدادات.
\nيطلب Trailhead الموقع حين ينقر المستخدم على Start tracking، وهي أول لحظة يرتبط فيها الطلب بوضوح بشيء يريده. وقبل نافذة النظام، يعرض شرحه القصير الخاص: “Trailhead records your route while you hike. Your location stays on this phone unless you sync.” ثم يُطلق زرّ Continue الطلب الحقيقي. شاشتك أنت يمكن إغلاقها دون عواقب؛ أما نافذة النظام فلا.
\nوالقاعدة نفسها تنطبق على كل إذن في التطبيق. اطلب الكاميرا حين ينقر المستخدم على Add photo، والإشعارات حين يفعّل التذكيرات، لا قبل ذلك. عندها يصل كل طلب وسببه ظاهر على الشاشة أصلًا، وترتفع نسب القبول بشكل ملحوظ.
\nimport * as Location from 'expo-location';\nimport { useFocusEffect } from 'expo-router';\nimport { useCallback, useState } from 'react';\nimport { Linking } from 'react-native';\n\nexport function useLocationPermission() {\n const [permission, setPermission] = useState<Location.LocationPermissionResponse | null>(null);\n\n // Re-check whenever the screen regains focus: the user may have\n // changed the setting in the Settings app while Trailhead was in the background.\n useFocusEffect(\n useCallback(() => {\n Location.getForegroundPermissionsAsync().then(setPermission);\n }, []),\n );\n\n const request = useCallback(async () => {\n const result = await Location.requestForegroundPermissionsAsync();\n setPermission(result);\n return result.granted;\n }, []);\n\n return { permission, request, openSettings: () => Linking.openSettings() };\n}ثم تقرأ شاشة التتبّع permission وتختار ما ترسمه: مؤشّر تحميل ما دامت null، والشرح مع زرّ Continue ما دام الطلب ممكنًا، ورسالة “Location is off for Trailhead” مع زرّ Open Settings بمجرد أن تصبح canAskAgain قيمتها false، والخريطة الحيّة بمجرد منح الإذن. وتحويل الاستجابة إلى واحد من هذه الأفعال الأربعة دالة نقية صغيرة، وهي تمرين هذا الدرس.
يعرض iOS جملة من تطبيقك في كل نافذة إذن، ويرفض الـ App Store التطبيقات التي تكون أوصافها مفقودة أو مبهمة (“This app needs your location”). قل ما الذي تفعله الميزة بالبيانات. تضبط هذه النصوص عبر الـ config plugin الخاص بكل وحدة في app.json:
{\n \"expo\": {\n \"plugins\": [\n [\n \"expo-location\",\n { \"locationWhenInUsePermission\": \"Trailhead records your route on the map while you track a hike.\" }\n ],\n [\n \"expo-image-picker\",\n {\n \"photosPermission\": \"Trailhead lets you attach photos from your library to a hike.\",\n \"cameraPermission\": \"Trailhead lets you take trail photos to attach to a hike.\"\n }\n ]\n ]\n }\n}تكتب الـ config plugins الإعدادات الأصلية (ملف Info.plist في iOS، والـ manifest في Android) حين يُبنى التطبيق. وهذا يجعلها تغييرات أصلية: لن يطبّقها Fast Refresh، فأعِد بناء الـ development build بعد تعديلها. ويعرض Expo Go نصوصه العامة الخاصة، وهذا سبب إضافي لانتقال Trailhead الآن إلى development build.
تتبّع رحلة والشاشة مطفأة يحتاج إلى موقع في الخلفية (background)، وهو إذن منفصل وأكثر حساسية، له متطلّبات إضافية من المنصّتين ومراجعة أدقّ في المتجرين. ابدأ بالوصول في المقدّمة (“while using the app”)، الذي يغطّي التتبّع ما دام Trailhead مفتوحًا. وأضف الوصول في الخلفية فقط حين يطلبه المستخدمون، مع شرح واضح للسبب، وتوقّع أن تطرح عليك المراجعة السؤال نفسه.
\nفي الدرس التالي ستستخدم هذه الأذونات فعلًا: موقع المتنزّه، وصور الدروب، وإشعار تذكير.
\n","toc":[{"id":"sec-1","text":"الحالات التي يمكن أن يكون فيها الإذن","level":2},{"id":"sec-2","text":"اسأل في السياق، بعد أن تشرح","level":2},{"id":"sec-3","text":"أوصاف الاستخدام والـ config plugins","level":2},{"id":"sec-4","text":"المقدّمة أولًا، والخلفية فقط عند الضرورة","level":2}],"takeaways":["استجابات الأذونات لهاstatus قيمتها undetermined أو granted أو denied، إضافةً إلى canAskAgain، التي تخبرك هل ما زال يمكن أن تظهر نافذة النظام.","اطلب الإذن حين يبدأ المستخدم الميزة التي تحتاج إليه، بعد شرح قصير في واجهتك أنت، ولا تطلق سيلًا من النوافذ عند التشغيل أبدًا.","بمجرد أن تصبح canAskAgain قيمتها false، لا يستطيع تغيير الإجابة إلا تطبيق الإعدادات في النظام، فقدّم زرًّا يستدعي Linking.openSettings().","يشترط iOS وصفًا للاستخدام لكل إذن؛ اضبطها عبر خيارات الـ config plugins في app.json وأعد البناء.","أعِد التحقّق من الأذونات حين تستعيد الشاشة التركيز، لأن المستخدمين يغيّرونها في الإعدادات بينما تطبيقك في الخلفية."],"further":[{"title":"Permissions","url":"https://docs.expo.dev/guides/permissions/"},{"title":"Location","url":"https://docs.expo.dev/versions/latest/sdk/location/"},{"title":"Linking","url":"https://reactnative.dev/docs/linking"}],"quiz":[{"q":"يطلب Trailhead الموقع في أول تشغيل للتطبيق، قبل أن يرى المستخدم أي شيء. على iOS، ينقر كثير من المستخدمين على Don’t Allow. لماذا يهمّ هذا إلى هذا الحد؟
","options":[{"text":"يُرفض التطبيق في الـ App Store لأنه يطلب الإذن عند التشغيل.","why":"الطلب عند التشغيل لا يعني الرفض تلقائيًا. الكلفة الحقيقية تقع على مستخدميك وميزاتك."},{"text":"بعد الرفض، لا يعرض iOS نافذة النظام مرة أخرى؛ ولا يغيّرها إلا تطبيق الإعدادات، فتصبح ميزة التتبّع عمليًا مفقودة لهؤلاء المستخدمين.","why":"صحيح. تحصل على نافذة نظام واحدة لكل إذن على iOS، فاستخدمها حين يفهم المستخدم السبب."},{"text":"الرفض عند التشغيل يرفض أيضًا أذونات الكاميرا والإشعارات.","why":"كل إذن يُجاب عنه على حدة. الضرر يقع على الموقع وحده، لكنه دائم."}],"answer":1},{"q":"استجابة الإذن هي { status: 'denied', granted: false, canAskAgain: false }. ماذا يجب أن يفعل زرّ Start tracking؟
requestForegroundPermissionsAsync() مرة أخرى؛ فقد يكون المستخدم غيّر رأيه.","why":"مع canAskAgain بقيمة false، يُحَلّ الطلب فورًا بالرفض نفسه ولا تظهر أي نافذة."},{"text":"يُخفي الزر نهائيًا.","why":"قد يريد المستخدم الميزة لاحقًا. وإخفاء الزر لا يترك له طريقًا للعودة."},{"text":"يشرح أن الموقع مُطفأ لـ Trailhead ويقدّم زرًّا يفتح صفحة التطبيق في الإعدادات.","why":"صحيح. يأخذه Linking.openSettings() مباشرة إلى المفتاح الذي يحتاج إليه."},{"text":"يبدأ التتبّع على أي حال ويعرض خطأ إن فشل.","why":"ستُرفض استدعاءات الموقع؛ وبدء ميزة تعرف أنها لا تعمل تجربة أسوأ من الشرح."}],"answer":2},{"q":"غيّرت وصف استخدام الموقع في app.json، وأعدت التحميل بـ Fast Refresh، وما زال النص القديم يظهر في النافذة. لماذا؟
","options":[{"text":"الوصف جزء من الإعدادات الأصلية للتطبيق، فلا يتغيّر إلا في build جديد.","why":"صحيح. نصوص الاستخدام تُترجَم إلى Info.plist؛ أعِد بناء الـ development build لتراها."},{"text":"يخزّن iOS نص النافذة مؤقتًا لمدة 24 ساعة.","why":"لا يوجد تخزين مؤقت كهذا؛ النص يأتي من الملف التنفيذي المثبّت."},{"text":"يجب ضبط الوصف في JavaScript باستخدامLocation.setDescription().","why":"لا توجد دالة كهذه. أوصاف الاستخدام إعدادات أصلية، لا استدعاءات وقت التشغيل."}],"answer":0}],"exercise":{"kind":"web","mode":"js","starter":{"js":"// Decide what the tracking screen shows for a permission response.\n// Returns one of: 'wait' | 'proceed' | 'ask' | 'open-settings'\nfunction permissionAction(response) {\n if (response.status === 'granted') return 'proceed';\n return 'ask';\n}\n\nconsole.log(permissionAction({ status: 'denied', granted: false, canAskAgain: false, expires: 'never' }));\n"},"solution":{"js":"function permissionAction(response) {\n if (!response) return 'wait';\n if (response.granted) return 'proceed';\n if (response.status === 'undetermined') return 'ask';\n return response.canAskAgain ? 'ask' : 'open-settings';\n}\n\nconsole.log(permissionAction({ status: 'denied', granted: false, canAskAgain: false, expires: 'never' }));\n"},"checks":[{"id":"loading","test":"return typeof permissionAction === 'function' && permissionAction(null) === 'wait' && permissionAction(undefined) === 'wait';"},{"id":"granted","test":"return permissionAction({ status: 'granted', granted: true, canAskAgain: true, expires: 'never' }) === 'proceed';"},{"id":"undetermined","test":"return permissionAction({ status: 'undetermined', granted: false, canAskAgain: true, expires: 'never' }) === 'ask';"},{"id":"denied-can-ask","test":"return permissionAction({ status: 'denied', granted: false, canAskAgain: true, expires: 'never' }) === 'ask';"},{"id":"denied-final","test":"return permissionAction({ status: 'denied', granted: false, canAskAgain: false, expires: 'never' }) === 'open-settings';"}],"title":"حوّل استجابة الإذن إلى شاشة","prompt":"تستدعي شاشة التتبّع في Trailhead الدالة permissionAction(response) لتقرّر ما ترسمه. response هو الكائن القادم من getForegroundPermissionsAsync()، أو null ما دام التحميل جاريًا. أرجع:
'wait' ما دامت الاستجابة null أو undefined (اعرض مؤشّر تحميل)،'proceed' حين يُمنح الوصول (اعرض الخريطة)،'ask' حين يمكن أن تظهر نافذة النظام: لم يُسأل قط، أو رُفض مع canAskAgain: true (اعرض الشرح وزرّ Continue)،'open-settings' حين يُرفض وتكون canAskAgain قيمتها false (اعرض زرّ Open Settings).response.","granted قيمة منطقية أصلًا، فلا حاجة إلى مقارنة status في تلك الحالة.","في حالة الرفض، الشيء الوحيد المهم هو canAskAgain."],"explanation":"انهار الكود المبدئي مع null (قراءة .status من لا شيء)، وأرسل المستخدمين الذين رفضوا رفضًا دائمًا إلى طلب لا يفعل شيئًا بصمت. تغطّي الدالة المُصلحة كل حالة بترتيب ثابت: التحميل، ثم المنح، ثم النوعين من «لم يُمنح بعد». ولأنها نقية، يمكنك اختبار الفروع الأربعة في أجزاء من الثانية، وتصبح الشاشة مجرّد switch على أربعة نصوص.