This commit is contained in:
petrovyuri
2025-01-21 14:24:31 +03:00
parent e7b2c31e86
commit 17d096baac
96 changed files with 3575 additions and 0 deletions

89
lib/app/app.dart Normal file
View File

@@ -0,0 +1,89 @@
import 'package:flutter/material.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart';
import 'package:friflex_starter/app/app_context_ext.dart';
import 'package:friflex_starter/app/theme/app_theme.dart';
import 'package:friflex_starter/app/theme/theme_notifier.dart';
import 'package:friflex_starter/di/di_container.dart';
import 'package:friflex_starter/l10n/localization_notifier.dart';
import 'package:go_router/go_router.dart';
import 'package:provider/provider.dart';
/// Класс для реализации объекта приложения
class App extends StatelessWidget {
/// Создает экземпляр приложения
///
/// Принимает:
/// - [diContainer] - набор зависимостей приложения
/// - [router] - экземпляр роутера приложения
const App({
super.key,
required this.diContainer,
required this.router,
});
/// Набор зависимостей приложения
final DiContainer diContainer;
/// Экземпляр роутера приложения
final GoRouter router;
@override
Widget build(BuildContext context) {
return AppProviders(
diContainer: diContainer,
child: LocalizationConsumer(
builder: () => ThemeConsumer(
builder: () => _App(router: router),
),
),
);
}
}
/// Класс для реализации объекта приложения
class _App extends StatelessWidget {
const _App({required this.router});
final GoRouter router;
@override
Widget build(BuildContext context) {
return MaterialApp.router(
routerConfig: router,
darkTheme: AppTheme.dark,
theme: AppTheme.light,
themeMode: context.theme.themeMode,
locale: context.localization.locale,
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
);
}
}
/// Класс для реализации провайдеров приложения
final class AppProviders extends StatelessWidget {
const AppProviders({
super.key,
required this.child,
required this.diContainer,
});
final Widget child;
final DiContainer diContainer;
@override
Widget build(BuildContext context) {
return MultiProvider(
providers: [
Provider.value(value: diContainer), // Передаем контейнер зависимостей
ChangeNotifierProvider(
create: (_) => ThemeNotifier(),
), // Провайдер для темы
ChangeNotifierProvider(
create: (_) => LocalizationNotifier(),
), // Провайдер для локализации
],
child: child,
);
}
}

View File

@@ -0,0 +1,59 @@
import 'package:envied/envied.dart';
import 'package:friflex_starter/app/app_config/i_app_config.dart';
import 'package:friflex_starter/app/app_env.dart';
part 'app_config.g.dart';
/// Класс для реализации конфигурации с моковыми данными
@Envied(name: 'Dev', path: 'env/dev.env')
class AppConfigDev implements IAppConfig {
@override
AppEnv get env => AppEnv.dev;
@override
String get name => 'AppConfigDev';
@override
@EnviedField()
final String baseUrl = _Dev.baseUrl;
@override
@EnviedField(obfuscate: true)
final String secretKey = _Dev.secretKey;
}
/// Класс для реализации конфигурации с продакшн данными
@Envied(name: 'Prod', path: 'env/prod.env')
class AppConfigProd implements IAppConfig {
@override
AppEnv get env => AppEnv.prod;
@override
String get name => 'AppConfigProd';
@override
@EnviedField(obfuscate: true)
final String baseUrl = _Prod.baseUrl;
@override
@EnviedField(obfuscate: true)
final String secretKey = _Prod.secretKey;
}
/// Класс для реализации конфигурации с стейдж данными
@Envied(name: 'Stage', path: 'env/stage.env')
class AppConfigStage implements IAppConfig {
@override
AppEnv get env => AppEnv.stage;
@override
String get name => 'AppConfigStage';
@override
@EnviedField(obfuscate: true)
final String baseUrl = _Stage.baseUrl;
@override
@EnviedField(obfuscate: true)
final String secretKey = _Stage.secretKey;
}

View File

