مدیریت داراییها، تصاویر و فونتهای محلی (Assets & Fonts)
Adding assets and imagesآموزش گامبهگام افزودن تصاویر محلی، آیکونها، فایلهای JSON و فونتهای فارسی در فایل pubspec.yaml و نمایش آنها در Flutter
فهرست مطالب این صفحه
اپلیکیشنها علاوه بر کد، شامل فایلهای استاتیک مانند تصاویر، آیکونها، فایلهای پیکربندی JSON و فونتهای سفارشی هستند. در Flutter به این فایلها Asset گفته میشود و هنگام کامپایل، درون بسته نهایی برنامه قرار میگیرند.
۱. معرفی تصاویر و پوشه داراییها در pubspec.yaml
ابتدا پوشهای مانند assets/images/ در ریشه پروژه بسازید و فایلهای تصویر خود را در آن قرار دهید. سپس در فایل pubspec.yaml مسیر پوشه یا فایلها را زیر کلید flutter: تعریف کنید:
flutter:
uses-material-design: true
assets:
- assets/images/
- assets/data/config.json
دقت در تورفتگی YAML: کلید
assets:باید دقیقاً دو فاصله از ابتدای خط تورفتگی داشته باشد و هر خط زیرمجموعه آن با چهار فاصله و یک خط تیره (-) آغاز شود.
۲. نمایش تصاویر محلی و اینترنتی
- نمایش تصویر محلی (
Image.asset):DartImage.asset( 'assets/images/banner.png', width: 300, fit: BoxFit.cover, ) - نمایش تصویر از اینترنت (
Image.network):DartImage.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 تعریف کنید:
flutter:
fonts:
- family: Vazirmatn
fonts:
- asset: assets/fonts/Vazirmatn-Regular.ttf
weight: 400
- asset: assets/fonts/Vazirmatn-Bold.ttf
weight: 700
سپس میتوانید این فونت را بهصورت سراسری در ThemeData کل اپلیکیشن فعال کنید:
MaterialApp(
theme: ThemeData(
fontFamily: 'Vazirmatn',
useMaterial3: true,
),
home: const HomePage(),
)