setup.md

課題の準備をする

課題をスムーズに進めるための準備をしましょう。

課題

• 作成した研修用のリポジトリにメンターをコラボレーターとして招待する
• 作成した研修用のリポジトリの GitHub Actions の権限を「Allow all actions and reusable workflows」に設定
• 作成した研修用のリポジトリの GitHub Actions のワークフローの権限を「Read and write permissions」に設定
• 作成した研修用のリポジトリでプルリクエストマージ後に自動でヘッドブランチが削除されるように設定
• 作成した研修用のリポジトリにルールセットを作成
  • 対象のブランチはデフォルトブランチ
  • 削除を許可しない
  • マージ前にプルリクエスト必須
    • マージ前に１人の承認を必須
    • マージ前に会話の解決必須
  • フォースプッシュを許可しない
• 使用しているチャットツールで GitHub 通知の購読設定
  • Slackコマンド:
    • /github subscribe ユーザー名/リポジトリ名 issues pulls reviews comments
    • /github unsubscribe ユーザー名/リポジトリ名 commits releases deployments workflows branches discussions
• 作成した研修用のリポジトリを git clone [url] して、ローカルにコピー
• fvm をインストール
• プロジェクトルートで fvm install コマンドを実行して対象の Flutter SDK をインストール
• IDE の最新安定板をインストール
• Flutter の設定（ fvm flutter doctor を実行して確認）
• Android・iOS でアプリを実行
• .github/workflows-templates ディレクトリを .github/workflows にリネーム
• review-assign.yaml の REVIEWERS にメンターの GitHub のユーザー名を設定
• 作成した研修用のリポジトリのルールセットを編集（上２つの修正を行ったプルリクエストでステータスチェック完了後に対応する）
  • マージ前にステータスチェック必須
    • マージ前にブランチ最新化必須
    • ステータスチェック flutter test check を追加

注意事項

• yumemi_lints が Flutter SDK の最新バージョンをサポートおらずエラーが発生してしまう場合があります。詳しくは Error occurs when yumemi_lints does not support the latest version of Flutter SDK をご覧ください。

参考資料

• コラボレーターを個人リポジトリに招待する
• リポジトリの GitHub Actions の設定を管理する
• ルールセットについて
• ステータスチェックについて
• GitHub + Slack