How to Customize Build Scripts with Capacitor CLI

Capacitor CLI는 iOS, Android, 웹 플랫폼에서 앱의 빌드 프로세스를 맞춤화할 수 있게 해줍니다. 빌드 스크립트를 조정함으로써,

• 업데이트 속도를 높일 수 있습니다: 앱 스토어 지연 없이 즉시 변경을 푸시할 수 있습니다.
• 배포를 제어할 수 있습니다: 업데이트 롤백 또는 특정 사용자 그룹을 대상으로 할 수 있습니다.
• 앱을 보호할 수 있습니다: 업데이트를 암호화하여 보호할 수 있습니다.
• 빌드를 최적화할 수 있습니다: 플랫폼에 맞는 설정을 조정할 수 있습니다.

주요 기능의 빠른 개요:

• 설정 파일: 사용 capacitor.config.json 및 package.json build 설정을 관리하기 위해
• Custom Scripts: 자동화에 필요한 prebuild 및 postbuild 작업을 추가합니다.
• Build Hooks: code을 build 프로세스의 특정 단계에서 실행합니다.
• Environment Variables: __CAPGO_KEEP_0__을 사용하여 환경에 따라 빌드를 단순화합니다. .env __CAPGO_KEEP_0__

Capgo__CAPGO_KEEP_0__ 자동화된 업데이트, 버전 추적 및 전역 성능 최적화. 계속 읽기를 통해 최대 효율성을 위해 빌드 스크립트를 설정하고 사용자 지정하는 방법을 알아보세요.

소개 Capacitor 설정

Default Build Process in Capacitor

Understanding how Capacitor handles its default build process is crucial if you want to customize it effectively. Below, we’ll break down the Capacitor CLI’s build process and its key configuration files.

표준 빌드 단계

Capacitor uses a step-by-step process to transform your web app into platform-specific builds. Here’s what happens during the default build process:

주요 설정 파일

Capacitor이 빌드를 처리하는 방식을 결정하는 두 가지 중요한 설정 파일입니다.

capacitor.config.json
Capacitor 프로젝트의 핵심 설정 파일입니다. 빌드에 중요한 매개 변수를 설정합니다.

{
  "appId": "com.example.app",
  "appName": "MyApp",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "plugins": {
    "SplashScreen": {
      "launchShowDuration": 3000
    }
  }
}

• appId: 앱의 고유 식별자입니다.
• appName: 앱의 이름입니다.
• webDir: Capacitor이 웹 자산을 찾는 위치를 지정합니다. (예: dist).
• plugins: 플러그인별 설정을 구성할 수 있습니다. (예: SplashScreen 옵션)

package.json
이 파일에는 빌드 스크립트 및 의존성이 포함되어 빌드 프로세스를影响합니다.

{
  "scripts": {
    "build": "npm run build:web && cap sync",
    "build:web": "vite build",
    "cap:build": "cap build"
  }
}

• The webDir 설정 capacitor.config.json 설정에서 Capacitor은 네이티브 빌드에 포함시키기 위해 컴파일된 웹 자산의 위치를 알려줍니다.
• 변경 사항을 적용한 후 capacitor.config.json, __CAPGO_KEEP_0__을 실행하여 네이티브 프로젝트가 업데이트되었는지 확인해야 합니다. cap sync 다음으로, __CAPGO_KEEP_0__의 설정을 수정하여 빌드를 더 세부적으로 커스터마이즈할 수 있는 방법에 대해 살펴보겠습니다.

빌드 스크립트 수정

__CAPGO_KEEP_0__의 기본 빌드 프로세스를 수정하여 프로젝트에 맞게 조정할 수 있습니다. 방법은 다음과 같습니다.

You can tweak Capacitor’s default build process to better suit your project needs. Here’s how:

__CAPGO_KEEP_0__ 파일을 편집하여 빌드 프로세스를 조정할 수 있습니다. 아래는 예시 구성입니다.

