メインコンテンツへスキップ
チュートリアル

Capacitor 8 を使って Next.js アプリを iOS & Android に変換

Capacitor 8 を使って、既存の Next.js 15 Web アプリをネイティブの iOS/Android モバイルアプリに変換しましょう。静的エクスポートの設定、ネイティブプラグインの追加、アプリストアへのデプロイまでを解説する完全ガイドです。

ブログ記事のイラスト: Capacitor 8 Capgo で Next.js アプリを iOS & Android に変換

はじめに

既存の Next.js Web アプリがありますか?このガイドでは、それをネイティブの iOS および Android モバイルアプリに変換する方法を説明します。使うのは Capacitor 8 — パフォーマンスが向上し、新機能を備えた最新バージョン。

Capacitor は、既存の React コードベースを維持したまま、Web アプリをネイティブコンテナでラップし、カメラやファイルシステム、プッシュ通知などのデバイス API へのアクセスを可能にします。React Native とは異なり、コードを書き直す必要はありません。Next.js の code がそのまま動作します。

学習内容:

  • 既存の Next.js アプリを静的エクスポート用に設定する
  • 必須のネイティブプラグインを含む Capacitor 8 を追加する
  • iOS および Android シミュレーターでのビルドとテスト
  • 開発を高速化するライブリロードの有効化
  • iOS でよくあるレイアウトの問題(viewport、セーフエリア、横方向のオーバーフロー)の修正
  • Capgo Native Navigation と Transitions でネイティブに近い UI を実現する

ゼロから新しいプロジェクトを始めたい方は、こちらのガイドをご覧ください: Next.js モバイルアプリをゼロから構築する.

Next.js と Capacitor を使用するメリット

  • Code による再利用性Next.js なら再利用可能なコンポーネントを書けて、Web アプリとモバイルアプリ間で code を共有できるため、開発の時間と手間を節約できます。
  • パフォーマンス:Next.js はサーバーサイドレンダリングや code スプリッティングなどのパフォーマンス最適化を内蔵しており、高速な読み込みとスムーズなユーザー体験を実現します。
  • ネイティブ機能:Capacitor を使用すると、カメラや位置情報などのネイティブデバイス機能にアクセスでき、機能豊富なモバイルアプリを構築できます。
  • 開発の簡素化:Capacitor を使用すると、慣れ親しんだ Web 技術でモバイルアプリの開発とテストが可能になり、学習コストを削減し、開発プロセスを効率化できます。

前提条件

開始前に、以下が用意されていることを確認してください:

  • Node.js 18以上 インストール
  • 既存の Next.js 15+ アプリケーション
  • iOSプロファイリング (iOS開発用、macOSのみ)
  • デバッグ (Android開発用)

Next.js アプリのモバイル向け設定

最初のステップは、Next.js アプリを静的エクスポート用に設定することです。Capacitor は、ネイティブアプリにバンドルするための静的な HTML/JS/CSS ファイルが必要です。

を開き next.config.js (または next.config.ts) ファイルにエクスポート設定を追加します:

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'export',
  images: {
    unoptimized: true,
  },
};

module.exports = nextConfig;

この output: 'export' この設定により、Next.js は静的 HTML ファイルを生成し、 images: { unoptimized: true } サーバーを必要とする Next.js の画像最適化を回避します。

重要: サーバーが必要な機能(API ルートや、データ取得を行うサーバーコンポーネントなど)を使用している場合は、クライアントサイドの代替手段や外部 API を使うようにリファクタリングする必要があります。

モバイル専用のスクリプトを追加してください: package.json:

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "next lint",
    "mobile": "bun run build && bunx cap sync",
    "mobile:ios": "bun run mobile && bunx cap open ios",
    "mobile:android": "bun run mobile && bunx cap open android"
  }
}

静的エクスポートをテストするには、次を実行します:

bun run build

以下が表示されるはずです: out プロジェクトのルートにあるフォルダです。ここには、Capacitor がネイティブアプリにバンドルするすべての静的ファイルが含まれています。

プロジェクトに Capacitor 8 を追加する

Next.js アプリをネイティブモバイルコンテナにパッケージングするには、以下の手順に従ってください:

  1. Capacitor core と CLI をインストールします:
