본문으로 건너뛰기
튜토리얼

Capacitor를 사용하여 Bolt.new 프로젝트를 네이티브 모바일 앱으로 변환하세요.

Capacitor를 사용하여 Bolt.new 웹 애플리케이션을 네이티브 모바일 앱으로 변환하는 방법을 배워보세요. React, Vue, 기타 프레임워크를 위한 완전한 가이드.

기사 기여자

마틴 도나디우

작가

발레리아

리뷰어

조던

Editor

Capacitor 프로젝트를 모바일 앱으로 변환하는 방법

소개

Bolt.new Bolt.new은 React, Vue, Svelte 등 다양한 프레임워크를 사용하여 풀스택 웹 애플리케이션을 생성할 수 있는 혁신적인 AI 개발 플랫폼입니다. 그러나 Bolt.new 프로젝트를 모바일 기기에서 실행하고 싶다면? 이 포괄적인 튜토리얼에서 Bolt.new 프로젝트를 __CAPGO_KEEP_0__를 사용하여 모바일 앱으로 변환하는 방법을 보여드리겠습니다. Capacitor.

페이지/영역: Live updates 제품 페이지. 역할: 섹션 또는 페이지 제목. 보이는 곳: 페이지 live-update.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하세요. 메시지 키 `live_update_platform_capacitor_title` (Live Update Platform Capacitor Title).

Bolt.new 프로젝트가 React, Vue, 또는 다른 지원 프레임워크를 사용하더라도 이 가이드는 iOS 및 Android 앱을 생성하여 카메라, 저장소, 푸시 알림과 같은 장치 기능에 접근할 수 있도록 도와줍니다.

준비하기 전: 요구 사항 및 시간예상 시간

: 3-5 시간 완전한 설정:

  • 시스템 요구 사항: macOS 12.0 이상의 Mac (필수, 대체 방법 없음)
  • Android 개발: 개발 도구를 위한 20-30GB의 빈 공간
  • 메모리: 최소 8GB RAM, 권장 16GB
  • 예상 비용애플 개발자

: iOS 앱 스토어를 위한 연간 $99:

  • 구글 플레이: 한 번에 $25
  • MacOS 12.0 이상의 Mac (필수, 대체 방법 없음)Android 개발
  • Cursor Pro: $20/월 (선택, 개발 속도를 높힘)

설치할 내용:

  • Node.js & npm
  • Xcode (Mac 전용, iOS)
  • Android Studio (Android)
  • 다양한 명령어 도구

왜 Bolt.new 앱을 모바일로 변환해야 하나요?

  • 플랫폼 간 접근성: 모바일 앱 스토어에 AI 생성 앱을 배포
  • 네이티브 장치 접근: 카메라, GPS, 파일 시스템, 기타 네이티브 기능 사용
  • 성능 개선: 네이티브 컨테이너는 웹 뷰보다 성능이 더 좋습니다.
  • 오프라인 기능: 네이티브 스토리지 솔루션을 사용하여 오프라인에서 작업할 수 있습니다.
  • 푸시 알림context

Why Capacitor Over Expo?

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

  • 왜 Capgo를 Expo보다 선택해야 하나요?context
  • Page/area: Capgo marketing website. Role: Short UI label or navigation item. Message key `why_capgo_over_expo` (Why Capgo Over Expo?).: 모바일 개발 옵션을 고려하고 계신다면 Capgo는 Expo보다 많은 이점을 제공합니다. 특히 웹 개발부터 시작하는 경우 especialmente: 하나의 코드베이스, 세 가지 플랫폼 (iOS, Android, 웹 앱)으로 전환할 필요가 없습니다. Expo와 달리 다른 프레임워크로의 전환을 필요로 하지 않습니다. Bolt.new 프로젝트를 그대로 사용할 수 있습니다.
  • 정확한 웹-첫 번째 접근 방식: Expo와 달리 모바일-첫 번째이고 웹에서 불편한 Capacitor는 웹을 최초의 시민으로 다루고 있습니다.
  • 무결점 개발: 자주 사용하는 웹 개발 도구와 워크플로우를 계속 사용하세요.
  • 프레임워크 자유도: React, Vue, Svelte, Next.js 등 어떤 웹 프레임워크와도 작동합니다 - Expo와 달리 React Native로 묶이지 않습니다.

