본문 바로가기
튜토리얼

CapacitorJS로 크로스 플랫폼 앱 개발하기: 단계별 가이드

단일 JavaScript 코드베이스로 Android, iOS, 웹(PWA)용 크로스 플랫폼 애플리케이션을 만드는 방법을 알아보세요.

'CapacitorJS로 크로스 플랫폼 앱 개발하기: 단계별 가이드' Capgo 블로그 일러스트

변화하는 모바일 앱 개발 환경에서 프로그레시브 웹 앱(PWA)의 부상은 새로운 크로스 플랫폼 런타임의 길을 열었습니다. 이러한 런타임은 네이티브 code에만 의존하지 않고 웹 기반 애플리케이션을 앱 스토어에 배포할 수 있게 합니다. 이를 가능하게 하는 기술 중 하나가 바로 CapacitorJS입니다. CapacitorJS는 단일 JavaScript 코드베이스를 사용하여 Android, iOS, 웹에 걸쳐 간단한 웹사이트를 애플리케이션으로 배포할 수 있게 합니다. 이 접근 방식은 개발 비용을 크게 줄이고 코딩 효율을 높입니다.

이 가이드는 추가 프레임워크 없이 순수 JavaScript로 애플리케이션을 만드는 데 초점을 맞춥니다. 2021년 순수 JavaScript 앱 개발 리소스를 찾는 것이 쉽지 않았지만, CapacitorJS를 활용해 애플리케이션을 구축하고 네이티브 플러그인을 사용하는 포괄적인 튜토리얼을 제공합니다.

‣ 사전 요구 사항

시작하기 전에 다음 도구가 설치되어 있는지 확인하세요:

참고: iOS 앱 개발은 macOS 기기에서만 가능합니다.

‣ Capacitor 프로젝트 설정하기

Capacitor 애플리케이션을 생성하려면 원하는 폴더로 이동한 뒤 터미널에서 다음 명령어를 실행하세요:

npm init @capacitor/app

프롬프트에 따라 패키지를 설치하고 프로젝트를 설정합니다. Capacitor v3를 사용하면 프로젝트 디렉토리가 다음과 같이 구성됩니다:

www/
  css/
    style.css
  js/
    capacitor-welcome.js
  index.html
  manifest.json
.gitignore
capacitor.config.json
package.json
README.md

초기 설정이 완료되었으므로 다음 단계로 진행할 준비가 되었습니다.

‣ 프로젝트 구조 재구성

JavaScript 파일을 번들링하기 위해 Vite를 사용할 예정이므로, 이에 맞춰 프로젝트 구조를 다음과 같이 재구성합니다:

  • 생성 새 폴더 src 메인 디렉토리에.
  • 생성 새 스크립트 파일 index.js 에서 src/.
  • 생성 Vite 설정 파일 vite.config.js 메인 디렉토리에.
  • 제거 해당 capacitor-welcome.js 파일에서 www/js/.

새로운 폴더 구조는 다음과 같아야 합니다:

src/
  index.js
www/
  css/
    style.css
  js/
  index.html
  manifest.json
.gitignore
capacitor.config.json
package.json
README.md
vite.config.js

‣ 순수 JavaScript로 전환하기

순수 JavaScript로 동작하도록 파일을 수정해 보겠습니다:

www/index.html

  1. 다음의 script import를 제거하세요: Ionic PWA Elements 앱을 PWA로 배포하지 않는 경우:
<script type="module" src="https://unpkg.com/@ionic/pwa-elements@latest/dist/ionicpwaelements/ionicpwaelements.esm.js"></script>
<script nomodule src="https://unpkg.com/@ionic/pwa-elements@latest/dist/ionicpwaelements/ionicpwaelements.js"></script>
  1. 다음 요소를 삭제하세요. <capacitor-welcome> body에서 HTML 요소.

  2. 스크립트 가져오기를 다음으로 업데이트하세요. capacitor.js 대상 js/main.js. 이 파일이 번들링된 JavaScript 파일입니다.

  3. 다음을 제거하세요: js/capacitor-welcome.js import. Your index.html 이제 준비되었습니다.