bun add @capacitor/core
bun add -D @capacitor/cli
  1. 必要になりそうな一般的な Capacitor プラグインをインストールします:
bun add @capacitor/app @capacitor/keyboard @capacitor/splash-screen @capacitor/preferences

これらのプラグインは、以下の必須機能を提供します:

  • @capacitor/app:アプリのライフサイクルイベント(フォアグラウンド/バックグラウンド、URL)を処理
  • @capacitor/keyboard:モバイルでのキーボードの動作を制御します
  • @capacitor/splash-screen: ネイティブのスプラッシュ画面を管理
  • @capacitor/preferences:キーバリューデータを永続的に保存
  1. プロジェクトの詳細で Capacitor を初期化します:
bunx cap init my-app com.example.myapp --web-dir out

置換する my-app アプリ名と com.example.myapp アプリID(逆ドメイン形式)を使用して。

  1. 以下を作成または更新: capacitor.config.ts 適切な設定を含むファイル:
import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.myapp',
  appName: 'my-app',
  webDir: 'out',
  plugins: {
    SplashScreen: {
      launchShowDuration: 2000,
      launchAutoHide: true,
      androidScaleType: 'CENTER_CROP',
      showSpinner: false,
      splashFullScreen: true,
      splashImmersive: true,
    },
  },
};

export default config;
  1. ネイティブプラットフォームのインストール:
bun add @capacitor/ios @capacitor/android
  1. ネイティブプラットフォームフォルダーの追加:
bunx cap add ios
bunx cap add android

Capacitor は作成します ios と android プロジェクトのルートにネイティブプロジェクトを含むフォルダーを。

Androidプロジェクトをビルドするには デバッグが必要です。iOSの場合は、Macが必要です。 iOSプロファイリング.

  1. プロジェクトのビルドと同期:
bun run mobile

これにより、Next.jsプロジェクトをビルドして静的ファイルをネイティブプラットフォームと同期するカスタムスクリプトが実行されます。

ネイティブアプリのビルドとデプロイ

ネイティブモバイルアプリをビルドしてデプロイするには、以下の手順に従ってください。 iOSアプリを開発するには、 iOSプロファイリング のインストールが必要です。また、Androidアプリの場合は、 デバッグ のインストールが必要です。さらに、アプリをApp Storeで配布する場合は、iOS用にApple Developer Programへ、Android用にGoogle Play Consoleへの登録が必要になります。

  1. ネイティブプロジェクトを開く:

iOSの場合:

bun run mobile:ios

Androidの場合:

bun run mobile:android

または Capacitor CLI で直接実行:

bunx cap open ios
bunx cap open android
  1. アプリをビルドして実行する:

Android Studioで実行

  • Android Studio でプロジェクトの準備が完了するのを待ってから、「Run」ボタンをクリックして、接続されたデバイスまたはエミュレーターにアプリをデプロイします。 Xcodeで実行

  • Xcode で署名アカウントを設定し、実機にアプリをデプロイします。初めての場合は、Xcode が設定をガイドします(Apple Developer Program に登録している必要があります)。設定が完了したら、「Play」ボタンをクリックして、接続されたデバイスでアプリを実行します。

おめでとうございます!Next.js ウェブアプリをモバイルデバイスに正常にデプロイできました。

nextjs-mobile-app
ただし、開発中はもっと高速な方法もあります...

Capacitor Live Reload

開発中は、ライブリロードを活用して、変更をモバイルデバイスに即座に反映できます。この機能を有効にするには、以下の手順に従ってください:

  1. ローカルIPアドレスを確認してください:
  • macOS では、ターミナルで以下のコマンドを実行します:

    ipconfig getifaddr en0
  • Windowsの場合は、以下を実行してください:

    ipconfig

    出力結果からIPv4アドレスを確認します。

  1. 以下のファイルを更新して、 capacitor.config.ts 開発サーバーを指すように:
import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'my-app',
  webDir: 'out',
  server: {
    url: 'http://YOUR_IP_ADDRESS:3000',
    cleartext: true,
  },
};

export default config;

置換する YOUR_IP_ADDRESS ローカルIPアドレスに置き換えます(例: 192.168.1.100).

  1. 変更をネイティブプロジェクトに適用します:
bunx cap copy