주요 차이점:

  • With Capacitor: 웹 사이트를 빌드하세요 → 모바일 지원 추가 (같은 코드베이스)
  • With Expo: 모바일을 빌드하세요 → 웹이 작동하도록 시도하세요 (다른 접근 방식, 종종 불편함)

Since your Bolt.new project is already a web application, Capacitor lets you extend it to mobile without changing a single line of code. Expo would require rebuilding your entire project for their framework.

1단계: 개발 환경 설정

Cursor - 당신의 AI-드라이브 Code 에디터

효율적으로 Bolt.new 프로젝트와 작업하기 위해, 우리는 Cursor, 지능적인 code 에디터를 사용하여 개발을 단순화합니다:

  1. Cursor 로 이동하여 cursor.sh
  2. 에서 운영 체제에 맞는 설치 프로그램을 다운로드합니다
  3. 설치 프로그램을 실행하여 설치 과정을 완료합니다

Cursor가 준비되면 Cursor를 실행합니다

Cursor를 시작합니다: Cursor를 최대한 생산적으로 구성합니다

Cursor를 최대한 활용하려면 초기 설정이 필요합니다:

  1. Cursor Pro를 고려해 보세요 - 무료 버전은 작동하지만 ($20/월) Pro는 다음과 같은 기능을 제공합니다:

    • 무제한 AI 지원
    • 프리미엄 모델 (GPT-4, Claude)
    • 즉시 반응
    • 프리미엄 지원
  2. 설정에 접근 with Command+, (Mac) 또는 Ctrl+, (Windows)

Cursor 설정

  1. AI 기능 활성화 AI 지원이 활성화되어 있는지 확인하세요:

모델 허용

  1. AI 모델 선택 Claude 또는 GPT-4를 추천합니다:

커서 모델 선택

  1. 명령 실행 허용 명령이 자동으로 실행되도록 커서를 활성화하세요:

명령 실행 허용

2단계: Bolt.new 프로젝트 내보내기

이제 Bolt.new 프로젝트를 Cursor로 가져옵니다.

프로젝트 다운로드

  1. 브라우저에서 Bolt.new 프로젝트로 이동하세요
  2. 찾아보세요 다운로드 또는 Capacitor live-update 대안 비교 페이지 다운로드

Cursor에서 프로젝트를 열어보세요

  1. Bolt.new 프로젝트 파일
  2. Cursor에서 프로젝트를 열어보세요

다운로드

압축 파일을 풀어보세요

컴퓨터에 폴더로 압축 파일을 풀어보세요

  1. 사용 File > Open Folder 커서
  2. 추출한 Bolt.new 프로젝트 폴더를 선택하세요
  3. 커서가 프로젝트를 로드합니다

커서에서 열기

대안: GitHub에서 클론

GitHub에 Bolt.new를 연결했다면:

  1. 클릭 Shift+Command+P (Mac) 또는 Shift+Ctrl+P (Windows)
  2. Git: Clone을 검색하세요
  3. repository URL을 입력하세요
  4. 위치 선택

Cursor에서 복제

2단계: 프로젝트 프레임워크 식별

Bolt.new는 다양한 프레임워크를 사용하여 프로젝트를 생성할 수 있습니다. 프로젝트 프레임워크를 식별해 보겠습니다:

package.json을 확인하세요

프로젝트가 사용하는 프레임워크를 확인하려면 package.json Bolt.new package.json 검사

일반적인 Bolt.new 프로젝트 유형:

React + Vite

  • : 가장 일반적인 설정Vue + Vite
  • Common Bolt.new project types:: Vue.js 애플리케이션들
  • SvelteSvelte 애플리케이션들
  • Next.js: 풀스택 React 앱들
  • Vanilla JS: 평범한 JavaScript 앱들

Step 3: 개발 도구 설치

Option A: Cursor AI가 모든 것을 처리하도록 해보세요

  1. Press Command+K (Mac) 또는 Ctrl+K (Windows)에서 Cursor
  2. 이 요청을 입력하세요:
    Install all necessary development tools including Node.js, then install project dependencies and start the dev server

