이 튜토리얼은 GitHub 호스팅에 중점을 두고 있지만 다른 CI/CD 플랫폼에 적응하기 위해 약간의 조정을 통해 사용할 수 있습니다.
소개
Capacitor 앱을 Capgo에 먼저 추가하도록 보장하십시오. 이 튜토리얼은 업로드 단계만을 다룹니다.
커밋 규칙
첫 번째로 커밋 규칙을 따르기 시작하십시오. conventional commits이것은 도구가 버전 번호를 업그레이드하는 방법을 이해하는 데 도움이 될 것입니다. 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이 작업은 당신의 main branch의 모든 커밋에 대해 태그를 릴리즈합니다. 그리고 마지막으로 커밋의 각 변경 로그에 대한 릴리즈를 생성합니다. alpha 릴리즈 development, 그리고 마지막으로 커밋의 각 변경 로그에 대한 릴리즈를 생성합니다. CHANGELOG.md.
변경 로그
이 파일이 없다고 걱정하지 마세요. 이 파일은 당신에게 자동으로 생성됩니다. 이 작업을 하려면, 당신은 개인 접근 토큰을 생성하고 __CAPGO_KEEP_0__ and add it to your GitHub 비밀 비밀 PERSONAL_ACCESS_TOKEN.
으로 추가해야 합니다.
CI가 변경 로그와 버전 업데이트를 커밋할 수 있도록 하기 위해 이것이 필요합니다. never 그리고 범위도 repo.
설정 version 키를 package.json 파일에 넣으세요. 그 파일을 사용하여 스토어에서 가장 최근에 출시된 버전을 사용하세요.
이것은 처음 한 번만 필요합니다. 그 다음부터는 도구가 자동으로 업데이트를 유지합니다.
이제 두 개의 파일을 커밋할 수 있습니다. 그리고 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__에서 변경할 수 있습니다. build_code 단계.
환경 변수가 필요하다면 사용하세요. MY_ENV_VAR 및 설정하여 __CAPGO_KEEP_0__ 프로젝트 설정에서 비밀번호를 설정하고 __CAPGO_KEEP_1__ 액션을 사용하세요. secret GitHub 업로드를 하려면 GitHub 키를 __CAPGO_KEEP_2__에 가져와 GitHub 저장소의 비밀을 추가하세요.
To make Capgo upload work, you need to get your API key for Capgo, add it in the GitHub 이제 이 두 파일을 모두 커밋하고 __CAPGO_KEEP_0__에 첫 번째 버전을 확인하세요! CAPGO_TOKEN.
커밋을 추가하면 새로운 Capgo 빌드를 프로덕션 및 개발 채널에 생성합니다.
테스트를 Ionic 빌드 단계에 추가하여 Capacitor가 올바르게 작동하는지 확인하세요.
code 대시보드로 이동하여 빌드가 생성된 것을 확인하세요. 이제 CI/CD 시스템이 준비되었습니다.
Capgo 액션으로 개발 및 프로덕션 빌드를 관리하세요.
GitHub
만약에 당신이 사용 중이라면 GitHub을 사용하여 개발 및 프로덕션 빌드를 관리하세요 채널 라우팅과 스테이지드 롤아웃을 계획하고 연결하려면 채널 채널 채널 채널 베타 테스트 솔루션 제품 워크플로우에서 베타 테스트 솔루션을 사용하고 버전 대상 솔루션 버전 대상 솔루션 버전 대상 솔루션 버전 목표 솔루션의 제품 워크플로우에 대해.