この copy このコマンドは、プロジェクト全体を更新することなく、webフォルダと設定の変更内容のみをネイティブプロジェクトにコピーします。

  1. Android StudioまたはXcodeを使用して、デバイス上でアプリを再ビルドして実行してください。

これで、Next.jsアプリに変更を加えるたびに、モバイルアプリが自動的にリロードされ、その変更が反映されるようになります。

注意:新しいプラグインをインストールしたり、ネイティブファイルを変更したりした場合は、ネイティブプロジェクトの再ビルドが必要です。ライブリロードはwebの code の変更にのみ適用されるためです。

Capacitor プラグインの使用

Capacitor プラグインを使うと、Next.js アプリからネイティブのデバイス機能にアクセスできます。ここでは、その使い方を見ていきます プラグインを共有 例として:

  1. Shareプラグインをインストールします:
bun add @capacitor/share
  1. 更新: pages/index.js ファイルで Share プラグインを使用します:
import Head from 'next/head';
import styles from '../styles/Home.module.css';
import { Share } from '@capacitor/share';

export default function Home() {
  const share = async () => {
    await Share.share({
      title: 'Open Youtube',
      text: 'Check new video on youtube',
      url: 'https://www.youtube.com',
      dialogTitle: 'Share with friends',
    });
  };

  return (
    <div className={styles.container}>
      <Head>
        <title>Create Next App</title>
        <meta name="description" content="Generated by create next app" />
        <link rel="icon" href="/favicon.ico" />
      </Head>

      <main className={styles.main}>
        <h1 className={styles.title}>
          Welcome to <a href="https://nextjs.org">Capgo!</a>
        </h1>

        <p className={styles.description}>
          <h2>Cool channel</h2>
          <button onClick={() => share()}>Share now!</button>
        </p>
      </main>
    </div>
  );
}
  1. 変更をネイティブプロジェクトに同期します:

先ほど説明したように、新しいプラグインをインストールするときは、sync 操作を行ってからアプリをデバイスに再デプロイする必要があります。これを行うには、次のコマンドを実行してください:

bun run mobile

または、リビルドせずに同期のみ行います:

bunx cap sync
  1. アプリを再ビルドして、デバイス上で実行します。

これで「Share now!」ボタンをクリックすると、ネイティブの共有ダイアログが表示され、他のアプリとコンテンツを共有できます。

next-capacitor-share
次に、Capgo のナビゲーションとトランジションを使って、iOS と Android でアプリをよりネイティブらしく感じさせ、水平方向のオーバーフローや安全領域の切り詰めを引き起こす一般的な iOS レイアウトの問題を修正します。 ## Capgo のネイティブナビゲーションとトランジションによるネイティブな UI

私は長年、 Ionic クロスプラットフォームアプリの構築には適していますが、既存の環境がある場合、Next.js との統合はハック的で、ほとんど意味がありません Tailwind CSS 4.

Next.js + Capacitor アプリでネイティブなモバイル体験を実現するには、Konsta UI などの Web 専用 UI キットではなく、Capgo プラグインを使用してください:

  • @capgo/capacitor-native-navigation — ネイティブなナビゲーションバー、iOS での Liquid Glass タブバー、Android でのブラー付きタブバースタイル。Next.js のルーターがルート状態を管理し、プラグインがネイティブの UI 要素を管理します。
  • @capgo/capacitor-transitions — Ionic UIを採用せずに、WebViewレイヤーでIonicスタイルのページ遷移とiOSのエッジスワイプによる戻る操作を実現します。

両方をインストールしてください:

bun add @capgo/capacitor-native-navigation @capgo/capacitor-transitions
bunx cap sync

CSS insetモードでネイティブナビゲーションを設定し、Webコンテンツがネイティブバーと重ならないようにします:

import { NativeNavigation } from '@capgo/capacitor-native-navigation';

await NativeNavigation.configure({
  contentInsetMode: 'css',
  animationDuration: 360,
  glass: {
    effect: 'liquidGlass',
  },
});

Liquid Glassタブバーをレンダリングします(iOSはシステム側のレンダリングを使用し、Androidはぼかし付きWebViewバックドロップを使用します):