Cursor AI는 자동으로:

  • Node.js와 npm를 설치해야 하는 경우 필요에 따라
  • macOS에서 Homebrew를 설정하세요
  • 프로젝트의 모든 종속성을 설치하세요
  • 개발 서버를 시작하세요

Homebrew를 설치하세요

Option B: 수동 설치 프로세스

AI 접근 방식이 문제를 만나거나 수동 제어를 선호하는 경우:

Cursor의 터미널을 먼저 열어주세요 with Shift+Command+T (Mac) 또는 Shift+Ctrl+T (Windows)

macOS 사용자들을 위한:

# 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

Windows 사용자들을 위한:

  1. Capacitor를 사용하여 모바일 앱으로 변환하기 nodejs.org
  2. 설치 마법사를 완료하세요
  3. Cursor의 터미널에서:
cd your-bolt-project
npm install
npm run dev

Bolt.new 앱이 로컬에서 실행 중입니다

Bolt.new 앱이 정상적으로 실행 중입니다 (일반적으로 http://localhost:5173 Step 4: 모바일 빌드 구성

프로젝트 프레임워크에 따라 구성이 달라질 수 있습니다.

nodejs.org

Option A: 자동 설정과 Cursor AI

Cursor AI에 설정을 맡겨보세요:

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

Cursor AI는 프레임워크를 감지하고 올바른 설정을 적용합니다.

Option 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',
  },
})

Next.js 프로젝트에 대해:

스크립트에 추가: package.json 업데이트

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

Update next.config.js:

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

module.exports = nextConfig

Step 5: 프로젝트를 빌드하세요

시간이 왔습니다. Bolt.new 앱의 프로덕션 빌드를 생성하세요.

Option A: Cursor AI를 사용하여 빌드

Cursor에게 간단히 물어보세요:

Build my Bolt.new project for production deployment

Cursor는 프레임워크에 따라 적절한 빌드 명령을 실행합니다.

Option B: 수동으로 빌드

Vite 기반 프로젝트 (React/Vue/Svelte):

npm run build

Bolt.new Vite 빌드 성공

Next.js 애플리케이션:

npm run static

빌드 성공을 확인하세요

빌드가 올바른 출력을 생성했는지 확인하세요:

  • Vite 프로젝트: 모바일 앱으로 변환하기 위해 dist 디렉토리
  • Next.js 프로젝트: Bolt.new 빌드 출력의 out 디렉토리

Step 6: Bolt.new 프로젝트에 __CAPGO_KEEP_0__을 추가하세요

Step 6: Add Capacitor to Your Bolt.new Project

Option A: Cursor AI를 사용한 빠른 설정

클릭

(Mac) 또는 Command+K (Windows) 키를 누르고 요청하세요: Ctrl+K protectedTokens

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

Cursor AI가 전체 설정 프로세스를 처리합니다.

Option B: 단계별 수동 설정

Install Capacitor’s command-line tools:

npm install -D @capacitor/cli

Capacitor 프로젝트를 초기화하세요:

npx cap init

Capacitor 초기화 Bolt

다음과 같은 정보를 입력하실 것입니다:

  • 앱 이름: Bolt.new 프로젝트 이름
  • Bundle ID: Format like com.yourcompany.yourapp

수동 설정을 계속하세요 - 필수 패키지를 설치하세요:

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

모바일 플랫폼 지원을 추가하세요:

npx cap add ios
npx cap add android

Capacitor 플랫폼이 추가되었습니다.

무엇이 일어났나요?

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

중요한 주의사항:

  • code은 웹에서 유지됩니다. src/ - 여기에 편집
  • ios/ 그리고 android/ 자동으로 생성되며 편집하지 마세요.
  • 변경 사항이 적용된 후 항상 npx cap sync
  • 각 플랫폼은 독자적인 빌드 프로세스를 가지고 있습니다.

7단계: Capacitor을 구성하세요.

특정 프레임워크에 맞게 Capacitor을 구성하는 시간입니다.

Option A: 자동 구성으로 커서를 사용하세요