__CAPGO_KEEP_0__ capacitor.config.json __CAPGO_KEEP_0__

{
  "appId": "com.example.app",
  "webDir": "www",
  "server": {
    "hostname": "localhost",
    "androidScheme": "https",
    "iosScheme": "https",
    "allowNavigation": ["*.example.com"]
  },
  "android": {
    "buildOptions": {
      "keystorePath": "release.keystore",
      "keystorePassword": "mypassword",
      "keystoreAlias": "release",
      "keystoreAliasPassword": "mypassword"
    }
  },
  "ios": {
    "scheme": "App",
    "automaticProvisioning": true
  }
}

다음 설정을 수정할 수 있습니다:

• webDir: 컴파일된 웹 자산의 위치를 지정합니다.
• server: 개발 서버를 구성하고, 호스트 이름 및 네비게이션 권한을 포함합니다.
• android/ios: 플랫폼별 빌드 설정을 허용합니다. 예를 들어 Android의 키 스토어 세부 정보 또는 iOS의 배포 옵션입니다.

Creating NPM Scripts

작업 흐름을 단순화하기 위해 NPM 스크립트를 추가하세요. 예를 들어: package.json 파일에 추가하세요.

{
  "scripts": {
    "prebuild": "node ./scripts/prepare-env.js",
    "build": "npm run build:web && cap sync",
    "build:web": "vite build",
    "build:ios": "cap build ios --release",
    "build:android": "cap build android --release",
    "postbuild": "node ./scripts/notify-completion.js"
  }
}

• prebuild 환경 설정이나 빌드가 완료되었을 때 알림을 보내는 등과 같은 작업을 위해 사용합니다. postbuild: Android 또는 iOS 앱을 빌드하기 위한 플랫폼별 명령어입니다.
• build:platform자동화 작업을 더 멀리 진행하기 위해 빌드 훅을 추가할 수 있습니다.

빌드 훅 설정

__CAPGO_KEEP_0__

더 많은 제어를 원하신다면, 빌드 프로세스의 특정 단계에서 code을 실행하기 위해 빌드 훅을 사용하세요. 예를 들어, 다음과 같은 설정을 사용하세요. capacitor.config.ts:

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

const config: CapacitorConfig = {
  appId: 'com.example.app',
  plugins: {
    CapacitorHooks: {
      beforeBuild: async () => {
        console.log('Running pre-build tasks...');
        // Add your pre-build tasks here
      },
      afterBuild: async () => {
        console.log('Running post-build tasks...');
        // Add your post-build tasks here
      }
    }
  }
};

export default config;

빌드 훅을 사용하면:

• 빌드가 시작되기 전에 요구 사항을 검증할 수 있습니다.
• 빌드 프로세스 중에 자산을 변환할 수 있습니다.
• 중요한 지점에서 알림을 트리거할 수 있습니다.
• 버전 번호를 자동으로 업데이트할 수 있습니다.
• 자동화된 테스트를 무중단으로 실행할 수 있습니다.

이 접근 방식은 빌드 라이프 사이클의 전체에 대한 더 많은 유연성과 제어를 제공합니다.

고급 빌드 커스터마이즈

큰 프로젝트를 작업할 때, 빌드 프로세스를 세밀하게 조정하면 큰 차이를 만들 수 있습니다. 환경별 빌드 및 플랫폼 커스터마이즈를 효과적으로 처리하는 방법을 알아보세요.

환경 변수

환경 변수를 설정하기 위해 별도의 .env 각 환경에 대한 파일들:

• .env.development
• .env.staging
• .env.production

그 다음, 환경에 따라 적절한 파일을 로드하기 위해 빌드 스크립트를 구성하세요:

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

export default defineConfig({
  ios: {
    buildConfig: {
      environment: process.env.BUILD_ENV || 'development',
      configurations: {
        development: {
          signing: {
            debug: true,
            automaticProvisioning: true
          }
        },
        production: {
          signing: {
            release: true,
            provisioningProfile: 'dist/profile.mobileprovision'
          }
        }
      }
    }
  }
});

