メインコンテンツにジャンプ
チュートリアル

Transform Your Bolt.new Project into Native Mobile Apps with Capacitor

CapacitorでBolt.newウェブアプリケーションをエクスポートし、ネイティブモバイルアプリに変換する方法を学びます。

Martin Donadieu

Martin Donadieu

コンテンツマーケター

Transform Your Bolt.new Project into Native Mobile Apps with Capacitor

導入

Bolt.new Bolt.newは、React、Vue、Svelteなど、さまざまなフレームワークを使用してフルスタックウェブアプリケーションを生成する革新的なAIパワード開発プラットフォームです。ですが、Bolt.newの創作をモバイルデバイスに持ち込みたい場合はどうしたらいいでしょうか? この包括的なチュートリアルでは、Bolt.newプロジェクトをエクスポートし、__CAPGO_KEEP_0__を使用してネイティブモバイルアプリに変換する方法を紹介します。 Capacitor.

Bolt.newプロジェクトがReact、Vue、またはサポートされている別のフレームワークを使用している場合、このガイドでは、カメラ、ストレージ、プッシュ通知などのデバイス機能にアクセスできるネイティブiOSおよびAndroidアプリを作成する方法を説明します。

開始する前に: 要件と時間

Estimated Time: 3-5 hours for complete setup

System Requirements:

  • iOS Development: Mac with macOS 12.0+ (required, no workaround)
  • Android Development: Any OS (Windows/Mac/Linux)
  • Free Space: 20-30GB for development tools
  • Memory: 8GB RAM minimum, 16GB recommended

Budget Needed:

  • Apple Developer: ¥9,990/年 (iOS App Store向け)
  • Google Play: ¥2,500の1回払い
  • Cursor Pro: ¥2,400/月 (任意、開発を高速化)

What We’ll Install:

  • Node.js & npm
  • Xcode (Macのみ、iOS向け)
  • Android Studio (Android向け)
  • Various command-line tools

Why Transform Your Bolt.new App to Mobile?

  • クロスプラットフォームアクセス:モバイルアプリストアにAI生成アプリを展開
  • ネイティブデバイスアクセス:カメラ、GPS、ファイルシステム、他にネイティブ機能を使用
  • 改善されたパフォーマンス:ネイティブコンテナはウェブビューに比べてパフォーマンスが良くなります
  • オフライン機能:ネイティブストレージソリューションを使用してオフラインで作業
  • プッシュ通知:ユーザーにネイティブプッシュ通知サポートを提供

Why Capacitor Over Expo?

If you’re considering mobile development options, Capacitor offers significant advantages over Expo, especially for web-first development:

  • One Codebase, Three Platforms:  ファストにいなただできだ。ファストにいなただできだ。ファストにいなただできだ。
  • No Rebuilding Required:ファストのファストにいなただできだ。ファストにいなただできだ。ファストにいなただできだ。
  • True Web-First Approach: Unlike Expo which is mobile-first and clunky on web, Capacitor treats web as a first-class citizen
  • Seamless Development:ファストにいなただできだ。ファストにいなただできだ。ファストにいなただできだ。
  • Framework Freedom:ファストにいなただできだ。ファストにいなただできだ。ファストにいなただできだ。

The Key Difference:

  • With Capacitor: Build your website → Add mobile support (same codebase)
  • Capacitorを使用して: Build for mobile → Try to make web work (different approach, often clunky)

Bolt.newプロジェクトはすでにWebアプリケーションなので、Capacitorは、codeを1行も変更せずにモバイルに拡張できます。Expoでは、フレームワークに合わせてプロジェクトを完全に再構築する必要があります。

Step 1: Set Up Your Development Environment

Cursor - Your AI-Powered Code Editor

Bolt.newプロジェクトと効率的に作業するには、 Cursor, すばらしいcodeエディターを使用します。

  1. Cursor にアクセスして、 cursor.sh
  2. Run through the installation process
  3. Cursorを使用できるようになるまでのインストールプロセスを実行

Cursorを起動

Cursorの起動

Cursorを最大限に活用するには、初期設定が必要です:

  1. Cursor Proを検討 - 無料版は機能しますが、Pro($20/月)では、以下の機能が利用可能になります:

    • 無制限のAIアシスタント
    • GPT-4、Claudeなどのプレミアムモデル
    • 即時レスポンス
    • プレミアムサポート
  2. 設定をアクセス with Command+, (Mac) or Ctrl+, (Windows)

カーソル設定

  1. AI機能を有効化 - AIアシスタンスが有効になっていることを確認してください:

