cloudensis learn

AIと学ぶ、はじめてのソフトウェア開発

第8章 動かないときに切り分ける

ゴール
手元と公開先の違いから、原因の場所を絞り込める
手に入るもの
公開先でも直ったゲーム
目安の時間
60分

いまの位置:第4部 自分で進む / 第8章

第7章の最後に足したタイトルロゴは、手元では表示されたのに、公開先では表示されなかったはずです。 同じファイルを置いたはずなのに、場所によって動きが変わる。 ソフトウェア開発では、とてもよく出会う種類の問題です。

この章では、その原因を自分で切り分けて見つけます。 第5章では、自分で壊したので原因を知っていました。 今回は、原因を知らない状態から始めます。 この章からは、本は手順だけを示し、答えは示しません。

始める前に

公開先でもロゴが問題なく表示されていた人もいるはずです。 その場合は、次のようにして練習用の不具合を作ってください。

  • my-game-backup を取り直す
  • index.html の中で、ロゴのファイル名を書いている箇所を、すべて大文字の LOGO.svg に書き換える
  • 手元で表示されることを確かめてから、公開し直す

自分で作った不具合なので、原因の見当はつくかもしれません。 それでも、すぐに直さず、下の手順を一つずつたどってください。 この章で身につけたいのは、原因そのものではなく、原因にたどり着くまでの手順です。

切り分けの手順

原因がどこにあるか分からないときは、次の4つの手順で範囲を狭めていきます。 この手順は、ゲーム以外のどんな問題にも使えます。

  1. 症状を言葉にする:何を期待して、実際には何が起きているか
  2. 再現する:いつ、どこで、何回やっても同じことが起きるか
  3. 違いを並べる:うまくいく場合と、うまくいかない場合で、何が違うか
  4. 一つずつ確かめて、狭める:違いを一つずつ確かめ、原因がありそうな範囲を小さくしていく

1. 症状を言葉にする

最初に、何が起きているかを文章にします。第5章の「エラーを相談する」で渡す項目のうち、「期待したこと」と「実際に起きたこと」の2つを、頭の中で埋めてみてください。

「ロゴが出ない」だけでは足りません。どこで開いたときに出ないのか、ロゴ以外のゲームはどうなっているのかまで言えるようにします。

2. 再現する

次の3つを試して、結果を見てください。

  • 手元の index.html をブラウザで開く
  • 公開先のURLを、シークレットウィンドウで開く
  • 公開先のURLを、スマートフォンなど別の端末で開く(なければ、ふだん使っていない別のブラウザで開く)

どの開き方でロゴが出て、どの開き方で出ないでしょうか。 別の端末や別のブラウザでも出ないなら、問題はあなたのパソコンやブラウザではなく、公開先の側にありそうだと分かります。 これだけで、調べる範囲がぐっと狭まります。

3. 違いを並べる

手元で開くときと、公開先で開くときで、何が違うでしょうか。 第7章で聞いた「ページが表示されるまで」を思い出してください。

  • ファイルを読み込んでいるのは、どこのコンピュータか
  • ブラウザのアドレス欄に表示されているURLは、どんな形か
  • 公開先に置かれているファイルは、手元のファイルと同じか

思いつかなければ、違いを並べるところをAIに手伝ってもらってもかまいません。

新しい会話で送ってください

自分のパソコンで index.html を開いたときと、それをインターネットに公開して開いたときとで、ページの表示が変わることがあるのはなぜですか。

- 考えられる違いを、5つまで一覧にしてください
- それぞれ、自分で確かめる方法を一言で添えてください
- 私はプログラミングの知識がまったくありません

4. 一つずつ確かめて、狭める

違いの候補が並んだら、確かめられるものから順に確かめていきます。 ここでは、手がかりを集める方法を2つ示します。

公開先でコンソールを見る

公開先のURLを開いた状態で、第5章で使った開発者ツールのコンソールを開いてください。 手元で開いたときにはなかった赤い文字が出ていないでしょうか。 出ていたら、第5章と同じように、ファイル名を探します。

