React NativeとExpo — 書けてもdivは無い

React NativeとExpo。アプリ画面付きのスマートフォンとコードを書くノートパソコン、操作部品。

React Nativeにdivはありません。Webとの違いを押さえ、書けることと書けないことを分けます。

前回: GraphQLクライアント — 一覧を出すのにAPIを4回叩く

これは【深掘り】の記事です。本線の順路ではありません。 本線のブラウザの外へ出る回で「Web の技術のままデスクトップやスマホに出す手段がある」ところまでは触れました。この記事は、そのうち React Native と Expo だけを取り出して、実際にスマホの上で動かすまでをやります。飛ばしても本線は進みます。

この回だけは、VM(Ubuntu Server)ではなく Windows 本体で作業します。 VM の中に Android エミュレータは入れません。 VMware の仮想マシンの中で、さらに Android の仮想化を動かすことになります。動いてもまともな速度になりませんし、多くの場合そもそも起動しません。 ✅ 使うのは「Windows 本体 + 手持ちのスマホ実機 + Expo Go」です。 エミュレータも Android Studio も Xcode も入れません。 実機がどうしても無い場合の代替は、記事の最後(⑥)に書きます。


自分が実際にぶつかったところから書きます。

ここまで React の深掘りを20本以上やってきて、「フックも状態管理もテストも一通り触った」という状態でした。そこで、こういう言葉を何度も見ました。

「React が書けるなら、React Native でスマホアプリも作れる」

素直に信じました。 同じ React なら、useState も props も同じはずです。画面の書き方も、たぶん className が少し違うくらいだろうと思っていました。

やったことは、こうです。プロジェクトを作って、いちばん最初の画面を、自分がいつも Web で書いている書き方で書きました。

export default function App() {
  const [count, setCount] = useState(0);
  return (
    <div className="container">
      <p>カウント: {count}</p>
      <button onClick={() => setCount(count + 1)}>+1</button>
    </div>
  );
}

動きませんでした。

スマホの画面が真っ赤になって、こう出ました。

Invariant Violation: View config getter callback for component `div` must be a function (received `undefined`). Make sure to start component names with a capital letter.

意味が分かりませんでした。「View config」とは何なのか。div の何がいけないのか。

そこで div を消して、React Native で使うと書いてあった View に置き換えました。今度はこうなりました。

Error: Text strings must be rendered within a <Text> component.

文字を、そのまま置いてはいけない。

さらに className="container" は、エラーにこそならないものの、何の効果もありませんでした。 CSS ファイルを作って import しようとしたら、今度はビルドが止まりました。

ここで、ようやく理解しました。

「React が書ける」は本当。「Web の書き方がそのまま通る」は嘘。 同じなのは "考え方" で、違うのは "何を描くか" です。

React の部品の組み立て方(コンポーネント・props・state・フック)は、丸ごとそのまま持っていけます。ところが画面に出す部品そのもの(div や p や CSS)は、1つも持っていけません。 そこは Web ブラウザが持っていたもので、スマホには Web ブラウザが居ないからです。

この記事では、何が同じで、何が違うのかを、頭の中の理解ではなく、実際にスマホの上で動かして、わざと落として切り分けます。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • React Native は「React で Web を書いてスマホで表示する」ものではないこと。HTML は1つも登場しない
  • そのまま持っていけるもの(コンポーネント・props・state・フック・JSX)と、1つも持っていけないもの(div などのタグ・CSS ファイル・onClick)の境界
  • 文字は必ず Text の中に置く必要があること。View に直接文字を書くと、警告ではなく落ちる
  • スタイルは CSS ファイルではなくオブジェクトで書き、単位が無く数値だけで、flexDirection の既定値が column(Web と逆)であること
  • 端末の機能(カメラ・位置情報)は「使えて当たり前」ではないこと。権限をユーザーに聞く必要があり、拒否されたときの分岐を書かないと落ちる
  • Expo と素の React Native の違いと、最初は Expo でよく、困ったら外せること
  • ストアに出すには開発者登録(有料・審査あり)が要ること。iOS のビルドには Mac が要ること。多くの人はここで止まる
  • そもそもネイティブアプリが要るのかを、Web / PWA / ネイティブの3択で判断する材料

