Issue 173 ページング機能のエラー発生時の復帰処理を実装

[Aosanori]

概要

• close: [Feature]: ページング機能のエラー発生時の復帰処理を実装する #173
• ページング機能 #2 にて基礎的なページング機能は実装されていましたが、2ページ目以降にエラーが発生した場合の復帰処理は未実装でしたので、2ページ目以降にエラーが発生した場合の復帰処理を実装いたしました。

レビュー観点

@akatsuki174 さんのお陰で解決しました！ありがとうございました！
common_paging_view.dartにおいて、
2ページ目以降の読み込み、表示、再読み込みの3つについての条件分岐が複雑であり、
三項演算子では可読性に乏しくなると考えました。
そこで無理矢理ですが、可読性の観点からswitch文を用いました。

こちらについてさらに良い方法がございましたら、ご教授いただけますと幸いです

switch (data.hasMore) {
  true when hasError && isLoading => const Center(
      child: Padding(
        padding: EdgeInsets.all(16),
        child: CircularProgressIndicator(),
      ),
    ),
  true when hasError && !isLoading => _EndItemWhenError(
      onPressed: () async =>
          ref.read(_provider.notifier).loadNext(),
    ),
  true when !hasError => _EndItem(
      onScrollEnd: () async =>
          ref.read(_provider.notifier).loadNext(),
    ),
  true => null,
  false => null,
},

レビューレベル

• Lv1: ぱっとみて違和感がないかチェックして Approve する
• Lv2: 仕様レベルまで理解して、仕様通りに動くかある程度検証して Approve する
• Lv3: 実際に環境で動作確認したうえで Approve する

レビュー優先度

• すぐに見てもらいたい ( hotfix など ) 🚀
• 今日中に見てもらいたい 🚗
• 今日〜明日中で見てもらいたい 🚶
• 数日以内で見てもらいたい 🐢

画像 / 動画

• 読み込み失敗時に再読み込みのためのボタンを設置いたしました。
• ボタンをタップ時に、再読み込みが行われます。その際に読み込み中はCircularProgressIndicatorが表示されるようにしました。

Before	After	Design
2024-05-21.18.15.24.mov	2024-05-21.17.34.39.mov

動作確認手順

• 初回読み込みのために最初は通常通りにアプリ起動
• 2ページ目以降は機内モードに設定もしくはPCのWIFIを切ってから、スクロールし追加読み込みを行う。
• 読み込みが失敗したことを確認したら、再びシミュレータをオンラインの状態に戻しrefreshボタンをタップする。
• 正常に次のページが読み込まれたら動作確認完了。

備考

[github-actions]

Ready for review 🚀

[github-actions]

Visit the preview URL for this PR (updated for commit 4dcf96c):

https://flutter-mobile-project-template-catalog--pr209-issue-1-kuhlhesg.web.app

_{(expires Tue, 30 Jul 2024 01:14:21 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 9ea56735a63d07a7cfe62eb204b0528284c37c23}

[akatsuki174]

コメントしましたが、Flutter/Dartからしばらく離れているので、他の方のレビューもいただけるといいかなという状態です 🙇

[Aosanori]

愚問で申し訳ござませんが、CIがcheck-format-ci.sh で失敗している原因を教えていただきたいです。

Switch式を切り出す以前のテスト(c82f97a)は成功していましたが、Switch式の切り出し等のリファクタリングを行った結果、CIからエラーが出力されるようになりました。(1a3cf4c),(bc7299b)

そこでテストが失敗している原因の究明のためにローカルで実行した結果、以下の出力が得られました。

$ bash scripts/check-format-ci.sh

Fixes might be needed for ./packages/cores/core/.dart_tool/build/entrypoint/build.dart
Fixes might be needed for ./apps/app/.dart_tool/flutter_build/dart_plugin_registrant.dart
Fixes might be needed for ./apps/app/.dart_tool/build/entrypoint/build.dart

check-format-ci.shでは、コードが警告の有無、正しく整形されているかをチェックするものと認識しております。しかしながらCIのエラーの有無に関わらず出力は変化しないため、原因の見当がつきません。

お忙しいところ恐縮ですが、回答の方お待ちしております。

[K9i-0]

@Aosanori

[cores_core]: Changed ./lib/src/ui/util/common_paging_view.dart

このファイルのフォーマットが必要みたいですよ 🙆‍♂️

[Aosanori]

@K9i-0
お忙しい中ありがとうございます！
おかげで解決することができました！

[warahiko]

レビューが遅れて申し訳ないです
全体的な動きは問題なく、UX が向上していると感じました 👍

細かい点をいくつかコメントしているので、確認いただけるとありがたいです！

[blendthink]

大変レビュー遅くなってしまい申し訳ありません 🙏
LGTM です！
ご対応ありがとうございます！