モデルを許可

  1. AIモデルを選択 - ClaudeまたはGPT-4を推奨します:

カーソルモデルを選択

  1. 自動コマンド実行を有効化 - カーソルがコマンドを自動的に実行するようにします:

実行コマンドを許可する

ステップ 2: Bolt.new プロジェクトをエクスポートする

Bolt.new プロジェクトをCursorに取り込んでみましょう。

プロジェクトをダウンロードする

  1. ブラウザでBolt.newプロジェクトにアクセスする
  2. Boltのインターフェイスで ダウンロード または エクスポート ボタンを探す

Bolt.newダウンロードボタン

  1. プロジェクトを含むZIPファイルをダウンロードする
  2. コンピューター上のフォルダに抽出

Bolt.newプロジェクトファイル

Cursorで開く

抽出後、Cursorでプロジェクトを開く:

  1. 使用 File > Open Folder Cursor
  2. 抽出されたBolt.newプロジェクトフォルダを選択
  3. Cursorはプロジェクトを読み込む

Cursorで開く

代替: GitHubからクローン

Bolt.newをGitHubに接続している場合:

  1. 押す Shift+Command+P (Mac) または Shift+Ctrl+P (Windows)
  2. 「Git: Clone」を検索してください
  3. リポジトリのURLを入力してください
  4. 保存先の場所を選択してください

Cursorでクローン

ステップ 2: プロジェクトのフレームワークを特定する

Bolt.newは、さまざまなフレームワークを使用してプロジェクトを生成できます。 ここでは、どのフレームワークを使用しているかを特定してみましょう:

package.jsonを確認してください

を開いてください package.json プロジェクトが使用しているフレームワークを確認してください:

Bolt.newのpackage.jsonのインスペクション

標準的なBolt.newプロジェクトタイプ:

  • React + Vite: 最も一般的な設定
  • Vue + Vite: Vue.jsアプリケーション
  • Svelte: Svelteアプリケーション
  • Next.js: フルスタックReactアプリ
  • Vanilla JS: プレーンJavaScriptアプリ

ステップ3: 開発ツールのインストール

Option A: __CAPGO_KEEP_0__が全てを取り扱います

  1. Press Command+K (Mac) または Ctrl+K (Windows) in __CAPGO_KEEP_1__
  2. Type this request:
    Install all necessary development tools including Node.js, then install project dependencies and start the dev server

__CAPGO_KEEP_0__は自動的に:

  • Node.jsとnpmが必要な場合はインストールします
  • macOSでHomebrewを設定
  • プロジェクトのすべての依存関係をインストール
  • 開発サーバーを起動

Homebrewをインストール

Option B: 手動インストールプロセス

AIアプローチが問題を起こした場合、または手動コントロールを好む場合:

最初に、Cursorのターミナルを開きます Macの場合: Shift+Command+T Windowsの場合: Shift+Ctrl+T macOSユーザー向け:

Windowsユーザー向け:

# Get Homebrew package manager
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Move to your project folder
cd your-bolt-project

# Install project packages
npm install

# Launch development server
npm run dev

Node.jsインストーラーをダウンロードする

  1. nodejs.org インストールウィザードを完了する
  2. Cursorのターミナルで:
  3. Bolt.new appをローカルで実行する
cd your-bolt-project
npm install
npm run dev

__CAPGO_KEEP_0__

あなたの Bolt.new アプリは、通常は http://localhost:5173 Vite プロジェクトの場合。

ステップ 4: モバイル用にビルドを設定する

あなたのプロジェクトのフレームワークに応じて、設定は異なります。

オプション A: カーソル AI を使用した自動設定

カーソル AI に設定を任せる

Configure my Bolt.new project for mobile deployment with proper build settings

カーソルはフレームワークを検出して適切な設定を適用します。

オプション B: フレームワークごとの手動設定

React + Vite プロジェクトの場合:

編集 vite.config.js:

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  base: './',
  build: {
    outDir: 'dist',
    assetsDir: 'assets',
    rollupOptions: {
      output: {
        manualChunks: undefined,
      },
    },
  },
})

Vue + Vite プロジェクトの場合:

変更 vite.config.js:

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  base: './',
  build: {
    outDir: 'dist',
    assetsDir: 'assets',
  },
})

For Next.js Projects

をあなたの package.json scripts:

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "static": "next build && next export"
  }
}

を更新 next.config.js:

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

module.exports = nextConfig

Step 5: Build Your Project

__CAPGO_KEEP_0__のプロダクションビルドの作成に

オプション A: Cursor AI でビルド

Cursor にだけ

Build my Bolt.new project for production deployment

