자동화된 빌드 및 릴리즈 앱과 Github 액션

이 튜토리얼은 GitHub 호스팅에 중점을 두고 있지만 다른 CI/CD 플랫폼에 적응하기 위해 약간의 조정을 통해 사용할 수 있습니다.

소개

Capacitor 앱을 Capgo에 먼저 추가하셨는지 확인하십시오. 이 튜토리얼은 업로드 단계만 다룹니다. Capgo에 앱을 추가해야 하는 경우에는 이 튜토리얼을 따르십시오. 튜토리얼

커밋 규칙

커밋 규칙을 따르기 시작하십시오. context: Page/area: Capgo Builder / native cloud build product page. Role: Short UI label or navigation item. Message key `native_build_builder_credit_first` (Native Build Builder Credit First).conventional commits

GitHub actions for tag

GitHub 액션을 위한 태그

__CAPGO_KEEP_0__ 액션을 생성하여 자동으로 빌드하고 태그를 생성하십시오. .github/workflows/bump_version.yml

이 내용과 함께:

name: Bump version

on:
  push:
    branches:
      - main

jobs:
  bump-version:
    if: "!startsWith(github.event.head_commit.message, 'chore(release):')"
    runs-on: ubuntu-latest
    name: "Bump version and create changelog with standard version"
    steps:
      - name: Check out
        uses: actions/checkout@v6
        with:
          fetch-depth: 0
          filter: blob:none
          token: '${{ secrets.PERSONAL_ACCESS_TOKEN }}'
      - name: Git config
        run: |
          git config --local user.name "github-actions[bot]"
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
      - name: Create bump and changelog
        run: npx capacitor-standard-version
      - name: Push to origin
        run: |
          CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
          remote_repo="https://${GITHUB_ACTOR}:${{ secrets.PERSONAL_ACCESS_TOKEN }}@github.com/${GITHUB_REPOSITORY}.git"
          git pull $remote_repo $CURRENT_BRANCH
          git push $remote_repo HEAD:$CURRENT_BRANCH --follow-tags --tags

이 작업은 메인 branch의 모든 커밋에 대해 태그를 릴리즈하고 메인 branch의 각 커밋에 대한 변경 로그 항목을 추가합니다. CHANGELOG.md.

이 파일이 없다고 걱정하지 마세요. 이 파일은 자동으로 생성됩니다.

이 기능을 사용하려면 __CAPGO_KEEP_0__ 개인 접근 토큰 GitHub 비밀 비밀 PERSONAL_ACCESS_TOKEN.

으로 설정해야 합니다.

CI가 변경 로그를 커밋할 수 있도록 하기 위해 이것이 필요합니다. never 토큰을 생성할 때 만료 기간을 선택하고 범위도 선택해야 합니다. repo.

마지막으로, __CAPGO_KEEP_0__에서 사용하는 버전을 설정하고 Native 버전 번호와 동기화하세요. 이 버전 번호는 다음 단계를 facilite 할 것입니다. package.json __CAPGO_KEEP_0__에서 사용하는 버전 번호를 설정하고 Native 버전 번호와 동기화하세요.

이 작업은 처음 한 번만 필요합니다. 그 후, 도구는 자동으로 업데이트를 유지합니다.

GitHub에 두 개의 파일을 커밋하고 GitHub에서 첫 번째 태그를 확인하세요!

Native 및 웹 플랫폼 모두 커밋마다 버전 번호를 업데이트합니다.

GitHub 액션

__CAPGO_KEEP_0__ 경로에 파일을 생성하세요. .github/workflows/build.yml

__CAPGO_KEEP_0__ 내용을 입력하세요.

name: Build source code and send to Capgo

on:
  push:
    tags:
      - '*'
      
jobs:
  deploy:
    runs-on: ubuntu-latest
    name: "Build code and release"
    steps:
      - name: Check out
        uses: actions/checkout@v6
      - name: Install dependencies
        id: install_code
        run: npm i
      - name: Build
        id: build_code
        run: npm run build
        env: # Remove both lines  if you don't need it
          FIREBASE_CONFIG: ${{ secrets.FIREBASE_CONFIG }} # Example of env var coming from a secret
      - name: Create Release
        id: create_release
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c production

Capgo에서 사용하는 의존성을 설치하고 빌드한 후 Capgo로 전송합니다.

빌드 명령이 다르다면, __CAPGO_KEEP_0__ 단계에서 변경할 수 있습니다. build_code 이 작업을 완료하려면 __CAPGO_KEEP_1__에서 __CAPGO_KEEP_0__ 키를 가져와 __CAPGO_KEEP_0__에 추가해야 합니다.

To make this work, you need to get your API key for Capgo, add it in the 당신의 GitHub 저장소의 비밀 그리고 CAPGO_TOKEN.

이 두 개의 파일을 커밋하고 GitHub에 첫 번째 태그가 나타날 수 있습니다!

__CAPGO_KEEP_0__에 새로운 빌드를 생성하는 데 사용되는 커밋을 추가하십시오.

빌드 단계에서 code이 작동하는지 확인하기 위해 테스트를 추가하십시오.

Capgo 대시보드로 가서 빌드가 나타났는지 확인하십시오. 이제 CI/CD 시스템이 있습니다.

사용자들이 업데이트를 받을 수 있도록 하려면 채널로 가서 __CAPGO_KEEP_0__을 public.

Ionic Capacitor JavaScript 앱의 네이티브 빌드를 추가하려면 이 튜토리얼 👇을 따라하십시오.

Github 액션을 사용하여 자동 빌드 및 릴리즈 앱을 계속 진행하십시오.

__CAPGO_KEEP_0__ 액션을 사용하여 CI/CD 자동화 계획을 만든 경우 Github 액션을 연결하십시오. __CAPGO_KEEP_0__ 액션을 사용하여 CI/CD 자동화 계획을 만든 경우 Capgo CI/CD Capgo CI/CD Capgo Native Builds Capgo Native Builds Capgo (Capgo) 통합 Capgo (Capgo) 통합 CI/CD 통합 __CAPGO_KEEP_0__ (Capgo) 액션 GitHub (Capgo) 액션 for the implementation detail in GitHub Actions Integration.