মোবাইল অ্যাপে ডকুমেন্টস ডিরেক্টরি — এটি কী, উদ্দেশ্য এবং স্টোরেজ কীভাবে সংগঠিত করবেন

অ্যাপ্লিকেশন ডকুমেন্টস ডিরেক্টরি কী?

ডকুমেন্টস ডিরেক্টরি হল অ্যাপ্লিকেশন স্যান্ডবক্সের ভিতরে একটি বিশেষায়িত সঞ্চয়স্থান, যা ব্যবহারকারীর ফাইলের স্থায়ী সঞ্চয়ের জন্য ডিজাইন করা হয়েছে। ক্যাশের বিপরীতে, এই ডিরেক্টরির ফাইলগুলি ব্যবহারকারীর জন্য গুরুত্বপূর্ণ বলে বিবেচিত হয়: স্পেস কম হলে সিস্টেম সেগুলি মুছে ফেলে না, অ্যাপ আপডেটের সময় সংরক্ষিত থাকে এবং ডিভাইস সিঙ্ক্রোনাইজেশনের সময় ব্যাকআপ নেওয়া হয়। iOS-এ, Documents ডিরেক্টরি Sandbox কন্টেইনারের অংশ এবং স্বয়ংক্রিয়ভাবে iCloud ব্যাকআপে অন্তর্ভুক্ত হয়। Android-এ, কোনও সরাসরি সমতুল্য নেই — সমতুল্য হল context.filesDir, যা স্থায়ী ফাইলের জন্যও কিন্তু এর কোনও অন্তর্নির্মিত ব্যাকআপ ব্যবস্থা নেই।

Android-এ ডকুমেন্টস ডিরেক্টরি এবং অভ্যন্তরীণ স্টোরেজের (Internal Storage) মধ্যে পার্থক্য ন্যূনতম: উভয়ই অ্যাপ স্যান্ডবক্সে অবস্থিত, উভয়ই আনইনস্টলে মুছে যায়, উভয়ই অন্যান্য অ্যাপের জন্য অগম্য। প্রধান পার্থক্য শব্দার্থগত: Documents Directory ধরে নেয় ফাইলগুলি ব্যবহারকারী দ্বারা তৈরি বা আমদানি করা হয়েছে, যখন Internal Storage-এ অ্যাপের অভ্যন্তরীণ ফাইল (ডেটাবেস, কনফিগারেশন) থাকতে পারে। iOS-এ, পার্থক্য আরও তাৎপর্যপূর্ণ: Documents স্বয়ংক্রিয়ভাবে ব্যাকআপ নেয়, যখন Library/Application Support নেয় না। এটি স্টোরেজ কৌশলকে প্রভাবিত করে: Documents-এ শুধুমাত্র সেটাই রাখুন যা ব্যবহারকারী নতুন ডিভাইসে পুনরুদ্ধার করতে চাইবেন, এবং Application Support-এ সেই অভ্যন্তরীণ ডেটা রাখুন যা অ্যাপ পুনরায় তৈরি করতে পারে।

স্যান্ডবক্স আর্কিটেকচার নিশ্চিত করে যে অন্যান্য অ্যাপ্লিকেশনগুলি আপনার অ্যাপের ডকুমেন্টস ডিরেক্টরিতে অ্যাক্সেস করতে পারে না। iOS-এ, জেলব্রেক ছাড়া অন্যান্য অ্যাপের Documents-এ অ্যাক্সেস অসম্ভব। Android-এ, রুট অ্যাক্সেস যেকোনো অ্যাপের filesDir পড়ার অনুমতি দেয়, তাই সংবেদনশীল ডেটা (টোকেন, এনক্রিপশন কী) EncryptedSharedPreferences বা AndroidX Security লাইব্রেরি থেকে EncryptedFile ব্যবহার করে অতিরিক্তভাবে সুরক্ষিত করা আবশ্যক।

ডকুমেন্টস ডিরেক্টরিতে কী ডেটা সংরক্ষণ করা হয়

