إذن الوصول إلى التقويم في تطوير تطبيقات الجوال — ما هو، وكيف يعمل، وطلب الوصول

ما هو إذن الوصول إلى التقويم؟

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

في iOS، يتم تنظيم الوصول إلى التقويم بواسطة إطار عمل EventKit. يمكن للتطبيق طلب وصول للقراءة والكتابة إلى الأحداث، ويمكن للمستخدم منح الطلب أو رفضه عبر حوار النظام. في Android، تعتمد الحماية على إذنين زمنيين: READ_CALENDAR وWRITE_CALENDAR.

وفقًا لدراسة Pew Research Center (2024)، حوالي 45% من مستخدمي الأجهزة المحمولة يستخدمون التقويم بانتظام، و62% منهم يرفضون الوصول للتطبيقات التي لا تشرح سبب طلب بيانات التقويم.

المبدأ الأساسي — يجب على التطبيق طلب الوصول فقط للميزات المرتبطة مباشرة بالتقويم: إنشاء التذكيرات، مزامنة الأحداث، استيراد الجداول.

كيف يعمل طلب الوصول إلى التقويم في iOS

في iOS، يتم توفير الوصول إلى التقويم والتذكيرات من خلال إطار عمل واحد — EventKit. الفئة المركزية EKEventStore تدير جميع العمليات: طلب الإذن، قراءة الأحداث، إنشاء وتحرير إدخالات التقويم. عند أول استدعاء لـ requestAccess(to:entityType:)، يعرض النظام حوارًا أصليًا مع شرح.

EventKit و EKEventStore

فئة EKEventStore هي نقطة الدخول إلى نظام التقويم الفرعي في iOS. لطلب الوصول، يجب استدعاء الطريقة requestAccess(to: .event) مع تمرير نوع الكيان (حدث أو تذكير). بعد الحصول على الإذن، يوفر EKEventStore الوصول إلى جميع التقاويم المتصلة بـ iCloud وGoogle وExchange ومزودين آخرين.

ميزة مهمة: EKEventStore كائن ثقيل — إنشاؤه يستغرق وقتًا ويستهلك موارد. يُوصى بتهيئته مرة واحدة وإعادة استخدامه طوال دورة حياة التطبيق. وفقًا لـ WWDC Session 10117 (2024)، توصي Apple بتخزين مثيل EventStore مؤقتًا لتحسين الأداء.

أنواع الوصول: القراءة والكتابة

لا يفصل iOS بين إذني القراءة والكتابة للتقويم — إما أن يمنح المستخدم الوصول الكامل أو يرفضه. ومع ذلك، يمكن للتطبيق التحكم في العمليات على مستوى الكود: قراءة الأحداث عبر EKEventStore.event، إنشاؤها عبر EKEventStore.save وحذفها عبر EKEventStore.remove. منذ iOS 18، أصبح من الممكن طلب الوصول لنوع كيان محدد فقط — .event أو .reminder.

في iOS 17+، أدخلت Apple آلية وصول مؤقت: يمكن لبعض التطبيقات الحصول على وصول لمدة 24 ساعة بعد تأكيد المستخدم لمرة واحدة. هذه الميزة مفيدة بشكل خاص للتطبيقات التي تحتاج وصولاً لمرة واحدة إلى التقويم — على سبيل المثال، لاستيراد جدول مؤتمر.

كيف يعمل طلب الوصول إلى التقويم في Android

في Android، الوصول إلى التقويم محمي بإذنين منفصلين: READ_CALENDAR و WRITE_CALENDAR. كلاهما ينتميان إلى الفئة الخطيرة ويتطلبان طلبًا في وقت التشغيل. فصل القراءة والكتابة يتيح للمستخدم ضبط مستوى وصول التطبيق بدقة.

READ_CALENDAR و WRITE_CALENDAR

إذن READ_CALENDAR يسمح للتطبيق بقراءة الأحداث من جميع تقاويم المستخدم، بما في ذلك الأسماء والأوقات والمشاركين والوصف. إذن WRITE_CALENDAR يسمح بإنشاء وتعديل وحذف الأحداث. يتم تحديد كليهما في البيان عبر علامة uses-permission وطلبهما في وقت التشغيل عبر ActivityResultLauncher.

بدءًا من Android 14 (API 34)، يحذر النظام المستخدم إذا طلب التطبيق كلا الإذنين في وقت واحد. يُوصى بطلبهما بشكل منفصل: أولاً READ_CALENDAR للقراءة، ثم WRITE_CALENDAR عند أول محاولة لإنشاء حدث. وفقًا لـ Google I/O 2024، هذا النهج يقلل معدل الرفض بنسبة 23%.

