Tutorial ini berfokus pada hosting GitHub, tetapi Anda bisa menyesuaikannya dengan sedikit penyesuaian ke platform CI/CD lainnya.
Kata Pengantar
Pastikan Anda sudah menambahkan aplikasi Capacitor Anda ke Capgo terlebih dahulu; tutorial ini hanya berfokus pada tahap upload. Jika Anda perlu menambahkan aplikasi ke Capgo, Anda dapat mengikuti ini Tutorial
Konvensi commit
Pertama, Anda perlu mulai mengikuti konvensi commit conventional commits` ini akan membantu tooling memahami cara memperbarui nomor versi, hanya butuh 5 menit untuk mempelajarinya.`

GitHub actions untuk tag
Setelah itu, Anda perlu membuat GitHub action pertama untuk otomatis melakukan build dan membuat tag.
Buat file di path ini: .github/workflows/bump_version.yml
dengan isi berikut:
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
Ini akan merilis tag untuk setiap commit di branch main Anda, serta menambahkan entri changelog untuk setiap commit di branch main ke dalam CHANGELOG.md.
Jangan khawatir jika Anda belum punya file ini, file akan dibuat untuk Anda.
Agar ini berfungsi, buatlah sebuah PERSONAL ACCESS TOKEN dan tambahkan ke GitHub Anda secrets sebagai PERSONAL_ACCESS_TOKEN.
Ini diperlukan agar CI dapat commit changelog.
Saat membuat token, pilih masa berlaku sebagai never dan scope sebagai repo.
Terakhir, atur versi di file package.json file, sinkronkan dengan nomor versi Native Anda untuk memudahkan, lalu lanjut ke langkah berikutnya.
Ini hanya perlu dilakukan pertama kali, setelah itu tools akan menjaganya tetap up to date.
Sekarang Anda bisa commit kedua file ini dan melihat tag pertama Anda muncul di GitHub!
Baik platform native maupun web akan mengalami peningkatan nomor versi setelah setiap commit.
GitHub actions untuk build
Buat file di path ini: .github/workflows/build.yml
dengan isi berikut:
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
Ini akan menginstal dan mem-build dependency Anda sebelum dikirim ke Capgo.
Jika perintah build Anda berbeda, Anda bisa mengubahnya di build_code langkah.
Agar ini berjalan, Anda perlu mendapatkan API untuk Capgo, lalu menambahkannya di secret dari repositori GitHub Anda sebagai CAPGO_TOKEN.
Sekarang Anda bisa commit kedua file ini dan melihat tag pertama Anda muncul di GitHub!
Menambahkan commit akan menghasilkan build baru untuk channel production.
Anda sebaiknya menambahkan test di build step untuk memastikan code Anda berfungsi dengan baik.
Buka dashboard Capgo Anda dan periksa build yang baru muncul; sekarang Anda sudah punya sistem CI/CD.
Jika ingin semua pengguna mendapatkan update begitu tersedia, buka channel Anda dan atur ke public.
Anda juga bisa menambahkan native build untuk aplikasi JavaScript Ionic Capacitor Anda dengan mengikuti tutorial ini ๐
Lanjutkan dari Automatic build and release app dengan Github actions
Jika Anda menggunakan Build dan rilis aplikasi otomatis dengan Github actions untuk merencanakan otomatisasi CI/CD, hubungkan dengan CI/CD Capgo untuk workflow produk di Capgo CI/CD, Capgo Native Build untuk workflow produk di Capgo Native Builds, Integrasi Capgo untuk alur kerja produk di Integrasi Capgo, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan Integrasi GitHub Actions untuk detail implementasi di Integrasi GitHub Actions.