環境構築

Reactの学習を進める際の環境構築について解説します。

本レッスンではコマンドラインツールを使ってReactの環境構築を進めていきます。

※CDNからの読み込みによってReactを導入する方法もありますが、フロントエンド開発で一般的に採用されているNode.jsノードジェイエスを使って導入する手順を説明します。

Create React Appのインストール

本レッスンでは、Reactアプリケーションの作成を一から行うのではなく、Facebookが公式に提供している「Create React Appクリエイト・リアクト・アップ」というコマンドラインツールを使用して環境を構築します。

Reactプロジェクトに必要なパッケージがあらかじめ組み込まれているため、コマンドラインで、Create React Appを使ってReactの開発環境を作成します。実行前に、Node.jsがインストールされており、コマンドラインで実行できることを確認しておきましょう。

Create React Appではじめるには以下のコマンドを入力します。「study-app」の部分は任意のディレクトリ名で、自由に名前を設定できます。

npx create-react-app study-app

はじめてコマンドを実行すると、必要なパッケージをインストールしてよいかどうかを質問されます。ここでは「y」をタイプして続行しましょう。パッケージのインストールや、ディレクトリの作成が行われます。(図ではYarnを使ったインストールが行われていますが、環境にインストールされているパッケージマネージャーによって異なります。)

パッケージのインストール

Create React Appの処理が終了すると、以下のような画面がコマンドライン上に表示されます。「Happy hacking!」と表示されたらインストールは成功です。

Reactの初期画面

ディレクトリーの確認

Create React Appで作成したReactアプリケーションは、以下のような構造になっています。

ファイル・ディレクトリー名 役割
README.md READMEファイル。環境構築直後は、create-react-appコマンド入力時のアプリケーション名が表示されます。
package.json Reactアプリケーションを動作させるのに必要なパッケージや、実行するためのスクリプトが記載されたJSONファイルです。
src ソースディレクトリ。Reactのコンポーネント(UI を独立して切り離し、再利用できるように分割したもの)などが格納されています。基本的にこのディレクトリー内のファイルを編集します。

ローカルサーバーで実行

Reactアプリケーションを、ローカルサーバーで実行してみましょう。コマンドラインで、以下のコマンドを入力します。

npm run start

コマンドを入力すると、http://localhost:3000がブラウザーでオープンし、下図と同じ画面が表示されれば導入は成功です。

Reactの初期画面

ビルドの確認

Reactで作成されたプロジェクトは、ウェブサーバーで配信する際にHTMLとJavaScriptにビルド・コンパイルする必要があります。Create React Appではビルドのコマンドも用意されていますので、コマンドラインで以下のコマンドを実行してみましょう。

npm run build

コマンドを実行するとプロダクション(本番環境)用のビルドがはじまります。実行終了すると、buildフォルダーがReactプロジェクト内に生成されます。ビルド後のファイルは、build/staticフォルダー内部に格納されています。

ビルド結果

ビルド後のファイルが正常に動作されているかどうかは、サーバーにbuildディレクトリーの中身をアップロードすることで確認できます。また、ビルドコマンド実行時に記載のある、serveモジュールを使った方法でも確認できます。今回は、serveモジュールを使ってビルドファイルの確認を行いましょう。

説明に記載のある通りグローバル領域にモジュールをインストールしてもよいのですが、今回はこのプロジェクトでのみserveモジュールを使用できるようにしましょう。

study-appディレクトリー直下で、以下のコマンドを実行します。

npm install serve

次に、study-app/package.jsonを開いて、scriptsフィールドに以下のようなnpmコマンドを追加します。

  "scripts": {
    ...
    "serve": "serve -s build"
  }

追加後に、以下のコマンドを実行してみましょう。

npm run serve

「Serving!」という表示が出たら、localhost:5000にアクセスすればビルド後の結果が表示されます。

serveコマンドの実行

コラム:serveコマンドを使わず、ローカル環境で確認する方法は?

Reactでビルドを行うと、以下のような構成で出力されます。

ビルド後の構成

ビルドされたCSSやJSはstaticディレクトリーに格納され、index.htmlで呼び出しています。ここで気をつけたいのが、ビルド後のリンクパスが絶対パスになっている点です。サーバーにアップロードする場合はサイトルートのパスに応じてリンクされるので問題ありませんが、ローカル環境だと確認ができません。

ビルドファイルが読み込めない

ローカル環境で動作しているかどうかを確認するには、JSやCSSのパスを相対パスにすることで読み込めるようになります。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8" />
    <link rel="icon" href="/favicon.ico" />
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <meta name="theme-color" content="#000000" />
    <meta
      name="description"
      content="Web site created using create-react-app"
    />
    <link rel="apple-touch-icon" href="/logo192.png" />
    <link rel="manifest" href="/manifest.json" />
    <title>React App</title>
    <!-- ビルドされたCSSを相対パスにする -->
    <link href="./static/css/main.8c8b27cf.chunk.css" rel="stylesheet" />
  </head>
  <body>
    <noscript>You need to enable JavaScript to run this app.</noscript>
    <div id="root"></div>
    <!-- ビルドされたJSを相対パスにする -->
    <script src="./static/js/2.57b20a80.chunk.js"></script>
    <script src="./static/js/main.5d7e9895.chunk.js"></script>
  </body>
</html>

コンポーネントを編集してみよう

ビルドが正常にできることを確認したら、アプリケーションの中身を見てみましょう。

src/App.jsの中身を確認してみると、Appという関数の中にHTMLのような文体の要素が記述されています。これは、「JSXジェイエスエックス」と呼ばれるJavaScriptの拡張構文です。HTMLのような見た目をしていますが、内部的にはJavaScriptであるためHTMLとは少し取り扱いが異なる点を覚えておきましょう。後々のレッスンで、JSXについて詳しく解説しています。

それでは、アプリケーションのコンポーネントを編集してみましょう。Create React Appはソースコードを編集した際に自動でブラウザへ反映してくれる、ホットリロード機能を標準で備えています。src/App.jsファイルを編集しましょう。

▼App.js

import React from 'react';
import logo from './logo.svg';
import './App.css';

function App() {
  return (
    <div className="App">
      <header className="App-header">
        <img src={logo} className="App-logo" alt="logo" />
        <p>
          Edit <code>src/App.js</code> and save to reload.
        </p>
        <a
          className="App-link"
          href="https://reactjs.org"
          target="_blank"
          rel="noopener noreferrer"
        >
          Learn React
        </a>
      </header>
    </div>
  );
}

export default App;

App関数のpタグをh1に変更し、中身を変えてみましょう。

import React from 'react';
import logo from './logo.svg';
import './App.css';

function App() {
  return (
    <div className="App">
      <header className="App-header">
        <img src={logo} className="App-logo" alt="logo" />
        <h1>
          Hello!
        </h1>
        <a
          className="App-link"
          href="https://reactjs.org"
          target="_blank"
          rel="noopener noreferrer"
        >
          Learn React
        </a>
      </header>
    </div>
  );
}

export default App;

編集した箇所が自動更新されました。

今回のレッスンでは、以下の内容を学びました。

  • Create React Appを使った環境構築
  • コンポーネント編集の仕方

次のレッスンでは、今回Create React Appで作成したアプリケーションを、さらに編集します。