موبائل ڈویلپمنٹ میں کیلنڈر تک رسائی کی اجازت — یہ کیا ہے، کیسے کام کرتی ہے اور رسائی کی درخواست

کیلنڈر تک رسائی کی اجازت کیا ہے؟

کیلنڈر تک رسائی کی اجازت ایک ذاتی ڈیٹا تحفظ میکانزم ہے جو ڈیوائس کی کیلنڈر ایپلیکیشنز میں واقعات کے پڑھنے اور لکھنے کو کنٹرول کرتا ہے۔ کیلنڈر میں حساس معلومات ہوتی ہیں: میٹنگیں، ڈیڈلائنز، یاد دہانیاں اور ذاتی منصوبے — اس لیے موبائل OS اس تک رسائی کو اہم درجہ دیتے ہیں۔

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 ContentProvider ہے جو کیلنڈر ڈیٹا کو متعلقہ جدولوں میں تشکیل دیتا ہے۔ اہم جدولوں میں شامل ہیں: Calendars (کیلنڈرز کی فہرست)، Events (واقعات)، Attendees (شرکاء)، Reminders (اطلاعات)۔ ڈیٹا تک رسائی مخصوص URI اور پروجیکشن کے ساتھ ContentResolver.query() کے ذریعے کی جاتی ہے۔

نیا واقعہ داخل کرنے کے لیے، آپ کو ContentValues استعمال کرنا ہوگا جس میں کیلنڈر، شروع اور ختم ہونے کا وقت، عنوان اور وضاحت متعین ہو۔ CalendarContract ٹائم زونز، بار بار آنے والے واقعات اور حسب ضرورت اطلاع کے وقفوں والی یاد دہانیوں کو سپورٹ کرتا ہے۔

کیلنڈر کے ساتھ کام کرنے کے لیے کوڈ کی مثالیں

کیلنڈر تک رسائی کی درخواستوں کے نفاذ کے لیے پلیٹ فارم کی مخصوص خصوصیات پر غور کرنا ضروری ہے۔ ذیل میں Swift اور Kotlin میں مثالیں دی گئی ہیں جو EventKit اور CalendarContract کے ساتھ درست کام کو ظاہر کرتی ہیں۔

Swift میں کیلنڈر تک رسائی

iOS کیلنڈر تک رسائی کی درخواست EKEventStore کلاس کے requestAccess طریقہ کار کے ذریعے کی جاتی ہے۔ نیچے دی گئی مثال اجازت ملنے کے بعد ایک واقعہ بنانا دکھاتی ہے۔

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)
    )
}

کیلنڈر تک رسائی کی درخواست کے لیے بہترین طریقے

کیلنڈر کی اجازتوں کے ساتھ کام کرنے کے لیے ایک اچھی طرح سے سوچی گئی حکمت عملی کی ضرورت ہوتی ہے جو دونوں پلیٹ فارمز کی ضروریات اور صارف کی توقعات پر غور کرے۔ نیچے دی گئی سفارشات پر عمل کرنے سے اعتدال کو پاس کرنے اور اجازت دینے کی شرح بڑھانے میں مدد ملتی ہے۔

درخواست کو کم سے کم کرنا اور سیاق و سباق

کیلنڈر تک رسائی صرف اس وقت درخواست کریں جب صارف کوئی ایسا عمل انجام دے جس کے لیے کیلنڈر ڈیٹا کی ضرورت ہو: «کیلنڈر میں شامل کریں»، «نظام الاوقات کو ہم آہنگ کریں»، «واقعات درآمد کریں»۔ پری اجازت ڈائیلاگ (سسٹم ڈائیلاگ سے پہلے ایک حسب ضرورت ڈائیلاگ) Localytics (2024) کے مطابق رضامندی کی شرح کو 35% بڑھاتا ہے۔

iOS پر، پرائیویسی مینی فیسٹ میں مخصوص متن کے ساتھ NSCalendarsUsageDescription کلید استعمال کریں۔ «واقعات بنانے کے لیے» کے بجائے «آپ کے کیلنڈر میں ورزشیں شامل کرنے کے لیے» لکھیں۔ مخصوص الفاظ درخواست کی تبدیلی کی شرح کو 20–30% بڑھاتے ہیں۔

مستردی کو سنبھالنا اور ترتیبات پر ری ڈائریکٹ کرنا

اگر صارف درخواست مسترد کرتا ہے تو سسٹم ڈائیلاگ دوبارہ نہ دکھائیں — یہ Android پر neverAskAgain کو متحرک کرے گا یا iOS پر ڈائیلاگ کو ناقابل رسائی بنا دے گا۔ اس کے بجائے، Android پر Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS) یا iOS پر UIApplication.openSettingsURLString کے ذریعے ترتیبات پر جانے کی پیشکش کریں۔

اسکرین پر دوبارہ داخل ہوتے وقت، اجازت کی حیثیت چیک کریں۔ iOS پر، EKEventStore.authorizationStatus(for: .event) کال کریں اور موجودہ حیثیت کے مطابق یوزر انٹرفیس کو اپ ڈیٹ کریں۔ Android پر، موجودہ حالت چیک کرنے اور ترتیبات ری ڈائریکٹ بٹن دکھانے کا فیصلہ کرنے کے لیے ContextCompat.checkSelfPermission() استعمال کریں۔