메인 콘텐츠로 건너뛰기
강좌

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

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

마틴 도나디우

마틴 도나디우

콘텐츠 마케터

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

소개

Bolt.new Bolt.new은 다양한 프레임워크를 사용하여 풀스택 웹 애플리케이션을 생성할 수 있는 혁신적인 AI 보조 개발 플랫폼입니다. React, Vue, Svelte 및 더 많은 프레임워크를 사용할 수 있습니다. 하지만 Bolt.new 생성물을 모바일 기기에 가져오려면 어떻게 해야 할까요? 이 포괄적인 튜토리얼에서 Bolt.new 프로젝트를 __CAPGO_KEEP_0__을 사용하여 네이티브 모바일 앱으로 변환하는 방법을 보여드리겠습니다. Capacitor.

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

시작하기 전에: 요구 사항 및 시간

예상 시간: 완전한 설정에 3-5 시간

시스템 요구 사항:

  • iOS 개발: macOS 12.0 이상 (필수, 대안 없음)
  • Android 개발: Windows/Mac/Linux 중 하나
  • 사용 가능한 공간: 개발 도구에 20-30GB
  • 메모리8GB RAM의 최소, 16GB 권장

예산이 필요합니다:

  • 애플 개발자$99/년 (iOS 앱 스토어)
  • 구글 플레이$25 한 번의 요금
  • 커서 프로$20/월 (선택, 개발 속도 향상)

설치할 내용:

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

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

  • 플랫폼 간 접근성: 모바일 앱 스토어에 AI 생성 앱을 배포하세요
  • 네이티브 장치 접근: 카메라, GPS, 파일 시스템 및 기타 네이티브 기능을 사용하세요
  • 향상된 성능: 네이티브 컨테이너는 웹 뷰보다 성능이 좋습니다
  • 오프라인 기능: 네이티브 저장 솔루션을 사용하여 오프라인 작업을 하세요
  • 푸시 알림: 네이티브 푸시 알림 지원을 사용하여 사용자와 상호 작용하세요

Why Capacitor Over Expo?

Capacitor는 Expo보다 많은 이점을 제공합니다. 특히 웹 개발에 초점을 맞춘 개발자들에게:

  • 한 번의 코드로 세 가지 플랫폼: __CAPGO_KEEP_0__를 사용하면 React, Next.js, 또는 Vue.js 웹사이트를 iOS, Android, 그리고 웹 앱으로 변환할 필요 없이 사용할 수 있습니다.
  • 재빌드가 필요하지 않습니다: Bolt.new 프로젝트를 그대로 사용할 수 있습니다. Expo와 같은 다른 프레임워크로의 변환은 필요하지 않습니다.
  • 웹 개발의 진정한 첫 번째 접근 방식: Expo는 모바일 개발에 초점을 맞추고 웹에서 불편함을 겪지만 Capacitor는 웹을 최우선으로 다룹니다.
  • 무결점 개발: __CAPGO_KEEP_0__를 사용하면 웹 개발 도구와 워크플로우를 계속 사용할 수 있습니다.
  • 프레임워크의 자유: __CAPGO_KEEP_0__는 React, Vue, Svelte, Next.js, 등과 같은 웹 프레임워크와 함께 작동합니다. Expo와 같은 React Native로만 제한되지 않습니다.

주요 차이점:

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

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-Powered Code 에디터

__CAPGO_KEEP_0__ 개발을 위해 효율적으로 작업하기 위해, 우리는 __CAPGO_KEEP_0__: 개발을 간소화하는 지능적인 code 에디터

  1. 가기 커서.sh 그리고 OS에 맞는 설치 프로그램을 다운로드하세요
  2. 설치 프로세스를 완료하세요
  3. 커서가 준비되면 커서를 시작하세요

커서 시작

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

커서 프로를 고려하세요

  1. - 무료 버전은 작동하지만 프로($20/월)로 업그레이드하면: 무제한 AI 지원

    • 프리미엄 모델(GPT-4, Claude)
    • 즉시 응답
    • 커서 프로($20/월)를 고려하세요
    • 고급 지원
  2. 설정 접근Command+, Mac) 또는 Ctrl+, Windows)