await NativeNavigation.setTabbar({
  selectedId: 'home',
  labelVisibilityMode: 'labeled',
  icons: true,
  colors: { dynamic: true },
  tabs: [
    { id: 'home', title: 'Home', icon: { svg: '...' } },
    { id: 'settings', title: 'Settings', icon: { svg: '...' } },
  ],
});

await NativeNavigation.addListener('tabSelect', ({ id }) => {
  router.push(`/${id}`);
});

アプリシェルにネイティブページ遷移を追加します:

import '@capgo/capacitor-transitions';
import { initTransitions, setDirection, setupRouterOutlet } from '@capgo/capacitor-transitions/react';

initTransitions({ platform: 'auto' });

ルーティングされたページを以下でラップします: cap-router-outlet, cap-pageや cap-content、そして呼び出します setDirection('forward') または setDirection('back') の前に router.push() または router.back()。ネイティブナビゲーションがヘッダーやフッターを担当している場合、Webのヘッダーやフッターを重複させないでください。

ガイドの全文はこちら: @capgo/capacitor-native-navigation の活用 と @capgo/capacitor-transitions の活用.

Tailwind によるセーフエリア対応

Tailwind CSS でデバイスのセーフエリアを扱うには、以下を使用します: @capgo/tailwind-capacitor ( tailwind-capacitor として npm で公開)。これは、 safe-areas ユーティリティや Capacitor と相性の良いその他の Tailwind プラグインを提供します:

bun add -D tailwind-capacitor

では styles/globals.css:

@import 'tailwindcss';
@plugin "@capgo/tailwind-capacitor/platform";
@plugin "@capgo/tailwind-capacitor/safe-areas";

次のようなユーティリティを使用します: pt-safe, pb-safeや px-safe 手作業でばらまくのではなく env(safe-area-inset-*) 手動で行っています。このプロジェクトは活発に開発が進められています。Next.jsのセットアップで足りないものがあれば、 GitHub でPRを作成してください.

iOSのレイアウト問題を修正(ビューポート、セーフエリア、横方向のオーバーフロー)

iOSでコンテンツが切れて見えたり、ずれて見えたり、横スクロールが発生したりする場合は、さらに追加するだけでも、 overflow-x: hidden viewportタグを調整するだけでも通常は解決しません。以下のチェックを順番に確認してください。

viewport メタタグが正しく適用されているか確認する

App Router (app/): export viewport と app/layout.tsx:

import type { Viewport } from 'next';

export const viewport: Viewport = {
  width: 'device-width',
  initialScale: 1,
  viewportFit: 'cover',
};

Pages Router (pages/): viewportのmetaタグはここに配置します pages/_app.tsxではなく、 _document.tsx (Next.js は、タグを _document.tsx viewport の動作で想定どおりに適用しない場合があります)。

iOSのセーフエリアは1つのルートラッパーだけで処理する

単一のアプリシェルを作成し、そこにセーフエリアのパディングを適用してください — 複数のネストしたコンポーネントではなく:

html,
body,
#__next {
  width: 100%;
  min-height: 100%;
  margin: 0;
  padding: 0;
  overflow-x: hidden;
}

* {
  box-sizing: border-box;
}

.app-shell {
  min-height: 100dvh;
  width: 100%;
  padding-top: env(safe-area-inset-top);
  padding-right: env(safe-area-inset-right);
  padding-bottom: env(safe-area-inset-bottom);
  padding-left: env(safe-area-inset-left);
}

すべてのページコンテンツを以下でラップします: .app-shellヘッダー、モーダル、レイアウトラッパーで safe-area のパディングが重複すると、UI が欠けたり、逆に大きすぎたりすることがよくあります。

を使用すると、 @capgo/tailwind-capacitor同じパディングを次のようなユーティリティで表現できます: pt-safe pb-safe px-safe その単一のシェル上で。

Capacitor iOS を設定 contentInset まで never 最初に

では capacitor.config.ts、native inset を無効にすることを推奨し、CSS(または Native Navigation のもの contentInsetMode: 'css')に safe area を任せる:

const config: CapacitorConfig = {
  appId: 'com.example.myapp',
  appName: 'my-app',
  webDir: 'out',
  ios: {
    contentInset: 'never',
  },
};