@@ -0,0 +1,158 @@
// GENERATED CODE - DO NOT MODIFY BY HAND
part of 'app_config.dart';
// **************************************************************************
// EnviedGenerator
// **************************************************************************
// coverage:ignore-file
// ignore_for_file: type=lint
// generated_from: env/dev.env
final class _Dev {
static const String baseUrl = 'https://dev';
static const List<int> _enviedkeysecretKey = <int>[
45820206,
4292305074,
1553598735,
];
static const List<int> _envieddatasecretKey = <int>[
45820234,
4292305111,
1553598841,
];
static final String secretKey = String.fromCharCodes(List<int>.generate(
_envieddatasecretKey.length,
(int i) => i,
growable: false,
).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]));
}
// coverage:ignore-file
// ignore_for_file: type=lint
// generated_from: env/prod.env
final class _Prod {
static const List<int> _enviedkeybaseUrl = <int>[
3619294633,
560029786,
3178585068,
3377720392,
977735066,
2142081055,
1298585806,
933917938,
1244996901,
1950368931,
2147265964,
2338251746,
];
static const List<int> _envieddatabaseUrl = <int>[
3619294657,
560029742,
3178584984,
3377720376,
977735145,
2142081061,
1298585825,
933917917,
1244996949,
1950368977,
2147265987,
2338251654,
];
static final String baseUrl = String.fromCharCodes(List<int>.generate(
_envieddatabaseUrl.length,
(int i) => i,
growable: false,
).map((int i) => _envieddatabaseUrl[i] ^ _enviedkeybaseUrl[i]));
static const List<int> _enviedkeysecretKey = <int>[
2449171331,
2315988352,
1037757119,
3159274193,
];
static const List<int> _envieddatasecretKey = <int>[
2449171443,
2315988466,
1037757136,
3159274165,
];
static final String secretKey = String.fromCharCodes(List<int>.generate(
_envieddatasecretKey.length,
(int i) => i,
growable: false,
).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]));
}
// coverage:ignore-file
// ignore_for_file: type=lint
// generated_from: env/stage.env
final class _Stage {
static const List<int> _enviedkeybaseUrl = <int>[
443716089,
3928907238,
1851881210,
3858110087,
3324475128,
1601592105,
2404110281,
1092690431,
1025677374,
3283672546,
425122182,
3412521909,
1297182020,
];
static const List<int> _envieddatabaseUrl = <int>[
443715985,
3928907154,
1851881102,
3858110199,
3324475019,
1601592083,
2404110310,
1092690384,
1025677389,
3283672470,
425122279,
3412521938,
1297181985,
];
static final String baseUrl = String.fromCharCodes(List<int>.generate(
_envieddatabaseUrl.length,
(int i) => i,
growable: false,
).map((int i) => _envieddatabaseUrl[i] ^ _enviedkeybaseUrl[i]));
static const List<int> _enviedkeysecretKey = <int>[
58874248,
3497500657,
3833421599,
555777488,
132619188,
];
static const List<int> _envieddatasecretKey = <int>[
58874363,
3497500549,
3833421694,
555777463,
132619217,
];
static final String secretKey = String.fromCharCodes(List<int>.generate(
_envieddatasecretKey.length,
(int i) => i,
growable: false,
).map((int i) => _envieddatasecretKey[i] ^ _enviedkeysecretKey[i]));
}

View File

@@ -0,0 +1,16 @@
import 'package:friflex_starter/app/app_env.dart';
/// Класс для описания интерфейса конфигурации
abstract interface class IAppConfig {
/// Наименование сервиса
String get name => 'IAppConfig';
/// Основной адрес для запросов к API
String get baseUrl;
/// Тип окружения
AppEnv get env;
/// Секретный ключ для шифрования данных
String get secretKey;
}

View File

@@ -0,0 +1,24 @@
import 'package:flutter/material.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart';
import 'package:friflex_starter/app/theme/theme_notifier.dart';
import 'package:friflex_starter/di/di_container.dart';
import 'package:friflex_starter/l10n/localization_notifier.dart';
import 'package:provider/provider.dart';
/// Класс, реализующий расширение для контекста приложения
extension AppContextExt on BuildContext {
/// Метод для получения экземпляра DIContainer
DiContainer get di => read<DiContainer>();
/// Геттер для получения цветовой схемы
ColorScheme get colors => Theme.of(this).colorScheme;
/// Геттер для получения темы
ThemeNotifier get theme => read<ThemeNotifier>();
/// Геттер для получения локализации
AppLocalizations get l10n => AppLocalizations.of(this)!;
/// Геттер для получения управления локализацией
LocalizationNotifier get localization => read<LocalizationNotifier>();
}

12
lib/app/app_env.dart Normal file
View File

@@ -0,0 +1,12 @@
/// Перечислимый тип окружений сборки
enum AppEnv {
/// Тестовое окружение (моковое)
dev,
/// Стейдж окружение (тестовое окружение, которое имеет возможность
/// как обращаться в сеть, так и использовать моковые данные)
stage,
/// Продакшен окружение
prod,
}

View File

@@ -0,0 +1,146 @@
import 'package:dio/dio.dart';
import 'package:friflex_starter/app/app_config/i_app_config.dart';
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/app/http/i_http_client.dart';
import 'package:friflex_starter/features/debug/i_debug_service.dart';
/// Класс для реализации HTTP-клиента для управления запросами
final class AppHttpClient implements IHttpClient {
/// Создает HTTP клиент
///
/// Принимает:
/// - [debugService] - сервис для логирования запросов
/// - [appConfig] - конфигурация приложения
AppHttpClient({
required IDebugService debugService,
required IAppConfig appConfig,
}) {
_httpClient = Dio();
_appConfig = appConfig;
_httpClient.options
..baseUrl = appConfig.baseUrl
..connectTimeout = const Duration(seconds: 5)
..sendTimeout = const Duration(seconds: 7)
..receiveTimeout = const Duration(seconds: 10)
..headers = {
'Content-Type': 'application/json',
};
// Добавление интерцептора для логирования запросов
if (appConfig.env != AppEnv.prod) {
final interceptor = debugService.createHttpInterceptor();
if (interceptor is Interceptor) {
_httpClient.interceptors.add(interceptor);
}
}
}
/// Конфигурация приложения
late final IAppConfig _appConfig;
/// Экземпляр HTTP клиента
late final Dio _httpClient;
@override
Future<Response> get(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
}) async {
_httpClient.options.baseUrl = _appConfig.baseUrl;
return _httpClient.get(
path,
data: data,
queryParameters: queryParameters,
options: options,
);
}
@override
Future<Response> post(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
}) async {
_httpClient.options.baseUrl = _appConfig.baseUrl;
return _httpClient.post(
path,
data: data,
queryParameters: queryParameters,
options: options,
);
}
@override
Future<Response> patch(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
}) async {
_httpClient.options.baseUrl = _appConfig.baseUrl;
return _httpClient.patch(
path,
data: data,
queryParameters: queryParameters,
options: options,
);
}
@override
Future<Response> put(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
}) async {
_httpClient.options.baseUrl = _appConfig.baseUrl;
return _httpClient.put(
path,
data: data,
queryParameters: queryParameters,
options: options,
);
}
@override
Future<Response> delete(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
}) async {
_httpClient.options.baseUrl = _appConfig.baseUrl;
return _httpClient.delete(
path,
data: data,
queryParameters: queryParameters,
options: options,
);
}
@override
Future<Response> head(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
}) async {
_httpClient.options.baseUrl = _appConfig.baseUrl;
return _httpClient.head(
path,
data: data,
queryParameters: queryParameters,
options: options,
);
}
}