커서의 도움을 요청하세요:

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

Option 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;

8단계: 빌드 및 동기화

모바일 배포를 위해 앱을 준비하세요.

Option A: 커서 AI 사용

커서에게 말하세요:

Build my project and sync it with Capacitor for mobile deployment

Option B: 수동 프로세스

다음 명령어를 순서대로 실행하세요:

npm run build
npx cap sync

Capacitor Bolt 동기화 완료

애플 스토어와 구글 플레이로 배포하려면 Mac이나 전체 로컬 Xcode/Android Studio pipeline가 필요하지 않습니다. Capgo 빌더 __CAPGO_KEEP_0__ 빌더

Capgo 빌더

  • __CAPGO_KEEP_0__ 빌더 __CAPGO_KEEP_0__ 빌더는 iOS와 Android 빌드를 클라우드에서 컴파일, 서명, 제출할 수 있습니다. - Bolt.new에서 export된 vibe-coded 앱의 가장 빠른 경로입니다.
  • CLI 빌더의 이유는 무엇인가요? — easy to script and hand off to Cursor, Claude Code, or Codex
  • — Windows, Linux, 또는 AI 코딩 환경에서 빌드하세요 __CAPGO_KEEP_0__ 빌더의 단일 워크플로

— Cursor, Claude Capgo, 또는 Codex와 같은 다른 도구로 쉽게 스크립트하고 전달하세요.

생산 빌드 후 Capacitor 동기화 작업을 로컬에서 수행한 후:

npx @capgo/cli@latest login
npx @capgo/cli@latest init
npx @capgo/cli@latest build init --platform ios
npx @capgo/cli@latest build init --platform android

인증서 및 프로비전 프로파일(Apple), Android 키 스토어를 포함한 서명 인증서를 한 번만 저장하세요. 인증서 관리 그리고 Windows에서 iOS 빌드.

클라우드 빌드를 요청하세요

npm run build
npx cap sync
npx @capgo/cli@latest build com.yourcompany.yourapp --platform ios --build-mode release
npx @capgo/cli@latest build com.yourcompany.yourapp --platform android --build-mode release

Capgo 빌더는 터미널에서 빌드 로그를 스트리밍합니다. App Store Connect가 구성된 경우 iOS 빌드는 TestFlight로 바로 전송됩니다.

웹 번들을 OTA 업데이트로 업로드하세요:

npx @capgo/cli@latest bundle upload --channel production

10단계: 로컬 테스트를 위한 네이티브 IDE 열기(선택 사항)

Mac을 가지고 있거나 클라우드 빌드 전에 에뮬레이터 테스트를 원한다면 로컬 네이티브 프로젝트를 열어보세요:

앱의 네이티브 개발 환경에 접근하세요.

iOS 개발

Option A: Cursor AI를 통해

Open my iOS project in Xcode

Option B: 터미널 명령어

npx cap open ios

Xcode Bolt 프로젝트 열기

안드로이드 개발

Option A: Cursor AI를 통해

Open my Android project in Android Studio

Option B: 터미널 명령어

npx cap open android

안드로이드 스튜디오 Bolt 프로젝트 열기

11단계: 로컬에서 빌드 및 실행 (선택사항)

iOS에서 실행

Xcode 설정 (처음)

  1. 목표 선택:

    • 플레이 버튼 옆에 기기 선택기 클릭
    • For testing: iPhone 시뮬레이터를 선택하세요.
    • For real device: iPhone을 USB로 연결하세요.
  2. Code 인증 설정:

    • 프로젝트 이름을 왼쪽 사이드바에서 클릭하세요.
    • “인증 및 기능” 탭으로 이동하세요.
    • “자동 인증 관리”를 활성화하세요.
    • Apple ID로 로그인하세요.
    • 주의:: 실제 장치 사용을 위해 Apple Developer Program ($99/년) 가입이 필요합니다.
  3. 앱 빌드:

    • ▶️ Play 버튼을 클릭하세요.
    • 첫 번째 빌드: 5-10분 소요 (잠시 기다려 주세요!).
    • 위치 바를 상단에서 감시하세요