この記事でやること

  1. Windows 本体に Node.js があることを確認し、npx create-expo-app で新しいプロジェクトを1つ作る
  2. npx expo start を実行し、出てきた QR コードを手持ちのスマホの Expo Go で読み、自分の書いたコードをスマホの画面に出す
  3. わざと div を書き、わざと View の中に生の文字を書いて、エラーメッセージを自分の目で読む
  4. View / Text / Pressable / StyleSheet でカウンターを作り、保存した瞬間にスマホの表示が変わる(ファストリフレッシュ)ことを確かめる
  5. 位置情報を1つだけ触り、権限ダイアログを「拒否」して、分岐が無いとどうなるかを見る
  6. Expo と素の React Native の違いを表で並べ、配布に何が必要かを確認して、作ったものを片づける

先に知る言葉

基本的な言葉は用語集にもまとめてあります。

言葉意味(1〜2行)
React NativeReact の書き方のまま、スマホの本物の部品(OS が持っているボタンや文字)を動かす仕組み。HTML は使わない
ネイティブアプリスマホの OS 向けに作られ、端末にインストールして使うアプリ。ホーム画面にアイコンが並ぶあれ
ExpoReact Native を面倒な準備なしで始められるようにした一式。開発サーバー・端末機能のライブラリ・クラウドビルドまで含む
Expo Goストアで配られている「他人の書いたコードを実行するための入れ物」アプリ。自分のコードを、ビルドせずに実機で動かせる
View / TextReact Native の基本部品。View は Web の div、Text は文字を入れる箱に相当する。相当するだけで、同じものではない
StyleSheetReact Native でスタイルを書くための仕組み。CSS ファイルではなく JavaScript のオブジェクトを書く
ファストリフレッシュファイルを保存すると、アプリを再起動せずに画面だけが差し替わる仕組み。Web の開発サーバーと同じ考え方
権限(パーミッション)カメラや位置情報など、ユーザーに聞いてから使うことになっている機能の許可。聞かずに使うことはできない
プレビルド / development buildExpo が用意した入れ物から出て、自分専用の入れ物を作り直すこと。ネイティブのコードが必要になったときに使う
EAS BuildExpo が提供するクラウド上でビルドする仕組み。手元に Mac が無くても iOS 向けのビルドができるのが大きい

① 何が同じか — 考え方は全部そのまま持っていける

先に、安心してよいところから確認します。

React でここまで積み上げてきたもののうち、次は全部そのまま通用します。

概念React Native でどうなるか
コンポーネント(関数を書いて返す)まったく同じ
props で親から子へ渡すまったく同じ
useState で状態を持つまったく同じ
useEffect / useRef / useMemoまったく同じ(React 本体のフックだから)
自作フックまったく同じ
JSX の文法まったく同じ({} で式を埋める、map で並べる、key を付ける)
条件分岐で出し分けるまったく同じ
状態を「持つ場所」を決める設計まったく同じ(むしろ、より重要)

つまり、コンポーネントと props の回でやった「部品をどう切るか」「状態を誰が持つか」の話は、1文字も無駄になりません。

理由は単純です。React 本体(react パッケージ)は同じものを使っているからです。

違うのは、その隣にいる相棒です。

環境React が状態を管理する実際に画面へ描くのは
Webreactreact-dom(ブラウザの DOM を触る)
スマホreactreact-native(OS の本物の部品を触る)

「何を描くか」を担当する相手が入れ替わっただけです。だから、React の考え方は残り、描く対象の名前は全部変わります。

これが「半分本当で半分嘘」の正体でした。


② 何が違うか — ここが

ここが、この記事のいちばん重要なところです。4つあります。

違い1: タグが1つも無い

div も span も p も h1 も ul も、1つも存在しません。

理由は「React Native が対応していないから」ではありません。そもそも HTML というものが登場しないからです。画面を描いているのはブラウザではなく、iOS / Android の OS そのものです。OS は div という言葉を知りません。

代わりに使うのは、react-native から import するコンポーネントです。

Web で書いていたものReact Native
<div><View>
<p> <span> <h1>すべて <Text>
<img><Image>
<button><Pressable>(または <Button>)
<input><TextInput>
スクロールする領域<ScrollView> / <FlatList>
<a href>画面遷移のライブラリ(Link など)

<h1> が無いのが分かりやすい例です。大きい文字にしたければ <Text> に大きいサイズを指定するだけで、「見出しである」という意味を持つタグはありません。