마우스 설정

  1. AI 기능 활성화 - AI 지원이 켜져 있는지 확인:

모델 허용

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

마우스 모델 선택

  1. 명령 실행 활성화 - 커서가 명령을 자동으로 실행하도록 하세요:

명령 실행 허용

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

현재 Bolt.new 프로젝트를 Cursor로 가져오겠습니다.

프로젝트 다운로드

  1. 브라우저에서 Bolt.new 프로젝트로 이동하세요
  2. 찾아보세요 다운로드 또는 Appflow 플러그인 또는 내보내기

Bolt.new 다운로드 버튼

  1. 프로젝트 ZIP 파일을 다운로드하세요
  2. 컴퓨터 폴더에 압축을 풀어주세요

Bolt.new 프로젝트 파일

Cursor에서 열기

Cursor에서 사용하세요

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

대안: __CAPGO_KEEP_0__에서 클론하세요

Alternative: Clone from 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: 자바스크립트 앱

Step 3: 개발 도구 설치

Option A: Cursor AI가 모든 것을 처리하십시오

  1. Press Command+K (Mac) 또는 Ctrl+K (Windows)에서 Cursor
  2. Cursor AI는 다음 요청을 입력하십시오:
    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. Node.js 설치 프로그램을 다운로드 하기 위해 nodejs.org 에 접속하라 설치 마법사를 완료하라
  2. nodejs.org
  3. Cursor의 터미널에서:
cd your-bolt-project
npm install
npm run dev

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

Bolt.new 앱이 이제 실행 중이어야 합니다 (일반적으로 http://localhost:5173 )

Step 4: 모바일을 위한 빌드 구성

Your configuration will vary based on your project framework.

Option A: Cursor AI를 사용한 자동 구성

Cursor AI에게 구성 처리를 부탁해:

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

Cursor는 프레임워크를 감지하고 올바른 구성이 적용될 것입니다.

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"
  }
}

업데이트 next.config.js:

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

module.exports = nextConfig

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 프로젝트: Bolt.new 빌드 출력을 찾으세요 dist : 디렉토리
  • Next.js 프로젝트: Bolt.new 빌드 출력을 확인하세요 out : 디렉토리

Bolt.new 빌드 출력

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

웹 애플리케이션을 네이티브 모바일 앱으로 변환하세요.

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

Press Command+K (Mac) 또는 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

다음과 같은 입력을 입력하실 수 있습니다:

  • 애플리케이션 이름: Bolt.new 프로젝트 이름
  • Bundle ID: 형식은 com.yourcompany.yourapp

수동 설정 계속하기 - 필수 패키지 설치:

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

모바일 플랫폼 지원 추가:

npx cap add ios
npx cap add android

Capacitor 플랫폼 Bolt 추가

What Just Happened?

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을 위한 시간이 왔습니다. 특정 프레임워크에 맞게 구성하세요.

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;

8단계: 빌드 및 Sync

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

Option A: Cursor AI 사용

Cursor에게 말하세요:

Build my project and sync it with Capacitor for mobile deployment

Option B: 수동 프로세스

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

npm run build
npx cap sync

Capacitor Bolt 완료 sync

__CAPGO_KEEP_0__ 빌더를 사용하면 Mac이 필요하지 않으며 App Store와 Google Play로 배포할 수 있습니다. Capgo 빌더 __CAPGO_KEEP_0__ 빌더는 앱을 클라우드에서 컴파일, 서명, 제출할 수 있는 빠른 경로입니다. Bolt.new에서 export된 vibe-coded 앱을 위한 것입니다.

Capgo 빌더는 왜 필요할까요?

  • iOS에는 Mac이 필요하지 않습니다. — Windows, Linux, 또는 AI 개발 환경에서 빌드합니다.
  • One CLI workflow — Cursor, Claude Code, 또는 Codex로 쉽게 스크립트하고 전달할 수 있습니다.
  • Pairs with Live Updates — JS/UI 오류를 실시간으로 업데이트하고 플러그인 또는 권한이 변경될 때만 네이티브 바이너리를 재빌드합니다.