iOS 문제 해결:

  • “No account found”: Xcode > 설정 > 계정에서 Apple ID 추가
  • “Failed to build”: Shift+Command+K를 눌러 빌드 폴더를 정리하고 다시 시도하세요
  • 시뮬레이터 문제: Device > 다시 시작을 클릭하여 시뮬레이터를 재시작하세요

iOS에서 Bolt 앱 실행

Android에서 실행

Android Studio 설정 (처음 사용)

  1. SDK 설정 (자동):

    • Android Studio는 누락된 구성 요소를 감지합니다.
    • 누락된 구성 요소를 설치할 때提示되면 "SDK"를 클릭합니다.
    • 이것은 약 2-3GB의 파일을 다운로드합니다.
  2. 가상 장치 만들기:

    • AVD 관리자 열기 (도구栏의 전화 아이콘)
    • 가상 장치 만들기 (+)
    • Pixel 6 (기본값으로 좋음)를 선택합니다.
    • 시스템 이미지를 다운로드할 때提示되면
    • 기본 옵션으로 설정을 마칩니다.
  3. 앱 실행:

    • 드롭다운 메뉴에서 에뮬레이터를 선택합니다.
    • Click green ▶️ Run button
    • 첫 번째 빌드: 10-15분
    • 자동으로 에뮬레이터가 시작됩니다.

안드로이드 문제 해결:

  • “Gradle 동기화 실패”: 캐시를 무효화하여 File > Invalidate Caches를 시도해 보세요.
  • 에뮬레이터가 느립니다.: AVD 설정에서 하드웨어 가속을 활성화하세요.
  • 빌드 오류: Gradle을 업데이트하여 제안된 수정 사항을 시도해 보세요.

볼트 앱이 안드로이드에서 실행됩니다.

인증 확인 목록

성공적인 빌드 후 확인:

✅ 앱이 충돌하지 않고 실행됩니다. ✅ Bolt.new 콘텐츠가 올바르게 표시됩니다. ✅ 버튼과 상호 작용이 작동합니다. ✅ 콘솔에 빨간색 오류가 표시되지 않습니다.

문제가 여전히 발생하는가요? 오류 메시지는 정확히 무엇이 잘못되었는지 알려줍니다. 그들을 신중하게 읽어보세요!

12단계: Live Reload 활성화 (개발)

개발 워크플로우를 가속화하세요.热重载을 사용하세요.

A 옵션: Cursor 자동 설정

Cursor에게 물어보세요:

Enable live reload for my Capacitor app development

Cursor는 모든 것을 자동으로 구성할 것입니다.

B 옵션: 수동 구성

  1. 로컬 IP 주소를 얻으세요:
# macOS
ipconfig getifaddr en0

# Windows  
ipconfig
  1. 업데이트를 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

Live reload Bolt 활성화

13단계: 네이티브 기능 추가

Bolt.new 앱을 장치에 특화된 기능으로 강화하세요.

A. AI-Powered 통합

Cursor에서 요청:

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

Cursor는 플러그인 설치 및 통합 code 생성

B. 수동 플러그인 설치

인기 네이티브 플러그인 설치:

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

Bolt에 Native 기능 추가:

14단계: 프로덕션 최적화:

앱 아이콘 및 스플래시 화면:

A. 옵션: Cursor AI 설정:

요청:

Create app icons and splash screens for my mobile app

B. 옵션: 수동 자산 생성:

  1. 자산 도구를 가져오세요:
npm install -D @capacitor/assets
  1. 그래픽 준비:

    • 만들기 (1024x1024px) assets/icon.png (1024x1024px)
    • 만들기 assets/splash.png (2732x2732px)
  2. 모든 크기 자동으로 생성:

npx capacitor-assets generate

볼트 앱 자산 생성

최적화 빌드

Vite 프로젝트의 경우 빌드 최적화:

// 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
        },
      },
    },
  },
})

최종 빌드

선택 A: 커서 AI로 빌드

Create the final production build and prepare for app store deployment

선택 B: 수동 빌드 프로세스

npm run build
npx cap sync
npx cap copy

일반적인 문제 해결

프레임워크별 문제