ডকুমেন্টস ডিরেক্টরিতে ডেটা সংরক্ষণ করা উচিত যা ব্যবহারকারীর জন্য মূল্যবান এবং অ্যাপ পুনরায় চালু বা ডিভাইস পুনরুদ্ধারের পরে অ্যাক্সেসযোগ্য হওয়া উচিত। সমস্ত ফাইল এই ডিরেক্টরিতে সংরক্ষণের জন্য উপযুক্ত নয় — পছন্দ ডেটার ধরন এবং ব্যবহারের পরিস্থিতির উপর নির্ভর করে।

ব্যবহারকারীর ডকুমেন্ট এবং ফাইল

ব্যবহারকারীর ফাইলগুলি ডকুমেন্টস ডিরেক্টরি-র প্রধান বিষয়বস্তু। এগুলি একটি এডিটরে তৈরি টেক্সট ডকুমেন্ট, অ্যাপ ক্যামেরায় তোলা ছবি, রপ্তানি করা PDF রিপোর্ট, অডিও রেকর্ডিং, নোট হতে পারে। এই ধরনের প্রতিটি ফাইল ব্যবহারকারী দ্বারা বা তার অনুরোধে তৈরি এবং যেকোনো সময় অ্যাক্সেসযোগ্য হতে হবে। iOS-এ, Documents-এর ফাইলগুলি সিস্টেম Files অ্যাপে প্রদর্শিত হয়, যা ব্যবহারকারীকে স্ট্যান্ডার্ড ফাইল ম্যানেজারের মাধ্যমে সেগুলি পরিচালনা করতে দেয়। Android-এ, কোনও অনুরূপ প্রদর্শন নেই — অ্যাপকে নিজেই সংরক্ষিত ফাইলগুলি দেখার জন্য একটি ইন্টারফেস প্রদান করতে হবে।

ডেটাবেস এবং অ্যাপ সেটিংস

SQLite ডেটাবেস এবং সেটিংস ফাইলগুলি সাধারণত ডকুমেন্টস ডিরেক্টরির কাছাকাছি সংরক্ষণ করা হয় কিন্তু এর ভিতরে নয়। iOS-এ, ডেটাবেস Library/Application Support-এ রাখা হয়, কারণ সেগুলি Files অ্যাপে প্রদর্শিত হওয়া এবং আলাদাভাবে ব্যাকআপ নেওয়া উচিত নয়। Android-এ, ডেটাবেস ডিফল্টভাবে /data/data/<package>/databases/-এ Room বা SQLiteOpenHelper-এর মাধ্যমে তৈরি করা হয়। যদি ডেটাবেসে ব্যবহারকারীর বিষয়বস্তু (নোট, ডায়েরি, আর্থিক রেকর্ড) থাকে, তবে সিস্টেম ব্যাকআপ নিশ্চিত করতে এটি filesDir-এ রাখা যেতে পারে। Room আপনাকে RoomDatabase.Builder কলব্যাকের মাধ্যমে ডেটাবেস স্টোরেজের জন্য একটি কাস্টম ডিরেক্টরি নির্দিষ্ট করার অনুমতি দেয়।

val dbFile = File(context.filesDir, "user_database.db")

val db = Room.databaseBuilder<AppDatabase>(
    context,
    dbFile.absolutePath
).build()

রপ্তানি এবং আমদানি করা ডেটা

যে ফাইলগুলি ব্যবহারকারী অন্যান্য অ্যাপ থেকে আমদানি করে বা আপনার অ্যাপ থেকে রপ্তানি করে, সেগুলিও ডকুমেন্টস ডিরেক্টরিতে সংরক্ষণ করা উচিত। iOS-এ, UIDocumentPickerViewController-এর মাধ্যমে আমদানি asCopy: true প্যারামিটার ব্যবহার করলে স্বয়ংক্রিয়ভাবে Documents-এ ফাইলের একটি কপি রাখে। Android-এ, SAF ডায়ালগের মাধ্যমে আমদানিও অ্যাপ স্যান্ডবক্সে ফাইলের একটি কপি তৈরি করে। ডেটা রপ্তানি করার সময় (উদাহরণস্বরূপ, পরিচিতি সহ CSV ফাইল তৈরি করা), প্রথমে ফাইলটি Documents/filesDir-এ সংরক্ষণ করুন, তারপর ব্যবহারকারীকে Share Sheet-এর মাধ্যমে এটি শেয়ার করার বিকল্প দিন। এটি নিশ্চিত করে যে ব্যবহারকারী পাঠানোর পরে ফাইলটি সংরক্ষণ করতে ভুলে গেলেও, পরে ব্যবহারের জন্য অ্যাপে একটি কপি থাকে।