Capgo 빌더를 설정하세요.

생산 빌드와 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 키 스토어를 한 번만 저장하세요. See Managing Credentials 그리고 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 Builder는 터미널에서 빌드 로그를 스트리밍합니다. App Store Connect가 구성되면 iOS 빌드는 TestFlight로 바로 이동할 수 있습니다.

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

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

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

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

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

iOS 개발

선택 A: Cursor AI를 통해서

Open my iOS project in Xcode

선택 B: 터미널 명령어를 통해서

npx cap open ios

Xcode Bolt 프로젝트 열기

안드로이드 개발

선택 A: Cursor AI를 통해서

Open my Android project in Android Studio

선택 B: 터미널 명령어를 통해서

npx cap open android

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

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

iOS에서 실행

Xcode 설정 (처음)

  1. 목표 선택:

    • 플레이 버튼 옆에 기기 선택기 클릭
    • 페이지/영역: Capgo Builder / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `native_build_builder_credit_next` (네이티브 빌드 빌더 크레딧 내일).
    • 테스트를 위해: iPhone 시뮬레이터 중 하나 선택
  2. Configure Code Signing:

    • __CAPGO_KEEP_0__ 서명 구성
    • 좌측 사이드바에서 프로젝트 이름 클릭
    • “서명 및 기능” 탭으로 이동하여 ‘자동 서명 관리’를 활성화
    • 애플 ID로 로그인하세요
    • 주의: 실제 기기에는 애플 개발자 프로그램 ($99/년)이 필요합니다
  3. 앱을 빌드하세요:

    • ▶️ 재생 버튼을 클릭하세요
    • 첫 번째 빌드: 5-10분 (잠시 기다려 주세요)
    • 상단의 진행 막대를 감시하세요

iOS 문제 해결:

  • “계정 없음”: Xcode > 설정 > 계정에서 애플 ID 추가하세요
  • “빌드 실패”: 빌드 폴더를 정리하세요 (Shift+Command+K) 및 다시 시도하세요
  • Simulator 문제: 기기 > 다시 시작하여 시뮬레이터를 재시작하십시오.

iOS에서 Bolt 앱 실행

Android에서 실행

Android Studio 설정 (처음 사용)

  1. SDK 설정 (자동):

    • Android Studio는 누락된 구성 요소를 감지합니다.
    • 누락된 SDK를 설치하라는 메시지가 표시되면 "누락된 SDK 설치"를 클릭하십시오.
    • 파일 다운로드가 ~2-3GB로 진행됩니다.
  2. 가상 장치 생성:

    • AVD 관리자 열기 (도구栏의 전화 아이콘)
    • 클릭 ‘+ 가상 장치 만들기’
    • ‘Pixel 6’ (기본 설정이 좋습니다) 선택
    • 시스템 이미지를 다운로드할 때提示
    • 기본 옵션으로 설정 완료
  3. 앱 실행:

    • 다운로드 드롭다운에서 에뮬레이터 선택
    • 녹색 ▶️ 실행 버튼 클릭
    • 첫 번째 빌드: 10-15 분
    • 에뮬레이터가 자동으로 시작

안드로이드 문제 해결:

  • ‘Gradle 동기화 실패’파일 > 캐시 무효화 시도
  • 속도 느린 에뮬레이터: 안드로이드 에뮬레이터 설정에서 하드웨어 가속을 활성화하세요
  • 빌드 오류: Gradle을 업데이트하세요 (자동으로 제안되는 수정 사항을 따라하세요)

볼트 앱이 안드로이드에서 실행 중입니다

검증 체크리스트

빌드가 성공적으로 완료되면 확인하세요:

✅ 앱이 충돌 없이 실행됩니다 ✅ 볼트.new 콘텐츠가 올바르게 표시됩니다 ✅ 버튼과 상호 작용이 정상적으로 작동합니다 ✅ 콘솔에 빨간색 오류 메시지가 표시되지 않습니다

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

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

개발 워크플로우를 가속화하세요 - 핫 리로딩을 사용하세요.

Option A: 자동 설정으로 커서 사용

