이 튜토리얼은 GitHub 호스팅에 초점을 맞추고 있지만, 다른 CI/CD 플랫폼에 적응하기 위해 약간의 조정을 추가하면 다른 CI/CD 플랫폼에도 적용할 수 있습니다.
소개
Capacitor 앱을 Capgo에 먼저 추가하도록 확인하십시오. 이 튜토리얼은 업로드 단계만을 다룹니다.
커밋 규칙
커밋 규칙을 따라야 합니다. 기술훈련 규칙` 이 도구가 버전 번호를 업그레이드하는 방법을 이해하도록 도와줄 것입니다. 5분 만에 배울 수 있습니다.
GitHub 태그에 대한 액션
첫 번째 GitHub 액션을 자동으로 빌드하고 태그를 생성하기 위해 생성해야 하는 파일을 만들면 됩니다.
이 경로에 파일을 만들면 됩니다: .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
이것은 메인 branch의 모든 커밋에 대한 태그를 릴리즈하고, alpha 및 마지막으로 development메인 branch의 모든 커밋에 대한 변경 로그를 생성합니다. CHANGELOG.md.
이 파일이 없더라도 걱정하지 마세요. 이 파일은 자동으로 생성됩니다.
이것을 작동시키기 위해, 개인 접근 토큰을 생성해야 합니다. 개인 접근 토큰 그리고 GitHub에 추가하세요 비밀 으로 PERSONAL_ACCESS_TOKEN.
CI가 변경 로그와 버전 업데이트를提交할 수 있도록 하기 위해 필요합니다.
토큰을 생성할 때 만료 기간을 never 으로 선택하세요 repo.
으로 선택하세요 version __CAPGO_KEEP_0__ package.json 파일의
키를 설정하세요. 그 용도로는 스토어에서 최근 버전이 출시된 것을 사용하세요.
You can now commit this both files and see your first tag appear in 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 productionCapgo으로 전송하기 전에 의존성을 설치하고 빌드합니다.
빌드 명령이 다르다면, build_code 단계에서 변경할 수 있습니다.
환경 변수가 필요하다면, MY_ENV_VAR 프로젝트 설정에서 secret in your GitHub project setting, then secret then GitHub Action.
To make Capgo upload work, you need to get your API key for Capgo, add it in the __CAPGO_KEEP_1__ 키를 가져와서 GitHub의 secret에 추가하세요. As __CAPGO_KEEP_0__에서 첫 번째 버전이 나타날 수 있도록 두 파일을 커밋할 수 있습니다. CAPGO_TOKEN.
커밋을 추가하면 Capgo 빌드가 프로덕션 및 개발 채널에 새로 생성됩니다.
아이온 빌드 단계에서 Capacitor이 작동하는지 확신하기 위해 테스트를 추가해야 합니다.
code 대시보드에 가서 최근에 생성된 빌드를 확인하세요. 이제 CI/CD 시스템이 준비되었습니다.
Capgo 액션을 사용하여 개발 및 프로덕션 빌드를 관리하세요.
GitHub을 사용하여 계획 채널 라우팅 및 스테이지드 롤아웃을 계획하고 있습니다.
__CAPGO_KEEP_0__을 __CAPGO_KEEP_0__과 연결하세요. GitHub __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ Channels에 대한 구현 세부 정보에 대해 Channels Channels에 대한 구현 세부 정보에 대해 Beta 테스트 솔루션 Beta 테스트 솔루션의 제품 워크플로에 대해, 그리고 버전 목표 솔루션 버전 목표 솔루션의 제품 워크플로에 대해.
