이 튜토리얼은 GitHub 호스팅에 중점을 두고 있지만, 다른 CI/CD 플랫폼에 적응하기 위해 약간의 조정을 통해 사용할 수 있습니다.
소개
Capacitor 앱을 Capgo에 먼저 추가하십시오. 이 튜토리얼은 업로드 단계만 다룹니다. Capgo에 앱을 추가해야 하는 경우에는 이 방법을 따라하십시오. 튜토리얼
커밋 규칙
커밋 규칙을 따르기 시작하십시오. conventional commits`이것은 도구가 버전 번호를 업그레이드하는 방법을 이해할 수 있도록 도와주며, 5분 만에 배울 수 있습니다.
GitHub 액션을 태그에 대한 태그를 자동으로 생성하고 빌드하는 데 사용합니다.
GitHub 액션을 생성하십시오.
파일을 다음 경로에 생성하십시오: .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이 작업은 주 브랜치의 모든 커밋에 대한 태그를 릴리즈하고, 주 브랜치의 모든 커밋에 대한 변경 로그 항목을 추가합니다. CHANGELOG.md.
이 파일이 없다고 걱정하지 마세요. 이 파일은 자동으로 생성됩니다.
이 작업을 완료하려면 __CAPGO_KEEP_0__ PERSONAL ACCESS TOKEN GitHub 비밀 으로 PERSONAL_ACCESS_TOKEN.
이 작업을 완료하려면 변경 로그를 CI가 커밋할 수 있도록 하기 위해 이 작업이 필요합니다.
토큰을 생성할 때 만료 기간을 never 으로 선택하고 범위는 repo.
마지막으로, 버전을 설정하고 package.json 파일에 반영하고 Native 버전 번호와 일치시켜야 합니다. 이로 인해 다음 단계가 수월해집니다.
이 작업은 처음 한 번만 필요합니다. 그 후, 도구는 자동으로 업데이트하므로.
이제 두 개의 파일을 커밋하고 GitHub에 첫 번째 태그가 나타날 수 있습니다!
Native 및 웹 플랫폼 모두 각 커밋마다 버전 번호를 업데이트합니다.
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 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_KEEP_1__에서 변경할 수 있습니다. build_code 이 작업을 완료하려면 __CAPGO_KEEP_0__ 키를 __CAPGO_KEEP_1__에서 가져와 __CAPGO_KEEP_2__에 추가해야 합니다.
To make this work, you need to get your API key for Capgo, add it in the GitHub의 비밀 저장소 as CAPGO_TOKEN.
GitHub의 두 파일을 모두 커밋하고 첫 번째 태그가 GitHub에 나타날 수 있습니다!
생산 채널에 대한 새로운 빌드를 생성하는 커밋을 추가합니다.
빌드 단계에서 code이 작동하는지 확인하기 위해 테스트를 추가해야 합니다.
Capgo 대시보드로 가서 최근에 생성된 빌드를 확인하세요. 이제 CI/CD 시스템이 준비되었습니다.
업데이트가 언제든지 사용할 수 있도록 하려면 채널로 이동하여 public.
Capacitor의 네이티브 빌드를 추가하는 방법에 대한 이 튜토리얼을 따라해 보세요 👇
Github 액션을 사용하여 자동 빌드 및 릴리스 앱을 계속 진행하세요.
__CAPGO_KEEP_0__ 액션을 사용하여 자동 빌드 및 릴리스 앱을 사용하는 경우 Automatic build and release app with Github actions __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 Actions 통합 GitHub Actions 통합 구현 세부 사항
