개발 및 운영 빌드를 관리하기 위해 GitHub 액션을 사용하세요

이 튜토리얼은 GitHub 호스팅에 초점을 맞추고 있지만, 다른 CI/CD 플랫폼에适용할 수 있도록 약간의 조정을 하면 됩니다.

소개

Capacitor 앱을 Capgo에 먼저 추가하셨는지 확인하세요. 이 튜토리얼은 업로드 단계만 다룹니다.

커밋 규칙

__CAPGO_KEEP_0__ conventional commits5분 만에 배울 수 있습니다.

GitHub

Then you need to create your first GitHub action to automatically build and create tags.

with this content: .github/workflows/bump_version.yml

이 메인 브랜치의 모든 커밋에 대해 태그를 릴리즈하고

name: Bump version

on:
  push:
    branches:
      - main
      - development

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
        if: github.ref == 'refs/heads/main'
        run: npx capacitor-standard-version
      - name: Create bump and changelog
        if: github.ref != 'refs/heads/main'
        run: npx capacitor-standard-version --prerelease alpha
      - 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

릴리즈 alpha 및 각 커밋에 대한 변경 로그를 작성합니다. development생략해도 됩니다. 이 파일은 자동으로 생성됩니다. CHANGELOG.md.

Then you need to create your first __CAPGO_KEEP_0__ action to automatically build and create tags.

이 기능을 사용하려면 __CAPGO_KEEP_0__에 개인 접근 토큰을 생성하고 추가해야 합니다. 개인 접근 토큰 GitHub의 비밀 비밀 CI가 변경 로그와 버전 업데이트를 제출할 수 있도록 하기 위해 필요합니다. PERSONAL_ACCESS_TOKEN.

토큰을 생성할 때 만료 기간을

scope를 never 로 선택하세요. repo.

__CAPGO_KEEP_0__에 있는 version 키를 설정하세요. 그곳에서 스토어에서 최근 버전을 사용하세요. package.json file.

처음에는만 필요합니다. 그 후에는 도구가 최신 상태를 유지합니다.

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

capacitor-standard-version 이 패키지는 마법을 일으키며 기본적으로 안드로이드와 IOS의 버전 번호를 업데이트합니다.

GitHub 빌드 액션

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

이 내용으로:

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 build
        env:
          MY_ENV_VAR: ${{ secrets.MY_ENV_VAR }}
      - name: Create Release Alpha
        if: "contains(github.ref, '-alpha.')"
        id: create_release_prepro
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c development
      - name: Create Release Production
        if: "!contains(github.ref, '-alpha.')"
        id: create_release_prod
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c production

Capgo으로 의존성을 설치하고 빌드한 후 전송합니다.

빌드 명령이 다르다면, __CAPGO_KEEP_0__에서 "step" 섹션을 변경하세요. build_code 환경 변수가 필요하다면, __CAPGO_KEEP_0__ 프로젝트 설정에서 "secret" 섹션을 사용하세요.

__CAPGO_KEEP_1__ 액션 MY_ENV_VAR 환경 변수가 필요하다면, __CAPGO_KEEP_0__ 프로젝트 설정에서 "secret" 섹션을 사용하세요. secret in your GitHub project setting, then secret then GitHub Action.

To make Capgo 업로드가 작동하려면, API 키를 Capgo에서 가져와 Capgo의 비밀을 위한 GitHub 저장소에 추가하십시오. as CAPGO_TOKEN.

이 두 개의 파일을 커밋하고 Capgo에 첫 번째 버전이 나타나기를 볼 수 있습니다.

커밋을 추가하면 Capacitor의 새로운 빌드가 프로덕션 및 개발 채널에 생성됩니다.

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

Capgo 대시보드로 이동하여 최근에 생성된 빌드를 확인하십시오. 이제 CI/CD 시스템을 갖추었습니다.

Manage development and production build with GitHub actions

관리 개발 및 프로덕션 빌드를 __CAPGO_KEEP_0__ 액션으로 계속 진행하십시오. 관리 개발 및 프로덕션 빌드를 GitHub 액션으로 계속 진행하십시오. 채널 라우팅 및 스테이지드 롤아웃을 계획하고 있는 경우 __CAPGO_KEEP_0__ 액션으로 __CAPGO_KEEP_0__을 연결하십시오. 관리 개발 및 프로덕션 빌드를 __CAPGO_KEEP_0__ 액션으로 계속 진행하십시오. Channels에 대한 구현 세부 정보에 대해 Channels Channels에 대한 구현 세부 정보에 대해 Channels Beta 테스트 솔루션 Beta 테스트 솔루션의 제품 워크플로에 대해 버전 대상 솔루션 버전 대상 솔루션의 제품 워크플로에 대해 작성자