Pengaturan Otomatis Pembangunan dan Rilis dengan Gitlab

Tutorial ini berfokus pada GitLab CI, tetapi Anda dapat menyesuaikannya dengan sedikit perubahan untuk platform CI/CD lainnya.

Pendahuluan

Pastikan Anda telah menambahkan aplikasi Anda terlebih dahulu ke Capgo, tutorial ini hanya berfokus pada fase unggah.

Konvensi Komit

Pertama, Anda perlu memulai mengikuti konvensi komit context: Halaman/area: Capgo Builder / produk halaman pembangunan asli di cloud. Peran: Label UI pendek atau item navigasi. Pesan kunci `native_build_builder_credit_first` (Kredit Pembangun Asli Pertama).Komit Konvensional

GitLab CI untuk Tag

Kemudian Anda perlu membuat GitLab pertama untuk membangun dan membuat tag secara otomatis.

Buat file di path ini: .github/workflows/bump_version.yml

Dengan konten ini:

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 komit di cabang utama Anda. Dan tambahkan entri perubahan log untuk setiap komit di cabang utama di CHANGELOG.md.

Tidak perlu khawatir jika Anda tidak memiliki file ini, akan dibuat untuk Anda.

Untuk membuat ini berfungsi, buatlah TOKEN AKSES Pribadi dan tambahkan ke variabel GitLab CI/CD sebagai PERSONAL_ACCESS_TOKEN.

Ini diperlukan untuk memungkinkan CI mengirimkan perubahan log.

Saat Anda membuat token, pilihlah masa kadaluarsa sebagai never dan ruang lingkup sebagai repo.

Terakhir, untuk memungkinkan alat memahami di mana versi Anda disimpan, Anda harus membuat file .cz.toml di root repositori Anda.

Dan tambahkan ini di dalamnya :

[tool.commitizen]
name = "cz_conventional_commits"
tag_format = "$major.$minor.$patch$prerelease"
version = "0.11.5"
version_files = [
    "package.json:version",
    ".cz.toml"
]

Setel versi di file ini sama dengan yang Anda miliki di package.json file.

Hal ini hanya perlu dilakukan kali pertama, kemudian alat akan menjaganya sampai saat ini.

Anda dapat menambahkan file-file ini dan melihat tag pertama muncul di GitHub!

GitHub aksi untuk pembangunan

Buat file di path ini: .github/workflows/build.yml

Dengan konten ini:

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

Hal ini akan menginstal dan membangun dependensi Anda sebelum mengirimkannya ke Capgo.

Jika perintah pembangunan Anda berbeda, Anda dapat mengubahnya di build_code Langkah.

Untuk membuat hal ini berfungsi, Anda perlu mendapatkan kunci API Anda untuk Capgo, tambahkan di Rahasia repositori GitHub Anda sebagai CAPGO_TOKEN.

Kamu bisa sekarang mengirimkan perubahan ini pada kedua file dan melihat tag pertama muncul di GitHub!

Menambahkan komit akan menghasilkan build baru untuk saluran produksi.

Kamu harus menambahkan tes di langkah build untuk memastikan code kamu berfungsi.

Pergi ke dashboard Capgo kamu dan cek build yang baru muncul, kamu sekarang memiliki sistem CI/CD.

Jika kamu ingin membiarkan semua pengguna mendapatkan update ketika tersedia, pergi ke saluran kamu dan atur untuk public.

Teruskan dari Automatic build and release with Gitlab

Jika kamu menggunakan Automatic build and release with Gitlab untuk merencanakan otomatisasi CI/CD, hubungkan dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Native Builds untuk alur kerja produk di Capgo Pembangunan Asli Capgo Integrasi untuk alur kerja produk di Capgo Integrasi Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Aksi Integrasi untuk detail implementasi di GitHub Aksi Integrasi.