HTML はタグで意味を与えるものという話をやりましたが、React Native にはその「意味」の層がありません。 意味(読み上げソフト向けの情報など)は、タグではなく accessibilityRole のような props で明示的に付けます。

違い2: 文字は必ず Text の中に入れる

Web ではこう書けました。

<div>こんにちは</div>

React Native では、これは落ちます。

<View>こんにちは</View>

出るのは、これです。

Error: Text strings must be rendered within a <Text> component.

警告ではありません。画面が赤くなって止まります。

正しくはこうです。

<View>
  <Text>こんにちは</Text>
</View>

慣れるまで、いちばん多く踏みます。 特に、次のような書き方で忘れます。

{/* これは落ちる */}
<View>{count > 0 && `${count}件あります`}</View>

条件分岐の中で文字列を返したときに、それを包む Text を忘れるわけです。③で実際に出します。

違い3: CSS ファイルが無い

.css ファイルは作れませんし、className も効きません。

スタイルは JavaScript のオブジェクトで書き、style に渡します。

import { StyleSheet, View, Text } from 'react-native';

export default function App() {
  return (
    <View style={styles.box}>
      <Text style={styles.label}>こんにちは</Text>
    </View>
  );
}

const styles = StyleSheet.create({
  box: {
    padding: 24,
    backgroundColor: '#eef',
    borderRadius: 8,
  },
  label: {
    fontSize: 18,
    color: '#333',
  },
});

React での CSS の当て方を1つに決める回で「インラインスタイル・CSS Modules・CSS-in-JS のどれを選ぶか」をやりましたが、React Native には選択肢がありません。オブジェクトだけです。

そして、ここに引っかかりやすい違いが3つあります。

違いWebReact Native
単位padding: 24pxpadding: 24(単位を書かない。書くとエラー)
プロパティ名background-colorbackgroundColor(キャメルケース)
flexDirection の既定値rowcolumn

3つ目が、いちばん静かに効きます。

Web で display: flex と書くと、要素は横に並びます。 ところが React Native では、View は最初から flex で、しかも縦並びが既定です。「横に並べたい」と思ったら、明示的に flexDirection: 'row' を書く必要があります。

エラーは出ません。ただ、思っていたのと違う向きに並ぶだけです。「なぜか縦に並ぶ」で30分溶かしました。

また、継承がありません。 Web では親に color を指定すると子の文字にも効きましたが、React Native ではText それぞれに指定する必要があります(Text を入れ子にした場合など、一部の例外はあります)。

違い4: onClick ではなく onPress

{/* Web */}
<button onClick={handle}>押す</button>

{/* React Native */}
<Pressable onPress={handle}>
  <Text>押す</Text>
</Pressable>

onClick を書いても、エラーになりません。何も起きないだけです。これも静かなほうの罠です。

「クリック」ではなく「押す」という言い方に変わっているのは、単なる言い換えではありません。スマホにはマウスオーバーが無く、代わりに長押し・スワイプ・複数本指があるからです。onPress のほかに onLongPress があります。


ここまでを1行でまとめると、こうです。

React の「頭」は持っていける。React の「手」は置いていくことになる。


③ 実際に作って、スマホの実機に出す

読むのはここまでにして、動かします。

前提の確認(Windows の PowerShell で打ちます)

ここから先のコマンドは、すべて Windows 本体の PowerShell で打ちます。VM の中ではありません。

まず Node.js があるか確認します。

bash
$ node -v
$ npm -v

v20.x 以上のような表示が出れば大丈夫です。「認識されていません」と出た場合は、本線の「初期状態のPCに入れるのは3つだけ」の回で Node.js を入れてから戻ってきてください。

そして、スマホ側の準備です。

  1. 手持ちのスマホ(iPhone でも Android でもよい)で、ストアから Expo Go を入れる
  2. スマホと PC を、同じ Wi-Fi に繋ぐ(これが後で効きます)

📷 スクリーンショット①: スマホに Expo Go を入れたところ(ストアの画面、またはホーム画面のアイコン)。

プロジェクトを作る

作業用のフォルダを1つ作って、その中に作ります。この記事で作ったものは、最後に丸ごと消します。

bash
$ cd ~/Desktop
$ npx create-expo-app@latest rnlab --template blank
$ cd rnlab

--template blank は、余計なものが入っていない最小構成を選ぶ指定です。付けないと、タブ付きのサンプルアプリが生成されて、自分が書いた部分がどこか分からなくなります。