vite.config.js

Node.js 모듈을 번들링하기 위해 Vite, 번들된 스크립트의 출력 경로를 지정하는 설정 파일이 필요합니다. 아래 설정은 해당 파일을 src/index.js 그리고 프로덕션용으로 번들링 www/js/main.js:

import { defineConfig } from 'vite';
import path from 'node:path';

export default defineConfig({
  build: {
    outDir: path.resolve(__dirname, 'www'),
    rollupOptions: {
      input: './src/index.js',
      output: {
        format: 'es',
        file: path.resolve(__dirname, 'www/js/main.js')
      }
    }
  }
});

capacitor.config.json

다음 capacitor.config.json 파일, 위치를 확인 "bundledWebRuntime": true 속성을 변경하여 false. 이 조정은 Capacitor가 파일을 bundle하지 않도록 하여, 대신 Vite를 해당 용도로 사용할 수 있게 합니다.

이 변경 사항으로 Capacitor 애플리케이션의 기본 설정이 완료되었으며, 이제 순수 JavaScript로 앱 개발을 시작할 준비가 되었습니다.

‣ 앱 개발하기

기반이 마련되었으니 이제 src/index.js 파일에서 애플리케이션 로직을 작성할 수 있습니다. 여기에서 필요한 Node.js 모듈을 import하고, 앱의 기능을 정의하며, Capacitor의 네이티브 플러그인과 상호작용할 수 있습니다.

변경 사항이 있을 때마다 JavaScript 파일을 bundle하기 위해 Vite의 build 명령을 실행하는 것을 잊지 마세요:

vite build

이 명령은 main.js 파일을 www/js 디렉터리에 생성하며, index.html 파일이 이를 참조합니다.

‣ 테스트 및 디버깅

Capacitor는 다양한 플랫폼에서 애플리케이션을 테스트할 수 있는 편리한 방법을 제공합니다. 다음 명령을 사용하여 해당 플랫폼의 개발 환경에서 앱을 열 수 있습니다:

Android의 경우:

npx cap add android
npx cap open android

iOS용 (macOS 전용):

npx cap add ios
npx cap open ios

Web/PWA용:

npx cap serve

이 명령어를 사용하면 Android Studio, Xcode 또는 웹 브라우저에서 애플리케이션을 실행하여 필요에 따라 테스트 및 디버깅할 수 있습니다.

‣ 결론

CapacitorJS를 사용하여 순수 JavaScript로 크로스 플랫폼 애플리케이션을 개발하는 것은 단일 코드베이스로 여러 플랫폼용 앱을 만드는 비용 효율적이고 효율적인 방법입니다. 이 가이드를 따라 프로젝트를 설정하고 Vite에 맞게 재구성했으며, 이제 개발을 위한 준비가 끝났습니다. 이 기반을 바탕으로 강력하고 다재다능한 애플리케이션을 구축하는 데 큰 진전을 이룰 수 있습니다.

모든 플랫폼에서 철저히 테스트하고, Capacitor의 네이티브 플러그인을 활용하여 앱의 기능을 향상시키세요. 즐거운 코딩 되세요!

CapacitorJS를 활용한 크로스 플랫폼 앱 개발: 단계별 가이드에서 계속하기

사용 중이라면 CapacitorJS로 크로스 플랫폼 앱 개발하기: 단계별 가이드 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우와, Capgo Native Build Capgo Native Builds의 제품 워크플로우를 위해.

Capacitor 앱용 Live updates

웹 레이어 버그가 라이브 상태라면, 앱 스토어 승인을 며칠씩 기다리지 말고 Capgo를 통해 수정 사항을 배포하세요. 네이티브 변경 사항은 정상 리뷰 절차를 그대로 따르는 반면, 사용자는 백그라운드에서 업데이트를 받습니다.

블로그 최신 글

Capgo는 정말 프로페셔널한 모바일 앱을 만드는 데 필요한 최고의 인사이트를 제공합니다.