Flutter и Dart: первое приложение

flutter doctor
flutter create service_card
cd service_card
flutter run -d chrome

/// Уровень услуги: enum — фиксированный набор значений.
enum ServiceLevel { standard, premium }

class Service {
  const Service({
    required this.title,
    required this.durationMinutes,
    this.description,
    this.level = ServiceLevel.standard,
  });

  final String title;
  final int durationMinutes;
  final String? description; // может отсутствовать — тип String?
  final ServiceLevel level;

  // Геттер — вычисляемое свойство, вызывается без скобок.
  String get durationLabel => '$durationMinutes мин';

  // ?? подставляет запасное значение, если слева null.
  String get descriptionOrPlaceholder =>
      description ?? 'Описание скоро появится';

  bool get isPremium => level == ServiceLevel.premium;
}

/// Имитация запроса к серверу: через 300 мс возвращает список услуг.
Future<List<Service>> fetchServices() async {
  await Future<void>.delayed(const Duration(milliseconds: 300));
  return const [
    Service(
      title: 'Чистка лица',
      durationMinutes: 60,
      description: 'Ультразвуковая чистка и маска по типу кожи.',
      level: ServiceLevel.premium,
    ),
    Service(title: 'Массаж спины', durationMinutes: 45),
  ];
}

// Консольный скрипт: здесь print уместен, поэтому отключаем правило линтера.
// ignore_for_file: avoid_print

import 'package:service_card/models/service.dart';

// Именованный параметр в фигурных скобках; String? — может быть null.
String greet(String name, {String? city}) {
  if (city == null) return 'Привет, $name!';
  // После проверки выше Dart знает, что city — уже String, а не String?.
  return 'Привет, $name из города ${city.toUpperCase()}!';
}

Future<void> main() async {
  print(greet('Аружан'));
  print(greet('Аружан', city: 'Алматы'));

  final services = await fetchServices(); // ждём Future, не блокируя программу
  for (final s in services) {
    print('${s.title} — ${s.durationLabel}. ${s.descriptionOrPlaceholder}');
  }

  final premiumCount = services.where((s) => s.isPremium).length;
  print('Премиум-услуг: $premiumCount');
}

$ dart run bin/basics.dart
Привет, Аружан!
Привет, Аружан из города АЛМАТЫ!
Чистка лица — 60 мин. Ультразвуковая чистка и маска по типу кожи.
Массаж спины — 45 мин. Описание скоро появится
Премиум-услуг: 1

import 'package:flutter/material.dart';

import 'service_screen.dart';

void main() {
  runApp(const ServiceApp());
}

class ServiceApp extends StatelessWidget {
  const ServiceApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Карточка услуги',
      // Вся палитра Material 3 строится из одного «зерна».
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.teal),
      ),
      home: const ServiceScreen(),
    );
  }
}

import 'package:flutter/material.dart';

import 'models/service.dart';

const demoService = Service(
  title: 'Чистка лица',
  durationMinutes: 60,
  description: 'Ультразвуковая чистка и маска по типу кожи.',
  level: ServiceLevel.premium,
);

class ServiceScreen extends StatelessWidget {
  const ServiceScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Услуга')),
      body: ListView(
        padding: const EdgeInsets.all(16),
        children: const [ServiceCard(service: demoService)],
      ),
    );
  }
}

class ServiceCard extends StatelessWidget {
  const ServiceCard({super.key, required this.service});

  final Service service;

  @override
  Widget build(BuildContext context) {
    final textTheme = Theme.of(context).textTheme;

    return Card(
      child: Padding(
        padding: const EdgeInsets.all(16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Row(
              children: [
                // Expanded отдаёт названию всё свободное место в строке.
                Expanded(
                  child: Text(service.title, style: textTheme.titleLarge),
                ),
                if (service.isPremium) const Chip(label: Text('Премиум')),
              ],
            ),
            const SizedBox(height: 8),
            Text(service.descriptionOrPlaceholder, style: textTheme.bodyMedium),
            const SizedBox(height: 16),
            Row(
              children: [
                const Icon(Icons.schedule, size: 20),
                const SizedBox(width: 4),
                // Expanded, а не Spacer: на узком экране текст сожмётся,
                // а кнопка останется у правого края.
                Expanded(child: Text(service.durationLabel)),
                const BookButton(),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

class BookButton extends StatefulWidget {
  const BookButton({super.key});

  @override
  State<BookButton> createState() => _BookButtonState();
}

class _BookButtonState extends State<BookButton> {
  bool _booked = false;

  @override
  Widget build(BuildContext context) {
    if (_booked) {
      return OutlinedButton.icon(
        onPressed: () => setState(() => _booked = false),
        icon: const Icon(Icons.check),
        label: const Text('Вы записаны'),
      );
    }
    return FilledButton(
      onPressed: () => setState(() => _booked = true),
      child: const Text('Записаться'),
    );
  }
}

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';

import 'package:service_card/main.dart';
import 'package:service_card/models/service.dart';
import 'package:service_card/service_screen.dart';

void main() {
  testWidgets('карточка показывает услугу, кнопка меняет состояние', (
    tester,
  ) async {
    await tester.pumpWidget(const ServiceApp());

    expect(find.text('Чистка лица'), findsOneWidget);
    expect(find.text('60 мин'), findsOneWidget);
    expect(find.text('Премиум'), findsOneWidget);

    await tester.tap(find.text('Записаться'));
    await tester.pump(); // перерисовка после setState

    expect(find.text('Вы записаны'), findsOneWidget);
    expect(find.text('Записаться'), findsNothing);
  });

  testWidgets('длинное название на узком экране не переполняет строку', (
    tester,
  ) async {
    tester.view.physicalSize = const Size(320, 640);
    tester.view.devicePixelRatio = 1.0;
    addTearDown(tester.view.reset);

    const service = Service(
      title: 'Очень длинное название услуги, которое не помещается в строку',
      durationMinutes: 90,
      level: ServiceLevel.premium,
    );
    await tester.pumpWidget(
      const MaterialApp(
        home: Scaffold(body: ServiceCard(service: service)),
      ),
    );

    expect(tester.takeException(), isNull); // нет ошибки переполнения
    expect(find.text('Описание скоро появится'), findsOneWidget);
  });
}

$ flutter analyze
Analyzing service_card...
No issues found! (ran in 11.1s)

$ flutter test
00:00 +0: карточка показывает услугу, кнопка меняет состояние
00:00 +1: длинное название на узком экране не переполняет строку
00:00 +2: All tests passed!