基礎から学ぶJavaScript入門 90日コース | 最終制作 - Day 90:最終完成・公開

JavaScript 90日で身につけるJavaScript
スポンサーリンク
スポンサーリンク

Day 90:最終完成・公開

Day 90では、最終制作アプリの機能やエラーを確認し、GitHubへ保存して、READMEを整え、必要ならWeb上に公開します。ここでの完成は「コードを書き終えた状態」ではなく、初めて使う人がアプリの目的を理解し、基本操作を試せる状態にすることです。

この教材では、これまでの例に合わせて「学習管理アプリ」を使います。GitHubへコードを保存することと、アプリをWeb上で公開することは別の作業です。公開しない場合も、GitHubのリポジトリとREADMEを整えるところまで進めれば、成果物を共有しやすくなります。

ステップ1:公開する前に完成範囲を確認する

まず、Day 81で決めたアプリの目的と完成条件を読み返します。追加機能を増やすより、最初に約束した機能が正しく動くことを優先します。

  • アプリの目的を、短く説明できますか。
  • 最初の完成版に入れると決めた機能はすべて動きますか。
  • 未完成の機能や、正しく動かない機能を把握していますか。
  • 公開するコードや画面に、個人情報や秘密情報が含まれていませんか。

未完成の機能を無理に完成したように見せるのではなく、READMEに「今後追加したい機能」として明記する方法もあります。

ステップ2:機能を一通りテストする

アプリを初めて使う人になったつもりで、画面を最初から操作します。基本機能だけでなく、入力エラーや検索結果がない状態も確認します。

確認対象テストする操作期待する結果
追加学習内容、時間、日付を入力して記録一覧と合計時間が更新される
入力確認学習内容を空欄にして送信案内が表示され、空の記録は追加されない
入力確認時間に0や不正な値を入力案内が表示され、記録は追加されない
編集記録の内容を変更して更新対象の記録だけが更新される
削除記録を削除確認後に一覧と合計が更新される
検索・フィルター語句や期間を指定条件に合う記録だけが表示される
保存ページを再読み込み保存した記録や設定が読み込まれる
空の状態記録をすべて削除次の操作が分かる案内が表示される

検索結果が0件の状態と、アプリに記録が1件もない状態は別です。それぞれに合ったメッセージが表示されるかも確認しましょう。

ステップ3:画面とブラウザーのエラーを確認する

ブラウザーでアプリを開き、開発者ツールのConsoleを確認します。赤いエラーが表示されていないかを見て、エラーがあれば上から一つずつ解決します。HTMLやCSSのパス、JavaScriptの読み込み、要素のidの誤記などがよくある原因です。

  • 画面の文字やボタンが重なったり、画面外にはみ出したりしていませんか。
  • スマートフォン程度の幅でも、フォームや一覧を操作できますか。
  • キーボードのTabキーで入力欄やボタンを選べますか。
  • エラーメッセージが具体的で、修正方法を想像できますか。
  • 入力された文字をHTMLとして実行させず、文字列として表示していますか。

特に、利用者が入力した内容を一覧に表示する部分では、textContentなどの安全な表示方法を使います。入力値をHTML文字列として直接挿入しないようにします。

ステップ4:公開してはいけない情報がないか確認する

GitHubのリポジトリを公開設定にする場合、コードやファイルを多くの人が閲覧できる可能性があります。公開前に、次のような情報が含まれていないか確認します。

  • APIキーやアクセストークン
  • パスワードや認証情報
  • 個人のメールアドレスや電話番号
  • 個人情報を含むテストデータ
  • 端末内だけで使うつもりだった設定ファイル

秘密情報をコードから削除しても、過去のコミットに残っている場合があります。秘密情報を誤って公開した場合は、単にファイルから消すだけでなく、利用先でそのキーを無効化・再発行するなど、サービスの案内に従って対応します。

ステップ5:GitHubへ保存する

GitHubは、コードの変更履歴を保存し、ほかの人と共有できるサービスです。まずGitHub上で新しいリポジトリを作成し、プロジェクトのファイルを登録します。

Gitがインストールされ、コマンドを使える環境では、プロジェクトのフォルダーで次のように操作できます。your-repository-urlの部分は、GitHubが作成後に表示する実際のリポジトリURLに置き換えてください。

# このフォルダーをGitで管理し始める
git init

# 変更したファイルを登録対象にする
git add .

# 現在の状態を履歴として保存する
git commit -m "Complete study tracker app"

# GitHub上のリポジトリを接続先として登録する
git remote add origin your-repository-url

# mainブランチの内容をGitHubへ送る
git branch -M main
git push -u origin main

GitHubの画面からファイルをアップロードする方法もあります。どちらの場合も、アップロード後にリポジトリを開き、index.html、CSS、JavaScript、READMEなど必要なファイルがそろっているか確認します。

ステップ6:READMEを作成する

READMEは、リポジトリを開いた人に「このアプリは何か」「どう使うか」を伝える説明書です。プロジェクトのルートにREADME.mdを作成し、次の内容を記載します。

  • アプリ名と概要
  • 主な機能
  • 使い方
  • 使った技術
  • ローカルでの起動方法
  • 公開版へのリンク(公開した場合)
  • 現在の制限や、今後追加したい機能

学習管理アプリのREADME例です。実際のアプリの内容に合わせて、文章や機能を調整してください。