리액트/Vite 프로젝트

  • 정확히 base: './' Vite 설정에서
  • 모든 임포트가 상대 경로를 사용하는지 확인하세요
  • Verify that the dist 폴더가 올바르게 생성되는지 확인하세요

Vue Projects

  • 모바일 환경에서 Vue Router이 해시 모드를 사용하는지 확인하세요
  • 자산이 올바르게 참조되는지 확인하세요
  • 모바일 환경에서 컴포넌트의 느긋한 로딩이 작동하는지 확인하세요

Next.js Projects

  • 정적 내보내기 설정이 올바르게 구성되어 있는지 확인하세요
  • 정적 환경에서 동적 임포트가 작동하는지 확인하세요
  • API 경로가 사용되지 않거나 적절하게 처리되는지 확인하세요.

빌드 오류

빌드 오류가 발생하는 경우:

  1. node_modules를 삭제하고 다시 설치하세요:
rm -rf node_modules package-lock.json
npm install
  1. Bolt.new 프로젝트의 모바일 호환성에 대한 의존성을 확인하세요.
  2. 모바일 배포를 위해 모든 상대 경로가 올바른지 확인하세요.

미리 로드된 자산이 없습니다.

자산 로드 오류가 발생하는 경우:

  1. 모든 자산이 public 폴더에 있는지 확인하세요.
  2. 이미지 및 파일에 대한 상대 경로를 사용하세요.
  3. 빌드 프로세스가 모든 필요한 자산을 복사하는지 확인하세요.

결론

축하합니다! Bolt.new 프로젝트를 성공적으로 네이티브 모바일 애플리케이션으로 변환했습니다. AI 생성된 웹 앱은 이제:

  • iOS 및 Android 기기에서 네이티브로 실행할 수 있습니다
  • 카메라, GPS, 저장소와 같은 장치 기능에 접근할 수 있습니다
  • 앱 스토어를 통해 배포할 수 있습니다
  • 최적화된 모바일 사용자 경험을 제공할 수 있습니다

다음 단계

  • Capgo Builder실시간 업데이트
  • : 구현Capgo에 PR 제출 Capgo __CAPGO_KEEP_0__ 빌더
  • 분석: 사용자 행동 추적을 위한 모바일 분석 추가
  • 성능: 모바일 앱의 성능을 모니터링하고 최적화
  • 테스트: 다양한 기기와 화면 크기에 대한 앱 테스트

모바일 생태계에 맞춰서 제작된 Bolt.new가 준비되었습니다!

자원

Capgo이 당신에게 즉시 업데이트를 제공하는 방법을 배워보세요. 무료 계정으로 가입하세요. 오늘.

Capacitor으로 Bolt.new 프로젝트를 Native 모바일 앱으로 변환하세요.

__CAPGO_KEEP_0__을 사용 중이라면 Capacitor으로 Native 플러그인 작업을 계획할 수 있습니다. __CAPGO_KEEP_0__ 플러그인 디렉토리와 연결하여 Capgo 플러그인 디렉토리에서 제품 워크플로우를 관리하세요. Capgo 플러그인으로 __CAPGO_KEEP_1__을 사용하세요. Capacitor Plugins by Capgo Capacitor 플러그인에 대한 구현 세부 정보는 Capgo에서 확인할 수 있습니다. 플러그인 추가 또는 업데이트 __CAPGO_KEEP_0__ 플러그인에 대한 구현 세부 정보는 플러그인 추가 또는 업데이트에서 확인할 수 있습니다. 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 대체에 대한 제품 워크플로우 및 Capgo 네이티브 빌드 Capgo 네이티브 빌드에 대한 제품 워크플로우

Capacitor 앱에 대한 실시간 업데이트

Capgo를 통해 웹-layer 버그가 생긴 경우, 앱 스토어 승인 대기 없이 바로 픽스를 배포하세요. 사용자는 배경에서 업데이트를 받으며, 네이티브 변경 사항은 일반적인 리뷰 경로를 따릅니다.

마틴의 인간 지원

시작하기

최신 뉴스

Capgo는 전문적인 모바일 앱을 만들기 위해 필요한 최고의洞察력을 제공합니다.