数分かかります。終わったら、中を見ます。

bash
$ ls

こういうものが並びます。

ファイル / フォルダ何か
App.js画面の入口。ここを書き換える
package.json依存の一覧。npm の回でやったのと同じもの
app.jsonアプリの名前・アイコン・向きなどの設定
assets/アイコンやスプラッシュ画像
node_modules/入れたパッケージの実体(消してよい)

index.html が無いことを確認してください。Web ではないので、HTML の入口そのものが存在しません。

開発サーバーを起動する

bash
$ npx expo start

ターミナルに QR コードが出ます。

  • Android: Expo Go アプリを開いて、中の「Scan QR code」で読む
  • iPhone: 標準のカメラアプリで QR を写すと、Expo Go を開くかどうか聞かれる

読み込むと、数十秒バンドルが作られて、スマホの画面に "Open up App.js to start working on your app!" と出ます。

📷 スクリーンショット②: PC のターミナルに出た QR コードと、その隣に、同じものを表示しているスマホの実機。「PC のコードがスマホで動いている」ことが1枚で分かるようにする。

繋がらないときの切り分け

ここでいちばん詰まります。 QR を読んだのに「Something went wrong」や、延々とロード中のままになるやつです。

上から順に潰します。

#確認することどう確かめるか
1PC とスマホが同じ Wi-Fi かスマホがモバイル回線になっていないか。 Wi-Fi のネットワーク名を両方で見比べる
2PC が有線 LAN で、スマホが Wi-Fi ではないか同じ建物でも、別のネットワークとして分かれていることがある。PC も Wi-Fi に繋ぎ直す
3ゲスト用 Wi-Fi ではないかゲスト用は端末同士の通信を遮断していることが多い。これだと原理的に繋がらない
4Windows のファイアウォールが止めていないか初回起動時に出る「アクセスを許可しますか」のダイアログで拒否していないか。設定から Node.js の受信を許可する
5それでも駄目なら USB / トンネル経由にするnpx expo start --tunnel で起動し直す。Wi-Fi を経由せず外部サーバー越しに繋ぐので遅いが、繋がる

4番までで解決しないときの最後の手段が5番です。自分の場合は 3番(ゲスト用 Wi-Fi)でした。同じ「Wi-Fi の名前」に見えていて、実は別ネットワークだった、というやつです。

「繋がらない」を4段階で切り分ける回でやった考え方と同じです。下(物理・ネットワーク)から順に確かめる。 アプリのコードを疑うのは最後です。

わざと落とす(違い2の確認)

繋がったら、先に壊します。 App.js を開いて、中身をこれに置き換えます。

import { View } from 'react-native';

export default function App() {
  return (
    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
      こんにちは
    </View>
  );
}

保存すると、スマホの画面が赤くなります。

Error: Text strings must be rendered within a <Text> component.

これを自分の目で見ておくのが大事です。 この文言を1度読んでおけば、次からは5秒で直せます。

次に、div を書いてみます。

export default function App() {
  return <div>こんにちは</div>;
}

出るのは、こちらです。

Invariant Violation: View config getter callback for component `div` must be a function (received `undefined`). Make sure to start component names with a capital letter.

「View config が関数でない」という言い方が親切ではないのですが、意味は「そんな部品は知らない」です。末尾の「部品の名前は大文字で始めて」が、ほぼ答えです。

エラーは下から読む回でやったとおり、赤い画面をスクリーンショットして閉じる前に、1行目を読む。 React Native の赤い画面は、下にスタックトレースが続きますが、原因は上の1〜2行にほぼ全部書いてあります。

カウンターを作る

直します。App.js を、これに置き換えます。

import { useState } from 'react';
import { StyleSheet, View, Text, Pressable } from 'react-native';

export default function App() {
  const [count, setCount] = useState(0);

  return (
    <View style={styles.screen}>
      <Text style={styles.count}>{count}</Text>

      <View style={styles.row}>
        <Pressable style={styles.button} onPress={() => setCount(count - 1)}>
          <Text style={styles.buttonLabel}>-1</Text>
        </Pressable>

        <Pressable style={styles.button} onPress={() => setCount(count + 1)}>
          <Text style={styles.buttonLabel}>+1</Text>
        </Pressable>
      </View>

      <Pressable onPress={() => setCount(0)}>
        <Text style={styles.reset}>リセット</Text>
      </Pressable>
    </View>
  );
}