# 学習管理アプリ

学習した内容と時間を記録し、履歴を振り返るためのWebアプリです。

## 主な機能

- 学習記録の追加・一覧表示・編集・削除
- 学習内容やメモの検索
- 期間による絞り込み
- 学習日の並べ替え
- ダークモード
- ブラウザー内への記録保存

## 使い方

1. 学習内容、学習時間、学習日を入力します。
2. 「記録する」ボタンを押します。
3. 登録した記録を一覧で確認します。
4. 必要に応じて、編集・削除・検索を行います。

## 使用技術

- HTML
- CSS
- JavaScript
- localStorage

## 起動方法

`index.html`をブラウザーで開いてください。
ES Modulesを利用している場合は、ローカル開発サーバーから開いてください。

## データについて

学習記録は、利用しているブラウザーのlocalStorageに保存されます。
別の端末やブラウザーとの自動同期には対応していません。

## 今後追加したい機能

- 学習記録の編集履歴
- 月ごとの学習時間表示

「使用技術」や「機能」は、実際に作ったものだけを記載します。実装していない機能をREADMEに書かないようにしましょう。

ステップ7:必要な場合はGitHub Pagesで公開する

HTML、CSS、JavaScriptで作った静的なアプリなら、GitHub Pagesを公開先の候補にできます。GitHub Docsでは、ブランチとフォルダーを公開元に設定する方法や、GitHub Actionsを使う方法が案内されています。(🔗 docs.github.com)

基本的な流れは次のとおりです。

  • アプリのファイルをGitHubリポジトリへ保存します。
  • リポジトリのSettingsからPagesの設定を開きます。
  • 公開元としてブランチを選び、公開するフォルダーを指定します。
  • 保存後、公開状態になったことを確認します。
  • 表示された公開先を開き、実際にアプリを操作します。

ブランチから公開する場合は、公開したいブランチとフォルダーを設定します。サイトの入口になるindex.htmlは、選んだ公開元の一番上の階層に置きます。(🔗 docs.github.com)

設定変更やファイルのアップロード後、公開反映まで少し時間がかかることがあります。GitHub Docsのクイックスタートでは、公開まで最大10分かかる場合があると案内されています。(🔗 docs.github.com)

公開後は、リポジトリ内のファイルを確認するだけでなく、公開された画面も実際に操作します。公開先では、CSSやJavaScriptの読み込みパスがローカル環境と異なることがあるため、画面崩れやConsoleのエラーも確認してください。

ステップ8:アプリの説明を書く

アプリの説明は、利用者が「何ができるのか」をすぐ理解できるよう、目的、主な機能、保存方法を簡潔に書きます。

  • 何のためのアプリかを最初の一文で伝えます。
  • 主な機能を、利用者ができることとして説明します。
  • データの保存場所や制限があれば明記します。
  • 未対応の機能を、対応済みであるかのように書かないようにします。

説明文の例です。

学習管理アプリは、学習した内容や時間を記録し、履歴を検索・整理できるWebアプリです。記録は利用中のブラウザーに保存されるため、別の端末との自動同期には対応していません。

最終チェックリスト

公開前に、次の項目を一つずつ確認します。

  • 追加・一覧表示・編集・削除が動きます。
  • 検索、フィルター、並べ替えなど、実装した追加機能が動きます。
  • 空入力や不正な値に対して適切な案内が表示されます。
  • 記録がない場合や検索結果が0件の場合の表示があります。
  • 再読み込み後も、保存する設計にしたデータが保たれます。
  • スマートフォン程度の画面幅でも操作できます。
  • 開発者ツールのConsoleに、解決していないエラーがありません。
  • APIキーや個人情報など、公開できない情報が含まれていません。
  • READMEにアプリの目的、機能、使い方、制限を記載しています。
  • 公開した場合は、公開先で実際に操作を確認しています。

よくあるつまずき

  • 公開先でCSSが読み込まれない場合は、`href`のパスやファイル名の大文字・小文字を確認します。
  • JavaScriptが動かない場合は、`script`のパスとConsoleのエラーを確認します。
  • 公開ページが見つからない場合は、Pagesの公開元と`index.html`の場所を確認します。
  • ローカルでは動くのに公開先で動かない場合は、相対パス、モジュール読み込み、APIの接続先を確認します。
  • 公開したデータが他の端末に出ない場合は、`localStorage`はブラウザーごとの保存であり、自動同期ではないことを確認します。

Day 90のゴール

  • 完成条件に沿ってアプリの機能を確認できます。
  • エラーや入力漏れを調べ、必要な案内を表示できます。
  • ソースコードをGitHubのリポジトリへ保存できます。
  • READMEでアプリの目的と使い方を説明できます。
  • 必要に応じて公開し、公開先でも動作確認できます。

まとめ

Day 90では、アプリの全機能をテストし、エラーや公開前の情報漏れを確認してから、GitHubへ保存し、READMEを作成します。静的なWebアプリであれば、GitHub Pagesを公開先の候補にできます。公開後も、公開URLで実際に操作し、画面や機能が正しく動くことを確かめましょう。

90日間の最終制作では、すべての機能を盛り込むことより、決めた範囲を動く形で完成させ、ほかの人が理解して試せる状態にすることが大切です。完成したアプリとREADMEは、学習の成果を伝えるポートフォリオの一部にもなります。

タイトルとURLをコピーしました