</>مدرسه زیب‌موجیاد بگیر، تمرین کن، بساز
مدرسهSwiftدرس 16
درس 16 از 21 · ۴۰ دقیقه

Codable و فایل JSON

یک مسئله واقعی را با «Codable و فایل JSON» حل می‌کنیم و نتیجه را همان لحظه می‌بینیم.

۰امتیاز شما
نقشه این درس

بعد از این درس چه کاری می‌توانی انجام بدهی؟

  • Codable تبدیل type-safe و FileManager/URL مسیر فایل را مدیریت می‌کنند.
  • کد را اجرا و نتیجه را پیش‌بینی کنی
  • یک تغییر کوچک بدهی و اثرش را توضیح بدهی
  • خطای واقعی درس را بخوانی و برطرف کنی
نکته مهم برای شروع Swift

اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیک‌ترین سرنخ‌اند.

چرا مهم است؟ Codable تبدیل type-safe و FileManager/URL مسیر فایل را مدیریت می‌کنند.

اولین تمرین تو: فایل را decode و عنوان را چاپ کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.

توضیح ساده و قدم‌به‌قدم

از یک مثال کوچک شروع کن

Codable تبدیل type-safe و FileManager/URL مسیر فایل را مدیریت می‌کنند. کد زیر را در فایل «main.swift» خودت تایپ و اجرا کن. بعد خروجی را با انتظار درس مقایسه کن.

1

۱. نمونه را اجرا کن

پیش از اجرا خروجی را حدس بزن و سپس تفاوت را یادداشت کن.

2

۲. کد را تغییر بده

فایل را decode و عنوان را چاپ کن.

3

۳. خطا را عمداً بساز

JSON ناسازگار DecodingError می‌دهد؛ نسخه سالم را بی‌خبر پاک نکن. متن خطا و شماره خط را بخوان، علت را پیدا کن و فقط همان بخش را اصلاح کن.

نکته مهم

اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیک‌ترین سرنخ‌اند.

مفهوم‌های اصلی

سه قطعه‌ای که باید بفهمی

Codable و فایل JSON

Codable تبدیل type-safe و FileManager/URL مسیر فایل را مدیریت می‌کنند.

نتیجه قابل مشاهده

tasks.json با JSON یک task ساخته می‌شود.

خطایی که باید بشناسی

JSON ناسازگار DecodingError می‌دهد؛ نسخه سالم را بی‌خبر پاک نکن.

سناریوی واقعی

taskها باید روی دیسک ذخیره و بازیابی شوند.

فرض کن taskها باید روی دیسک ذخیره و بازیابی شوند. فعلاً قرار نیست کل برنامه را بسازیم؛ فقط همین نیاز را با چند خط کد حل می‌کنیم تا معلوم باشد هر خط چه کاری انجام می‌دهد.

بازی ساختن کد

قطعه‌ها را به ترتیب درست بچین

روی هر قطعه بزن تا وارد پاسخ شود؛ برای برگرداندن دوباره روی آن بزن. با دکمه‌های جابه‌جایی هم می‌توانی بدون کشیدن و رهاکردن ترتیب را اصلاح کنی.

مرحله ۲ از ۳ · مرتب‌کردن کد
بانک قطعه‌هاقطعه مناسب را انتخاب کن
ترتیب پاسخ تواز بالا به پایین اجرا می‌شود

    هنوز پاسخی بررسی نشده است.

    کارگاه تعاملی

    بررسی ساختار تمرین

    این صفحه کامپایلر کامل Swift نیست؛ ساختار تمرین را صادقانه بررسی می‌کند و خروجی مورد انتظار را نشان می‌دهد. برای اجرای کامل به محیط رسمی همان زبان نیاز است.

    main.swift
    خروجیآماده
    یک بخش را تغییر بده و دکمه بررسی را بزن.
    بعد از هر تغییر، نتیجه را دوباره بررسی کن.
    تمرین هدایت‌شده

    فایل را decode و عنوان را چاپ کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.

    دام‌های رایج

    این سه اشتباه را انجام نده

    1

    JSON ناسازگار DecodingError می‌دهد؛ نسخه سالم را بی‌خبر پاک نکن.

    2

    کپی‌کردن کد بدون اجرای مرحله‌به‌مرحله

    3

    تغییر چند قسمت هم‌زمان و گم‌شدن علت نتیجه

    سنجش چندمرحله‌ای

    با 5 سؤال مطمئن شو که مفهوم را گرفته‌ای

    سؤال 1 از 5

    خروجی درست این نمونه چیست؟

    سؤال 2 از 5

    چرا پیش از اجرا نتیجه را حدس می‌زنیم؟

    سؤال 3 از 5

    سرنخ خطای این درس چیست؟

    سؤال 4 از 5

    بعد از تغییر کد چه کنیم؟

    سؤال 5 از 5

    چه وقت آماده درس بعدی هستی؟

    پایان درس 16

    فهمیدی، تغییر دادی، نتیجه را توضیح دادی؟

    فقط در این صورت درس را کامل کن و سراغ مرحله بعد برو.