const styles = StyleSheet.create({
  screen: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#fafafa',
  },
  count: {
    fontSize: 64,
    fontWeight: 'bold',
    marginBottom: 24,
  },
  row: {
    flexDirection: 'row',
    gap: 16,
  },
  button: {
    paddingVertical: 12,
    paddingHorizontal: 28,
    borderRadius: 8,
    backgroundColor: '#2563eb',
  },
  buttonLabel: {
    color: '#fff',
    fontSize: 20,
  },
  reset: {
    marginTop: 24,
    color: '#2563eb',
  },
});

保存すると、アプリを触らなくても、スマホの画面が勝手に切り替わります。 これがファストリフレッシュです。

ここで確かめてほしいことが3つあります。

  1. useState が、Web のときと1文字も違わないこと
  2. styles.row の flexDirection: 'row' を消してみる。→ ボタンが縦に並びます。 これが「既定値が column」の意味です
  3. count の値を保ったまま保存すると、カウントがリセットされずに残ること(状態を保ったままコードだけ差し替わっている)

3番は特に見ておく価値があります。「カウントを5にしてから、色を変えて保存する」とよく分かります。数字は5のままで、色だけ変わります。

📷 スクリーンショット③: スマホでカウントを進めた状態と、PC の VS Code に開いた App.js。片方を直すともう片方が変わる構図。


④ 端末の機能を1つだけ触る — 権限の話

ここが、Web との一番大きな差です。

Web でも位置情報は取れますが、スマホのアプリではカメラ・写真・連絡先・通知・バックグラウンド動作まで、幅広く触れます。ただし、どれも勝手には使えません。

位置情報を1つだけやります。入れるのは1パッケージです。

bash
$ npx expo install expo-location

npm install ではなく npx expo install を使います。 Expo が、いま使っている React Native のバージョンに合うバージョンを選んで入れてくれます。npm install で最新を入れると、バージョンがずれて起動しなくなることがあります。

App.js に足します。

import { useState } from 'react';
import { StyleSheet, View, Text, Pressable } from 'react-native';
import * as Location from 'expo-location';

export default function App() {
  const [status, setStatus] = useState('まだ取得していません');

  async function getLocation() {
    setStatus('取得中...');

    // ① まず「使ってよいか」をユーザーに聞く
    const permission = await Location.requestForegroundPermissionsAsync();

    // ② ⚠️ 断られたときの分岐。これが無いと次の行で落ちる
    if (permission.status !== 'granted') {
      setStatus('位置情報が許可されませんでした');
      return;
    }

    // ③ ここでようやく取れる
    const position = await Location.getCurrentPositionAsync({});
    setStatus(
      `緯度 ${position.coords.latitude.toFixed(4)} / 経度 ${position.coords.longitude.toFixed(4)}`
    );
  }

  return (
    <View style={styles.screen}>
      <Text style={styles.status}>{status}</Text>
      <Pressable style={styles.button} onPress={getLocation}>
        <Text style={styles.buttonLabel}>現在地を取る</Text>
      </Pressable>
    </View>
  );
}

const styles = StyleSheet.create({
  screen: { flex: 1, justifyContent: 'center', alignItems: 'center', padding: 24 },
  status: { fontSize: 16, marginBottom: 24, textAlign: 'center' },
  button: {
    paddingVertical: 12,
    paddingHorizontal: 28,
    borderRadius: 8,
    backgroundColor: '#2563eb',
  },
  buttonLabel: { color: '#fff', fontSize: 18 },
});

ボタンを押すと、OS のダイアログが出ます。 「このアプリに位置情報の使用を許可しますか」というやつです。

ここで、必ず1回は「許可しない」を押してください。

分岐を書いてあるので、画面には「位置情報が許可されませんでした」と出るだけです。ここで ② の if を消して、もう一度「許可しない」を押すと、赤い画面になります。

ここが Web と決定的に違うところです。 端末の機能は「使える前提」で書けません。 「聞く」「断られる」「あとから設定で変えられる」の3つを、毎回コードに書く必要があります。

もう1つ大事なことがあります。一度「許可しない」を選ぶと、次からダイアログが出なくなります。 OS が覚えているためです。もう一度試したいときは、スマホの設定 → Expo Go → 位置情報から手で戻します。