Cursor は、あなたのフレームワークに基づいて適切なビルドコマンドを実行します。

オプション B: 手動でビルド

Vite ベースのプロジェクト (React/Vue/Svelte):

npm run build

Bolt.new Vite ビルド成功

For Next.js Applications:

npm run static

Confirm Build Success

Ensure your build generated the correct output:

  • Vite projects: Look for a dist directory
  • Next.js projects: Check for an out directory

Bolt.new build output

Step 6: Add Capacitor to Your Bolt.new Project

Let's transform your web application into native mobile apps.

Option A: Cursor AIで迅速なセットアップ

Press Command+K (Mac) or Ctrl+K (Windows)と要求:

Add Capacitor to my project and set up iOS and Android platforms

Cursor AIはセットアッププロセスをすべて処理します。

Option B: ステップバイステップのマニュアルセットアップ

Capacitorのコマンドラインツールをインストールする:

npm install -D @capacitor/cli

Capacitorプロジェクトを初期化する:

npx cap init

Capacitor初期化のBolt

次の質問に答えるよう求められます:

  • アプリ名 : Your Bolt.newプロジェクト名
  • Bundle ID: Format like com.yourcompany.yourapp

Continue with manual setup - install essential packages:

npm install @capacitor/core @capacitor/ios @capacitor/android

モバイルプラットフォームのサポートを追加する:

npx cap add ios
npx cap add android

Capacitor プラットフォームを追加しましたBolt

何が起こったの?

Bolt.newプロジェクトの構造は次のようになりました:

your-bolt-project/
├── src/           # Your app source (React/Vue/etc)
├── public/        # Static files  
├── dist/          # Build output (Vite)
├── out/           # Build output (Next.js)
├── ios/           # iOS Xcode project (NEW!)
├── android/       # Android Studio project (NEW!)
├── capacitor.config.ts  # Mobile configuration
└── package.json   # Dependencies

重要な注意事項:

  • Web codeは src/ - ここで編集
  • ios/android/ 自動生成 - ここで編集しないでください
  • 変更後は常に実行 npx cap sync
  • 各プラットフォームには独自のビルドプロセスがあります

Step 7: Capacitorを設定する

Capacitorを設定する時間です。

オプション A: カーソルによる自動設定

カーソルの助けを求めます:

Configure capacitor.config.ts for my Bolt.new project build output

オプション B: 手動設定

Viteベースのアプリケーション用:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.yourcompany.yourapp',
  appName: 'Your Bolt App',
  webDir: 'dist',
  bundledWebRuntime: false,
  server: {
    androidScheme: 'https'
  }
};

export default config;

Next.jsアプリケーション用:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.yourcompany.yourapp',
  appName: 'Your Bolt App',
  webDir: 'out',
  bundledWebRuntime: false,
  server: {
    androidScheme: 'https'
  }
};

export default config;

Step 8: ビルドと同期

モバイル デプロイ用にアプリを準備する

オプション A: カーソル AIを使用する

Cursor に伝える:

Build my project and sync it with Capacitor for mobile deployment

オプション B: 手動プロセス

次のコマンドをシーケンスで実行します:

npm run build
npx cap sync

Capacitor sync Bolt complete

ステップ 9: 自然言語IDEを開く

アプリのネイティブ開発環境にアクセスします。

iOS 開発

オプション A: Cursor AI による

Open my iOS project in Xcode

オプション B: ターミナル コマンド

npx cap open ios

Xcode の Bolt プロジェクトを開く

Android 開発

オプション A: Cursor AI による

Open my Android project in Android Studio

オプション B: ターミナル コマンド

npx cap open android

Android Studio で Bolt プロジェクトを開く

ステップ 10: モバイル アプリをビルドおよび実行する

iOS で実行中

Xcode の設定 (初回のみ)

  1. ターゲットを選択する:

    • プレイ ボタン横のデバイス セレクターをクリックする
    • テスト用: iPhone シミュレータを選択する
    • 実機用: iPhone を USB で接続する
  2. Code の署名を設定する:

    • 左サイドバーのプロジェクト名をクリックする
    • 「署名と機能」タブに移動する
    • 自動署名を有効にする
    • Apple IDでサインイン
    • 注意実機はApple Developer Program ($99/年)が必要です
  3. アプリをビルド:

    • ▶️再生ボタンをクリック
    • 初回ビルド: 5-10分 (待ってください!)
    • 進行状況バーを上部で確認

iOSのトラブルシューティング:

  • 「アカウントが見つかりません」Xcode > 設定 > アカウント > Apple IDを追加
  • ビルドに失敗しました: ビルドフォルダをクリーンアップ (Shift+Command+K) して再試行
  • シミュレータの問題: シミュレータを再起動する (Device > Restart)