Ask Cursor:

Enable live reload for my Capacitor app development

커서가 모든 것을 자동으로 설정합니다.

Option 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 활성화

Step 13: 네이티브 기능 추가

Bolt.new 앱을 장치에 특화된 기능으로 강화합니다.

Option A: AI-Powered 통합

Cursor로부터 요청:

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

커서(Cursor)는 플러그인 설치 및 code 통합을 생성합니다.

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

커서 AI와 동기화:

수동 명령어:

Sync my native feature changes to all platforms

커서 AI 설정:

npx cap sync

Step 14: 프로덕션 최적화

앱 아이콘 및 스플래시 화면

Option A: 커서 AI 설정

Native features added Bolt

요청:

Create app icons and splash screens for my mobile app

Option B: 수동 자산 생성

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

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

npx capacitor-assets generate

볼트 앱 자산 생성

Optimize Build

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

최종 빌드

Option A: Cursor AI를 사용한 빌드

Create the final production build and prepare for app store deployment

Option B: 수동 빌드 프로세스

npm run build
npx cap sync
npx cap copy

일반적인 문제 해결

프레임워크별 문제

React/Vite 프로젝트

  • Vite 설정에서 base: './' Vite 설정에서 설정이 올바르게 설정되어 있는지 확인하세요
  • 모든 임포트가 상대 경로를 사용하는지 확인하세요
  • 가져온 폴더가 올바르게 생성되었는지 확인하세요 dist Vue 프로젝트

__CAPGO_KEEP_0__

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

Next.js 프로젝트

  • 정적 내보내기 설정이 올바르게 구성되어 있는지 확인하세요.
  • 정적 내보내기 환경에서 동적 임포트가 작동되는지 확인하세요.
  • 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 빌더: Cloud Native 빌드를 사용하여 테스트 플라이트 및 플레이 스토어 릴리즈에 사용하세요
  • 라이브 업데이트: 구현 Capgo : 즉시 오버 더 에어 업데이트
  • 분석: 사용자 행동을 추적하기 위해 모바일 분석을 추가하세요
  • 성능: 앱의 모바일 성능을 모니터링하고 최적화하세요
  • 테스트: 다양한 장치 및 화면 크기에 대한 앱 테스트

Capacitor를 사용하여 Bolt.new 앱을 모바일로 변환하세요!

자원

Capgo을 사용하여 모바일 앱에 즉시 업데이트 제공하는 방법을 배워보세요. __CAPGO_KEEP_0__ 무료 계정으로 가입하세요. 오늘.

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

If you are using Capacitor를 사용 중이라면 Capacitor Capacitor를 사용하여 Native Mobile 앱으로 변환하는 __CAPGO_KEEP_0__ Capacitor와 함께 Native 플러그인 작업을 계획하려면 Capgo 플러그인 디렉토리와 연결하세요. Capacitor와 함께 Native 플러그인 작업을 계획하려면 Capgo 플러그인 디렉토리와 연결하세요. Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, Capacitor와 함께 Native 플러그인 작업을 계획하려면 __CAPGO_KEEP_0__ 플러그인 디렉토리와 연결하세요. Capacitor와 함께 Native 플러그인 작업을 계획하려면 __CAPGO_KEEP_0__ 플러그인 디렉토리와 연결하세요. Capacitor와 함께 Native 플러그인 작업을 계획하려면 __CAPGO_KEEP_0__ 플러그인 디렉토리와 연결하세요. Capacitor와 함께 Native 플러그인 작업을 계획하려면 __CAPGO_KEEP_0__ 플러그인 디렉토리와 연결하세요. Capacitor와 함께 Native 플러그인 작업을 계획하려면 Capgo 플러그인 디렉토리와 연결하세요. for the product workflow in Capgo Native Builds.

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

웹-layer 버그가 활성화되면 Capgo를 통해修정을 배포하는 대신 앱 스토어 승인까지 며칠 기다리지 마세요. 사용자는 배경에서 업데이트를 받으면서 네이티브 변경 사항은 일반적인 검토 경로에 남아 있습니다.

마틴의 인간 지원

시작하기

최신 뉴스

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