View File

@@ -0,0 +1,94 @@
import 'package:dio/dio.dart';
/// Класс для описания интерфейса сервиса по управлению HTTP запросами
abstract interface class IHttpClient {
/// Описывает поля HTTP клиента
const IHttpClient();
/// Наименование сервиса
static const name = 'IHttpClient';
/// Метод для реализации запроса GET
///
/// Принимает:
/// - [path] - путь к ресурсу
/// - [data] - тело запроса
/// - [queryParameters] - параметры запроса
/// - [options] - конфигурация запроса
Future<Response> get(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
});
/// Метод для реализации запроса POST
///
/// Принимает:
/// - [path] - путь к ресурсу
/// - [data] - тело запроса
/// - [queryParameters] - параметры запроса
/// - [options] - конфигурация запроса
Future<Response> post(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
});
/// Метод для реализации запроса PATCH
///
/// Принимает:
/// - [path] - путь к ресурсу
/// - [data] - тело запроса
/// - [queryParameters] - параметры запроса
/// - [options] - конфигурация запроса
Future<Response> patch(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
});
/// Метод для реализации запроса PUT
///
/// Принимает:
/// - [path] - путь к ресурсу
/// - [data] - тело запроса
/// - [queryParameters] - параметры запроса
/// - [options] - конфигурация запроса
Future<Response> put(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
});
/// Метод для реализации запроса DELETE
///
/// Принимает:
/// - [path] - путь к ресурсу
/// - [data] - тело запроса
/// - [queryParameters] - параметры запроса
/// - [options] - конфигурация запроса
Future<Response> delete(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
});
/// Метод для реализации запроса POST
///
/// Принимает:
/// - [path] - путь к ресурсу
/// - [data] - тело запроса
/// - [queryParameters] - параметры запроса
/// - [options] - конфигурация запроса
Future<Response> head(
String path, {
Object? data,
Map<String, dynamic>? queryParameters,
Options? options,
});
}

View File

@@ -0,0 +1,9 @@
import 'package:flutter/material.dart';
/// Класс, реализующий расширение для добавления токенов в цветовую схему
extension AppColorsScheme on ColorScheme {
bool get _isDark => brightness == Brightness.dark;
// Тестовый цвет
Color get testColor => _isDark ? Colors.green : Colors.red;
}

View File

@@ -0,0 +1,10 @@
import 'package:flutter/material.dart';
/// Класс для конфигурации светлой/темной темы приложения
abstract class AppTheme {
/// Геттер для получения светлой темы
static ThemeData get light => ThemeData.light();
/// Геттер для получения темной темы
static ThemeData get dark => ThemeData.dark();
}

View File

@@ -0,0 +1,33 @@
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
typedef ThemeBuilder = Widget Function();
/// Виджет для подписки на изменение темы приложения
class ThemeConsumer extends StatelessWidget {
const ThemeConsumer({super.key, required this.builder});
final ThemeBuilder builder;
@override
Widget build(BuildContext context) {
return Consumer<ThemeNotifier>(
builder: (_, __, ___) {
return builder();
},
);
}
}
/// Класс для управления темой приложения
final class ThemeNotifier extends ChangeNotifier {
ThemeMode _themeMode = ThemeMode.system;
ThemeMode get themeMode => _themeMode;
void changeTheme() {
_themeMode =
_themeMode == ThemeMode.light ? ThemeMode.dark : ThemeMode.light;
notifyListeners();
}
}

6
lib/di/di_base_repo.dart Normal file
View File

@@ -0,0 +1,6 @@
/// Миксин репозитория в приложении.
/// Каждый интерфейс репозитория в приложении должен подмешивать текущий класс
mixin class DiBaseRepo {
/// Наименование репозитория
String get name => 'DiBaseRepo';
}

103
lib/di/di_container.dart Normal file
View File

