Phase 2 · Modern & Asynchronous DartModule 15~48 min read

Packages, Tooling & Dart Testing

Manage dependencies, enforce analysis and formatting, write fast tests, evaluate packages, and maintain reusable Dart libraries.

What you'll learn

Manage dependencies, enforce analysis and formatting, write fast tests, evaluate packages, and maintain reusable Dart libraries. The lesson turns the APIs into a repeatable engineering workflow instead of a collection of isolated snippets.

By the end of this lesson, you'll be able to:

  • Apply pubspec and Pub in a production-shaped Flutter feature
  • Apply Version constraints in a production-shaped Flutter feature
  • Apply Analyzer and lints in a production-shaped Flutter feature
  • Apply Unit tests in a production-shaped Flutter feature

Core mental model

Connect each API to the decision it supports. Flutter code stays maintainable when state, ownership, lifecycle, and platform boundaries are explicit.

ConceptWhat it meansDecision rule
Version constraintThe allowed dependency-version rangeExpress compatible releases and commit the resolved lockfile for applications
AnalyzerStatic checks driven by the language and lint configurationTreat analysis as a required delivery gate
FakeA lightweight working dependency implementation for testsUse when behavior matters more than interaction counts

Professional workflow

Work in small vertical slices and keep behavior observable from the first iteration.

  1. Define the reproducible Dart package boundary: user goal, inputs, visible states, ownership, and expected failures.
  2. Build the smallest working vertical slice with typed data and explicit dependencies.
  3. Represent loading, empty, success, and failure behavior where the feature can encounter them.
  4. Verify logic away from the UI, then exercise the rendered behavior at its public boundary.
  5. Inspect lifecycle, accessibility, performance, security, and platform behavior before widening the feature.
  6. Refactor only after behavior is protected by repeatable evidence.

Protect the frame

Keep build methods predictable, move side effects to explicit owners, and measure before introducing caches, isolates, or architectural layers.

Guided Flutter lab

Build a focused reproducible Dart package slice

This compact example keeps the important ownership and data-flow decisions visible so the behavior is easy to extend and test.

test/progress_test.dart
import 'package:test/test.dart';

int completedPercent({required int completed, required int total}) {
  if (total <= 0) return 0;
  return ((completed / total) * 100).round().clamp(0, 100);
}

void main() {
  group('completedPercent', () {
    test('rounds a partial course', () {
      expect(completedPercent(completed: 2, total: 3), 67);
    });

    test('handles an empty course', () {
      expect(completedPercent(completed: 0, total: 0), 0);
    });
  });
}

Production practice

Contract

Define the reproducible Dart package inputs, outputs, owner, lifecycle, visible states, and platform assumptions before selecting APIs or packages.

Verification

Protect pure rules with unit tests and the rendered public contract with widget or integration evidence; include one unavailable or failure case.

Operations

Keep dependencies replaceable, log actionable context without user secrets, and measure user-visible behavior before optimizing.

Common failure mode

Selecting a package only by popularity ignores maintenance, platform support, license, API quality, transitive risk, and the cost of removing it later.

Independent workshop

Extend the guided lab into a review-ready reproducible Dart package feature that fits the running course portfolio app.

Your finished workshop must include:

  • pubspec and Pub
  • Version constraints
  • Analyzer and lints
  • Unit tests
  • Fakes and async tests
  • Automated verification and a short design note

Definition of done

Demonstrate the happy path, an empty or unavailable state, and at least one failure path. Add an automated check and a short note explaining one design decision.

Recap & quick check

Key takeaways

  • Version constraint: Express compatible releases and commit the resolved lockfile for applications
  • Analyzer: Treat analysis as a required delivery gate
  • Fake: Use when behavior matters more than interaction counts

Quick check

1. Which rule best applies to Version constraint?

2. Which rule best applies to Analyzer?

3. Which rule best applies to Fake?

Next: How Flutter Works