CalendarContract ContentProvider

CalendarContract هو موفر محتوى Android ينظم بيانات التقويم في جداول علائقية. الجداول الرئيسية تشمل: Calendars (قائمة التقاويم)، Events (الأحداث)، Attendees (المشاركون)، Reminders (التذكيرات). يتم الوصول إلى البيانات عبر ContentResolver.query() مع تحديد URI والإسقاط.

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

أمثلة برمجية للعمل مع التقويم

تنفيذ طلبات الوصول إلى التقويم يتطلب مراعاة الخصائص الخاصة بكل منصة. فيما يلي أمثلة بلغتي Swift و Kotlin توضح العمل الصحيح مع EventKit وCalendarContract.

الوصول إلى التقويم في Swift

طلب الوصول إلى التقويم في iOS يتم من خلال طريقة requestAccess لفئة EKEventStore. المثال أدناه يوضح إنشاء حدث بعد الحصول على الإذن.

import EventKit

let eventStore = EKEventStore()

eventStore.requestAccess(to: .event) { granted, error in
    guard granted else {
        print("تم رفض الوصول إلى التقويم")
        return
    }

    let event = EKEvent(eventStore: eventStore)
    event.title = "اجتماع الفريق"
    event.startDate = Date()
    event.endDate = Date(timeIntervalSinceNow: 3600)
    event.calendar = eventStore.defaultCalendarForNewEvents

    do {
        try eventStore.save(event, span: .thisEvent)
        print("تم إنشاء الحدث: \(event.eventIdentifier)")
    } catch {
        print("خطأ في الحفظ: \(error.localizedDescription)")
    }
}

الوصول إلى التقويم في Kotlin

في Android، طلب إذني READ_CALENDAR و WRITE_CALENDAR يتم عبر ActivityResultLauncher. يوضح المثال قراءة الأحداث من تقويم المستخدم بعد الحصول على الوصول.

val calendarPermissionLauncher =
    registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { permissions ->
        if (permissions[Manifest.permission.READ_CALENDAR] == true) {
            val uri = CalendarContract.Events.CONTENT_URI
            val projection = arrayOf(
                CalendarContract.Events.TITLE,
                CalendarContract.Events.DTSTART,
                CalendarContract.Events.DTEND
            )
            val cursor = contentResolver.query(uri, projection, null, null, null)
            cursor?.use {
                val titleIndex = it.getColumnIndex(CalendarContract.Events.TITLE)
                while (it.moveToNext()) {
                    Log.d("التقويم", "الحدث: ${it.getString(titleIndex)}")
                }
            }
        } else {
            // عرض الشرح واقتراح الانتقال إلى الإعدادات
            requestPermissionSettingsRedirect()
        }
    }

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    calendarPermissionLauncher.launch(
        arrayOf(Manifest.permission.READ_CALENDAR, Manifest.permission.WRITE_CALENDAR)
    )
}

أفضل الممارسات لطلب الوصول إلى التقويم

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

التقليل وسياق الطلب

اطلب الوصول إلى التقويم فقط عندما يقوم المستخدم بإجراء يتطلب بيانات التقويم: «إضافة إلى التقويم»، «مزامنة الجدول»، «استيراد الأحداث». حوار ما قبل الإذن (حوار مخصص قبل حوار النظام) يزيد معدل الموافقة بنسبة 35%، وفقًا لـ Localytics (2024).

في iOS، استخدم المفتاح NSCalendarsUsageDescription في بيان الخصوصية مع نص محدد. بدلاً من «لإنشاء الأحداث»، اكتب «لإضافة التمارين إلى تقويمك». الصياغة المحددة تزيد معدل تحويل الطلب بنسبة 20–30%.

معالجة الرفض وإعادة التوجيه إلى الإعدادات

إذا رفض المستخدم الطلب، لا تظهر حوار النظام مرة أخرى — سيؤدي ذلك إلى تفعيل neverAskAgain في Android أو جعل الحوار غير متاح في iOS. بدلاً من ذلك، قدم الانتقال إلى الإعدادات عبر Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS) في Android أو UIApplication.openSettingsURLString في iOS.

عند إعادة الدخول إلى الشاشة، تحقق من حالة الإذن. في iOS، استدع EKEventStore.authorizationStatus(for: .event) وحدث واجهة المستخدم وفقًا للحالة الحالية. في Android، استخدم ContextCompat.checkSelfPermission() للتحقق من الحالة الحالية واتخاذ قرار بشأن إظهار زر الانتقال إلى الإعدادات.