@@ -0,0 +1,103 @@
import 'package:app_services/app_services.dart';
import 'package:friflex_starter/app/app_config/app_config.dart';
import 'package:friflex_starter/app/app_config/i_app_config.dart';
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/app/http/app_http_client.dart';
import 'package:friflex_starter/app/http/i_http_client.dart';
import 'package:friflex_starter/di/di_repositories.dart';
import 'package:friflex_starter/di/di_typedefs.dart';
import 'package:friflex_starter/features/debug/i_debug_service.dart';
import 'package:i_app_services/i_app_services.dart';
/// {@template dependencies_container}
/// Контейнер для зависимостей
/// {@macro composition_process}
/// {@endtemplate}
final class DiContainer {
/// {@macro dependencies_container}
DiContainer({required this.env, required IDebugService dService})
: debugService = dService;
final AppEnv env;
/// Сервис для отладки, получаем из конструктора
late final IDebugService debugService;
/// Сервис для работы с путями
late final IPathProvider pathProvider;
/// Конфигурация приложения
late final IAppConfig appConfig;
/// Сервис для работы с локальным хранилищем
late final ISecureStorage secureStorage;
/// Сервис для работы с HTTP запросами
late final IHttpClient httpClient;
late final DiRepositories repositories;
/// Метод для инициализации зависимостей
Future<void> init({
required OnProgress onProgress,
required OnComplete onComplete,
required OnError onError,
}) async {
// Инициализация сервисов
await _initServices(
onComplete: onComplete,
onError: onError,
onProgress: onProgress,
);
// Инициализация репозиториев
repositories = DiRepositories();
repositories.init(
onProgress: onProgress,
onComplete: onComplete,
onError: onError,
diContainer: this,
);
onComplete('Инициализация зависимостей завершена!');
}
/// Метод для инициализации сервисов
Future<void> _initServices({
required OnComplete onComplete,
required OnError onError,
required OnProgress onProgress,
}) async {
appConfig = switch (env) {
AppEnv.dev => AppConfigDev(),
AppEnv.prod => AppConfigProd(),
AppEnv.stage => AppConfigStage()
};
httpClient = AppHttpClient(
debugService: debugService,
appConfig: appConfig,
);
try {
pathProvider = AppPathProvider();
onProgress(AppPathProvider.name);
} on Object catch (error, stackTrace) {
onError(
'Ошибка инициализации ${IPathProvider.name}',
error: error,
stackTrace: stackTrace,
);
}
try {
secureStorage = AppSecureStorage(secretKey: appConfig.secretKey);
onProgress(AppSecureStorage.name);
} on Object catch (error, stackTrace) {
onError(
'Ошибка инициализации ${ISecureStorage.name}',
error: error,
stackTrace: stackTrace,
);
}
}
}

115
lib/di/di_repositories.dart Normal file
View File

@@ -0,0 +1,115 @@
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/di/di_base_repo.dart';
import 'package:friflex_starter/di/di_container.dart';
import 'package:friflex_starter/di/di_typedefs.dart';
import 'package:friflex_starter/features/auth/data/repository/auth_mock_repository.dart';
import 'package:friflex_starter/features/auth/data/repository/auth_repository.dart';
import 'package:friflex_starter/features/auth/domain/repository/i_auth_repository.dart';
import 'package:friflex_starter/features/main/data/repository/main_mock_repository.dart';
import 'package:friflex_starter/features/main/data/repository/main_repository.dart';
import 'package:friflex_starter/features/main/domain/repository/i_main_repository.dart';
/// Список названий моковых репозиториев, которые должны быть подменены
/// для использования в сборке stage окружения
///
/// Для того, чтобы репозиторий был автоматически подменен на моковый в stage
/// сборке, необходимо в этом списке указать название мокового репозитория,
/// обращаясь к соответствующему полю name.
///
/// Пример:
/// ```
/// [ AuthCheckRepositoryMock().name, ]
/// ```
final List<String> _mockReposToSwitch = [];
/// Класс для инициализации репозиториев в приложении
///
/// По умолчанию репозиторию присваивается моковая реализация.
/// В зависимости от окружения либо выполняется подмена репозиторий,
/// либо используется моковый.
final class DiRepositories {
/// Интерфейс для работы с репозиторием авторизации
late final IAuthRepository authRepository;
/// Интерфейс для работы с репозиторием главного сервиса
late final IMainRepository mainRepository;
/// Метод для инициализации репозиториев в приложении
///
/// Принимает:
/// - [onProgress] - обратный вызов при прогрессе
/// - [onComplete] - обратный вызов при успешной инициализации
/// - [diContainer] - контейнер зависимостей
void init({
required OnProgress onProgress,
required OnComplete onComplete,
required OnError onError,
required DiContainer diContainer,
}) {
try {
//Инициализация репозитория авторизации
authRepository = lazyInitRepo<IAuthRepository>(
mockFactory: AuthMockRepository.new,
mainFactory: () => AuthRepository(
httpClient: diContainer.httpClient,
),
onProgress: onProgress,
environment: diContainer.env,
);
onProgress(authRepository.name);
} on Object catch (error, stackTrace) {
onError(
'Ошибка инициализации репозитория $IAuthRepository',
error: error,
stackTrace: stackTrace,
);
}
try {
// Инициализация репозитория сервиса управления токеном доступа
mainRepository = lazyInitRepo<IMainRepository>(
mockFactory: MainMockRepository.new,
mainFactory: () => MainRepository(
httpClient: diContainer.httpClient,
),
onProgress: onProgress,
environment: diContainer.env,
);
onProgress(mainRepository.name);
} on Object catch (error, stackTrace) {
onError(
'Ошибка инициализации репозитория $IMainRepository',
error: error,
stackTrace: stackTrace,
);
}
onComplete(
'Инициализация репозиториев завершена! Было подменено репозиториев - ${_mockReposToSwitch.length} (${_mockReposToSwitch.join(', ')})',
);
}
/// Метод для ленивой инициализации конкретного репозитория по типу [Т].
/// В зависимости от окружения инициализируется моковый или сетевой репозиторий.
///
/// Принимает:
/// - [mockFactory] - функция - фабрика для инициализации репозитория для управления моковыми запросами
/// - [mainFactory] - функция - фабрика для инициализации основного репозиторий
/// - [onProgress] - обратный вызов при прогрессе
T lazyInitRepo<T extends DiBaseRepo>({
required AppEnv environment,
required T Function() mainFactory,
required T Function() mockFactory,
required OnProgress onProgress,
}) {
final repo = switch (environment) {
AppEnv.dev => mockFactory(),
AppEnv.prod => mainFactory(),
AppEnv.stage => _mockReposToSwitch.contains(mockFactory().name)
? mockFactory()
: mainFactory(),
};
onProgress(repo.name);
return repo;
}
}