iOS上のBoltアプリ

Android上で実行中

Android Studioの設定 (初回)

  1. SDKの設定 (自動)

    • Android Studioは、欠落しているコンポーネントを検出します
    • 「SDKをインストールする」ボタンをクリックしてください
    • ファイルのダウンロードは約2-3GB
  2. 仮想デバイスを作成:

    • AVD マネージャーを開く (ツールバーの電話アイコン)
    • 「+」クリックして仮想デバイスを作成
    • 「Pixel 6」を選択(デフォルトの良い選択)
    • システムイメージのダウンロードを求められたらダウンロード
    • デフォルトのオプションでセットアップを完了
  3. アプリを実行:

    • エミュレータをドロップダウンから選択
    • 緑の▶️実行ボタンをクリック
    • 最初のビルド:10-15分
    • エミュレータは自動的に起動

Androidのトラブルシューティング:

  • 「Gradleの同期が失敗しました」: テスイン File > パックトエントエン
  • コンタールトエン: バームコンタートエントエンバームコンタートエン。
  • バームコンタートエントエン: バームコンタートエントエンバームコンタートエン。

アコトエントエンバームコンタートエントエンバームコンタートエン。

バームコンタートエントエンバームコンタートエン。

バームコンタートエントエンバームコンタートエン。

アコトエントエンバームコンタートエントエンバームコンタートエン。

バームコンタートエントエンバームコンタートエン。 アコトエントエンバームコンタートエントエンバームコンタートエン。

バームコンタートエントエン。アコトエントエンバームコンタートエントエン。バームコンタートエン。

__CAPGO_KEEP_0__を高速化する開発ワークフロー

__CAPGO_KEEP_1__ A: カーソルによる自動セットアップ

__CAPGO_KEEP_2__ カーソルに質問する

Enable live reload for my Capacitor app development

カーソルは自動的にすべての設定を構成します。

__CAPGO_KEEP_3__ B: 手動設定

  1. ローカルIPアドレスを取得する:
# macOS
ipconfig getifaddr en0

# Windows  
ipconfig
  1. __CAPGO_KEEP_4__ を更新する capacitor.config.ts:
import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.yourcompany.yourapp',
  appName: 'Your Bolt App',
  webDir: 'dist', // or 'out' for Next.js
  bundledWebRuntime: false,
  server: {
    url: 'http://YOUR_IP_ADDRESS:5173', // or 3000 for Next.js
    cleartext: true,
  },
};

export default config;
  1. 設定を適用する:
npx cap copy

__CAPGO_KEEP_5__ Live Reloadが有効ですBolt

__CAPGO_KEEP_6__ 12: ネイティブ機能を追加する

__CAPGO_KEEP_7__ を使用してBolt.newアプリを強化するデバイス固有の機能

__CAPGO_KEEP_8__ A: AIパワード統合

Request from Cursor:

Add native share, camera, and geolocation features to my Bolt.new app

Cursorはプラグインをインストールし、codeの統合を作成します。

オプション B: マニュアル プラグイン インストール

人気のnative プラグインをインストール:

npm i @capacitor/share @capacitor/camera @capacitor/geolocation

React プロジェクト用のユーティリティ ファイルを作成:

// utils/capacitor.js
import { Share } from '@capacitor/share';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';

export const shareContent = async (title, text, url) => {
  await Share.share({
    title,
    text,
    url,
    dialogTitle: 'Share with friends',
  });
};

export const takePicture = async () => {
  const image = await Camera.getPhoto({
    quality: 90,
    allowEditing: true,
    resultType: CameraResultType.Uri
  });
  return image;
};

export const getCurrentPosition = async () => {
  const coordinates = await Geolocation.getCurrentPosition();
  return coordinates;
};

コンポーネントで使用:

// For React components
import React from 'react';
import { shareContent, takePicture } from '../utils/capacitor';

function MyComponent() {
  const handleShare = () => {
    shareContent('My Bolt App', 'Check out this amazing app!', 'https://your-app.com');
  };

  const handleCamera = async () => {
    try {
      const photo = await takePicture();
      console.log('Photo taken:', photo);
    } catch (error) {
      console.error('Camera error:', error);
    }
  };

  return (
    <div>
      <button onClick={handleShare}>Share App</button>
      <button onClick={handleCamera}>Take Photo</button>
    </div>
  );
}

export default MyComponent;

変更を同期:

Cursor AIと一緒:

Sync my native feature changes to all platforms