이러한 설정을 플랫폼에 맞게 조정하여 요구 사항을 충족시킬 수 있습니다.

플랫폼별 빌드

Android 및 iOS를 위한 빌드 커스터마이즈를 위해 다음 구조를 사용하세요:

const platformConfig = {
  android: {
    buildType: process.env.BUILD_TYPE || 'debug',
    keystoreConfig: {
      path: process.env.KEYSTORE_PATH,
      password: process.env.KEYSTORE_PASSWORD,
      alias: process.env.KEYSTORE_ALIAS
    }
  },
  ios: {
    scheme: process.env.APP_SCHEME || 'App',
    xcodePreferences: {
      automaticSigning: false,
      developmentTeam: process.env.DEVELOPMENT_TEAM
    }
  }
};

이러한 구성은 각 플랫폼에 맞게 빌드를 조정하여 smoother 배포를 보장합니다.

자산 카탈로그

• 빌드 최적화를 위한 추가 팁이 있습니다.
• 오류 추적 설정을 빠르게 문제를 식별하는 데 도움이 됩니다.
• 베타 테스트 버전을 위한 채널 시스템을 만듭니다.
• 안전한 배포를 위해 끝에서 끝까지 암호화하는 것을 활성화합니다.

Capgo와 같은 분석 및 안전한 업데이트 도구와 함께 pair하면 이러한 기술은 배포 프로세스의 제어를 더 많이 할 수 있습니다. [1].

빌드 스크립트 문제 및 해결

커스텀 빌드 구성과 작업할 때, 오류를 빠르게 해결하는 것은 빌드 프로세스를 원활하게 유지하는 데 중요합니다.

일반적인 오류를 고치기

빌드 스크립트 문제의 많은 경우 환경 설정 또는 의존성 문제에서 비롯됩니다. 여기서 몇 가지 일반적인 문제를 해결하는 방법을 설명합니다.

환경 변수가 누락된 경우

다음과 같은 오류가 발생하는 경우:

error: Cannot find environment configuration for BUILD_ENV

이를 해결하려면 프로젝트의 루트 디렉토리에 파일을 생성하면 됩니다. 예를 들어: .env.local ]}

BUILD_ENV=development
CAPACITOR_PLATFORM=ios
BUILD_TYPE=debug

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

npx cap build android --keystorePassword=$KEYSTORE_PASSWORD --keystoreAlias=$KEYSTORE_ALIAS

__CAPGO_KEEP_2__

npx cap build ios --configuration=release --type=development

수정 후 오류를 해결한 후, 변경 사항이 안정적인지 확인하기 위해 철저한 빌드 테스트를 수행하세요.

빌드 스크립트 테스트

오류를 해결한 후, 빌드 스크립트를 다음 단계로 검증하세요:

• 자동 검증: 빌드 프로세스가 예상대로 작동하는지 확인하기 위해 중요한 명령어를 실행하세요.

npm run build
npx cap sync
npx cap copy

• 환경 검증: 빌드 전에 환경 변수가 누락되지 않았는지 확인하세요.

const requiredVars = ['BUILD_ENV', 'KEYSTORE_PATH'];
requiredVars.forEach(varName => {
  if (!process.env[varName]) {
    throw new Error(`Missing required env var: ${varName}`);
  }
});

• 빌드 스크립트 디버깅: 빌드 중 발생할 수 있는 문제를 잡기 위한 세부적인 스크립트를 추가하세요.

{
  "scripts": {
    "build:debug": "NODE_ENV=development npx cap build --verbose",
    "build:release": "NODE_ENV=production npx cap build --verbose"
  }
}

추가 테스트 팁:

• Docker 컨테이너를 사용하여 빌드를 분리하세요. 설정 파일을 확인하여 프로세스를 시작하기 전에 유효성을 검사하세요.
• 다양한 Node.js 버전으로 테스트하세요.
• 플랫폼에 특정한 요구 사항이 충족되는지 확인하세요. __CAPGO_KEEP_0__ __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__
• 빌드 성능을 향상할 수 있는 가능성을 위해 주의 깊게 지켜보세요.

Capgo Capgo로 PR 제출하는 방법

Capgo Live Update Dashboard Interface

__CAPGO_KEEP_0__는 자동 배포를 통해 빌드 스크립트를 다음 단계로 끌어올리며 효율성을 높이고 프로세스를 단순화합니다.

Capgo’s update performance is impressive:

• __CAPGO_KEEP_0__의 업데이트 성능은 다음과 같습니다: 활성 사용자 중 95%가
• 24시간 이내에 업데이트 받습니다. 업데이트 전달률 82%
• An average API response time of 434ms 전역.

플랫폼은 부분 업데이트 사용으로, 변경 사항만 다운로드합니다. 이 접근 방식은 대역폭 사용량을 줄이고 업데이트 프로세스를 가속화합니다. 또한 전체 빌드 프로세스는 완전히 자동화되어 시간과 노력을 절약합니다.

빌드 자동화

Capgo은 주요 CI/CD 플랫폼과 완벽하게 호환되며 다양한 통합을 제공합니다:

자동 빌드 설정은 보통 $300 per 달, 이는 전통적인 솔루션보다 $6,000 년.

보안 표준

Capgo은 보안에 중점을 둔 강력한 프레임워크를 제공합니다.

• 업데이트 패키지의 종단 간 암호화.
• 보안 키 관리.
• 애플과 구글 지침 준수.

버전 관리 기능.

• 즉시 롤백 옵션.
• 배포 버전 추적.
• 스테이징 릴리즈를 위한 업데이트 채널 관리.

이 보안 프레임워크는 수백 개의 기업 애플리케이션을 통해 엄격하게 테스트되었습니다. 추가 보안이 필요한 팀에게도 Capgo는 자체 호스팅 솔루션과 사용자 정의 구성이 가능한 옵션을 제공합니다.

Capgo의 채널 시스템은 업데이트 분배를 유연하게 만듭니다. 개발자는 특정 사용자 그룹에 대해 다른 버전을 대상으로 하여 베타 테스트나 점진적인 릴리스에 적합합니다.

요약.

빌드 단계 개요.

커스텀 빌드 스크립트는 빌드 훅, 환경 변수, 플랫폼 특정 명령을 사용하여 자동화되고 일관된 배포를 가능하게합니다. 이러한 프로세스는 Capgo를 통해 가능해지는 배포 개선의坚固한 기초를 제공합니다.

Capgo 이점.

Capgo는 배포를 간소화하여 750 개의 프로덕션 앱을 통해 23.5 만 개의 업데이트를 성공적으로 배포했습니다. [1]및 배포 시간을 모두 줄여주는 부분 업데이트 시스템이 있습니다.

플랫폼은 빠른 업데이트, 전 세계 성능 최적화, 보안을 위한 끝에서 끝까지 암호화, 유연한 채널 기반 배포 시스템을 제공합니다. 이 설정은 목표 업데이트, 베타 테스트 및 앱 스토어 지침 준수를 유지하면서 강력한 보안 프레임워크를 유지합니다.

How to Customize Build Scripts with Capacitor CLI 계속하기

이미 __CAPGO_KEEP_0__를 사용하고 있다면 How to Customize Build Scripts with Capacitor CLI CI/CD 자동화 계획을 위해 __CAPGO_KEEP_0__를 사용하고 있다면 __CAPGO_KEEP_0__ CI/CD와 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 사용하세요. Capgo Native Builds Capgo Native Builds에서 제품 워크플로우를 사용하세요. Capgo Integrations Capgo Integrations에서 제품 워크플로우를 사용하세요. CI/CD 통합 CI/CD 통합 구현 세부 사항 GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항