12
lib/di/di_typedefs.dart Normal file
View File

@@ -0,0 +1,12 @@
/// Обратный вызов при ошибки инициализации
typedef OnError = void Function(
String message, {
Object? error,
StackTrace? stackTrace,
});
/// Обратный вызов при прогрессе
typedef OnProgress = void Function(String name);
/// Обратный вызов при успешной инициализации
typedef OnComplete = void Function(String msg);

View File

@@ -0,0 +1,9 @@
import '../../domain/repository/i_auth_repository.dart';
/// {@template AuthMockRepository}
///
/// {@endtemplate}
final class AuthMockRepository implements IAuthRepository {
@override
String get name => 'AuthMockRepository';
}

View File

@@ -0,0 +1,15 @@
import 'package:friflex_starter/app/http/i_http_client.dart';
import '../../domain/repository/i_auth_repository.dart';
/// {@template AuthRepository}
///
/// {@endtemplate}
final class AuthRepository implements IAuthRepository {
final IHttpClient httpClient;
AuthRepository({required this.httpClient});
@override
String get name => 'AuthRepository';
}

View File

@@ -0,0 +1,6 @@
import 'package:friflex_starter/di/di_base_repo.dart';
/// {@template IAuthRepository}
///
/// {@endtemplate}
abstract interface class IAuthRepository with DiBaseRepo {}

View File

@@ -0,0 +1,21 @@
import 'package:flutter/material.dart';
/// {@template AuthScreen}
///
/// {@endtemplate}
class AuthScreen extends StatelessWidget {
/// {@macro AuthScreen}
const AuthScreen({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text('AuthScreen'),
),
body: const Center(
child: Text('AuthScreen'),
),
);
}
}

View File

@@ -0,0 +1,60 @@
import 'package:flutter/material.dart';
import 'package:friflex_starter/features/debug/i_debug_service.dart';
import 'package:talker_bloc_logger/talker_bloc_logger.dart';
import 'package:talker_dio_logger/talker_dio_logger_interceptor.dart';
import 'package:talker_flutter/talker_flutter.dart';
/// Класс реализации интерфейса дебаг сервиса
class AppDebugService implements IDebugService {
/// Наименование сервиса
static const name = 'GmsDebugService';
final Talker _talker = TalkerFlutter.init();
@override
TalkerBlocObserver createBlocObserver() =>
TalkerBlocObserver(talker: _talker);
@override
TalkerDioLogger createHttpInterceptor() => TalkerDioLogger(talker: _talker);
@override
TalkerRouteObserver createRouterObserver() => TalkerRouteObserver(_talker);
@override
void error(String msg, [Object? exception, StackTrace? stackTrace]) {
_talker.error(msg, exception, stackTrace);
}
@override
void handleError(Object error, [StackTrace? stackTrace, String? message]) {
_talker.handle(error, stackTrace, message);
}
@override
void info(String message) {
_talker.info(message);
}
@override
void log(String message) {
_talker.log(message);
}
@override
void warning(String message) {
_talker.warning(message);
}
@override
Future<T?> openDebugScreen<T>(
BuildContext context, {
bool useRootNavigator = false,
}) {
return Navigator.of(context).push<T>(
MaterialPageRoute(
builder: (context) => TalkerScreen(talker: _talker),
),
);
}
}

View File

@@ -0,0 +1,32 @@
import 'package:flutter/widgets.dart';
import 'package:friflex_starter/features/debug/debug_screen.dart';
import 'package:go_router/go_router.dart';
abstract final class DebugRoutes {
/// Название роута страницы профиля пользователя
static const String debugScreenName = 'debug_screen';
/// Путь роута страницы профиля пользователя
static const String _debugScreenPath = '/debug';
/// Метод для построения ветки роутов по фиче профиля пользователя
///
/// Принимает:
/// - [routes] - вложенные роуты
static StatefulShellBranch buildShellBranch({
List<RouteBase> routes = const [],
List<NavigatorObserver>? observers,
}) =>
StatefulShellBranch(
initialLocation: _debugScreenPath,
observers: observers,
routes: [
GoRoute(
path: _debugScreenPath,
name: debugScreenName,
builder: (context, state) => const DebugScreen(),
routes: routes,
),
],
);
}

View File