Android-এ ডকুমেন্টস ডিরেক্টরি নিয়ে কীভাবে কাজ করবেন

Android-এ, ডকুমেন্টস ডিরেক্টরি-র কার্য context.filesDir সম্পাদন করে। অতিরিক্তভাবে, SD কার্ডে context.externalFilesDir ডিরেক্টরি উপলব্ধ, কিন্তু এটি ডেটার অখণ্ডতার গ্যারান্টি দেয় না। আসুন এই ডিরেক্টরিগুলির সাথে কাজ করার মূল কৌশলগুলি দেখি।

filesDir-এর মাধ্যমে ফাইল অ্যাক্সেস এবং ব্যবস্থাপনা

filesDir Android-এ অ্যাপের স্থায়ী ফাইলের জন্য প্রধান ডিরেক্টরি। এটি অ্যাপ স্যান্ডবক্সে অবস্থিত এবং আনইনস্টলে সম্পূর্ণ মুছে যায়। File ইনস্ট্যান্স পেতে, context.filesDir ব্যবহার করুন, যা /data/data/<package>/files/-এর পাথ ফেরত দেয়। ফাইল তৈরি এবং পড়ার জন্য, স্ট্যান্ডার্ড Java/Kotlin File অপারেশন বা কনটেক্সট মেথড openFileInput() এবং openFileOutput() ব্যবহার করুন, যা একটি ফাইলের নাম নেয় এবং FileInputStream/FileOutputStream ফেরত দেয়। openFileOutput() মেথডটি filesDir-এ ফাইলটি স্বয়ংক্রিয়ভাবে তৈরি করে যদি এটি এখনও না থাকে এবং অ্যাক্সেস মোড নির্দিষ্ট করার অনুমতি দেয়: MODE_PRIVATE (শুধুমাত্র বর্তমান অ্যাপ), MODE_APPEND (সংযোজন), বা MODE_WORLD_READABLE (অপ্রচলিত, API 24+ থেকে ব্যবহার করা হয় না)।

val fileName = "report.pdf"
val content = "PDF content".toByteArray()

context.openFileOutput(fileName, Context.MODE_PRIVATE).use { stream ->
    stream.write(content)
}

val bytes = context.openFileInput(fileName).use { stream ->
    stream.readBytes()
}

Android 10+ এ স্টোরেজ বৈশিষ্ট্য

Android 10+-এ, Scoped Storage মডেল filesDir-কে প্রভাবিত করে না — অ্যাপের নিজস্ব স্যান্ডবক্সে সম্পূর্ণ অ্যাক্সেস থাকে। filesDir-এর ভিতরে সমস্ত পড়া এবং লেখার অপারেশনের জন্য অতিরিক্ত অনুমতির প্রয়োজন নেই। তবে, আপনি যদি filesDir-এর মাধ্যমে অন্য অ্যাপের ফাইল অ্যাক্সেস করার চেষ্টা করেন, তাহলে আপনি একটি ব্যতিক্রম পাবেন। ফাইল শেয়ার করার জন্য, FileProvider ব্যবহার করুন, যা অন্য অ্যাপে ফাইল স্থানান্তরের জন্য একটি অস্থায়ী কনটেন্ট URI তৈরি করে। FileProvider AndroidManifest.xml-এ <provider> ট্যাগের মাধ্যমে ঘোষণা করা হয় এবং XML পাথ ফাইলে কনফিগার করা হয়। এটি অ্যাপগুলির মধ্যে ফাইল স্থানান্তরের মানক ব্যবস্থা, যা উদাহরণস্বরূপ, ACTION_SEND সহ Intent-এর মাধ্যমে ছবি পাঠানোর সময় ব্যবহৃত হয়।

iOS-এ ডকুমেন্টস ডিরেক্টরি নিয়ে কীভাবে কাজ করবেন