公開先のファイルを、直接開いてみる

公開先のURLのうしろに / とファイル名を付けると、そのファイルだけを直接開けます。 たとえばURLが https://my-game.example.workers.dev なら、https://my-game.example.workers.dev/style.css で style.css の中身が表示されます。

この方法で、公開先に本当に置かれているファイルと、index.html が読み込もうとしているファイルを、それぞれ開いてみてください。 片方は開けて、片方は開けない、ということはないでしょうか。 もしそうなら、その2つの名前を、1文字ずつ見比べてください。

相談する

原因の見当がついたら、あるいは見当がつかなくても手がかりが集まったら、AIに相談します。第5章の「エラーを相談する」の項目に、切り分けで分かったことを足して送ります。

新しい会話で送ってください

次の問題について、原因と直し方を教えてください。

# やったこと
(何をしたら、問題が起きたか)

# 期待したこと
(本当はどうなってほしかったか)

# 実際に起きたこと
(どこで開くと、何が起きているか)

# 切り分けで分かったこと
(試したことと、その結果。うまくいく場合といかない場合の違い)

# エラーの全文
(公開先で開いたときのコンソールの赤い文字を、英語のまま全部)

# 関係しそうなファイル
(index.html の全文と、my-game フォルダに入っているファイル名の一覧)

切り分けで分かったことを添えると、AIは推測の範囲を最初から絞って答えられます。 「なぜ手元では表示されたのか」も、あわせて聞いておいてください。 同じ問題を二度と起こさないための知識になります。

直して、確かめる

原因が分かったら、手元のファイルを直し、手元で表示されることを確かめてから、公開し直してください。 そのうえで、2で試した3つの開き方をすべてもう一度試します。 すべての開き方でロゴが表示されれば、直ったと言えます。

AIの説明に「〇〇の仕組みのため」のような理由が含まれていたら、第7章の「公式資料を読ませる」で、それが公式資料にも書かれているかを確かめてみてください。 理由まで確かめておくと、次に似た問題に出会ったとき、自分で気づけるようになります。

次へ進んでよい状態

  • 公開先のURLで、ロゴを含めてゲームが正しく表示される
  • 原因が何だったかを、一言で言える
  • なぜ手元では表示されたのかを、一言で言える

つまずいたら

手元でも公開先でも、ロゴが出ない
原因は公開先ではなく、ファイルそのものにありそうです。手元のコンソールを見て、第5章と同じ手順で調べてください。
直したのに、公開先はまだ表示されない
公開し直したか、公開し直したあとに再読み込みしたかを確かめてください。ブラウザが古いファイルを覚えていることがあるので、シークレットウィンドウを開き直して確かめるのが確実です。
原因の見当がまったくつかない
公開先のファイルを直接開く方法を、index.html・style.css・script.js・ロゴのファイルのすべてで試してください。開けるものと開けないものが分かれるはずです。
AIの答えを試しても直らない
第1章の「詰まったときの共通ルール」を使います。my-game-backup から戻し、新しい会話で、切り分けで分かったことを最初から伝え直してください。

どれにも当てはまらないとき、同じところで何度も止まるときは、第1章の「詰まったときの共通ルール」に戻ってください。

ここまでの確認

  • 症状を、どこで開いたときに何が起きるかまで言葉にした
  • 開き方を変えて再現し、問題のある側を絞り込んだ
  • コンソールと、ファイルを直接開く方法で手がかりを集めた
  • 切り分けで分かったことを添えて、AIに相談した
  • 直して公開し直し、すべての開き方で確かめた

ロードマップ用チャットに報告する

ロードマップ用チャットで送ってください

第8章を終えました。
手元では動くのに公開先では動かない問題を、症状を言葉にする・再現する・違いを並べる・一つずつ確かめる、の手順で切り分けて直せるようになりました。原因は(一言で)でした。

次の一歩

第8章では、本が手順を示しました。 第9章では、その手順も示しません。 この本が扱っていない機能を1つ、自分の力でゲームに足します。