「テスト中にダイアログが出ないので、コードが動いていないと思った」——これを2回やりました。コードではなく、OS が覚えているだけでした。


⑤ Expo と、素の React Native の違い

ここまで「Expo」と言い続けてきましたが、React Native そのものとは別物です。整理します。

素の React NativeExpo(Expo Go で動かす)
始めるのに要るものAndroid Studio / Xcode(数十 GB)Node.js とスマホだけ
実機で動かすまでビルドが必要。初回は数十分かかることもあるQR を読むだけ
カメラ・位置情報など自分でライブラリを入れ、ネイティブ側の設定も書くnpx expo install 1行で入る
ネイティブのコード(Swift / Kotlin)を書けるか書けるExpo Go のままでは書けない
ビルドをどこでやるか手元の PC。iOS 向けは Mac が必須クラウド(EAS Build)が使える。Mac が無くても iOS 向けを作れる
更新の反映再ビルド保存した瞬間(ファストリフレッシュ)

迷ったら Expo でよいです。

かつては「Expo で始めると、あとで困って全部作り直し」と言われていました。いまはそうではありません。 困ったときの出口が用意されています。

段階何をするか
1. Expo Goいまやったところ。入れ物は他人のもの。ネイティブのコードは書けない
2. development build自分専用の Expo Go を作る。好きなネイティブのライブラリを入れられて、ファストリフレッシュは残る
3. prebuild して取り出すandroid/ ios/ フォルダを生成し、素の React Native と同じ状態にする。戻すのは手間

1 → 2 は、多くの人が実際に通ります。 「Expo Go に入っていないライブラリを使いたい」となった時点で 2 に進みます。3 まで行く必要があるのは、かなり特殊なことをする場合だけです。

つまり、最初から素の React Native を選ぶ理由は、いまはあまりありません。 困ったときに外せるからです。


⑥ 配布の現実 — ここで止まる人がいちばん多い

カウンターがスマホで動いたところで、「アプリを作った」と言いたくなります。 自分もそうでした。

ところが、「他の人に使ってもらう」までには、まだ距離があります。 ここを正直に書きます。

配布の4段階

段階誰が使えるか必要なもの
1. Expo Go で自分が動かす自分だけNode.js とスマホ。いまここ
2. QR / リンクを人に渡すExpo Go を入れた知人同上。相手にも Expo Go を入れてもらう必要がある
3. ファイル(apk など)を直接渡すAndroid の知人ビルド環境(EAS Build でも可)。iOS ではこの手が実質使えない
4. ストアに出す全世界開発者登録(有料)+審査+アイコン・説明文・プライバシー方針

4段階目に何が要るか

  • Apple / Google の開発者アカウント登録が必要です。 どちらも有料で、Apple は年ごと、Google は登録時という形の違いがあります。金額はここには書きません。変わるので、必ず公式の料金ページを見てください
  • 審査があります。 出せば載る、ではありません。理由を付けて差し戻されます(説明文と実物が違う、権限を取る理由が書かれていない、など)
  • iOS 向けのビルドには、原則 Mac が必要です。 Apple のビルドツールが macOS でしか動かないためです
  • その回避策が EAS Build です。Expo のクラウド上でビルドするので、手元に Mac が無くても iOS 向けのファイルを作れます。ただし無料枠を超えると有料なので、これも公式の料金ページを確認してください
  • アイコン・スプラッシュ画像・スクリーンショット・説明文・プライバシーポリシーが必要です。プライバシーポリシーは、位置情報などを取るなら実質必須です

だから、ここで区切る

この記事の着地は「Expo Go で自分のスマホに出せた」までにします。 理由は2つあります。

  1. 登録は有料で、しかも本人確認が要ります。 学習の途中で払うものではありません
  2. 「作る」と「配る」は別の仕事です。 デプロイと運用の回で Web についてやったのと同じで、配布は配布で丸ごと1つの学習項目です

実機が手元に無い場合は、npx expo start のあとに w キーを押すと、ブラウザで動きます(React Native for Web)。ただし、これは「近いもの」であって同じではありません。 位置情報やカメラの挙動、権限ダイアログ、スクロールの感触は再現されません。④の権限の話は、実機でないと体験できません。


⑦ そもそもネイティブアプリが要るのか — 判断表

最後に、いちばん手前の話に戻ります。

「スマホで使いたい」=「アプリを作る」ではありません。 選択肢は3つあります。