iOS-এ, Documents Directory বিশেষ অবস্থা সহ অ্যাপের Sandbox কন্টেইনারের অংশ। এই ডিরেক্টরির ফাইলগুলি স্বয়ংক্রিয়ভাবে iCloud ব্যাকআপে অন্তর্ভুক্ত হয়, Files অ্যাপে প্রদর্শিত হয় এবং App Store-এর মাধ্যমে অ্যাপ আপডেটের সময় সংরক্ষিত থাকে।

ডকুমেন্টস ডিরেক্টরি এবং ব্যাকআপ

Documents-এর স্বয়ংক্রিয় ব্যাকআপ iOS-এর একটি মূল সুবিধা। যখন ব্যবহারকারী ডিভাইসটি iTunes-এ সংযুক্ত করে বা iCloud Backup সক্রিয় করে, তখন Documents/-এর সমস্ত ফাইল ব্যাকআপে কপি হয়ে যায়। নতুন ডিভাইসে পুনরুদ্ধার করার সময়, ব্যবহারকারী অতিরিক্ত কোনো পদক্ষেপ ছাড়াই তার সমস্ত ফাইল পেয়ে যায়। তবে, এই সুবিধা অসুবিধায় পরিণত হয় যদি অ্যাপ Documents-এ প্রচুর পরিমাণে ডেটা সংরক্ষণ করে: ব্যাকআপের সময় বেড়ে যায় এবং iCloud স্টোরেজ দ্রুত শেষ হতে পারে। তাই, Documents-এ শুধুমাত্র সেই ফাইলগুলি সংরক্ষণ করা উচিত যা ব্যবহারকারীর পুনরুদ্ধারের সময়จริงে প্রয়োজন। অস্থায়ী ফাইল, ক্যাশ এবং পুনঃনির্মাণযোগ্য ডেটা Caches বা Library/Application Support-এ থাকা উচিত। Apple isExcludedFromBackup অ্যাট্রিবিউটের মাধ্যমে ইন্টারনেট থেকে পুনরায় ডাউনলোড করা যেতে পারে এমন ফাইলগুলিকে ব্যাকআপ থেকে বাদ দেওয়ার পরামর্শ দেয়।

let fm = FileManager.default
let docsURL = fm.urls(
    for: .documentDirectory,
    in: .userDomainMask
).first!

let fileURL = docsURL.appendingPathComponent("notes.txt")
let text = "নোট বিষয়বস্তু"
try text.write(to: fileURL, atomically: true, encoding: .utf8)

iCloud Drive এবং ক্রস-ডিভাইস সিঙ্ক্রোনাইজেশন

iCloud Drive ব্যবহারকারীর ডিভাইসগুলিতে Documents-এর ফাইলগুলি সিঙ্ক্রোনাইজ করার অনুমতি দেয়। সিঙ্ক্রোনাইজেশন সক্রিয় করতে, অ্যাপটিকে NSDocument বা UIDocument API ব্যবহার করা উচিত, যা স্বয়ংক্রিয়ভাবে ভার্সনিং এবং দ্বন্দ্ব সমাধান পরিচালনা করে। একটি বিকল্প পদ্ধতি হল CloudKit-এর সাথে iCloud ব্যবহার করা, যা সিঙ্ক্রোনাইজেশনের উপর আরও নমনীয় নিয়ন্ত্রণ প্রদান করে কিন্তু CloudKit Dashboard-এ কনফিগারেশন প্রয়োজন। iCloud Drive ব্যবহার করার সময়, নিশ্চিত করুন যে আপনি সম্পাদনা দ্বন্দ্ব সঠিকভাবে পরিচালনা করেন (মার্জ বা লাস্ট-রাইট-উইনস) এবং অ্যাপ ইন্টারফেসের মাধ্যমে ব্যবহারকারীকে সিঙ্ক্রোনাইজেশন অবস্থা সম্পর্কে জানান। iCloud তাৎক্ষণিক সিঙ্ক্রোনাইজেশনের গ্যারান্টি দেয় না — ফাইলের আকার এবং সংযোগের গুণমানের উপর নির্ভর করে বিলম্ব কয়েক সেকেন্ড থেকে কয়েক মিনিট পর্যন্ত হতে পারে। গুরুত্বপূর্ণ ডেটার জন্য, লেনদেনমূলক লেখা এবং ভার্সনিং ব্যবহার করুন যাতে দ্বন্দ্বের ক্ষেত্রে ফাইলের পূর্ববর্তী সংস্করণ পুনরুদ্ধার করা যায়।

