مدیریت دارایی‌ها، تصاویر و فونت‌های محلی (Assets & Fonts)

Adding assets and images

آموزش گام‌به‌گام افزودن تصاویر محلی، آیکون‌ها، فایل‌های JSON و فونت‌های فارسی در فایل pubspec.yaml و نمایش آن‌ها در Flutter

فهرست مطالب این صفحه

اپلیکیشن‌ها علاوه بر کد، شامل فایل‌های استاتیک مانند تصاویر، آیکون‌ها، فایل‌های پیکربندی JSON و فونت‌های سفارشی هستند. در Flutter به این فایل‌ها Asset گفته می‌شود و هنگام کامپایل، درون بسته نهایی برنامه قرار می‌گیرند.

۱. معرفی تصاویر و پوشه دارایی‌ها در pubspec.yaml

ابتدا پوشه‌ای مانند assets/images/ در ریشه پروژه بسازید و فایل‌های تصویر خود را در آن قرار دهید. سپس در فایل pubspec.yaml مسیر پوشه یا فایل‌ها را زیر کلید flutter: تعریف کنید:

YAML
flutter:
  uses-material-design: true

  assets:
    - assets/images/
    - assets/data/config.json

دقت در تورفتگی YAML: کلید assets: باید دقیقاً دو فاصله از ابتدای خط تورفتگی داشته باشد و هر خط زیرمجموعه آن با چهار فاصله و یک خط تیره ( -) آغاز شود.

۲. نمایش تصاویر محلی و اینترنتی

  • نمایش تصویر محلی (Image.asset):
    Dart
    Image.asset(
      'assets/images/banner.png',
      width: 300,
      fit: BoxFit.cover,
    )
    
  • نمایش تصویر از اینترنت (Image.network):
    Dart
    Image.network(
      'https://example.com/photo.jpg',
      loadingBuilder: (context, child, loadingProgress) {
        if (loadingProgress == null) return child;
        return const CircularProgressIndicator();
      },
      errorBuilder: (context, error, stackTrace) {
        return const Icon(Icons.broken_image, size: 48);
      },
    )
    

۳. افزودن فونت سفارشی (مانند فونت فارسی Vazirmatn)

برای استفاده از فونت دلخواه در کل برنامه، فایل‌های فونت (.ttf یا .woff2) را در پوشه assets/fonts/ قرار دهید و در pubspec.yaml تعریف کنید:

YAML
flutter:
  fonts:
    - family: Vazirmatn
      fonts:
        - asset: assets/fonts/Vazirmatn-Regular.ttf
          weight: 400
        - asset: assets/fonts/Vazirmatn-Bold.ttf
          weight: 700

سپس می‌توانید این فونت را به‌صورت سراسری در ThemeData کل اپلیکیشن فعال کنید:

Dart
MaterialApp(
  theme: ThemeData(
    fontFamily: 'Vazirmatn',
    useMaterial3: true,
  ),
  home: const HomePage(),
)