Для чего нужна функция main() во Flutter?

Функция main() во Flutter

Функция main() — это точка входа приложения, первая функция, которая вызывается при запуске приложения. Это критически важный элемент любого Flutter проекта.

Минимальный main()

void main() {
  runApp(MyApp());
}

Это всё, что нужно:

1. Определить функцию main()
2. Вызвать runApp() с корневым виджетом

Что делает runApp()?

runApp() инициализирует Flutter систему:

void main() {
  // runApp() выполняет:
  // 1. Инициализирует механизм виджетов
  // 2. Создаёт RenderView
  // 3. Запускает приложение в полноэкранном режиме
  // 4. Прикрепляет переданный виджет к экрану
  
  runApp(MyApp());
}

Типичная структура main()

void main() async {
  // Инициализация Firebase
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // Инициализация других сервисов
  setupServiceLocator();
  
  // Запуск приложения
  runApp(MyApp());
}

void setupServiceLocator() {
  getIt.registerSingleton<UserRepository>(UserRepositoryImpl());
  getIt.registerSingleton<UserService>(UserService(getIt()));
}

WidgetsFlutterBinding.ensureInitialized()

Это необходимо для инициализации асинхронных операций ДО запуска приложения:

void main() async {
  // ОБЯЗАТЕЛЬНО перед Firebase.initializeApp()
  WidgetsFlutterBinding.ensureInitialized();
  
  // Теперь можно использовать async операции
  await Firebase.initializeApp();
  await initLocalStorage();
  
  runApp(MyApp());
}

Инициализация Firebase

import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  
  runApp(MyApp());
}

Инициализация локального хранилища

import 'package:shared_preferences/shared_preferences.dart';
import 'package:hive/hive.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // SharedPreferences
  final prefs = await SharedPreferences.getInstance();
  getIt.registerSingleton(prefs);
  
  // Hive
  await Hive.initFlutter();
  await Hive.openBox('app_data');
  
  runApp(MyApp());
}

Инициализация логирования

import 'package:logger/logger.dart';

void main() {
  // Настроить логирование
  Logger.level = Level.debug;
  
  final logger = Logger();
  logger.i('App starting...');
  
  runApp(MyApp());
}

Обработка глобальных ошибок в main()

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Перехватываем необработанные Flutter ошибки
  FlutterError.onError = (FlutterErrorDetails details) {
    FlutterError.presentError(details);
    logError(details.exceptionAsString(), details.stack);
  };
  
  // Асинхронные ошибки
  PlatformDispatcher.instance.onError = (error, stack) {
    logError(error.toString(), stack);
    return true;
  };
  
  runApp(MyApp());
}

Отключение логотипа Debug в углу

void main() {
  runApp(
    MaterialApp(
      debugShowCheckedModeBanner: false,
      home: MyApp(),
    ),
  );
}

Полный пример с инициализацией

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:get_it/get_it.dart';
import 'package:logger/logger.dart';
import 'firebase_options.dart';

final getIt = GetIt.instance;
final logger = Logger();

void main() async {
  // Инициализируем binding перед асинхронными операциями
  WidgetsFlutterBinding.ensureInitialized();
  
  // Инициализируем Firebase
  logger.i('Initializing Firebase...');
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  
  // Инициализируем сервисы
  logger.i('Setting up services...');
  _setupServiceLocator();
  
  // Обрабатываем ошибки
  _setupErrorHandling();
  
  // Запускаем приложение
  logger.i('Starting app...');
  runApp(MyApp());
}

void _setupServiceLocator() {
  // Регистрируем зависимости
  getIt.registerSingleton(UserRepository());
  getIt.registerSingleton(UserService(getIt<UserRepository>()));
}

void _setupErrorHandling() {
  FlutterError.onError = (FlutterErrorDetails details) {
    FlutterError.presentError(details);
    logger.e(
      'Flutter Error',
      error: details.exception,
      stackTrace: details.stack,
    );
  };
  
  PlatformDispatcher.instance.onError = (error, stack) {
    logger.e(
      'Platform Error',
      error: error,
      stackTrace: stack,
    );
    return true;
  };
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'My App',
      theme: ThemeData(primarySwatch: Colors.blue),
      debugShowCheckedModeBanner: false,
      home: HomeScreen(),
    );
  }
}

Лучшие практики

1. Используй async/await для инициализации

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeApp();
  runApp(MyApp());
}

Future<void> initializeApp() async {
  await Firebase.initializeApp();
  await _loadConfiguration();
}

2. Создай отдельный файл для инициализации

// lib/main.dart
import 'config/app_config.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AppConfig.initialize();
  runApp(MyApp());
}

// lib/config/app_config.dart
class AppConfig {
  static Future<void> initialize() async {
    await Firebase.initializeApp();
    await _setupServices();
  }
}

3. Логируй инициализацию

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  logger.i('App initialization started');
  
  await Firebase.initializeApp();
  logger.i('Firebase initialized');
  
  _setupServiceLocator();
  logger.i('Services registered');
  
  logger.i('App starting...');
  runApp(MyApp());
}

4. Обрабатывай ошибки инициализации

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  try {
    await Firebase.initializeApp();
  } catch (e) {
    logger.e('Firebase init failed', error: e);
    // Приложение может работать без Firebase
  }
  
  runApp(MyApp());
}

Различия между runApp() и other alternatives

// Правильно — это main функция
void main() {
  runApp(MyApp());
}

// Неправильно — это НЕ entry point
class MyApp extends StatelessWidget {}

// Правильно — инициализация и runApp
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await setupAsync();
  runApp(MyApp());
}

Вывод: main() — это entry point приложения. Используй для инициализации Firebase, сервисов, обработки ошибок и вызова runApp(). Структурируй инициализацию через отдельные функции для читаемости.