ক্যাশ ডিরেক্টরি থেকে পার্থক্য এবং সর্বোত্তম অনুশীলন

সঠিক পছন্দ Documents Directory এবং Cache Directory-র মধ্যে ব্যবহারকারীর ডেটা স্টোরেজের নির্ভরযোগ্যতা নির্ধারণ করে। পছন্দের ত্রুটি হয় ডেটা ক্ষতি (যদি গুরুত্বপূর্ণ ফাইল ক্যাশে সংরক্ষিত থাকে) বা ব্যাকআপ ওভারফ্লো (যদি অস্থায়ী ফাইল Documents-এ সংরক্ষিত থাকে) হতে পারে।

সর্বোত্তম অনুশীলন ডকুমেন্টস ডিরেক্টরি ব্যবহারে বেশ কয়েকটি মূল নিয়ম অন্তর্ভুক্ত। প্রথমত, এই ডিরেক্টরি থেকে ফাইল মুছে ফেলার আগে সর্বদা ব্যবহারকারীর নিশ্চিতকরণ নিন। ক্যাশের বিপরীতে, একটি ডকুমেন্ট মুছে ফেলার ফলে ব্যবহারকারীর বিষয়বস্তুর অপূরণীয় ক্ষতি হতে পারে। দ্বিতীয়ত, ফাইল ভার্সনিং প্রয়োগ করুন: একটি বিদ্যমান ফাইল ওভাররাইট করার সময়, _backup প্রত্যয় সহ পূর্ববর্তী সংস্করণ সংরক্ষণ করুন বা Snapshot প্রক্রিয়া ব্যবহার করুন। তৃতীয়ত, ব্যবহারকারীকে ডকুমেন্টস ডিরেক্টরি থেকে ফাইল দেখতে, নাম পরিবর্তন করতে, মুছতে এবং রপ্তানি করার জন্য একটি ইন্টারফেস প্রদান করুন। iOS-এ, Documents-এর ফাইলগুলি স্বয়ংক্রিয়ভাবে Files-এ প্রদর্শিত হয়; Android-এ, আপনাকে নিজস্ব ফাইল ম্যানেজার প্রয়োগ করতে হবে বা তৃতীয়-পক্ষের লাইব্রেরি ব্যবহার করতে হবে।

অ্যাপ আপডেটের সময় ডেটা মাইগ্রেশন-এ বিশেষ মনোযোগ দিন। যদি নতুন সংস্করণ ফাইল স্টোরেজ কাঠামো পরিবর্তন করে (উদাহরণস্বরূপ, ডেটা এক উপডিরেক্টরি থেকে অন্যতে স্থানান্তর করে বা ফাইল ফরম্যাট পরিবর্তন করে), তাহলে আপডেটের পরে প্রথম লঞ্চে এককালীন মাইগ্রেশন প্রয়োগ করুন। ডেটা স্কিমা ভার্সন নম্বর SharedPreferences-এ সংরক্ষণ করুন এবং যদি তারা মেলে না তাহলে মাইগ্রেশন চালান। মাইগ্রেশন সম্পূর্ণ হওয়ার আগে পুরানো ফাইলগুলি মুছবেন না — ব্যর্থতার ক্ষেত্রে, ব্যবহারকারীর ডেটা হারানো উচিত নয়। যদি মাইগ্রেশনে ফরম্যাট রূপান্তর অন্তর্ভুক্ত থাকে (উদাহরণস্বরূপ, JSON থেকে SQLite-এ স্যুইচ করা), তাহলে মূল ফাইলগুলি মাইগ্রেশন তারিখ সহ একটি আলাদা ডিরেক্টরিতে ব্যাকআপ হিসাবে সংরক্ষণ করুন। Apple Human Interface Guidelines-এর সুপারিশ অনুসারে, ব্যবহারকারী আপডেটের পরে প্রথম 30 দিনের মধ্যে অ্যাপ সেটিংসের মাধ্যমে পরিবর্তনগুলি পূর্বাবস্থায় ফেরাতে সক্ষম হওয়া উচিত।