MENU
現役エンジニアが教えない、挫折と苦悩のアプリ開発
  1. ホーム
  2. Flutter
  3. パッケージの追加方法 – 完全ガイド!

パッケージの追加方法 – 完全ガイド!

Flutter Flutter解説

新しいパッケージを追加する方法を、ステップバイステップで説明します!

📝 基本の流れ(3ステップ)

STEP
pubspec.yaml に書く
STEP
flutter pub get を実行
STEP
import して使う

実際にやってみましょう!

例: intl パッケージを追加する場合

STEP
pubspec.yaml に書く

1-1.pubspec.yaml ファイルを開く
プロジェクトのルートにある pubspec.yaml を開きます。

name: my_app
description: A new Flutter project.

dependencies:
  flutter:
    sdk: flutter
  
  # ↓ ここに追加します!

dev_dependencies:
  flutter_test:
    sdk: flutter

1-2. パッケージを追加する
最新バージョンを使う場合:

dependencies:
  flutter:
    sdk: flutter
  
  intl: ^0.19.0  # ← ここに追加!

インデント(字下げ)が超重要! スペース2個分
flutter: と同じレベルに書く
: の後には必ずスペース1個

❌ 間違った書き方:

# インデントがずれている
dependencies:
  flutter:
    sdk: flutter
intl: ^0.19.0  # ← ダメ! 左に寄りすぎ

# スペースがない
dependencies:
  flutter:
    sdk: flutter
  intl:^0.19.0  # ← ダメ! : の後にスペースが必要
STEP
flutter pub get を実行

パッケージをダウンロードして、プロジェクトに追加します。

方法1: コマンド実行(ターミナル)

flutter pub get

実行すると:

Running "flutter pub get" in my_app...
Resolving dependencies...
+ intl 0.19.0
Changed 1 dependency!

「Changed 1 dependency!」 と出たら成功!

方法1: エディタが自動実行(超簡単!)

Android Studio / VS Code の場合:

pubspec.yaml を保存すると、エディタが自動で flutter pub get を実行してくれます!

画面上部に表示:
Pub get…クリックでもOK

STEP
import して使う

Dartファイルの先頭で import します:

dartimport 'package:intl/intl.dart'; // ← 追加!

void main() {
final now = DateTime.now();
final formatted = DateFormat('yyyy年MM月dd日').format(now);
print(formatted); // 2026年01月10日
}

これで使えるようになりました!

📌 バージョンの指定方法

パッケージのバージョンは、いろいろな指定方法があります。

1. ^ 記号 – 互換性のある最新版(推奨!)

intl: ^0.19.0

意味: 0.19.0 以上、1.0.0 未満の最新版を使う

0.19.5 → ✅ OK
0.20.0 → ✅ OK
1.0.0 → ❌ NG(大きな変更があるかも)

これが一番おすすめ! 自動で安全にアップデートされます。

2. 固定バージョン

intl: 0.19.0

意味: 0.19.0 のみ使う(他のバージョンは使わない)
いつ使う?

特定のバージョンじゃないとバグが出る場合
古いアプリで安定性を優先する場合

3. 範囲指定

intl: '>=0.18.0 <0.20.0'

意味: 0.18.0 以上、0.20.0 未満
いつ使う? あまり使わない(細かく制御したいとき)

4. 最新版を使う(非推奨)

intl: 0.19.0

意味: 何でもいいから最新版

危険! 将来的に互換性が壊れる可能性があるので、使わないほうがいい!

🔍 最新バージョンを調べる方法

方法1: pub.dev で検索

https://pub.dev を開く
パッケージ名で検索(例: intl)
右上に最新バージョンが表示される

方法2: コマンドで調べる

flutter pub outdated

現在のバージョンと最新版を比較してくれます:

Package Name  Current  Upgradable  Resolvable  Latest
intl          0.18.0   0.19.0      0.19.0      0.19.0
http          0.13.5   0.13.6      0.13.6      1.0.0

⚠️よくあるエラーと解決策

エラー1: インデントがおかしい

Error on line 12, column 3: Expected a key while parsing a block mapping.

原因: スペースの数が間違っている

解決策:

# ❌ 間違い
dependencies:
  flutter:
    sdk: flutter
    intl: ^0.19.0  # ← インデント多すぎ

# ✅ 正しい
dependencies:
  flutter:
    sdk: flutter
  intl: ^0.19.0  # ← flutter: と同じレベル

エラー2: パッケージが見つからない

Because my_app depends on intll ^0.19.0 which doesn't exist, version solving failed.

原因: パッケージ名のスペルミス(intl を intll と書いた)

解決策:スペルを確認して修正

エラー3: バージョンが競合

Because package_a depends on http ^0.13.0 and package_b depends on http ^1.0.0, version solving failed.

原因: 複数のパッケージが、同じパッケージの違うバージョンを要求している
解決策:

dependency_overrides:
  http: ^1.0.0  # ← 強制的にこのバージョンを使う

エラー4: キャッシュの問題

Git error. Command: `git clone`

解決策: キャッシュをクリア

flutter pub cache clean
flutter pub get

複数パッケージを一度に追加

dependencies:
  flutter:
    sdk: flutter
  
  # 状態管理
  provider: ^6.1.0
  
  # ネットワーク
  http: ^1.1.0
  dio: ^5.4.0
  
  # データ保存
  shared_preferences: ^2.2.0
  sqflite: ^2.3.0
  
  # UI
  google_fonts: ^6.1.0
  flutter_slidable: ^3.0.0
  
  # ユーティリティ
  intl: ^0.19.0
  url_launcher: ^6.2.0

注意: 一度に全部追加してから flutter pub get を1回実行でOK!

📦 パッケージ追加の完全チェックリスト

  • ステップ1: pub.dev で最新バージョンを確認
  • ステップ2: pubspec.yaml の dependencies: に追加
  • ステップ3: インデント(スペース2個)を確認
  • ステップ4: 保存する(エディタが自動で pub get 実行)
  • ステップ5: Dartファイルで import する
  • ステップ6: 使ってみる!

🚀 ショートカット技!

VS Code / Android Studio で超簡単に追加:

❶pubspec.yaml を開く
❷dependencies: の下に パッケージ名だけ書く

  intl:

❸エディタが自動で 最新バージョンを提案してくれる!
❹Tab キーで確定

これが一番楽! 😊

💡 コツを調べてみた

❶ コメントを書いておく

dependencies:
  flutter:
    sdk: flutter
  
  provider: ^6.1.0        # 状態管理用
  intl: ^0.19.0           # 日付フォーマット
  sqflite: ^2.3.0         # ローカルDB

何のために使っているか分かりやすい!

❷ アルファベット順に並べる

dependencies:
  dio: ^5.4.0
  google_fonts: ^6.1.0
  intl: ^0.19.0
  provider: ^6.1.0
  sqflite: ^2.3.0

探しやすくなります!

❸ カテゴリーで分ける

dependencies:
  # 状態管理
  provider: ^6.1.0
  
  # ネットワーク
  http: ^1.1.0
  dio: ^5.4.0
  
  # UI
  google_fonts: ^6.1.0

わかりやすい!

一言まとめ:
パッケージ追加は pubspec.yaml に書く → flutter pub get → import する の3ステップ!
インデントに注意して、^ 記号でバージョン指定するのがおすすめ! 📦✨

Flutter Flutter解説