マニュアル コマンド:

npx cap sync

Native機能を追加したBolt

ステップ 13: プロダクション用に最適化

アプリ アイコンとスプラッシュ スクリーン

オプション A: カーソル AI セットアップ

要求:

Create app icons and splash screens for my mobile app

オプション B: マニュアル アセット作成

  1. アセットツールを取得:
npm install -D @capacitor/assets
  1. グラフィックを準備:

    • 作成 assets/icon.png (1024x1024px)
    • 作成 assets/splash.png (2732x2732px)
  2. すべてのサイズを自動生成:

npx capacitor-assets generate

ボルトアプリアセット生成

ビルド最適化

For Vite projects, optimize your build:

// vite.config.js
export default defineConfig({
  plugins: [react()], // or vue()
  base: './',
  build: {
    outDir: 'dist',
    minify: 'terser',
    terserOptions: {
      compress: {
        drop_console: true,
        drop_debugger: true,
      },
    },
    rollupOptions: {
      output: {
        manualChunks: {
          vendor: ['react', 'react-dom'], // adjust for your framework
        },
      },
    },
  },
})

Final Build

Option A: Build with Cursor AI

Create the final production build and prepare for app store deployment

Option B: Manual Build Process

npm run build
npx cap sync
npx cap copy

Troubleshooting Common Issues

Framework-Specific Issues

React/Vite Projects

  • Ensure base: './' __CAPGO_KEEP_0__
  • __CAPGO_KEEP_1__
  • __CAPGO_KEEP_2__ dist __CAPGO_KEEP_3__

Vue Projects

  • モバイル用に、Vue Routerがハッシュモードで使用されていることを確認してください。
  • モバイル用に、資産が正しく参照されていることを確認してください。
  • モバイルコンテキストでコンポーネントのロードが機能していることを確認してください。

Next.js Projects

  • 静的エクスポートが正しく設定されていることを確認してください。
  • 静的コンテキストでダイナミックインポートが機能していることを確認してください。
  • API ルートが使用されていないことを確認してください (または適切に処理されていることを確認してください)。

Build Errors

ビルドエラーが発生した場合:

  1. node_modulesをクリアし、再インストールしてください。
rm -rf node_modules package-lock.json
npm install
  1. モバイル互換性のあるBolt.newプロジェクトの依存関係を確認してください。
  2. モバイル デプロイ用のすべての相対パスが正しいことを確認してください。

アセットが見つかりません。

アセットの読み込みに関する問題の場合:

  1. すべてのアセットが public フォルダ内にあることを確認してください。
  2. 画像やファイルの相対パスを使用してください。
  3. ビルドプロセスが必要なすべてのアセットをコピーしていることを確認してください。

まとめ

あなたはBolt.newプロジェクトを成功させました!あなたのAI生成のWebアプリは、以下のことができます。

  • iOSおよびAndroidデバイス上でネイティブに実行できます。
  • カメラ、GPS、ストレージなどのデバイス機能にアクセスできます。
  • アプリストアから配布できます。
  • 最適化されたモバイルユーザー体験を提供できます。

次のステップ

  • リアルタイム更新:実装 Capgo 即時オーバー・ザ・エア更新用
  • 分析:ユーザー行動を追跡するためのモバイル分析を追加
  • パフォーマンス:アプリのモバイルパフォーマンスを監視および最適化
  • テスト:さまざまなデバイスと画面サイズでアプリをテスト

CapgoでBolt.newの作成は、モバイルエコシステムに用意されています!

リソース

Capgo を使用して、即時更新を提供するモバイルアプリを配信する方法を学びましょう。 無料アカウントに登録する 今日です。

Transform Your Bolt.new Project into Native Mobile Apps with Capacitor

Bolt.newプロジェクトを使用している場合 Transform Your Bolt.new Project into Native Mobile Apps with Capacitor nativeプラグインの作業を計画するには、__CAPGO_KEEP_0__を接続する Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフローについて Capacitor プラグインは Capgo によって提供されます Capacitor プラグインの実装詳細については Capacitor プラグインは Capgo によって提供されます プラグインの追加または更新 プラグインの追加または更新の実装詳細 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフロー Capgo ネイティブ ビルド Capgo ネイティブ ビルドの製品ワークフロー

Capacitor アプリのリアルタイム更新

Capgo を使用して、ウェブ層のバグが生じた場合に、ユーザーに背景で更新を提供し、ネイティブの変更は通常のレビュー経路に残す

今すぐ始める

Latest from our Blog

Capgoは、プロフェッショナルなモバイルアプリを実現するために必要な最良の洞察を提供します。