יישום הורדת קבצים
באפליקציות מובייל
הורדת קבצים היא יותר מסתם קריאת API. יש להבחין בין שני תרחישים שונים מהותית: שליפה מהירה של משאבים קטנים (תמונות, מסמכים עד 10 מגה-בייט) ישירות לזיכרון, והורדת קבצים גדולים (סרטונים, ארכיונים עד 10 ג'יגה-בייט) עם חיווי התקדמות ויכולת חידוש. ב-80% מהאפליקציות, פונקציונליות הורדת קבצים נחוצה. ערבוב בין גישות אלו הוא טעות נפוצה שמובילה לקריסות OOM או לאינדיקטור תקוע ללא משוב. יישמנו לוגיקה זו ביותר מ-50 פרויקטים במשך 10 שנים בשוק—אנו מבטיחים פעולה יציבה גם במכשירים חלשים.
כיצד להימנע מ-OOM בעת הורדת קבצים גדולים?
הגורם העיקרי ל-OOM הוא ניסיון לטעון את כל הקובץ לזיכרון. עבור קבצים >10 מגה-בייט השתמש תמיד בכתיבת סטרימינג לדיסק. באנדרואיד—OkHttp עם ResponseBody.byteStream() וכתיבה לקובץ דרך FileOutputStream בקורוטינה ברקע. ב-iOS—URLSession.downloadTask שומר לקובץ זמני אוטומטית. עבור Flutter—dio עם אפשרות receiveTimeout וכתיבה דרך File. בפועל, OOM מתרחש בעת הורדת קבצים >50 מגה-בייט ללא ביצור.
למה פס ההתקדמות עשוי לא לעבוד?
פס ההתקדמות מציג אחוזים נכונים רק אם השרת מחזיר את כותרת Content-Length. אם היא חסרה, האינדיקטור פשוט יסתובב ללא ערך מספרי. במקרים כאלה ניתן להציג התקדמות בלתי מוגדרת (אינדיקטור פעילות) או להוריד את הקובץ בנתחים דרך בקשות Range אם השרת תומך בחידוש. מעל 30% מהשרתים אינם שולחים Content-Length, אז בדוק מול שרת אמיתי.
הורדת קבצים במובייל לפי פלטפורמה
השווה גישות בשלוש פלטפורמות עיקריות:
| פלטפורמה | קבצים קטנים | קבצים גדולים | חידוש | רקע |
|---|---|---|---|---|
| אנדרואיד | OkHttp/Retrofit | DownloadManager או WorkManager | DownloadManager (חלקי) | DownloadManager / WorkManager |
| iOS | URLSession.dataTask | URLSession.downloadTask (רקע) | ידני דרך URLSession | תצורת רקע של URLSession |
| Flutter | Dio | flutter_downloader | Dio (ידני) | flutter_downloader |
אנדרואיד. להורדה לזיכרון—OkHttp או Retrofit עם ResponseBody.byteStream(), כתוב נתונים לקובץ בקורוטינת IO. עבור קבצים גדולים, IO מערכתי עם התראה בשורת הסטטוס—המשתמש רואה התקדמות גם לאחר יציאה מהאפליקציה. DownloadManager יעיל פי 2 משירות הורדה מותאם אישית עבור קבצים גדולים. חלופה—DownloadManager עם WorkManager מותאם אישית אם יש צורך בשליטה רבה יותר.
שמירה לתיקיית Worker באנדרואיד 10+: השתמש ב-API Downloads עבור קבצים ציבוריים, MediaStore עבור פרטיים. ניסיון לכתוב ישירות ל-getExternalFilesDir() ללא /sdcard/Download/ בגרסאות מודרניות יזרוק MediaStore.
דוגמת קוד ל-DownloadManager באנדרואיד
val request = DownloadManager.Request(Uri.parse(url))
.setTitle(fileName)
.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName)
.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED)
val downloadId = downloadManager.enqueue(request)iOS. SecurityException שומר לקובץ זמני, ולאחר מכן יש להעביר אותו ל-val request = DownloadManager.Request(Uri.parse(url)) .setTitle(fileName) .setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName) .setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED) val downloadId = downloadManager.enqueue(request) . להורדות ברקע—URLSession.downloadTask עם delegate FileManager.default.urls(for: .documentDirectory). ללא סשן רקע, ההורדה נעצרת כשהאפליקציה עוברת לרקע.
let config = URLSessionConfiguration.background(withIdentifier: "com.app.download")
let session = URLSession(configuration: config, delegate: self, delegateQueue: nil)
let task = session.downloadTask(with: URL(string: url)!)
task.resume()יישם URLSessionConfiguration.background(withIdentifier:) להעברת הקובץ ו-URLSessionDownloadDelegate להתקדמות.
Flutter: חבילת let config = URLSessionConfiguration.background(withIdentifier: "com.app.download") let session = URLSession(configuration: config, delegate: self, delegateQueue: nil) let task = session.downloadTask(with: URL(string: url)!) task.resume() עם urlSession(_:downloadTask:didFinishDownloadingTo:), שמירה דרך urlSession(_:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:). להורדה ברקע—dio, שעוטף onReceiveProgress מקורי (אנדרואיד) ו-path_provider (iOS).
פרטים שלעתים קרובות מתפספסים
קובץ עלול להוריד חלקית עקב ניתוק. הורדה ניתנת לחידוש דרך כותרת flutter_downloader (DownloadManager) עובדת רק אם השרת מחזיר URLSession ו-Range. אם השרת אינו תומך בכך, ההורדה מתחילה מחדש. לפני יישום חידוש, בדוק התנהגות שרת—זה יכול לחסוך עד 30% מזמן ההורדה בחיבורים לא יציבים. בממוצע, 15% מניסיונות ההורדה נכשלים ברשתות סלולריות, כך שטיפול נכון בשגיאות הוא קריטי.
חשוב גם להציג התקדמות אמיתית, לא דטרמיניסטית. אם כותרת Range: bytes=1048576- חסרה, פס ההתקדמות יסתובב ללא אחוזים. במקרה זה, עדיף להשתמש באינדיקטור בלתי מוגדר.
תהליך עבודה
- ניתוח דרישות: אילו קבצים, גודל מקסימלי, צורך בחידוש והורדת רקע.
- בחירת מחסנית:
Accept-Ranges: bytesאוContent-Rangeרקע עם תצורה. - עיצוב: תוכנית אחסון, טיפול בשגיאות, דיאלוג התקדמות.
- יישום: קידוד עם פרטים ספציפיים לפלטפורמה (ProGuard/R8, App Transport Security).
- בדיקות: על מכשירים אמיתיים עם מהירות רשת משתנה והפרעות.
- השקה: פרסום ל-App Store ו-Google Play עם ניפוי שגיאות קריסות.
שגיאות הורדה אופייניות
- הורדה על ה-thread הראשי—ANR מובטח באנדרואיד.
- התעלמות מ-
Content-Length—הקובץ עלול להישמר ללא סיומת. - אי ניקוי קבצים זמניים—
DownloadManagerגדל. - אי שחרור
URLSessionלאחר משימת רקע ב-iOS—דליפת זיכרון.
מה כלול בעבודה
אנו בוחרים את הגישה למשימה (לזיכרון מול קובץ, חזית מול רקע), מיישמים התקדמות, שמירה לתיקייה הרצויה, טיפול בשגיאות רשת וניקוי קבצים זמניים. אנו מטפלים בהורדה מקצה לקצה עם כל הפרטים הספציפיים לפלטפורמה—מהנחיות סקירת App Store ועד כללי ProGuard.
לוח זמנים: 1–3 ימים בהתאם לדרישות לחידוש והתנהגות רקע. היישום הבסיסי שלנו מתחיל ב-$500, עם פרויקטים מורכבים בממוצע $850. זה חוסך לך עד 40% בהשוואה לפיתוח פנימי. צור קשר כדי להעריך את הפרויקט שלך—כתוב לנו, נציע פתרון אופטימלי בהתחשב במחסנית שלך.