このチュートリアルはGitLab CIに焦点を当てていますが、他のCI/CDプラットフォームに適応するには少し調整するだけで済みます。
序文
このチュートリアルはアップロードフェーズに焦点を当てていますが、まずアプリをCapgoに追加してください。
コミット規約
最初はコミット規約を遵守する必要があります conventional commits` これを実行すると、ツールがバージョン番号をアップグレードする方法を理解できるようになります。5分で学べます。
GitLab CI for tag
次に、GitLab CIを使用してタグを作成するように自動的にビルドするGitLabを作成する必要があります。
このパスにファイルを作成してください: .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.
このファイルが必要ない場合は心配しないでください。自動的に作成されます。
この機能を実行するには、 PERSONAL ACCESS TOKEN GitLab CI/CD変数に追加してください PERSONAL_ACCESS_TOKEN.
CIが変更履歴をコミットできるようにする必要があります。
トークンを作成するときは、有効期限を never スコープを repo.
最初に、バージョンが保存されている場所をツールが理解できるようにするために、ファイル .cz.toml リポジトリのrootに作成してください。
この中に追加してください。
[tool.commitizen]
name = "cz_conventional_commits"
tag_format = "$major.$minor.$patch$prerelease"
version = "0.11.5"
version_files = [
"package.json:version",
".cz.toml"
]このファイルのバージョンを、 package.json ファイルのバージョンと同じに設定してください。
最初の1回だけ必要です。ツールはその後自動的に更新します。
You can now commit this both files and see your first tag appear in GitHub!
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に送信します。
ビルドのコマンドが異なる場合は、ステップで変更してください。 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 secret of your GitHub repository ビルドステップでテストを追加してください。__CAPGO_KEEP_0__が正常に動作していることを確認する必要があります。 CAPGO_TOKEN.
GitHubダッシュボードに移動し、最近のビルドを確認してください。CI/CDシステムが稼動しています。
__CAPGO_KEEP_0__のシークレットに__CAPGO_KEEP_0__キーを追加する必要があります。
codeのビルドが正常に生成されることを確認するには、codeのシークレットにcodeキーを追加する必要があります。
CapgoのCI/CDシステムを設定するには、CapgoのシークレットにCapgoキーを追加する必要があります。
すべてのユーザーが更新を取得できるようにしたい場合は、チャンネルに移動し、 public.
GitLabの自動ビルドとリリースから続けてください。
「 GitLabの自動ビルドとリリース 」を使用してCI/CDの自動化を計画している場合、 Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds, Capgo Integrations for the product workflow in Capgo Integrations, __CAPGO_KEEP_0__ CI/CD CI/CD統合の実装詳細について GitHub アクション統合 for the implementation detail in GitHub Actions Integration.