やりたいことWeb で足りるPWA で足りるネイティブが要る
スマホの画面で見やすく表示したい✅ 足りる(レスポンシブ)——
ホーム画面にアイコンを置きたい△ ブックマーク✅ 足りる—
通信が無いときも動かしたい❌✅ 足りる(Service Worker)—
写真を選んでアップロードしたい✅ 足りる(input type="file")✅—
カメラを常時起動して読み取り続けたい△ 制約が多い△✅ 要る
アプリを閉じていても通知を出したい❌△ iOS での扱いに制約がある✅ 要る
アプリ内で課金したい❌❌✅ 要る(ストアの仕組みを使う)
バックグラウンドで位置を記録し続けたい❌❌✅ 要る
端末の連絡先やヘルスケアのデータを読みたい❌❌✅ 要る
「ストアにある」という信用が欲しい❌❌✅ 要る

見て分かるとおり、上半分は Web か PWA で足ります。

ネイティブが本当に必要になるのは、「アプリを閉じている間も何かをする」か「OS が守っているデータに触る」か「ストアの仕組みを使う」の3つに、ほぼ集約されます。

「Web 版とアプリ版を両方作る」を安く見積もらない

ここは正直に書きます。

React Native と React でコードを共有できるので、作る量は2倍にはなりません。 状態管理・API 通信・入力の検証・自作フックは、そのまま共有できます。

ただし1.5倍にはなります。 共有できないものが、これだけあるからです。

  • 画面のコード(JSX)。div と View は別物なので、書き直しです
  • スタイル。CSS とオブジェクトで、書き直しです
  • 画面遷移。ブラウザの URL と、アプリの画面スタックは別の考え方です(ルーティングの回で扱った /tasks/3 のような URL は、アプリには存在しません)
  • テスト。ブラウザが無いので、Vitest でやったテストの道具立てがそのままでは使えません
  • リリース作業が2系統になる。Web は上げれば終わりですが、アプリは審査を待ちます
  • バージョンが2つ存在する。ユーザーが古いアプリを更新してくれないので、サーバー側は古い版も相手にし続ける必要があります

最後の項目が、いちばん見落とされます。Web ならリロードで全員が新しくなりますが、アプリはそうなりません。

だから、判断はこうなります。

迷ったら、まず Web で作る。 上の表の「ネイティブが要る」に◯が付いたときに、初めてアプリを作る。


つまずいたところ

  1. div を書いて View config getter callback for component `div` must be a function で止まった

→ 「View config」という見慣れない言葉に引っ張られて、「入れるパッケージが足りないのか」と探しました。そうではなく、HTML というものが存在しません。 View に置き換えるだけでした。

  1. View に文字を直接書いて落ちた

→ Text strings must be rendered within a <Text> component. です。警告ではなく停止です。特に {条件 && '文字列'} の中で忘れます。文字が出る場所には必ず Text がある、と覚えるまで何度も踏みました。

  1. padding: '24px' と書いて落ちた

→ React Native では単位を書きません。24 です。Web の癖で px を付けると、「数値であるべき」という趣旨のエラーになります。

  1. 横に並べたつもりが縦に並んだ

→ エラーが1つも出ないので、いちばん時間を溶かしました。 React Native は flexDirection の既定値が column です。Web と逆です。横にしたいときだけ flexDirection: 'row' を明示します。

  1. QR を読んでも「Something went wrong」から進まなかった

→ 原因はゲスト用の Wi-Fi でした。ネットワーク名は同じに見えても、端末同士が通信できない設定になっていました。③の切り分け表を上から順に潰して見つけました。最後の手段は --tunnel です。

  1. onClick を書いて、押しても何も起きなかった

→ エラーが出ません。 React Native は onPress です。onClick は「知らない props」として黙って捨てられます。「押しても無反応」のときは、まず props の名前を疑うようにしました。

  1. 権限ダイアログが2回目から出なくなった

→ 一度「許可しない」を押すと、OS が覚えます。 コードが壊れたと思って30分探しました。スマホの設定から Expo Go の権限を戻す必要があります。「もう一度試す」がタダではないのが、Web との違いでした。

  1. npm install expo-location で入れたら、起動しなくなった

→ npx expo install を使うべきでした。 最新版が、いま使っている React Native のバージョンと合っていませんでした。Expo 関連のパッケージは npx expo install と決めてしまうのが安全です。