@@ -0,0 +1,45 @@
import 'package:flutter/material.dart';
import 'package:friflex_starter/app/app_context_ext.dart';
class DebugScreen extends StatelessWidget {
const DebugScreen({Key? key}) : super(key: key);
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('Debug Screen')),
body: Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
ElevatedButton(
onPressed: () {
throw Exception(
'Тестовая ошибка Exception для отладки FlutterError',);
},
child: const Text('Вызывать ошибку FlutterError'),
),
const SizedBox(height: 16),
ElevatedButton(
onPressed: () async {
await callError();
},
child: const Text('Вызывать ошибку PlatformDispatcher'),
),
const SizedBox(height: 16),
ElevatedButton(
onPressed: () async {
await context.di.debugService.openDebugScreen(context);
},
child: const Text('Вызывать Talker'),
),
],
),
),
);
}
Future<void> callError() async {
throw Exception('Тестовая ошибка Exception для отладки PlatformDispatcher');
}
}

View File

@@ -0,0 +1,60 @@
import 'package:flutter/material.dart';
/// Интерфейс для сервиса отладки
abstract interface class IDebugService {
/// Наименование сервиса
static const name = 'IDebugService';
/// Метод для создания обработчика для BLoC
Object createBlocObserver();
/// Метод для создания обработчика для роутера
NavigatorObserver createRouterObserver();
/// Метод для создания обработчика для http-клиентов
Object createHttpInterceptor();
/// Метод для логгирования предупреждений
///
/// Принимает:
/// - [message] - сообщение для логгирования в формате [String]
void warning(String message);
/// Метод для логгирования ошибок
///
/// Принимает:
/// - [message] - сообщение для логгирования в формате [String]
/// - [exception] - исключение
/// - [stackTrace] - стек вызова
void error(String message, [Object? exception, StackTrace? stackTrace]);
/// Метод для обработки ошибок
///
/// Принимает:
/// - [error] - исключение
/// - [stackTrace] - стек вызова
/// - [message] - сообщение для логгирования в формате [String]
void handleError(Object error, [StackTrace? stackTrace, String? message]);
/// Метод для логгирования информативных сообщений
///
/// Принимает:
/// - [message] - сообщение для логгирования в формате [String]
void info(String message);
/// Метод для логгирования сообщений
///
/// Принимает:
/// - [message] - сообщение для логгирования в формате [String]
void log(String message);
/// Метод для открытия окна отладки
///
/// Принимает:
/// - [context] - для определения навигатора по нему
/// - [useRootNavigator] - при true, открывает окно в корневом навигаторе
Future<T?> openDebugScreen<T>(
BuildContext context, {
bool useRootNavigator = false,
});
}

View File

@@ -0,0 +1,23 @@
import 'package:flutter/material.dart';
/// {@template ErrorScreen}
/// Экран, когда в приложении произошла фатальная ошибка
/// {@endtemplate}
class ErrorScreen extends StatelessWidget {
/// {@macro ErrorScreen}
const ErrorScreen({super.key});
@override
Widget build(BuildContext context) {
return const MaterialApp(
home: Scaffold(
body: Center(
child: Text(
'Что-то пошло не так, попробуйте перезагрузить приложение',
textAlign: TextAlign.center,
),
),
),
);
}
}

View File

@@ -0,0 +1,9 @@
import '../../domain/repository/i_main_repository.dart';
/// {@template MainMockRepository}
///
/// {@endtemplate}
final class MainMockRepository implements IMainRepository {
@override
String get name => 'MainMockRepository';
}

View File

@@ -0,0 +1,15 @@
import 'package:friflex_starter/app/http/i_http_client.dart';
import '../../domain/repository/i_main_repository.dart';
/// {@template MainRepository}
///
/// {@endtemplate}
final class MainRepository implements IMainRepository {
final IHttpClient httpClient;
MainRepository({required this.httpClient});
@override
String get name => 'MainRepository';
}

View File

@@ -0,0 +1,6 @@
import 'package:friflex_starter/di/di_base_repo.dart';
/// {@template IMainRepository}
///
/// {@endtemplate}
abstract interface class IMainRepository with DiBaseRepo{}

View File

@@ -0,0 +1,32 @@
import 'package:flutter/widgets.dart';
import 'package:friflex_starter/features/main/presentation/screens/main_screen.dart';
import 'package:go_router/go_router.dart';
abstract final class MainRoutes {
/// Название роута главной страницы
static const String mainScreenName = 'main_screen';
/// Путь роута страницы профиля пользователя
static const String _mainScreenPath = '/main';
/// Метод для построения ветки роутов по фиче профиля пользователя
///
/// Принимает:
/// - [routes] - вложенные роуты
static StatefulShellBranch buildShellBranch({
List<RouteBase> routes = const [],
List<NavigatorObserver>? observers,
}) =>
StatefulShellBranch(
initialLocation: _mainScreenPath,
observers: observers,
routes: [
GoRoute(
path: _mainScreenPath,
name: mainScreenName,
builder: (context, state) => const MainScreen(),
routes: routes,
),
],
);
}

View File