Capacitor の自動コンテンツ inset と CSS を混在させると env(safe-area-inset-*) padding は二重スペースのよくある原因です。

実際にオーバーフローしている要素を特定する

原因はたいてい、使用している要素です 100vw、Tailwind w-screen、固定ピクセル幅、または大きな min-width.

Safari Web Inspectorで以下を実行してください:

[...document.querySelectorAll('*')]
  .filter(el => el.scrollWidth > document.documentElement.clientWidth)
  .map(el => ({
    el,
    tag: el.tagName,
    class: el.className,
    scrollWidth: el.scrollWidth,
    clientWidth: document.documentElement.clientWidth,
  }));

Tailwindを使用する場合は、可能な限り w-screen を使用して w-full 置き換えてください。水平方向のオーバーフロー問題の多くは 100vw / w-screen、重複したセーフエリアのパディング、または固定幅のコンテナに起因し、viewportのmetaタグ自体が原因ではありません。

パフォーマンスの最適化

Next.jsとCapacitorアプリの最適なパフォーマンスを確保するには、以下のベストプラクティスを検討してください:

  • 未使用の依存関係やアセットを削除して、アプリのサイズを最小限に抑えましょう。
  • 画像やその他のメディアファイルを最適化して、読み込み時間を短縮しましょう。
  • コンポーネントとページに遅延読み込みを実装し、初期ロードの性能を向上させます。
  • Next.js のサーバーサイドレンダリング (SSR) を活用して、アプリの読み込み速度と検索エンジン最適化 (SEO) を向上させます。
  • WebView のキャッシュやアプリのバンドリングなど、Capacitor の組み込み最適化を活用します。

まとめ

Capacitor 8 を使って、既存の Next.js Web アプリケーションをネイティブの iOS/Android アプリに変換しました。Web コードベースはモバイルデバイス上でネイティブに動作し、デバイス API にもアクセスできます。

達成したこと:

  • Next.jsを静的エクスポート用に設定
  • 必須プラグイン入りの Capacitor 8 を追加
  • iOSとAndroidシミュレータ向けにビルドしてデプロイ
  • 開発用にライブリロードを有効化
  • iOSでよくあるレイアウト問題(viewport、safe area、overflow)を修正
  • Capgo Native NavigationとTransitionsでネイティブ感のあるUIを追加

次のステップ:

  • セットアップ Capgo App Storeへの再申請なしでOTAアップデートを実現
  • Camera、Geolocation、Push Notificationsなどのネイティブプラグインをさらに追加
  • 本番用のアプリアイコンとスプラッシュ画面を設定
  • App StoreとGoogle Playへの申請準備

新規プロジェクトを始めるならこちら Next.js モバイルアプリをゼロから構築する のガイド付きチュートリアルをご覧ください。

リソース

Capgo が、より良いアプリをより速く作るのにどう役立つかをご覧ください。 無料アカウントに登録する を今すぐ作成してください。

よくある質問

Next.js アプリをモバイルアプリに変換するには?

next.config で output を export に設定して Next.js が静的サイトをビルドするようにし、Capacitor と iOS/Android プラットフォームを追加、webDir を out フォルダに向けます。その後 npx cap sync を実行し、ネイティブプロジェクトを開きます。API ルートなどのサーバー専用機能は、別のバックエンドに移す必要があります。リリース後、 Capgo Live Updates ストアの再審査なしで Web 変更を配信できます。

Capacitor 8 で Next.js アプリの iOS & Android 変換を続行

使用している場合 Capacitor 8 を使って Next.js アプリを iOS & Android に変換 ネイティブプラグインの作業を計画するには、次と連携してください: Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新に関する実装詳細については、 Ionic Enterprise プラグインの代替案 Ionic Enterprise Plugin Alternatives のプロダクトワークフロー、および Capgo Native Build Capgo Native Builds のプロダクトワークフローについては、

Capacitor アプリ向けの Live Updates

Web レイヤーのバグが本番で発生したら、App Store の審査を何日も待たずに Capgo で修正を配信しましょう。ネイティブの変更は通常の審査フローに残したまま、ユーザーはバックグラウンドでアップデートを受け取れます。

最新のブログ記事

Capgoは、真にプロフェッショナルなモバイルアプリを作るために必要な最高のインサイトを提供します。