後片づけ

この記事で作ったものは、全部消します。

まず、開発サーバーを止めます。ターミナルで Ctrl + C です。

そのうえで、フォルダごと消します。

bash
$ cd ~/Desktop
$ rm -rf rnlab

PowerShell で rm -rf が使えない場合は、エクスプローラーで rnlab フォルダを削除しても同じです。

スマホ側の片づけも、忘れずにやります。

  1. Expo Go アプリを消す(使い続けるなら残してよい)
  2. 消さない場合は、設定 → Expo Go → 位置情報 を「許可しない」に戻す

2番は、④で位置情報の許可を出した場合だけです。学習のために出した許可を、そのままにしない、というだけの話ですが、消したつもりで残る類の話と同じで、片づけまでが1セットです。

本線で作った ~/react-demo/ や、VM の中には、この記事では一切触っていません。 触っていないことも確認しておいてください。


まとめ — 理解できたこと

  1. 「React が書けるならアプリも作れる」は半分本当。React の考え方(コンポーネント・props・state・フック・JSX)は1つも無駄にならない
  2. 半分嘘なのは「Web の書き方が通る」の部分。react は同じで、隣にいる react-dom が react-native に入れ替わっただけ。だから描く対象の名前が全部変わる
  3. div も span も p も存在しない。 HTML そのものが登場しない。使うのは View / Text / Image / Pressable / TextInput
  4. 文字は必ず Text の中に置く。 View に直接書くと警告ではなく停止する。条件分岐の中で忘れやすい
  5. CSS ファイルは作れない。 StyleSheet.create でオブジェクトを書く。単位は書かず数値だけ、プロパティ名はキャメルケース
  6. flexDirection の既定値が column(Web と逆)。エラーが出ないので、いちばん静かに時間を奪う
  7. onClick は無反応。onPress を使う。 これもエラーが出ない側の罠
  8. npx create-expo-app と npx expo start で、Android Studio も Xcode も入れずに実機で動く。 QR を Expo Go で読むだけ
  9. 繋がらないときは、コードではなくネットワークから疑う。 同じ Wi-Fi か → ゲスト用でないか → ファイアウォールか → 最後に --tunnel
  10. 端末の機能は「使える前提」で書けない。 権限を聞き、拒否されたときの分岐を必ず書く。書かないと落ちる
  11. 一度拒否した権限は、次から聞かれない。 OS が覚えている。設定から手で戻す必要がある
  12. Expo は「あとで外せる」。 Expo Go → development build → prebuild という出口があるので、最初は Expo でよい
  13. ストア配布には開発者登録(有料・審査あり)が要り、iOS のビルドには Mac が要る(EAS Build でクラウド代替は可能)。ここで止まる人が多いので、Expo Go で自分のスマホに出せたところで一区切りにしてよい
  14. アプリが本当に要るのは「閉じている間も動く」「OS が守るデータを触る」「ストアの仕組みを使う」の3つ。 それ以外は Web か PWA で足りる。Web 版とアプリ版の両方は、2倍にはならないが1.5倍にはなる

参考リンク


この段階の確認

【深掘り】React は、ここで終わりです。 次に進む前に、答えを見ずに試してください。

読み終えた直後は、たいてい「分かった気」になっています。 手が動くかどうかは別です。

説明できますか

  1. JSXの正体は何か。 変換後に何になっていますか
  2. 押していない子まで描き直されるのはなぜか
  3. useMemo を付けるほど遅くなることがあるのはなぜか

手が動きますか

  • 再描画の回数を実際に数え、減らしてから測り直す
  • カスタムフックに切り出し、「似ているだけでは共通化しない」判断をする
  • エラー境界を置き、例外1つで画面が真っ白にならないようにする

1つでも詰まったら、飛ばした回があります。 そこへ戻ってください。戻るのは後退ではありません。 戻り先の目安: JSXの回 / 再描画の回 / useMemoの回 / カスタムフックの回

全部答えられたなら、次の段階へ進んでください。


次に読む

この記事は 【深掘り】React の 24 / 24 本目です。

記事
← 前の記事GraphQLクライアント — 一覧を出すのにAPIを4回叩く
→ 次の記事Kubernetesは要るのか — 1台で足りるなら入れない

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

›React — Mobile
  • div も CSS ファイルも無い
  • Expo Go で自分のスマホに配るまで

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次