@@ -0,0 +1,73 @@
import 'package:flutter/material.dart';
import 'package:friflex_starter/app/app_context_ext.dart';
import 'package:friflex_starter/app/theme/app_colors_scheme.dart';
class MainScreen extends StatelessWidget {
const MainScreen({super.key});
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: const Text('Main Screen'),
),
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
const SizedBox(height: 16),
Text(
'Окружение: ${context.di.appConfig.env.name}',
),
const SizedBox(height: 16),
ElevatedButton(
onPressed: () {
context.theme.changeTheme();
},
child: const Text('Сменить тему'),
),
const SizedBox(height: 16),
ColoredBox(
color: context.colors.testColor,
child: const SizedBox(height: 100, width: 100),
),
const SizedBox(height: 16),
Text(
'Текущая тема: ${context.theme.themeMode}',
),
const SizedBox(height: 16),
Text(
'Текущий репозиторий: ${context.di.repositories.authRepository.name}',
),
const SizedBox(height: 16),
ElevatedButton(
onPressed: () {
context.localization.changeLocal(
const Locale('ru', 'RU'),
);
},
child: const Text('Сменить язык на Rусский'),
),
const SizedBox(height: 16),
ElevatedButton(
onPressed: () {
context.localization.changeLocal(
const Locale('en', 'EN'),
);
},
child: const Text('Сменить язык на Английский'),
),
const SizedBox(height: 16),
Text(
'Тестовое слово: ${context.l10n.helloWorld}',
),
const SizedBox(height: 16),
Text(
'Текущий язык: ${context.l10n.localeName}',
),
],
),
),
);
}
}

View File

@@ -0,0 +1,32 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
/// Класс для реализации корневой страницы приложения
class RootScreen extends StatelessWidget {
/// Создает корневую страницу приложения
///
/// Принимает:
/// - [navigationShell] - текущая ветка навигации
const RootScreen({
super.key,
required this.navigationShell,
});
/// Текущая ветка навигации
final StatefulNavigationShell navigationShell;
@override
Widget build(BuildContext context) {
return Scaffold(
body: navigationShell,
bottomNavigationBar: BottomNavigationBar(
items: const <BottomNavigationBarItem>[
BottomNavigationBarItem(icon: Icon(Icons.home), label: 'Home'),
BottomNavigationBarItem(icon: Icon(Icons.bug_report), label: 'Debug'),
],
currentIndex: navigationShell.currentIndex,
onTap: navigationShell.goBranch,
),
);
}
}

6
lib/l10n/app_en.arb Normal file
View File

@@ -0,0 +1,6 @@
{
"helloWorld": "Hello World!",
"@helloWorld": {
"description": "The conventional newborn programmer greeting"
}
}

6
lib/l10n/app_ru.arb Normal file
View File

@@ -0,0 +1,6 @@
{
"helloWorld": "Привет, мир!",
"@helloWorld": {
"description": "Обычное приветствие новичка-программиста"
}
}

View File

@@ -0,0 +1,32 @@
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
typedef LocalizationBuilder = Widget Function();
/// Виджет для перестройки виджета в зависимости от локализации
class LocalizationConsumer extends StatelessWidget {
const LocalizationConsumer({super.key, required this.builder});
final LocalizationBuilder builder;
@override
Widget build(BuildContext context) {
return Consumer<LocalizationNotifier>(
builder: (_, __, ___) {
return builder();
},
);
}
}
/// Класс для управления локализацией
final class LocalizationNotifier extends ChangeNotifier {
Locale _locale = const Locale('en', 'US');
Locale get locale => _locale;
void changeLocal(Locale locale) {
_locale = locale;
notifyListeners();
}
}

4
lib/main.dart Normal file
View File

@@ -0,0 +1,4 @@
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/runner/app_runner.dart';
void main() => AppRunner(AppEnv.prod).run();

View File

@@ -0,0 +1,41 @@
import 'package:flutter/cupertino.dart';
import 'package:friflex_starter/features/debug/debug_routes.dart';
import 'package:friflex_starter/features/debug/i_debug_service.dart';
import 'package:friflex_starter/features/main/presentation/main_routes.dart';
import 'package:friflex_starter/features/root/root_screen.dart';
import 'package:go_router/go_router.dart';
/// Класс, реализующий роутер приложения и все поля классов
class AppRouter {
/// Конструктор для инициализации роутера
const AppRouter();
/// Ключ для доступа к корневому навигатору приложения
static final rootNavigatorKey = GlobalKey<NavigatorState>();
/// Начальный роут приложения
static String get initialLocation => '/main';
/// Метод для создания экземпляра GoRouter
static GoRouter createRouter(IDebugService debugService) {
return GoRouter(
navigatorKey: rootNavigatorKey,
debugLogDiagnostics: true,
initialLocation: initialLocation,
observers: [
debugService.createRouterObserver(),
],
routes: [
StatefulShellRoute.indexedStack(
parentNavigatorKey: rootNavigatorKey,
builder: (context, state, navigationShell) =>
RootScreen(navigationShell: navigationShell),
branches: [
MainRoutes.buildShellBranch(),
DebugRoutes.buildShellBranch(),
],
),
],
);
}
}

107
lib/runner/app_runner.dart Normal file
View File

