Automatische Build- und Releasefunktion mit Gitlab

Dieses Tutorial konzentriert sich auf GitLab CI, aber Sie können es mit einem kleinen Anpassung auf jede andere CI/CD-Plattform anwenden.

Einleitung

Stellen Sie sicher, dass Sie Ihre App zuerst bei Capgo hinzugefügt haben, da dieses Tutorial sich nur auf die Upload-Phase konzentriert.

Commit-Konvention

Zuerst müssen Sie die Commit-Konvention befolgen kontext: Seite/Bereich: Capgo Builder / native cloud build Produktseite. Rolle: Kurze Benutzeroberflächenebene oder Navigationselement. Nachrichtenschlüssel `native_build_builder_credit_first` (Native Build Builder Credit First).konventionelle Commits

Konventionelle Commits

GitLab CI für Tag

Anschließend müssen Sie Ihre erste GitLab erstellen, um automatisch zu bauen und einen Tag zu erstellen. .github/workflows/bump_version.yml

Erstellen Sie ein Datei an diesem Pfad:

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

Dies wird für jeden Commit in Ihrer Hauptzweig eine Versionsnummer freigeben. Und ein Eintrags in der Versionshistorie für jeden Commit in der Hauptzweig hinzufügen. CHANGELOG.md.

Sie müssen sich keine Sorgen machen, wenn Sie dieses Datei nicht haben, es wird für Sie erstellt.

Um dies zu ermöglichen, erstellen Sie ein PERSONAL ACCESS TOKEN und fügen Sie es Ihren GitLab CI/CD Variablen als PERSONAL_ACCESS_TOKEN.

Dies ist erforderlich, damit der CI die Versionshistorie einträgt.

Wählen Sie bei der Erstellung des Tokens als never als Ablaufdatum und als repo.

als Bereich .cz.toml Zum Schluss müssen Sie das Tool dazu bringen, wo Ihre Versionsnummer gespeichert ist, indem Sie die Datei

an der Wurzel Ihres Repository erstellen.

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

Und fügen Sie dies hinein: package.json Datei.

Dies ist nur notwendig die erste Zeit, dann halten die Werkzeuge es auf dem neuesten Stand.

Sie können diese beiden Dateien jetzt committen und sehen, wie Ihre erste Tag in GitHub erscheint!

Aktionen für die GitHub-Erstellung

Erstellen Sie ein Datei am diesem Pfad: .github/workflows/build.yml

Mit diesem Inhalt:

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

Dies wird Ihre Abhängigkeit installieren und bauen, bevor sie an Capgo gesendet wird.

Wenn Ihr Befehl für die Build-Ausführung anders ist, können Sie ihn im (Note: I kept the placeholder __CAPGO_KEEP_0__ exactly as written) build_code Schritt.

Um dies zu ermöglichen, benötigen Sie Ihren API-Schlüssel für Capgo, fügen Sie ihn ein. Geheimnis Ihres GitHub-Repositories als CAPGO_TOKEN.

Sie können jetzt beide Dateien committen und sehen, wie Ihre erste Tag in GitHub erscheint!

Der Commit wird eine neue Build für den Produktionskanal generieren.

Sie sollten Ihre Tests in der Build-Schritt hinzufügen, um sicherzustellen, dass Ihre code funktioniert.

Gehen Sie zu Ihrem Capgo-Dashboard und überprüfen Sie Ihre Build, die gerade erschienen ist, jetzt haben Sie Ihr CI/CD-System.

Wenn Sie möchten, dass alle Ihre Benutzer die Aktualisierung erhalten, sobald sie verfügbar ist, gehen Sie zu Ihrem Kanal und setzen Sie ihn auf public.

Fortsetzen Sie mit der automatischen Build- und Release-Verarbeitung mit Gitlab

Wenn Sie Automatische Build- und Release-Verarbeitung mit Gitlab verwenden Capgo CI/CD Capgo CI/CD für das Produktworkflow in Capgo CI/CD, für das Produktworkflow in Capgo Native Builds Capgo Integrations für das Produktworkflow in Capgo Integrations CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration, und für die Implementierungsdetails in GitHub Actions Integration for the implementation detail in GitHub Actions Integration.