@@ -0,0 +1,107 @@
import 'dart:async';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:friflex_starter/app/app.dart';
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/di/di_container.dart';
import 'package:friflex_starter/features/debug/app_debug_service.dart';
import 'package:friflex_starter/features/debug/i_debug_service.dart';
import 'package:friflex_starter/features/error/error_screen.dart';
import 'package:friflex_starter/router/app_router.dart';
import 'package:friflex_starter/runner/timer_runner.dart';
import 'package:go_router/go_router.dart';
part 'errors_handlers.dart';
/// Класс, реализующий раннер для конфигурирования приложения при запуске
///
/// Порядок инициализации:
/// 1. _initApp - инициализация конфигурации приложения
/// 2. инициализация репозиториев приложения (будет позже)
/// 3. runApp - запуск приложения
/// 4. _onAppLoaded - после запуска приложения
class AppRunner {
/// Создает экземпляр раннера приложения
///
/// Принимает:
/// - [env] - тип окружения сборки приложения
AppRunner(this.env);
/// Тип окружения сборки приложения¬
final AppEnv env;
/// Контейнер зависимостей приложения
late final IDebugService _debugService;
/// Роутер приложения
late final GoRouter router;
/// Таймер для отслеживания времени инициализации приложения
late final TimerRunner _timerRunner;
/// Метод для запуска приложения
Future<void> run() async {
WidgetsFlutterBinding.ensureInitialized();
// Инициализация сервиса отладки
_debugService = AppDebugService();
_timerRunner = TimerRunner(_debugService);
// Инициализация приложения
await _initApp();
// Инициализация метода обработки ошибок
_initErrorHandlers(_debugService);
// Инициализация репозиториев и сервисов
final diContainer = await _initDependencies(_debugService);
// Инициализация роутера
router = AppRouter.createRouter(_debugService);
runApp(
App(diContainer: diContainer, router: router),
);
await _onAppLoaded();
}
/// Метод инициализации приложения,
/// выполняется до запуска приложения
Future<void> _initApp() async {
// Запрет на поворот экрана
await SystemChrome.setPreferredOrientations(
[DeviceOrientation.portraitUp],
);
// Заморозка первого кадра (сплеш)
WidgetsBinding.instance.deferFirstFrame();
}
/// Метод срабатывает после запуска приложения
Future<void> _onAppLoaded() async {
// Разморозка первого кадра (сплеш)
WidgetsBinding.instance.addPostFrameCallback((_) {
WidgetsBinding.instance.allowFirstFrame();
});
_timerRunner.stop();
}
/// Метод для инициализации зависимостей приложения
Future<DiContainer> _initDependencies(IDebugService debugService) async {
debugService.log('Тип сборки: ${env.name}');
final diContainer = DiContainer(
env: env,
dService: debugService,
);
await diContainer.init(
onProgress: _timerRunner.logOnProgress,
onComplete: _timerRunner.logOnComplete,
onError: _timerRunner.logOnError,
);
return diContainer;
}
}

View File

@@ -0,0 +1,27 @@
part of 'app_runner.dart';
/// Метод инициализации обработчиков ошибок
void _initErrorHandlers(IDebugService debugService) {
// Обработка ошибок в приложении
FlutterError.onError = (details) {
_showErrorScreen();
debugService.handleError(details.exception, details.stack,
'FlutterError.onError: ${details.exceptionAsString()}',);
};
// Обработка асинхронных ошибок в приложении
PlatformDispatcher.instance.onError = (error, stack) {
_showErrorScreen();
debugService.handleError(error, stack, 'PlatformDispatcher: $error');
return true;
};
}
/// Метод для показа экрана ошибки
void _showErrorScreen() {
WidgetsBinding.instance.addPostFrameCallback((_) {
AppRouter.rootNavigatorKey.currentState?.push(
MaterialPageRoute(
builder: (_) => const ErrorScreen(),
),
);
});
}

View File

@@ -0,0 +1,49 @@
import 'package:friflex_starter/features/debug/i_debug_service.dart';
/// {@template TimerRunner}
/// Класс для подсчета времени запуска приложения
/// {@endtemplate}
class TimerRunner {
/// {@macro TimerRunner}
TimerRunner(this._debugService) {
_stopwatch.start();
}
/// Сервис для отладки
final IDebugService _debugService;
/// Секундомер для подсчета времени инициализации
final _stopwatch = Stopwatch();
/// Метод для остановки секундомера и вывода времени
/// полной инициализации приложения
void stop() {
_stopwatch.stop();
_debugService.log(
'Время инициализации приложения: ${_stopwatch.elapsedMilliseconds} мс',
);
}
/// Метод для обработки прогресса инициализации зависимостей
void logOnProgress(String name) {
_debugService.log(
'$name успешная инициализация, прогресс: ${_stopwatch.elapsedMilliseconds} мс',
);
}
/// Метод для обработки прогресса инициализации зависимостей
void logOnComplete(String message) {
_debugService.log(
'$message, прогресс: ${_stopwatch.elapsedMilliseconds} мс',
);
}
/// Метод для обработки прогресса инициализации зависимостей
void logOnError(
String message, {
Object? error,
StackTrace? stackTrace,
}) {
_debugService.error(message, error, stackTrace);
}
}

4
lib/targets/dev.dart Normal file
View File

@@ -0,0 +1,4 @@
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/runner/app_runner.dart';
void main() => AppRunner(AppEnv.dev).run();

5
lib/targets/prod.dart Normal file
View File

@@ -0,0 +1,5 @@
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/runner/app_runner.dart';
void main() => AppRunner(AppEnv.prod).run();

5
lib/targets/stage.dart Normal file
View File

@@ -0,0 +1,5 @@
import 'package:friflex_starter/app/app_env.dart';
import 'package:friflex_starter/runner/app_runner.dart';
void main() => AppRunner(AppEnv.stage).run();